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는 서비스가 일시 중단되거나, 서비스 함수가 호출되거나, 들어오는 요청(수신)이 수신될 때 서비스를 자동으로 재개합니다(서비스 사용하기 참조). |
|
서비스와 연결된 외부 액세스 통합 목록입니다. 자세한 내용은 네트워크 송신 구성하기 섹션을 참조하십시오. |
|
서비스가 생성된 타임스탬프입니다. |
|
서비스가 마지막으로 업데이트된 타임스탬프입니다. |
|
서비스가 마지막으로 재개된 타임스탬프입니다. |
|
서비스가 마지막으로 일시 중단된 타임스탬프입니다. |
|
비활성 상태 지속 시 Snowflake가 서비스를 자동으로 일시 중단하도록 설정된 시간(초)입니다. |
|
서비스 관련 설명입니다. |
|
오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다. |
|
서비스 컨테이너가 쿼리를 실행하기 위해 Snowflake에 연결하고 사용할 웨어하우스를 명시적으로 지정하지 않으면 Snowflake는 이 웨어하우스를 기본값으로 사용합니다. |
|
해당 서비스가 작업 서비스인 경우 |
|
작업 서비스가 비동기적으로 실행 중인 경우 |
|
서비스 사양 내용을 나타내는 고유하고 변경 불가능한 식별자입니다. 시간에 따른 |
|
Snowflake가 서비스를 업그레이드하는 중인 경우 TRUE. |
|
관리 오브젝트의 도메인(예: 서비스를 관리하는 노트북의 도메인). 서비스가 Snowflake 엔터티에 의해 관리되지 않는 경우 NULL. |
|
관리하는 오브젝트의 이름(예: 서비스를 관리하는 노트북의 이름)입니다. 서비스가 Snowflake 엔터티에 의해 관리되지 않는 경우 NULL. |
액세스 제어 요구 사항¶
이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
Any one of these privileges: OWNERSHIP, USAGE, MONITOR or OPERATE |
서비스 |
스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 모든 권한 부여된 역할은 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령의 출력을 후처리하기 위해 파이프 연산자 (
->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.
When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column
type, specifySELECT "type".You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.
예¶
다음 예시에서는 my_service_with_ebs_volume 라는 서비스를 설명합니다.
DESCRIBE SERVICE echo_service;
+--------------+---------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------+-------------------+------------------+---------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+--------------+-------------------+---------+-----------------+-----------------+--------+--------------+------------------------------------------------------------------+--------------+------------------------+----------------------+
| name | status | database_name | schema_name | owner | compute_pool | spec | dns_name | current_instances | target_instances | min_ready_instances | min_instances | max_instances | auto_resume | external_access_integrations | created_on | updated_on | resumed_on | suspended_on | auto_suspend_secs | comment | owner_role_type | query_warehouse | is_job | is_async_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.k3m6.svc.spcs.internal | 1 | 1 | 1 | 1 | 1 | true | NULL | 2024-11-29 12:12:47.310 -0800 | 2024-11-29 12:12:48.843 -0800 | NULL | NULL | 0 | NULL | ROLE | NULL | false | false | edaf548eb0c2744a87426529b53aac75756d0ea1c0ba5edb3cbb4295a381f2b4 | false | NULL | NULL |
| | | | | | | spec: | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | containers: | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | - name: "echo" | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | image: "sfengineering-prod1-snowservices-test2.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest" | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | sha256: "@sha256:d04a2d7b7d9bd607df994926e3cc672edcb541474e4888a01703e8bb0dd3f173" | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | 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 | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
+--------------+---------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------+-------------------+------------------+---------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+--------------+-------------------+---------+-----------------+-----------------+--------+--------------+------------------------------------------------------------------+--------------+------------------------+----------------------+