SHOW SERVICE INSTANCES IN SERVICE

서비스 의 인스턴스를 나열합니다.

명령 출력을 통해 각 개별 서비스 인스턴스의 상태를 표시하여 자동 크기 조정 및 롤링 업그레이드에 대한 가시성을 제공합니다.

참고 항목:

Snowpark Container Services 개요, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE CONTAINERS IN SERVICE

구문

SHOW SERVICE INSTANCES IN SERVICE <name>
Copy

매개 변수

name

인스턴스를 나열할 서비스의 식별자를 지정합니다.

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

출력

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

열

설명

database_name

서비스가 생성되는 데이터베이스입니다.

schema_name

서비스가 생성되는 스키마입니다.

service_name

서비스의 이름입니다.

instance_id

서비스 인스턴스의 ID입니다(0부터 시작하는 서비스 인스턴스의 인덱스임).

status

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

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

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

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

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

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

spec_digest

서비스 사양 내용을 나타내는 고유하고 변경 불가능한 식별자입니다.

creation_time

Snowflake가 서비스 인스턴스를 생성하기 시작한 시간입니다.

start_time

Snowflake가 서비스 인스턴스가 노드에서 실행 중임을 확인한 시간입니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

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

서비스

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

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

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

사용법 노트

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

예

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

SHOW SERVICE INSTANCES IN SERVICE echo_service;
Copy

샘플 출력:

+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
| database_name | schema_name | service_name | instance_id | status | spec_digest                                                      | creation_time        | start_time           |
|---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | READY  | cb0cbefa3376e75e5926d56535198ce27b3790780beb2c924085eef41dad9adf | 2024-08-08T18:31:38Z | 2024-08-08T18:34:01Z |
+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
언어: 한국어