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

서비스의 이름입니다.

service_status

다음 값 중 하나로, 서비스의 현재 상태를 나타냅니다.

  • PENDING

  • RUNNING

  • FAILED

  • DONE

  • SUSPENDING

  • SUSPENDED

  • DELETING

  • DELETED

  • INTERNAL_ERROR

이 열의 값은 DESCRIBE SERVICE 의 출력에 있는 status 열과 동일하다는 점에 유의하십시오.

instance_id

서비스 인스턴스의 ID입니다(0부터 시작하는 서비스 인스턴스의 인덱스임). 실행 중인 서비스 인스턴스가 없는 경우(즉, 서비스가 SUSPENDED 또는 PENDING), 인스턴스_id 및 인스턴스_상태는 NULL 로 반환됩니다. 또한 출력의 컨테이너 관련 필드도 NULL 로 반환됩니다.

instance_status

다음 값 중 하나로, 서비스 인스턴스의 현재 상태를 나타냅니다.

  • PENDING: 서비스 인스턴스가 현재 배포되는 중이며 아직 요청을 처리할 준비가 되지 않았습니다.

  • READY: 서비스 인스턴스의 모든 컨테이너가 준비되었으며, 서비스 인스턴스 역시 요청을 처리할 준비가 되었습니다.

  • FAILED: 서비스 인스턴스에서 하나 이상의 컨테이너가 오류로 인해 종료되었습니다.

  • TERMINATING: 서비스 인스턴스가 종료 프로세스를 진행 중이며 이 프로세스가 완료되면 제거됩니다.

  • SUCCEEDED: 서비스는 작업 서비스이고 서비스 인스턴스의 모든 컨테이너가 성공적으로 종료되었습니다.

instance_id 열로 식별되는 특정 서비스 인스턴스의 경우 instance_status 열의 값이 SHOW SERVICE INSTANCES IN SERVICE 명령의 출력에 있는 status 열의 값과 일치한다는 점에 유의하십시오.

container_name

컨테이너의 이름입니다. 실행 중인 컨테이너가 없는 경우(즉, 서비스가 SUSPENDED 또는 PENDING 상태인 경우) 컨테이너 이름은 NULL 로 반환되며, 모든 컨테이너별 필드 값도 NULL 입니다.

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

컨테이너가 시작된 날짜와 시간입니다.

last_exit_code

컨테이너가 마지막으로 종료된 시점의 종료 코드를 나타냅니다. 서비스 컨테이너의 경우, 서비스 컨테이너가 조기에 종료되면 Snowflake가 컨테이너를 다시 시작합니다. 종료 코드는 정수 값으로 표현됩니다.

  • NULL: 컨테이너가 현재 실행 중이며 종료된 적이 없습니다.

  • 0: 컨테이너의 마지막 종료가 성공했습니다.

  • 0 이외의 값: 컨테이너에서 오류가 발생했습니다.

last_restart_time

Snowflake가 가장 최근에 컨테이너를 다시 시작한 타임스탬프를 제공합니다. NULL 값은 컨테이너가 다시 시작되지 않았음을 나타냅니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

다음 권한 중 하나: OWNERSHIP 또는 MONITOR

서비스

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

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

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

사용법 노트

  • 이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.

  • 이 명령은 현재 사용자의 현재 역할에 하나 이상의 액세스 권한이 부여된 오브젝트만 반환합니다.

  • MANAGE GRANTS 액세스 권한은 그 권한을 보유한 자가 계정에 있는 모든 오브젝트를 볼 수 있도록 암시적으로 허용합니다. 기본적으로, 계정 관리자(ACCOUNTADMIN 역할 이 있는 사용자)와 보안 관리자(SECURITYADMIN 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다. 파이프 연산자 를 사용하여 이 명령의 출력을 쿼리할 수도 있습니다.

  • 이 명령은 명령을 실행하는 데 사용된 역할에 대한 액세스 권한에 따라 지정된 오브젝트 유형에 대해 최대 1만 개의 레코드를 반환합니다. 필터를 적용하더라도 1만 개 레코드 제한을 초과하는 레코드는 반환되지 않습니다.

    10,000개 이상의 레코드가 존재하는 결과를 보려면 Snowflake Information Schema 에서 해당 뷰(있는 경우)를 쿼리하십시오.

예

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

SHOW SERVICE CONTAINERS IN SERVICE echo_service;
Copy

샘플 출력:

+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+
| 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              |
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+
언어: 한국어