카테고리:

시스템 함수 (시스템 정보)

SYSTEM$DESC_ICEBERG_ACCESS_IDENTITY

계정의 지정된 외부 클라우드 공급자에 대한 Snowflake 서비스 주체에 관한 정보를 반환합니다.

참고 항목:

Snowflake 관리형 Apache Iceberg™ 테이블에 대한 복제 구성

구문

SYSTEM$DESC_ICEBERG_ACCESS_IDENTITY(
  '<cloud_storage_provider>' [ , '<account_name>' ] )
Copy

필수 인자

'cloud_storage_provider'

서비스 주체 정보를 검색할 클라우드 공급자를 지정합니다. 이 인자에 대해 다음 값 중 하나를 지정할 수 있습니다.

  • 'S3'

  • 'GCS'

  • 'AZURE'

선택적 인자

'account_name'

선택적으로 서비스 주체 정보를 검색할 Snowflake 계정의 이름을 지정합니다. 지정된 경우 SHOW REPLICATION ACCOUNTS 명령으로 반환된 account_name 열에 해당 값을 사용해야 합니다.

지정하지 않으면 함수는 현재 계정에 대한 정보를 반환합니다.

반환

이 함수는 다음 이름/값 쌍을 포함하는 JSON 오브젝트를 반환합니다.

S3

{
  "STORAGE_PROVIDER":"S3",
  "STORAGE_AWS_IAM_USER_ARN":"<iam_user_arn>"
}
Copy

여기서

STORAGE_PROVIDER

클라우드 저장소 공급자입니다.

STORAGE_AWS_IAM_USER_ARN

Snowflake 계정에 대해 자동으로 생성된 AWS IAM 사용자의 ARN입니다.

GCS

{
  "STORAGE_PROVIDER":"GCS",
  "STORAGE_GCP_SERVICE_ACCOUNT":"<service_account_identifier>"
}
Copy

여기서

STORAGE_PROVIDER

클라우드 저장소 공급자입니다.

STORAGE_GCP_SERVICE_ACCOUNT

Snowflake 계정에 대해 자동으로 생성된 GCS 서비스 계정의 ID입니다.

AZURE

{
  "STORAGE_PROVIDER":"AZURE",
  "AZURE_MULTI_TENANT_APP_NAME":"<client_app_name>",
  "AZURE_CONSENT_URL_TEMPLATE":"https://login.microsoftonline.com/<your_tenant_id>/oauth2/authorize?client_id=..."
}
Copy

여기서

STORAGE_PROVIDER

클라우드 저장소 공급자입니다.

AZURE_MULTI_TENANT_APP_NAME

Snowflake 계정에 대해 생성된 Snowflake 클라이언트 애플리케이션의 이름입니다.

AZURE_CONSENT_URL_TEMPLATE

Microsoft 권한 요청 페이지에 대한 템플릿 URL입니다. :samp:`{your_tenant_id}`를 저장소 위치가 속한 테넌트의 ID로 대체해야 합니다.

Tenant ID를 찾으려면 Azure 포털에 로그인하여 Azure Active Directory » Properties 를 클릭하십시오. tenant ID는 Tenant ID 필드에 표시됩니다.

사용법 노트

계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)에 대한 결과만 반환합니다.

예

Azure의 서비스 주체를 검색합니다.

SELECT SYSTEM$DESC_ICEBERG_ACCESS_IDENTITY('AZURE', 'MY_TARGET_SNOWFLAKE_ACCOUNT');
Copy
언어: 한국어