DESCRIBE SERVICE¶
Snowpark Container Services 서비스 (작업 서비스 포함)의 속성을 설명합니다. 서비스와 작업처럼 실행되는 서비스 모두에 이 명령을 사용합니다.
DESCRIBE는 DESC로 축약할 수 있습니다.
- 참고 항목:
CREATE SERVICE , ALTER SERVICE, DROP SERVICE , SHOW SERVICES
구문¶
DESC[RIBE] SERVICE <name>
매개 변수¶
name설명할 서비스의 식별자를 지정합니다.
식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
출력¶
명령 출력은 다음 열에 서비스 속성과 메타데이터를 제공합니다.
열 |
설명 |
|---|---|
|
Snowpark Container Services 서비스 이름입니다. |
|
다음 값 중 하나로, 서비스의 현재 상태를 나타냅니다.
|
|
서비스가 생성되는 데이터베이스입니다. |
|
서비스가 생성되는 스키마입니다. |
|
서비스를 소유한 역할입니다. |
|
Snowflake가 서비스를 실행하는 컴퓨팅 풀 이름입니다. |
|
서비스 사양 파일입니다. 명령을 실행할 때 서비스의 소유자 역할을 사용하는 경우에만 출력에 이 열이 포함됩니다. |
|
SELECT SYSTEM$GET_SERVICE_DNS_DOMAIN('mydb.myschema');
다음 사항을 참고하십시오.
DNS 이름을 사용하면 서비스 간 통신이 가능합니다(자습서 3 참조). |
|
서비스의 현재 인스턴스 수입니다. |
|
Snowflake에서 결정한 대로 실행해야 하는 서비스 인스턴스의 목표 수입니다.
예를 들어,
|
|
Snowflake가 실행해야 하는 최소 서비스 인스턴스 수입니다. |
|
Snowflake가 필요할 때 확장할 수 있는 최대 서비스 인스턴스 수입니다. |
|
true인 경우 Snowflake는 서비스가 일시 중단되거나, 서비스 함수가 호출되거나, 들어오는 요청(수신)이 수신될 때 서비스를 자동으로 재개합니다(서비스 사용하기 참조). |
|
서비스와 연결된 외부 액세스 통합 목록입니다. 자세한 내용은 네트워크 송신 섹션을 참조하십시오. |
|
서비스가 생성된 타임스탬프입니다. |
|
서비스가 마지막으로 업데이트된 타임스탬프입니다. |
|
서비스가 마지막으로 재개된 타임스탬프입니다. |
|
서비스 관련 설명입니다. |
|
오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다. |
|
서비스 컨테이너가 쿼리를 실행하기 위해 Snowflake에 연결하고 사용할 웨어하우스를 명시적으로 지정하지 않으면 Snowflake는 이 웨어하우스를 기본값으로 사용합니다. |
|
해당 서비스가 작업 서비스인 경우 |
|
서비스 사양 내용을 나타내는 고유하고 변경 불가능한 식별자입니다. 시간에 따른 |
|
Snowflake가 서비스를 업그레이드하는 중인 경우 TRUE. |
|
관리 오브젝트의 도메인(예: 서비스를 관리하는 노트북의 도메인). 서비스가 Snowflake 엔터티에 의해 관리되지 않는 경우 NULL. |
|
관리하는 오브젝트의 이름(예: 서비스를 관리하는 노트북의 이름)입니다. 서비스가 Snowflake 엔터티에 의해 관리되지 않는 경우 NULL. |
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
MONITOR |
서비스 |
스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 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.com/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 | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | | | |
+--------------+---------+---------------+-------------+-----------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+