SHOW SERVICE VOLUMES IN SERVICE

서비스의 모든 인스턴스에 대한 스토리지 볼륨(storage volume)을 나열하는 명령이에요.

출처: 문서

본문

기능 — 일반 사용 가능(Generally Available): Snowpark Container Services는 일부 예외를 제외하고 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요. 자세한 내용은 사용 가능한 리전 및 고려 사항을 참고해요.

서비스의 모든 인스턴스에 대한 스토리지 볼륨을 나열해요. 마운트된 각 볼륨에 대해, 출력은 그 볼륨을 마운트하는 모든 컨테이너에 대한 행을 포함해요. 출력에는 서비스에서 최소 하나의 컨테이너에 마운트된 볼륨만 표시돼요. 지정되었지만 어떤 컨테이너에도 사용되지 않은 볼륨은 포함되지 않아요.

구문

SHOW SERVICE VOLUMES IN SERVICE <name>

매개변수

name

마운트된 볼륨 목록을 표시할 서비스의 이름을 지정해요. 특수 문자나 대소문자 구분 이름을 위한 따옴표 이름은 지원되지 않아요.

출력

명령 출력은 서비스 볼륨의 속성을 다음 컬럼으로 제공해요:

컬럼	설명
volume_name	볼륨의 이름이에요.
instance_id	서비스 인스턴스의 ID로, 0부터 시작하는 서비스 인스턴스의 인덱스예요.
container_name	볼륨이 마운트된 컨테이너의 이름이에요.
volume_type	볼륨의 유형이에요. 다음 유형 중 하나일 수 있어요: block, stage, local, memory. 볼륨 유형에 대한 자세한 설명은 서비스 명세(service specification)를 참고해요.
size	`numberGi` 형식의 볼륨 크기예요.
iops	block 볼륨에만 적용돼요. 각 블록 볼륨에 대해 구성된 초당 입출력(I/O) 연산을 보여 줘요.
throughput	block 볼륨에만 적용돼요. 각 블록 볼륨에 대해 구성된 처리량(throughput)을 보여 줘요.
encryption	stage와 block 볼륨에만 적용돼요. block 볼륨의 경우 구성된 볼륨 암호화 유형을 보여 줘요. 블록 볼륨 암호화 유형에 대한 자세한 설명은 블록 스토리지 볼륨의 암호화 지원(Encryption Support for block storage volumes)을 참고해요. stage 볼륨의 경우 기본 스테이지의 암호화 유형을 보여 줘요. 호출자에게 스테이지에 대한 USAGE 또는 OWNERSHIP 권한이 있어야 스테이지 암호화 정보를 얻을 수 있어요.
snapshot_used	block 볼륨에만 적용돼요. 볼륨을 만드는 데 사용된 스냅샷을 보여 줘요. 스냅샷에 대한 USAGE 또는 OWNERSHIP 권한이 부여된 역할을 사용하는 경우에만 이 컬럼에 스냅샷이 나열돼요.
stage_source	stage 볼륨에만 적용돼요. stage 볼륨에 사용되는 스테이지의 정규화된 이름을 보여 줘요.
volume_mounts	주어진 컨테이너에서 볼륨이 마운트된 경로의 쉼표로 구분된 목록이에요.

필드가 특정 볼륨 유형에만 적용되는 경우, 다른 모든 볼륨 유형에 대해서는 그 필드가 NULL로 채워져요.

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 가져야 해요:

권한	객체	참고
OWNERSHIP 또는 MONITOR	Service	없음
OWNERSHIP 또는 USAGE	Snapshot	블록 스토리지 스냅샷에 접근할 수 없으면 Snowflake는 snapshot_used 필드를 인증 오류로 채우지만 명령은 실패하지 않아요.
OWNERSHIP 또는 USAGE	Stage	스테이지에 접근할 수 없으면 Snowflake는 stage 볼륨의 encryption 필드를 인증 오류로 채우지만 명령은 실패하지 않아요.

스키마의 객체를 운영하려면 상위 데이터베이스에 대한 권한이 하나 이상, 상위 스키마에 대한 권한이 하나 이상 필요해요. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 사용자 정의 역할 만들기(Creating custom roles)를 참고해요. 보안 객체에 대한 SQL 작업 수행을 위한 역할·권한 부여에 대한 일반 정보는 액세스 제어 개요(Overview of Access Control)를 참고해요.

사용 메모

이 명령은 실행에 웨어하우스가 필요하지 않아요.
이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
이 명령은 명령을 실행하는 역할의 액세스 권한에 따라 지정한 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개를 초과하는 결과를 보려면 Snowflake 정보 스키마의 해당 뷰(존재하는 경우)를 쿼리해요.

예제

다음 예제는 echo_service 서비스의 볼륨을 나열해요:

SHOW SERVICE VOLUMES IN SERVICE echo_service;

샘플 출력:

+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| volume_name    | instance_id | container_name | volume_type |  size  |  iops  | throughput |   encryption   | snapshot_used | stage_source |       volume_mounts       |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| block-volume-1 | 0           | main           | block       | 1Gi    | 3000   | 125        | SNOWFLAKE_SSE  | [NULL]        | [NULL]       | /tmp/block1               |
| block-volume-1 | 0           | secondary      | block       | 1Gi    | 3000   | 125        | SNOWFLAKE_SSE  | [NULL]        | [NULL]       | /data/shared              |
| block-volume-2 | 0           | main           | block       | 50Gi   | 3500   | 150        | SNOWFLAKE_FULL | [NULL]        | [NULL]       | /tmp/block2               |
| local-volume   | 0           | main           | local       | [NULL] | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /tmp/local                |
| memory-volume  | 0           | main           | memory      | 512Mi  | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /tmp/memory, /tmp/memory2 |
| memory-volume  | 0           | secondary      | memory      | 512Mi  | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /cache/memory             |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+

더 알아보기 (Learn more)

See also: Snowpark Container Services overview, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE, SHOW SERVICE CONTAINERS IN SERVICE, SHOW <objects>