SHOW SERVICE CONTAINERS IN SERVICE¶

서비스 의 모든 인스턴스에 있는 컨테이너를 나열합니다.

Snowflake가 하나 이상의 서비스 컨테이너를 실행하는 동안 문제가 발생하는 경우 이 명령을 사용하면 개별 컨테이너의 상태를 확인할 수 있습니다. 마찬가지로, 롤링 업그레이드 중에는 각 컨테이너에서 실행 중인 서비스 코드의 버전이 표시됩니다.

참고 항목:: Snowpark Container Services 개요, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE

구문¶

SHOW SERVICE CONTAINERS IN SERVICE <name>

Copy

매개 변수¶

name

컨테이너를 나열할 서비스의 식별자를 지정합니다.

특수 문자에 대해 따옴표가 있는 이름이나 대/소문자를 구분하는 이름은 지원되지 않습니다.

출력¶

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

열	설명
`database_name`	서비스가 생성되는 데이터베이스입니다.
`schema_name`	서비스가 생성되는 스키마입니다.
`service_name`	서비스의 이름입니다.
`instance_id`	서비스 인스턴스의 ID입니다(0부터 시작하는 서비스 인스턴스의 인덱스임).
`container_name`	컨테이너의 이름입니다.
`status`	서비스 컨테이너 상태입니다. 현재 지원되는 상태 값은 다음과 같습니다. `PENDING`: 컨테이너가 현재 배포 중입니다. `READY`: 컨테이너가 시작되었으며 준비 상태 프로브가 HTTP 200 OK 상태를 반환했습니다. `DONE`: 컨테이너가 0 종료 코드로 종료되었습니다. `FAILED`: 컨테이너가 0이 아닌 종료 코드로 종료되었습니다(종료 코드 0은 성공을 나타냄). `UNKNOWN`: Snowflake가 컨테이너 상태를 검색할 수 없습니다. 지원 문의
`message`	상태에 대한 추가 설명입니다. 예를 들어, 상태가 FAILED인 경우 Snowflake는 추가 정보를 제공할 수도 있습니다.
`image_name`	서비스를 만드는 데 사용된 이미지 이름입니다.
`image_digest`	이미지 콘텐츠를 나타내는 고유하고 변경 불가능한 식별자입니다.
`restart_count`	Snowflake가 서비스를 다시 시작한 횟수입니다.
`start_time`	컨테이너가 시작된 날짜와 시간입니다.

액세스 제어 요구 사항¶

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

권한	오브젝트	참고
다음 권한 중 하나: OWNERSHIP 또는 MONITOR	서비스

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

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

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

사용법 노트¶

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

예¶

다음 예에서는 세션에 대한 현재 데이터베이스 및 스키마에 있는 echo_service 서비스의 컨테이너를 나열합니다.

SHOW SERVICE CONTAINERS IN SERVICE echo_service;

Copy

샘플 출력:

+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
| database_name | schema_name | service_name | instance_id | container_name | status | message | image_name                                                                                                                | image_digest                                                            | restart_count | start_time           |
|---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | echo           | READY  | Running | orgname-acctname.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest | sha256:060d2dd3dc1da647b5bdbfd3b86251d80e955c5dcd9a6a19a8593aa0a1627676 |             0 | 2024-08-08T18:34:24Z |
+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+