SHOW SERVICES

列出您具有访问权限的 Snowpark Container Services 服务 （包括作业服务）。

  • SHOW SERVICES 的输出还包含了作为作业运行的服务（请参阅 EXECUTE JOB SERVICE）。

  • SHOW JOB SERVICES 仅提供作为作业运行的服务的列表。

  • SHOW SERVICES EXCLUDE JOBS 的输出不包含作为作业运行的服务。

另请参阅：

CREATE SERVICE、ALTER SERVICE、DROP SERVICE、DESCRIBE SERVICE、SHOW SERVICE INSTANCES IN SERVICE、SHOW SERVICE CONTAINERS IN SERVICE

语法

SHOW [ JOB ] SERVICES [ EXCLUDE JOBS ] [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>            |

                  COMPUTE POOL <compute_pool_name>
                }
           ]
           [ STARTS WITH '<name_string>' ]
           [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

参数

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回 相同的 结果：

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

[ IN ... ]

（可选）指定命令的作用域。指定以下任一项：

ACCOUNT

返回整个账户的记录。

DATABASE、. DATABASE db_name

返回当前正在使用的数据库或指定数据库 (db_name) 的记录。

如果指定 DATABASE 而不指定 db_name，并且没有使用任何数据库，则关键字对输出没有影响。

SCHEMA、. SCHEMA schema_name、. schema_name

返回当前正在使用的架构或指定架构 (schema_name) 的记录。

如果数据库正在使用中，或者指定了完全限定 schema_name （例如 db.schema），则 SCHEMA 是可选选项。

如果未使用任何数据库，则指定 SCHEMA 对输出没有影响。

默认：取决于会话当前是否正在使用数据库：

  • 数据库：DATABASE 是默认值（即该命令返回您有权在数据库中查看的对象）。

  • 无数据库：ACCOUNT 是默认值（即该命令返回您有权在账户中查看的对象）。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且 区分大小写。

例如，以下字符串会返回 不同的 结果：

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows

（可选）限制返回的最大行数。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

默认：无值（不对输出应用限制）。

输出

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

列

描述

name

Snowpark Container Services 服务名称。

status

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

  • PENDING

  • RUNNING

  • FAILED

  • DONE

  • SUSPENDING

  • SUSPENDED

  • DELETING

  • DELETED

  • INTERNAL_ERROR

database_name

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

schema_name

在其中创建服务的架构。

owner

拥有服务的角色。

compute_pool

Snowflake 在其中运行服务的计算池的名称。

dns_name

Snowflake 为服务分配的 DNS 名称，格式如下：service-name.unique-id.svc.spcs.internal。

unique-id 是一个 4-8 个字符长的字母数字标识符，唯一对应于数据库架构的特定实例。要查找架构的唯一 ID，请调用 SYSTEM$GET_SERVICE_DNS_DOMAIN 函数。例如：

SELECT SYSTEM$GET_SERVICE_DNS_DOMAIN('mydb.myschema');
Copy

请注意以下事项：

  • 如果您重命名一个架构，标识符保持不变。

  • 如果您删除并重新创建一个具有相同名称的架构，标识符将会改变。

DNS 名称支持服务到服务的通信（请参阅 教程 3）。

current_instances

服务的当前实例数。

target_instances

Snowflake 确定的应运行的服务实例的目标数量。

当 current_instances 值与 target_instances 值不相等时，Snowflake 正在关闭或启动服务实例。

例如，请考虑以下示例：

  • 假设您创建了一个服务，其中 MIN_INSTANCES = 1，MAX_INSTANCES = 3。在服务运行时，Snowflake 可能确定一个实例是不够的。在这种情况下，target_instances 的值将增加，表明 Snowflake 正在启动其他实例。

    target_instances 值也可能小于 current_instances 值，这表明 Snowflake 正在减少运行实例的数量。

  • 如果您创建服务，但计算池没有容量来满足您请求的最小实例数，则 target_instances 的值将等于 min_instances 的值。current_instances 的值将小于 target_instances 的值。

min_instances

Snowflake 应该运行的最小服务实例数。

max_instances

Snowflake 在需要时可以扩展的最大服务实例数。

auto_resume

如果为 true，则在调用服务函数或收到传入请求 (ingres) 时，Snowflake 会自动恢复已暂停的服务（请参阅 使用服务）。

external_access_integrations

与服务相关联的外部访问集成的列表。有关更多信息，请参阅 配置网络出口。

created_on

服务的创建日期和时间。

updated_on

服务的上次更新日期和时间。

resumed_on

服务的上次恢复时间戳。

comment

服务的相关注释。

owner_role_type

拥有对象的角色类型是 ROLE 或 DATABASE_ROLE。

query_warehouse

当服务容器连接到 Snowflake 以执行查询，但未显式指定要使用的仓库时，Snowflake 默认使用该仓库。

is_job

如果服务是作业服务，则为 true，否则为 false。SHOW JOB SERVICES 和 SHOW SERVICES EXCLUDE JOBS 的输出中不包含此列。

spec_digest

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

为了观察 spec_digest 列的值随时间的变化，服务用户可能会定期执行 SHOW SERVICES 命令。如果服务用户注意到值发生变化，则可以推断服务已升级。

is_upgrading

如果 Snowflake 正在升级服务，则为 TRUE。

managing_object_domain

管理对象的域（例如，管理服务的笔记本的域）。如果服务不受 Snowflake 实体管理，则为 NULL。

managing_object_name

管理对象的名称（例如，管理服务的笔记本的名称）。如果服务不受 Snowflake 实体管理，则为 NULL。

访问控制要求

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

权限

对象

备注

以下任何一项权限：OWNERSHIP、USAGE、MONITOR 或者 OPERATE

服务

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

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

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

使用说明

  • 以前缀 is_ 开头的列返回 Y (yes) 或 N (no)。

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

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

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

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

示例

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

SHOW SERVICES;
Copy

示例输出：

+----------------------------+-----------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+
| name                       | status    | database_name | schema_name | owner     | compute_pool          | dns_name                                                                       | current_instances | target_instances | min_instances | max_instances | auto_resume | external_access_integrations | created_on                    | updated_on                    | resumed_on | comment | owner_role_type | query_warehouse | is_job | spec_digest                                                      | is_upgrading | managing_object_domain | managing_object_name |
|----------------------------+-----------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------|
| ECHO_SERVICE               | RUNNING   | TUTORIAL_DB   | DATA_SCHEMA | TEST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.fsvv.svc.spcs.internal                                            |                 1 |                1 |             1 |             1 | true        | NULL                         | 2024-08-16 19:05:45.537 -0700 | 2024-08-16 19:05:46.354 -0700 | NULL       | NULL    | ROLE            | NULL            | false  | 58447f146a9591df5a69668f73ea35be9aa1b2829ace05d1c97c6f999246ac31 | false        | NULL                   | NULL                 |
| ECHO_SERVICE2              | RUNNING   | TUTORIAL_DB   | DATA_SCHEMA | TEST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service2.fsvv.svc.spcs.internal                                           |                 1 |                1 |             1 |             1 | true        | NULL                         | 2024-08-16 19:03:46.893 -0700 | 2024-08-16 19:03:47.895 -0700 | NULL       | NULL    | ROLE            | NULL            | false  | 58447f146a9591df5a69668f73ea35be9aa1b2829ace05d1c97c6f999246ac31 | false        | NULL                   | NULL                 |
+----------------------------+-----------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+

以下示例列出了一项服务：

SHOW SERVICES LIMIT 1;
Copy

以下示例列出了名称中包含“echo”的服务：

SHOW SERVICES LIKE '%echo%';
Copy

以下示例列出了名称中包含“echo”的一项服务：

SHOW SERVICES LIKE '%echo%' LIMIT 1;
Copy

以下示例仅列出作为作业运行的服务：

SHOW JOB SERVICES;
Copy
语言: 中文