SHOW SERVICE VOLUMES IN SERVICE¶

:doc:`서비스</developer-guide/snowpark-container-services/working-with-services>`의 모든 인스턴스에 대한 저장소 볼륨을 나열합니다. 탑재된 각 볼륨의 경우, 출력에는 해당 볼륨을 탑재하는 모든 컨테이너에 대한 줄이 포함됩니다. 출력에는 서비스에서 하나 이상의 컨테이너에 탑재된 볼륨만 표시됩니다. 지정되었지만 컨테이너에서 사용하지 않는 볼륨은 포함되지 않습니다.

참고 항목:: Snowpark Container Services 개요, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE, SHOW SERVICE CONTAINERS IN SERVICE, SHOW <오브젝트>

구문¶

SHOW SERVICE VOLUMES IN SERVICE <name>

Copy

매개 변수¶

name

탑재된 볼륨 목록을 표시할 서비스의 이름을 지정합니다.

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

출력¶

명령 출력은 다음 열에 서비스 볼륨의 속성을 제공합니다.

열	설명
`volume_name`	볼륨의 이름입니다.
`instance_id`	서비스 인스턴스의 ID입니다(0부터 시작하는 서비스 인스턴스의 인덱스임).
`container_name`	볼륨이 탑재된 컨테이너의 이름입니다.
`volume_type`	볼륨의 유형입니다. 이는 다음 중 하나일 수 있습니다. `block` `stage` `local` `memory` 볼륨 유형에 대한 자세한 설명은 :doc:`서비스 사양</developer-guide/snowpark-container-services/specification-reference>`을 참조하세요.
`size`	`numberGi` 형식의 볼륨 크기입니다.
`iops`	블록 볼륨에만 적용 가능합니다. 각 블록 볼륨에 대해 구성된 초당 입력/출력 작업을 표시합니다.
`throughput`	블록 볼륨에만 적용 가능합니다. 각 블록 볼륨에 대해 구성된 처리량을 보여줍니다.
`encryption`	스테이지 및 블록 볼륨에만 적용 가능합니다. 블록 볼륨의 경우 구성된 볼륨 암호화 유형이 표시됩니다. 블록 볼륨 암호화 유형에 대한 자세한 설명은 :doc:`블록 저장소 볼륨에 대한 암호화 지원</developer-guide/snowpark-container-services/block-storage-volume>`을 참조하세요. 스테이지 볼륨의 경우 기본 스테이지의 암호화 유형을 보여줍니다. 스테이지 암호화 정보를 확인하려면 호출자의 스테이지에 대한 USAGE 또는 OWNERSHIP 권한이 필요합니다.
`snapshot_used`	블록 볼륨에만 적용 가능합니다. 볼륨을 생성하는 데 사용된 스냅샷을 보여줍니다. 스냅샷은 스냅샷에 대한 USAGE 또는 OWNERSHIP 권한이 부여된 역할을 사용하는 경우에만 이 열에 나열됩니다.
`stage_source`	스테이지 볼륨에만 적용됩니다. 스테이지 볼륨에 사용되는 스테이지의 정규화된 이름을 표시합니다.
`volume_mounts`	볼륨이 지정된 컨테이너에 마운트되는 경로의 쉼표로 구분된 목록입니다.

필드가 특정 볼륨 유형에 적용 가능한 경우 다른 모든 볼륨 유형에 대해 NULL로 채워집니다.

액세스 제어 요구 사항¶

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

권한	오브젝트	참고
OWNERSHIP 또는 MONITOR	서비스	없음
OWNERSHIP 또는 USAGE	스냅샷	블록 저장소 스냅샷에 액세스하지 않으면 Snowflake가 인증 오류로 `snapshot_used` 필드를 채우지만 명령은 실패하지 않습니다.
OWNERSHIP 또는 USAGE 권한 중 하나	스테이지	스테이지에 액세스하지 않으면 스테이지 볼륨에 대한 인증 오류로 암호화 필드를 채우지만 명령은 실패하지 않습니다.

스키마의 오브젝트에 대한 작업을 수행하려면 상위 데이터베이스에 대한 하나 이상의 권한과 상위 스키마에 대한 하나 이상의 권한이 필요합니다.

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

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

사용법 노트¶

이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.
이 명령은 현재 사용자의 현재 역할에 하나 이상의 액세스 권한이 부여된 오브젝트만 반환합니다.
MANAGE GRANTS 액세스 권한은 그 권한을 보유한 자가 계정에 있는 모든 오브젝트를 볼 수 있도록 암시적으로 허용합니다. 기본적으로, 계정 관리자(ACCOUNTADMIN 역할 이 있는 사용자)와 보안 관리자(SECURITYADMIN 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.

이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

예를 들어, 파이프 연산자 또는 RESULT_SCAN 함수를 사용하여 SHOW 명령 출력에서 특정 열을 선택하거나 행을 필터링할 수 있습니다.

출력 열을 참조하는 경우 열 이름에 :ref:`큰따옴표로 묶인 식별자<label-delimited_identifier>`를 사용합니다. 예를 들어, 출력 열 ``type``을 선택하려면 ``SELECT “type”``을 지정합니다.

SHOW 명령의 출력 열 이름은 소문자이므로 큰따옴표로 묶인 식별자를 사용해야 합니다. 큰따옴표는 SELECT 목록 또는 WHERE 절의 열 이름이 스캔된 SHOW 명령 출력과 일치하도록 보장합니다.

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

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

예¶

다음 예에서는 echo_service 서비스의 볼륨을 나열합니다.

SHOW SERVICE VOLUMES IN SERVICE echo_service;

Copy

샘플 출력:

+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| 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             |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+