SYSTEM$VERIFY_EXTERNAL_VOLUME

SYSTEM$VERIFY_EXTERNAL_VOLUME

SYSTEM$VERIFY_EXTERNAL_VOLUME는 지정한 외부 볼륨(external volume)의 구성을 검증하는 시스템 함수예요. 쓰기 접근이 가능한 외부 볼륨의 경우, Snowflake는 구성을 검증하기 위해 다음 추가 작업을 시도해요: 테스트 파일 쓰기, 테스트 파일 읽기, 스토리지 위치의 파일 목록 나열, 테스트 파일 삭제.

출처: Snowflake SQL Reference

본문

카테고리: System 함수 (System Information)

구문 (Syntax)

SYSTEM$VERIFY_EXTERNAL_VOLUME('<external_volume_name>')

인자 (Arguments)

<external_volume_name> — 검증할 외부 볼륨의 이름이에요. 식별자에 공백이나 특수 문자가 있으면 전체 문자열을 큰따옴표로 감싸야 해요. 큰따옴표로 감싼 식별자는 대소문자를 구분해요.

반환값 (Returns)

이 함수는 아래에 설명된 속성을 가진 JSON 객체를 반환해요:

결과 값 (Result values)

결과를 나타내는 반환 속성은 다음 값을 가질 수 있어요:

예시 출력 (Example output)

{
  "success": true,
  "storageLocationSelectionResult": "PASSED",
  "storageLocationName": "my-azure-westus-1",
  "servicePrincipalProperties": "AZURE_MULTI_TENANT_APP_NAME: powerful-azure-ad-auth-test-snowflake-app_...; AZURE_CONSENT_URL: https://login.microsoftonline.com...",
  "location": "azure://myStorageAccount.blob.core.windows.net/myStorageLocation/",
  "storageAccount": "myStorageAccount",
  "region": "westus",
  "writeResult": "PASSED",
  "readResult": "PASSED",
  "listResult": "PASSED",
  "deleteResult": "PASSED",
  "awsRoleArnValidationResult": "SKIPPED",
  "azureGetUserDelegationKeyResult": "PASSED"
}

접근 제어 요구 사항 (Access control requirements)

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

지정된 권한 집합으로 커스텀 역할을 만드는 방법은 커스텀 역할 만들기를 참고해요.

보호 가능한 객체(securable objects)에 대한 SQL 작업 시 역할과 권한 부여에 관한 일반 정보는 접근 제어 개요를 참고해요.

사용 시 유의사항 (Usage notes)

• Amazon S3 외부 볼륨의 경우: 다음 오류를 받으면 계정 관리자가 Snowflake 배포 리전에서 AWS STS를 활성화해야 해요. 자세한 내용은 AWS 문서의 Manage AWS STS in an AWS Region을 참고해요.

Error assuming AWS_ROLE:
STS is not activated in this region for account:<external volume id>. Your account administrator can activate STS in this region using the IAM Console.

예시 (Examples)

my_s3_external_volume이라는 외부 볼륨을 검증해요:

SELECT SYSTEM$VERIFY_EXTERNAL_VOLUME('my_s3_external_volume');

더 알아보기

• Apache Iceberg™ 테이블을 위한 스토리지
• 외부 볼륨 구성
• CREATE EXTERNAL VOLUME