카테고리:

시스템 함수 (시스템 제어)

SYSTEM$REGISTER_CMK_INFO

|tri-secret-secure|와 함께 사용할 고객 관리 키(CMK)를 등록합니다.

참고 항목:

|tri-secret-secure|의 활성화를 지원하는 CMK 자체 등록 이해

구문

AWS:

SYSTEM$REGISTER_CMK_INFO( '<cmk_arn>' [ , '<privatelink_enabled>' ] )
Copy

Azure:

SYSTEM$REGISTER_CMK_INFO( '<vault_uri>' , '<key_name>' [ , '<privatelink_enabled>' ] )
Copy

Google Cloud

SYSTEM$REGISTER_CMK_INFO( '<project_id>' , '<location>', '<key_ring>' , '<key_name>' )
Copy

참고

비공개 연결은 현재 Google Cloud에서 지원되지 않습니다.

인자

필수 사항

AWS

cmk_arn

Tri-Secret Secure 와 함께 사용할 고객 관리 키(CMK)를 지정하는 Amazon Web Services 리소스 번호(ARN)를 지정합니다.

Azure

vault_uri

Azure Key Vault에 대한 Microsoft Azure 고유 엔드포인트 식별자를 지정합니다.

key_name

CMK의 이름을 Microsoft Azure 에 지정합니다.

Google Cloud

project_id

프로젝트의 고유 식별자를 Google Cloud Platform 에 지정합니다.

location

Snowflake 계정을 호스팅하는 Google Cloud Platform 리전을 지정합니다.

key_ring

Google Cloud에서 CMK의 키 링을 지정합니다.

key_name

Google Cloud에서 CMK의 이름을 지정합니다.

선택 사항

option

|tri-secret-secure|에 대해 비공개 연결 엔드포인트를 사용하는 옵션에 다음 값을 지정할 수 있습니다.

'TRUE'

Snowflake가 |tri-secret-secure|에 대해 프로비저닝된 연결 엔드포인트를 사용하도록 지정합니다.

중요

이 옵션의 값을 전달하지 않으면 Snowflake는 |tri-secret-secure|에 대해 프로비저닝된 연결 엔드포인트를 사용하지 않습니다.

참고

|tri-secret-secure|에 대한 비공개 연결을 활성화하는 옵션은 AWS 및 Azure에서만 지원됩니다.

반환

등록이 완료되었다는 상태 메시지를 반환합니다.

액세스 제어 요구 사항

계정 관리자(ACCOUNTADMIN 역할이 있는 사용자)만 이 함수를 호출할 수 있습니다.

Amazon Web Services 에서 Snowflake 계정에 CMK를 등록합니다.

SELECT SYSTEM$REGISTER_CMK_INFO('arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59');
Copy

Microsoft Azure 에서 Snowflake 계정에 CMK를 등록합니다.

SELECT SYSTEM$REGISTER_CMK_INFO('https://trisecretsite.vault.azure.net/', 'trisecretazkey');
Copy

Google Cloud Platform 에서 Snowflake 계정에 CMK를 등록합니다.

SELECT SYSTEM$REGISTER_CMK_INFO('my-env', 'us-west1', 'trisecrettest', 'trisecretgcpkey');
Copy

|aws|에서 Snowflake 계정에 대한 비공개 엔드포인트에 CMK를 등록합니다.

SELECT SYSTEM$REGISTER_CMK_INFO('arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59', 'true');
Copy

|azure|에서 Snowflake 계정에 대한 비공개 엔드포인트에 CMK를 등록합니다.

SELECT SYSTEM$REGISTER_CMK_INFO('https://trisecretsite.vault.azure.net/', 'trisecretazkey', 'true');
Copy