类别：: :doc:`/sql-reference/functions-system`（系统控制）

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS¶

预置 Snowflake VPC 或 VNet 中的专用连接端点，以支持 Snowflake 通过使用专用连接来连接到密钥管理服务 (KMS)。端点可以是服务端点或资源端点，具体取决于托管 Snowflake 账户的云平台。

备注

如果 Snowflake 账户位于 Azure 政府区域中，则提供商资源 ID 必须是政府订阅中资源的 ID。有关 Snowflake 客户的政府区域的更多信息，请参阅美国 SnowGov 区域。

语法¶

AWS：

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS(
  '<provider_service_name>',
  '<host_name>'
)

Copy

Azure：

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS(
  '<provider_resource_id>',
  '<host_name>'
)

Copy

实参¶

'provider_service_name'

在 AWS 中指定要连接的 KMS 服务。

有关从 AWS 中检索此值的信息，请参阅提供专用连接端点。

'provider_resource_id'

在您的 VPC 或 VNet 中指定 Azure Key Vault 的完全限定标识符。

'host_name'

指定完全限定主机名，以便在您的 VPC 或 VNet 中访问 KMS 资源。

此值不包含任何端口号，并且必须与您在 Snowflake 对象中指定的内容匹配，以便您能够连接到 KMS。

返回¶

返回端点已成功配置的状态信息，或返回端点未成功配置的详细信息和说明。

访问控制要求¶

只有被授予该账户 MODIFY 权限的用户才能调用此函数。MODIFY 权限通常仅授予该 ACCOUNTADMIN 角色。

使用说明¶

您不能修改现有的专用连接端点；必须取消该端点的设置，然后才能设置新端点。要取消端点的设置，请调用 SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT_TSS 系统函数。
执行该功能可能需要大约 5 分钟，因为它取决于在云平台（Snowflake 外部）中配置专用连接端点的流程。
有关专用端点限制的详细信息，请参阅扩展注意事项。

示例¶

AWS：

设置到外部 KMS 资源的出站专用连接：

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS(
  'com.amazonaws.us-west-2.kms',
  'kms.us-west-2.amazonaws.com'
);

Copy

"Private endpoint with ID "vpce-0123456789abcdef0" to resource "com.amazonaws.us-west-2.kms" has been provisioned successfully. Please
note the Private Endpoint ID and approve the corresponding connection request in the cloud provider console."

Azure：

在 Microsoft Azure 上为 TSS 配置专用端点

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS(
  '/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault',
  'trisecretvault.vault.azure.net'
);

Copy

Private endpoint with ID "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/prod-snowplex-rg/providers/Microsoft.Network/privateEndpoints/12345678-90ab-cdef-1234-567890abcdef"
to resource "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault"
has been provisioned successfully.

 Please note the Private Endpoint ID and approve the corresponding connection request in the cloud provider console.