DESCRIBE SERVICE¶
描述 :doc:` Snowpark Container Services 服务 </developer-guide/snowpark-container-services/working-with-services>` （包括作业服务）。将此命令用于服务和像作业一样运行的服务。
DESCRIBE 可以缩写为 DESC。
语法¶
DESC[RIBE] SERVICE <name>
参数¶
name指定要描述的服务的标识符。
如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
有关更多信息，请参阅 标识符要求。
输出¶
命令输出在以下列中提供服务属性和元数据：
列 |
描述 |
|---|---|
|
Snowpark Container Services 服务名称。 |
|
在其中创建服务的数据库。 |
|
在其中创建服务的架构。 |
|
拥有服务的角色。 |
|
Snowflake 在其中运行服务的计算池的名称。 |
|
服务规范文件。仅当您在执行命令时使用服务的所有者角色时，输出才包含此列。 |
|
Snowflake 为服务分配的 DNS 名称。DNS 名称支持服务到服务的通信（请参阅 教程 3）。 |
|
Snowflake 应该运行的最小服务实例数。 |
|
Snowflake 在需要时可以扩展的最大服务实例数。 |
|
如果为 true，则在调用服务函数或收到传入请求 (ingres) 时，Snowflake 会自动恢复已暂停的服务（请参阅 使用服务）。 |
|
与服务相关联的外部访问集成的列表。有关更多信息，请参阅 网络出口。 |
|
服务的创建时间戳。 |
|
服务的上次更新时间戳。 |
|
服务的上次恢复时间戳。 |
|
服务的相关注释。 |
|
拥有对象的角色类型是 ROLE 或 DATABASE_ROLE。 |
|
当服务容器连接到 Snowflake 以执行查询，但未显式指定要使用的仓库时，Snowflake 默认使用该仓库。 |
|
如果服务是作业服务，则为 |
访问控制要求¶
权限 |
对象 |
备注 |
|---|---|---|
MONITOR |
服务 |
请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。
有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。
使用说明¶
若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。
示例¶
以下示例描述名为 echo_service 的服务：
DESCRIBE SERVICE echo_service;
+--------------+---------------+-------------+-----------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+
| name | database_name | schema_name | owner | compute_pool | spec | 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 |
| | | | | | spec: | | | | | | | | | | | | |
| | | | | | containers: | | | | | | | | | | | | |
| | | | | | - name: "echo" | | | | | | | | | | | | |
| | | | | | image: "orgname-acctname.registry.snowflakecomputing.cn/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest" | | | | | | | | | | | | |
| | | | | | sha256: "@sha256:70421668b2635b2996c6d5bc80627cf6d98c0716948b5f60d198d6411d411111" | | | | | | | | | | | | |
| | | | | | env: | | | | | | | | | | | | |
| | | | | | SERVER_PORT: "8000" | | | | | | | | | | | | |
| | | | | | CHARACTER_NAME: "Bob" | | | | | | | | | | | | |
| | | | | | readinessProbe: | | | | | | | | | | | | |
| | | | | | port: 8000 | | | | | | | | | | | | |
| | | | | | path: "/healthcheck" | | | | | | | | | | | | |
| | | | | | endpoints: | | | | | | | | | | | | |
| | | | | | - name: "echoendpoint" | | | | | | | | | | | | |
| | | | | | port: 8000 | | | | | | | | | | | | |
| | | | | | public: true | | | | | | | | | | | | |
| | | | | | - name: "echoendpoint2" | | | | | | | | | | | | |
| | | | | | port: 8002 | | | | | | | | | | | | |
| | | | | | public: true | | | | | | | | | | | | |
| | | | | | serviceRoles: | | | | | | | | | | | | |
| | | | | | - name: "ECHOENDPOINT_ROLE" | | | | | | | | | | | | |
| | | | | | endpoints: | | | | | | | | | | | | |
| | | | | | - "echoendpoint" | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | |
+--------------+---------------+-------------+-----------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+