SHOW SERVICE CONTAINERS IN SERVICE

列出 服务 的所有实例中的容器。

如果 Snowflake 在执行一个或多个服务容器时遇到问题，此命令可提供单个容器状态的可见性。同样，在滚动升级期间，它会显示在每个容器中运行的服务代码版本。

另请参阅：

Snowpark Container Services 概述、CREATE SERVICE、SHOW SERVICES、SHOW SERVICE INSTANCES IN SERVICE

语法

SHOW SERVICE CONTAINERS IN SERVICE <name>
Copy

参数

name

指定要列出其容器的服务的标识符。

不支持带引号的特殊字符名称或区分大小写的名称。

输出

命令输出将在以下列中提供服务容器的属性和元数据：

列

描述

database_name

在其中创建服务的数据库。

schema_name

在其中创建服务的架构。

service_name

服务的名称。

service_status

以下各值之一，表示服务的当前状态：

  • PENDING

  • RUNNING

  • FAILED

  • DONE

  • SUSPENDING

  • SUSPENDED

  • DELETING

  • DELETED

  • INTERNAL_ERROR

此列中的值与 DESCRIBE SERVICE 输出中的 status 列相同。

instance_id

服务实例的 ID（这是从 0 开始的服务实例索引）。当没有正在运行的服务实例时（即服务为 SUSPENDED 或 PENDING），instance_id 和 instance_status 将返回为 NULL。此外，输出中与容器相关的字段也返回为 NULL。

instance_status

以下各值表示服务实例的不同当前状态：

  • PENDING：服务实例目前正在部署中，尚未准备好为请求提供服务。

  • READY：服务实例中的所有容器都已就绪；服务实例已准备好为请求提供服务。

  • FAILED：服务实例中至少有一个容器因故障退出。

  • TERMINATING：服务实例正在终止，将在该过程结束后移除。

  • SUCCEEDED：该服务是一项作业服务，服务实例中的所有容器都已成功终止。

请注意，对于由 instance_id 列标识的给定服务实例，instance_status 列中的值与 SHOW SERVICE INSTANCES IN SERVICE 命令输出中 status 列的值匹配。

container_name

容器的名称。如果没有容器在运行（即服务处于 SUSPENDED 或 PENDING 状态），则容器名称将返回为 NULL，并且所有容器特定的字段值也将为 NULL。

status

服务容器状态。目前支持的状态值包括以下项：

  • PENDING：当前正在部署容器。

  • READY：容器启动，就绪探测器返回 HTTP 200 OK 状态。

  • DONE：容器以 0 的退出代码退出。

  • FAILED：容器以非 0 的退出代码退出（退出代码 0 表示成功）。

  • UNKNOWN：Snowflake 无法检索容器状态。联系支持。

message

关于状态的补充说明。例如，当状态为 FAILED 时，Snowflake 可能会提供其他信息。

image_name

用于创建服务的图像名称。

image_digest

代表图像内容的唯一且不可更改的标识符。

restart_count

Snowflake 重新启动服务的次数。

start_time

容器开始运行的日期和时间。

last_exit_code

表示容器上次退出时的退出代码。如果服务容器过早退出，Snowflake 会重新启动该容器。退出代码采用整数值的形式表示：

  • NULL：容器目前正在运行，且从未退出。

  • 0：容器上次退出成功。

  • 非零值：容器遭遇故障。

last_restart_time

提供 Snowflake 最近一次重新启动容器的时间戳。NULL 值表示容器从未重新启动过。

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

以下任何一项权限：OWNERSHIP 或 MONITOR

服务

要对架构中的任何对象执行操作，需要对父数据库和架构具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 该命令不需要正在运行的仓库即可执行。

  • 该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。

  • MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。

  • 若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。您还可以使用 管道运算符 来查询此命令的输出。

  • 该命令 最多 返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定。即使应用了筛选器，也不会返回任何超过 1 万条限制的记录。

    要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。

示例

下面的示例列出了会话的当前数据库和架构中 echo_service 服务的容器：

SHOW SERVICE CONTAINERS IN SERVICE echo_service;
Copy

示例输出：

+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+
| database_name | schema_name | service_name | service_status | instance_id | instance_status | container_name | status | message | image_name                                                                                                                                         | image_digest                                                            | restart_count | start_time           | last_exit_code | last_restart_time |
|---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | RUNNING        | 0           | READY           | echo           | READY  | Running | orgname.acctname.registry-dev.snowflakecomputing.cn/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest                      | sha256:d04a2d7b7d9bd607df994926e3cc672edcb541474e4888a01703e8bb0dd3f173 |             0 | 2025-04-25T06:01:38Z |           NULL | NULL              |
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+
语言: 中文