SYSTEM$VALIDATE_STORAGE_INTEGRATION

SYSTEM$VALIDATE_STORAGE_INTEGRATION

지정한 스토리지 통합의 설정을 검증하는 시스템 함수예요. 스토리지 통합을 사용해 지정한 경로의 스토리지 위치에 파일을 쓰고·읽고·나열하고·삭제하는 동작을 시도해 봅니다.

출처: Snowflake SQL Reference

본문

SYSTEM$VALIDATE_STORAGE_INTEGRATION( '<storage_integration_name>', '<storage_path>', '<test_file_name>', '<validate_action>' )

storage_integration_name

테스트할 스토리지 통합의 이름이에요. 대소문자를 구분해요.

storage_path

검증하려는 스토리지 위치의 전체 경로예요. 스토리지 통합의 STORAGE_ALLOWED_LOCATIONS 목록에 있는 URL이어야 해요.

• Amazon S3: 's3://bucket/path/' — s3 접두사는 공개 AWS 리전의 S3, s3gov는 정부 리전의 S3를 뜻해요.
• Google Cloud Storage: 'gcs://bucket/path/'
• Microsoft Azure: 'azure://account.blob.core.windows.net/container/path/'

test_file_name

스토리지 통합 검증에 사용할 파일 이름이에요.

validate_action

수행할 검증 동작이에요.

• read — Snowflake가 스토리지 위치에서 읽을 수 있는지 검증. 파일이 없으면 실패해요.
• write — Snowflake가 스토리지 위치에 쓸 수 있는지 검증. 파일이 이미 있으면 실패해요.
• list — Snowflake가 스토리지 위치의 파일을 나열할 수 있는지 검증.
• delete — Snowflake가 스토리지 위치의 파일을 삭제할 수 있는지 검증.
• all — 스토리지 위치에서 가능한 모든 동작을 검증.

반환값 — 함수는 다음 속성을 가진 JSON 객체를 반환해요.

예시 — 스토리지 통합 example_integration의 설정을 모든 검증 동작으로 검증해요.

SELECT
  SYSTEM$VALIDATE_STORAGE_INTEGRATION(
    'example_integration',
    's3://example_bucket/test_path/',
    'validate_all.txt', 'all');

+----------------------------+
|           RESULT           |
+----------------------------+
| {                          |
|   "status" : "success",    |
|   "actions" : {            |
|     "READ" : {             |
|       "status" : "success" |
|     },                     |
|     ...                    |
|   }                        |
| }                          |
+----------------------------+

더 알아보기 (Learn more)

• System functions (시스템 함수)
• CREATE STORAGE INTEGRATION