DESCRIBE SERVICE¶

Snowpark Container Services 서비스 의 속성을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:: CREATE SERVICE , ALTER SERVICE, DROP SERVICE , SHOW SERVICES

구문¶

DESC[RIBE] SERVICE <name>

Copy

매개 변수¶

name

설명할 서비스의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

출력¶

명령 출력은 다음 열에 서비스 속성과 메타데이터를 제공합니다.

열	설명
`name`	Snowpark Container Services 서비스 이름입니다.
`database_name`	서비스가 생성되는 데이터베이스입니다.
`schema_name`	서비스가 생성되는 스키마입니다.
`owner`	서비스를 소유한 역할입니다.
`compute_pool`	Snowflake가 서비스를 실행하는 컴퓨팅 풀 이름입니다.
`spec`	서비스 사양 파일입니다. 명령을 실행할 때 서비스 소유자 역할을 사용하는 경우에만 출력에 이 열이 포함됩니다.
`dns_name`	Snowflake에서 할당한 서비스의 DNS 이름입니다. DNS 이름을 사용하면 서비스 간 통신이 가능합니다(자습서 3 참조).
`min_instances`	Snowflake가 실행해야 하는 최소 서비스 인스턴스 수입니다.
`max_instances`	Snowflake가 필요할 때 확장할 수 있는 최대 서비스 인스턴스 수입니다.
`auto_resume`	true인 경우 Snowflake는 서비스가 일시 중단되거나, 서비스 함수가 호출되거나, 들어오는 요청(수신)이 수신될 때 서비스를 자동으로 재개합니다(서비스 사용하기 참조).
`external_access_integrations`	서비스와 연결된 외부 액세스 통합 목록입니다. 자세한 내용은 네트워크 송신 섹션을 참조하십시오.
`created_on`	서비스가 생성된 타임스탬프입니다.
`updated_on`	서비스가 마지막으로 업데이트된 타임스탬프입니다.
`resumed_on`	서비스가 마지막으로 재개된 타임스탬프입니다.
`comment`	서비스 관련 설명입니다.
`owner_role_type`	오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다.
`query_warehouse`	서비스 컨테이너가 쿼리를 실행하기 위해 Snowflake에 연결하고 사용할 웨어하우스를 명시적으로 지정하지 않으면 Snowflake는 이 웨어하우스를 기본값으로 사용합니다.

액세스 제어 요구 사항¶

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
MONITOR	서비스

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

예¶

다음 예시에서는 echo_service 라는 서비스를 설명합니다.

DESCRIBE SERVICE echo_service;

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 |
|--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------------------------+-----------------|
| ECHO_SERVICE       | TUTORIAL_DB   | DATA_SCHEMA | TST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.data-schema.tutorial-db.snowflakecomputing.internal      |             1 |             1 | true        | ["example_access_integration"] |2023-10-26 10:53:32.150 -0700  | 2023-10-31 23:56:49.041 -0700  | NULL       | NULL    | ROLE            | NULL            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+