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

服务的名称。

instance_id

服务实例的 ID（这是从 0 开始的服务实例索引）。

container_name

容器的名称。

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

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

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

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

服务

请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

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

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

使用说明

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

示例

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

SHOW SERVICE CONTAINERS IN SERVICE echo_service;
Copy

示例输出：

+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
| database_name | schema_name | service_name | instance_id | container_name | status | message | image_name                                                                                                                | image_digest                                                            | restart_count | start_time           |
|---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | echo           | READY  | Running | orgname-acctname.registry.snowflakecomputing.cn/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest | sha256:060d2dd3dc1da647b5bdbfd3b86251d80e955c5dcd9a6a19a8593aa0a1627676 |             0 | 2024-08-08T18:34:24Z |
+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
语言: 中文