카테고리:

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

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>' [ , '<privatelink_enabled>' ] )
Copy

인자

필수:

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 에 지정합니다.

location

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

key_ring

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

key_name

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

선택 사항:

privatelink_enabled

다음 값 중 하나를 제공하여 |tri-secret-secure|에 비공개 연결 엔드포인트를 사용할지 여부를 지정합니다.

중요

이 인자를 생략하거나 빈 문자열을 제공하는 경우 Snowflake는 |tri-secret-secure|에 비공개 연결 엔드포인트를 사용하지 않습니다.

'TRUE'

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

'FALSE' (기본값)

Snowflake가 |tri-secret-secure|에 비공개 연결 엔드포인트를 사용하지 않도록 지정합니다.

''

빈 문자열입니다. ``’FALSE’``와 동일한 동작입니다.

반환

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

액세스 제어 요구 사항

계정 관리자(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

CMK 에서 Snowflake 계정에 |google-cloud|를 등록합니다.

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

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

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