SHOW SERVICE INSTANCES IN SERVICE

服务 实例列表。

命令输出通过显示每个服务实例的状态，能够清晰地呈现自动扩展和滚动升级的情况。

另请参阅：

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

语法

SHOW SERVICE INSTANCES IN SERVICE <name>
Copy

参数

name

指定要列出其实例的服务的标识符。

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

输出

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

列

描述

database_name

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

schema_name

在其中创建服务的架构。

service_name

服务的名称。

instance_id

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

status

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

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

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

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

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

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

spec_digest

代表服务规范内容的唯一且不可变的标识符。

creation_time

Snowflake 开始创建服务实例的时间。

start_time

Snowflake 确认服务实例在节点上运行的时间。

访问控制要求

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

权限

对象

备注

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

服务

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

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

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

使用说明

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

示例

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

SHOW SERVICE INSTANCES IN SERVICE echo_service;
Copy

示例输出：

+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
| database_name | schema_name | service_name | instance_id | status | spec_digest                                                      | creation_time        | start_time           |
|---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | READY  | cb0cbefa3376e75e5926d56535198ce27b3790780beb2c924085eef41dad9adf | 2024-08-08T18:31:38Z | 2024-08-08T18:34:01Z |
+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
语言: 中文