SHOW SERVICE CONTAINERS IN SERVICE¶
서비스 의 모든 인스턴스에 있는 컨테이너를 나열합니다.
Snowflake가 하나 이상의 서비스 컨테이너를 실행하는 동안 문제가 발생하는 경우 이 명령을 사용하면 개별 컨테이너의 상태를 확인할 수 있습니다. 마찬가지로, 롤링 업그레이드 중에는 각 컨테이너에서 실행 중인 서비스 코드의 버전이 표시됩니다.
- 참고 항목:
Snowpark Container Services 개요, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE
구문¶
SHOW SERVICE CONTAINERS IN SERVICE <name>
매개 변수¶
name컨테이너를 나열할 서비스의 식별자를 지정합니다.
특수 문자에 대해 따옴표가 있는 이름이나 대/소문자를 구분하는 이름은 지원되지 않습니다.
출력¶
명령 출력은 다음 열에 서비스 컨테이너의 속성과 메타데이터를 제공합니다.
열 |
설명 |
|---|---|
|
서비스가 생성되는 데이터베이스입니다. |
|
서비스가 생성되는 스키마입니다. |
|
서비스의 이름입니다. |
|
다음 값 중 하나로, 서비스의 현재 상태를 나타냅니다.
이 열의 값은 DESCRIBE SERVICE 의 출력에 있는 |
|
서비스 인스턴스의 ID입니다(0부터 시작하는 서비스 인스턴스의 인덱스임). 실행 중인 서비스 인스턴스가 없는 경우(즉, 서비스가 SUSPENDED 또는 PENDING), 인스턴스_id 및 인스턴스_상태는 NULL 로 반환됩니다. 또한 출력의 컨테이너 관련 필드도 NULL 로 반환됩니다. |
|
다음 값 중 하나로, 서비스 인스턴스의 현재 상태를 나타냅니다.
|
|
컨테이너의 이름입니다. 실행 중인 컨테이너가 없는 경우(즉, 서비스가 SUSPENDED 또는 PENDING 상태인 경우) 컨테이너 이름은 NULL 로 반환되며, 모든 컨테이너별 필드 값도 NULL 입니다. |
|
서비스 컨테이너 상태입니다. 현재 지원되는 상태 값은 다음과 같습니다.
|
|
상태에 대한 추가 설명입니다. 예를 들어, 상태가 FAILED인 경우 Snowflake는 추가 정보를 제공할 수도 있습니다. |
|
서비스를 만드는 데 사용된 이미지 이름입니다. |
|
이미지 콘텐츠를 나타내는 고유하고 변경 불가능한 식별자입니다. |
|
Snowflake가 서비스를 다시 시작한 횟수입니다. |
|
컨테이너가 시작된 날짜와 시간입니다. |
|
컨테이너가 마지막으로 종료된 시점의 종료 코드를 나타냅니다. 서비스 컨테이너의 경우, 서비스 컨테이너가 조기에 종료되면 Snowflake가 컨테이너를 다시 시작합니다. 종료 코드는 정수 값으로 표현됩니다.
|
|
Snowflake가 가장 최근에 컨테이너를 다시 시작한 타임스탬프를 제공합니다. NULL 값은 컨테이너가 다시 시작되지 않았음을 나타냅니다. |
액세스 제어 요구 사항¶
이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
다음 권한 중 하나: OWNERSHIP 또는 MONITOR |
서비스 |
스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 모든 권한 부여된 역할은 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.
이 명령은 현재 사용자의 현재 역할에 하나 이상의 액세스 권한이 부여된 오브젝트만 반환합니다.
MANAGE GRANTS 액세스 권한은 그 권한을 보유한 자가 계정에 있는 모든 오브젝트를 볼 수 있도록 암시적으로 허용합니다. 기본적으로, 계정 관리자(ACCOUNTADMIN 역할 이 있는 사용자)와 보안 관리자(SECURITYADMIN 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.
이 명령의 출력을 후처리하기 위해 파이프 연산자 (
->>) 또는 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.
이 명령은 명령을 실행하는 데 사용된 역할에 대한 액세스 권한에 따라 지정된 오브젝트 유형에 대해 최대 1만 개의 레코드를 반환합니다. 필터를 적용하더라도 1만 개 레코드 제한을 초과하는 레코드는 반환되지 않습니다.
10,000개 이상의 레코드가 존재하는 결과를 보려면 Snowflake Information Schema 에서 해당 뷰(있는 경우)를 쿼리하십시오.
예¶
다음 예에서는 세션에 대한 현재 데이터베이스 및 스키마에 있는 echo_service 서비스의 컨테이너를 나열합니다.
SHOW SERVICE CONTAINERS IN SERVICE echo_service;
샘플 출력:
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+
| database_name | schema_name | service_name | service_status | instance_id | instance_status | container_name | status | message | image_name | image_digest | restart_count | start_time | last_exit_code | last_restart_time |
|---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------|
| TUTORIAL_DB | DATA_SCHEMA | ECHO_SERVICE | RUNNING | 0 | READY | echo | READY | Running | orgname.acctname.registry-dev.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest | sha256:d04a2d7b7d9bd607df994926e3cc672edcb541474e4888a01703e8bb0dd3f173 | 0 | 2025-04-25T06:01:38Z | NULL | NULL |
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+