DESCRIBE SERVICE¶
描述 Snowpark Container Services 服务 （包括作业服务）。将此命令用于服务和像作业一样运行的服务。
DESCRIBE 可以缩写为 DESC。
语法¶
DESC[RIBE] SERVICE <name>
参数¶
name指定要描述的服务的标识符。
如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
有关更多信息，请参阅 标识符要求。
输出¶
命令输出在以下列中提供服务属性和元数据：
列 |
描述 |
|---|---|
|
Snowpark Container Services 服务名称。 |
|
以下各值之一，表示服务的当前状态：
|
|
在其中创建服务的数据库。 |
|
在其中创建服务的架构。 |
|
拥有服务的角色。 |
|
Snowflake 在其中运行服务的计算池的名称。 |
|
服务规范文件。仅当您在执行命令时使用服务的所有者角色时，输出才包含此列。 |
|
Snowflake 为服务分配的 DNS 名称，格式如下：
SELECT SYSTEM$GET_SERVICE_DNS_DOMAIN('mydb.myschema');
请注意以下事项：
DNS 名称支持服务到服务的通信（请参阅 教程 3）。 |
|
服务的当前实例数。 |
|
Snowflake 确定的应运行的服务实例的目标数量。 当 例如：
|
|
Snowflake 应该运行的最小服务实例数。 |
|
Snowflake 在需要时可以扩展的最大服务实例数。 |
|
如果为 true，则在调用服务函数或收到传入请求 (ingres) 时，Snowflake 会自动恢复已暂停的服务（请参阅 使用服务）。 |
|
与服务相关联的外部访问集成的列表。有关更多信息，请参阅 配置网络出口。 |
|
服务的创建时间戳。 |
|
服务的上次更新时间戳。 |
|
服务的上次恢复时间戳。 |
|
服务的相关注释。 |
|
拥有对象的角色类型是 ROLE 或 DATABASE_ROLE。 |
|
当服务容器连接到 Snowflake 以执行查询，但未显式指定要使用的仓库时，Snowflake 默认使用该仓库。 |
|
如果服务是作业服务，则为 |
|
代表服务规范内容的唯一且不可变的标识符。 为了观察 |
|
如果 Snowflake 正在升级服务，则为 TRUE。 |
|
管理对象的域（例如，管理服务的笔记本的域）。如果服务不受 Snowflake 实体管理，则为 NULL。 |
|
管理对象的名称（例如，管理服务的笔记本的名称）。如果服务不受 Snowflake 实体管理，则为 NULL。 |
访问控制要求¶
权限 |
对象 |
备注 |
|---|---|---|
MONITOR |
服务 |
请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。
有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。
使用说明¶
若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。
示例¶
以下示例描述名为 my_service_with_ebs_volume 的服务：
DESCRIBE SERVICE my_service_with_ebs_volume;
+--------------+---------+---------------+-------------+-----------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+
| name | status | database_name | schema_name | owner | compute_pool | spec | 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 |
| | | | | | | spec: | | | | | | | | | | | | | | | | | | |
| | | | | | | containers: | | | | | | | | | | | | | | | | | | |
| | | | | | | - name: "echo" | | | | | | | | | | | | | | | | | | |
| | | | | | | image: "preprod8-spcsdocs1.awsuswest2preprod8.registry-dev.snowflakecomputing.cn/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest" | | | | | | | | | | | | | | | | | | |
| | | | | | | sha256: "@sha256:e79089e8862f9b90d9114857a38c6954db4701a973e931277900617fcbecd099" | | | | | | | | | | | | | | | | | | |
| | | | | | | env: | | | | | | | | | | | | | | | | | | |
| | | | | | | SERVER_PORT: "8000" | | | | | | | | | | | | | | | | | | |
| | | | | | | CHARACTER_NAME: "Bob" | | | | | | | | | | | | | | | | | | |
| | | | | | | readinessProbe: | | | | | | | | | | | | | | | | | | |
| | | | | | | port: 8000 | | | | | | | | | | | | | | | | | | |
| | | | | | | path: "/healthcheck" | | | | | | | | | | | | | | | | | | |
| | | | | | | resources: | | | | | | | | | | | | | | | | | | |
| | | | | | | limits: | | | | | | | | | | | | | | | | | | |
| | | | | | | memory: "6Gi" | | | | | | | | | | | | | | | | | | |
| | | | | | | cpu: "1" | | | | | | | | | | | | | | | | | | |
| | | | | | | requests: | | | | | | | | | | | | | | | | | | |
| | | | | | | memory: "0.5Gi" | | | | | | | | | | | | | | | | | | |
| | | | | | | cpu: "0.5" | | | | | | | | | | | | | | | | | | |
| | | | | | | endpoints: | | | | | | | | | | | | | | | | | | |
| | | | | | | - name: "echoendpoint" | | | | | | | | | | | | | | | | | | |
| | | | | | | port: 8000 | | | | | | | | | | | | | | | | | | |
| | | | | | | public: true | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | | | |
+--------------+---------+---------------+-------------+-----------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+