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

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT¶

预置 Snowflake VPC 或 VNet 中的专用连接端点，以支持 Snowflake 使用专用连接连接到外部服务。端点可以是服务端点或资源端点，具体取决于托管 Snowflake 账户的云平台。

备注

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

语法¶

AWS：

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

Copy

Azure：

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '<provider_resource_id>',
  '<host_name>'
  [, '<subresource>' ]
)

Copy

实参¶

'provider_service_name'

指定要连接的外部服务或资源。例如，com.amazonaws.us-west-2.execute-api for the Amazon API Gateway 或 com.amazonaws.us-west-2.s3 for Amazon S3。

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

'host_name'

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

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

AWS：

示例包括 bedrock-runtime.us-west-2.amazonaws.com 和 *.s3.us-west-2.amazonaws.com：

当对外部暂存区和外部卷使用专用连接时，host_name 必须使用通配符，而不是指定具体的 AWS S3 桶。

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

Azure：

对于 Microsoft Azure API 管理，该值必须与 API 集成的 API_ALLOWED_PREFIXES 属性相匹配。不包括 https://。

有关外部函数的出站专用连接的主机名示例，请参阅以下内容：

Azure 门户

Azure ARM 模板。

'provider_resource_id'

指定 VPC 或 VNet 中资源的完全限定标识符。

'subresource'

指定 Azure 资源的子资源的名称。

Azure 专用链接服务 (https://learn.microsoft.com/en-us/azure/private-link/private-link-service-overview) 和 Azure API 管理服务不需要此实参。

有关所有支持的值，请参阅子资源表 (https://learn.microsoft.com/en-us/azure/private-link/private-endpoint-overview#private-link-resource)。

返回¶

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

使用说明¶

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

示例¶

AWS：

设置到外部 S3 服务的出站专用连接：

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  'com.amazonaws.us-west-2.s3',
  '*.s3.us-west-2.amazonaws.com'
);

Copy

有关更多 AWS 示例，请参阅以下指南：

Microsoft Azure：

设置专用端点，以允许 Snowflake on Microsoft Azure 连接到 Microsoft Azure VNet 中的 Microsoft Azure API 管理服务：

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'aztest1-external-function-api.azure.net',
  'Gateway'
  );

Copy

Private endpoint with ID "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/test_rg/providers/microsoft.network/privateendpoints/32bd3122-bfbd-417d-8620-1a02fd68fcf8" to resource "/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api" has been provisioned successfully. Please note down the endpoint ID and approve the connection from it on the Azure portal.

提供一个专用端点，允许 Snowflake on Microsoft Azure 使用外部网络访问连接到外部服务：

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/leorg1/providers/Microsoft.Sql/servers/myserver/databases/testdb',
  'testdb.database.windows.net',
  'sqlServer'
  );

Copy

"Resource Endpoint with id "/subscriptions/f0abb333-1b05-47c6-8c31-dd36d2512fd1/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" provisioned successfully"

配置专用端点，以允许 Snowflake 连接到 Microsoft Azure 的外部暂存区：

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/cc2909f2-ed22-4c89-8e5d-bdc40e5eac26/resourceGroups/mystorage/providers/Microsoft.Storage/storageAccounts/storagedemo',
  'storagedemo.blob.core.windows.net',
  'blob'
);

Copy

"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" provisioned successfully"