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 确认服务实例在节点上运行的时间。

ip_address

服务实例的 IP 地址。同一服务（或其他服务）的其他实例可以使用此 IP 地址来连接到特定的服务实例。

运行多个服务实例时，您可以通过以下方式在服务实例中实施 Leader 选举：instance_id 0 的实例作为 Leader。

访问控制要求

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

权限

对象

备注

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

服务

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

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

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

使用说明

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

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

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

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

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

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

示例

以下示例列出了会话的当前数据库和架构中的 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           | ip_address |
|---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | READY  | edaf548eb0c2744a87426529b53aac75756d0ea1c0ba5edb3cbb4295a381f2b4 | 2025-02-21T07:17:02Z | 2025-02-21T07:17:02Z | 10.244.3.8 |
+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------+
语言: 中文