- 类别:
:doc:`/sql-reference/functions-system`(系统控制)
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS¶
在 Snowflake VPC 或 VNet 中恢复私有连接端点,以通过私有连接让 Snowflake 连接到外部密钥管理服务 (KMS) 资源。该端点可以是服务端点或资源端点,具体取决于托管您 Snowflake 账户的云平台。
您可以在取消预置专用端点后的 7 天内将其恢复。7 天后,端点将无法恢复,您需要使用 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS 系統函数重新创建端点。
语法¶
AWS:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'<provider_service_name>'
)
Azure:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'<provider_resource_id>'
)
实参¶
AWS:
provider_service_name指定要恢复的外部 KMS 资源端点。
Azure:
provider_resource_id指定 VPC 或 VNet 中资源的完全限定标识符。
返回¶
返回一条状态消息,表明端点及其标识符已成功恢复。
如果不成功,会返回错误。例如,提供的参数不是有效的已存在端点。如果您不知道端点名称,您可以使用 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 系统函数列出您的 Snowflake 账户中的所有端点。
访问控制要求¶
只有账户管理员(具有 ACCOUNTADMIN 角色的用户)才能调用此函数。
使用说明¶
如果专用连接端点未与指定实参关联,则会出现错误消息。
示例¶
AWS:
恢复对 AWS 密钥库具有外部访问权限的私有端点。
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'com.amazonaws.us-west-2.s3'
);
Azure:
恢复私有端点,以允许 Snowflake 在 Microsoft Azure 上的连接到您 Azure VNet 中的 Azure 密钥库。
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault'
);
"Resource Endpoint with id "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/privatelink-test/providers/Microsoft.KeyVault/vaults/TriSecretVault/privateEndpoints/" restored successfully.