类别:

系统函数 (系统控制)

SYSTEM$REGISTER_CMK_INFO

Registers your customer-managed key (CMK) for use with Tri-Secret Secure.

另请参阅:

Understanding CMK self-registration with support activation of Tri-Secret Secure

语法

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 密钥库指定 Microsoft Azure 唯一端点标识符。

key_name

在 Microsoft Azure 中指定 CMK 的名称。

Google Cloud

project_id

在 Google Cloud Platform 中指定项目唯一标识符。

location

指定托管您的 Snowflake 账户的 Google Cloud Platform 区域。

key_ring

Specifies the key ring for your CMK in Google Cloud.

key_name

Specifies the name for your CMK in Google Cloud.

可选

privatelink_enabled

Specify whether or not to use your private connectivity endpoint for Tri-Secret Secure by passing in one of the following values:

重要

If you omit this argument or pass in an empty string, Snowflake doesn't use a private connectivity endpoint for Tri-Secret Secure.

'TRUE'

Specifies that Snowflake uses the provisioned private connectivity endpoint for Tri-Secret Secure.

'FALSE' (default)

Specifies that Snowflake doesn't use a private connectivity endpoint for Tri-Secret Secure.

''

返回

Returns a status message stating that the registration is complete.

访问控制要求

只有账户管理员(具有 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

Register your CMK with a privatelink endpoint for your Snowflake account on Amazon Web Services:

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

Register your CMK with a privatelink endpoint for your Snowflake account on Microsoft Azure:

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