SHOW SERVICES¶

列出您具有访问权限的 :doc:` Snowpark Container Services 服务 </developer-guide/snowpark-container-services/working-with-services>` （包括作业服务）。

SHOW SERVICES 的输出还包含了作为作业运行的服务（请参阅 EXECUTE JOB SERVICE）。
SHOW JOB SERVICES 仅提供作为作业运行的服务的列表。
SHOW SERVICES EXCLUDE JOBS 的输出不包含作为作业运行的服务。

另请参阅：: CREATE SERVICE、ALTER SERVICE、DROP SERVICE、DESCRIBE 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 服务名称。
`database_name`	在其中创建服务的数据库。
`schema_name`	在其中创建服务的架构。
`owner`	拥有服务的角色。
`compute_pool`	Snowflake 在其中运行服务的计算池的名称。
`dns_name`	Snowflake 为服务分配的 DNS 名称。DNS 名称支持服务到服务的通信（请参阅教程 3）。
`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 的输出中不包含此列。

访问控制要求¶

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

权限	对象	备注
以下任何一项权限：OWNERSHIP、USAGE、MONITOR 或者 OPERATE	服务

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

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

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

使用说明¶

以前缀 is_ 开头的列返回 Y (yes) 或 N (no)。
该命令不需要正在运行的仓库即可执行。
该命令最多返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定；即使应用了筛选器，也不会返回任何超过 1 万条限制的记录。

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

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

示例¶

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

SHOW SERVICES;

Copy

示例输出：

+-----------------------+---------------+-------------+-----------+-----------------------+---------------------------------------------------------------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+
| name                  | database_name | schema_name | owner     | compute_pool          | dns_name                                                                  | min_instances | max_instances | auto_resume | external_access_integrations | created_on                    | updated_on                    | resumed_on | comment | owner_role_type | query_warehouse | is_job |
|-----------------------+---------------+-------------+-----------+-----------------------+---------------------------------------------------------------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------|
| ECHO_SERVICE          | TUTORIAL_DB   | DATA_SCHEMA | TEST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.data-schema.tutorial-db.snowflakecomputing.internal          |             1 |             1 | true        | NULL                         | 2024-04-29 14:58:49.036 -0700 | 2024-04-29 14:58:51.039 -0700 | NULL       | NULL    | ROLE            | NULL            | false  |
+-----------------------+---------------+-------------+-----------+-----------------------+---------------------------------------------------------------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+

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

SHOW SERVICES LIMIT 1;

Copy

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

SHOW SERVICES LIKE '%echo%';

Copy

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

SHOW SERVICES LIKE '%echo%' LIMIT 1;

Copy

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

SHOW JOB SERVICES;

Copy