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

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT¶

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

您可以在取消预置专用端点后的 7 天内将其恢复。7 天后，端点将无法恢复，您需要使用 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 系統函数重新创建端点。

语法¶

AWS：

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '<provider_service_name>' )

Copy

Azure：

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '<provider_resource_id>'
  [, '<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。

'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)。

返回¶

返回一条状态消息，表明端点及其标识符已成功恢复。

如果不成功，则返回错误。例如，如果提供的实参不是有效的现有端点。如果您不知道端点名称，您可以使用 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 系统函数列出您的 Snowflake 账户中的所有端点。

使用说明¶

只有账户管理员（具有 ACCOUNTADMIN 角色的用户）才能调用此函数。
如果专用连接端点未与指定实参关联，则会出现错误消息。

示例¶

AWS：

恢复对 Amazon S3 具有外部访问权限的专用端点：

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');

Copy

Azure：

恢复专用端点，允许 Microsoft Azure 上的 Snowflake 连接到 Azure VNet 中的 Azure API 管理服务：

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/my_rg/providers/Microsoft.Sql/servers/my_db_server',
  'sqlServer'
);

Copy

Private endpoint with id ''/subscriptions/66666666-7777-8888-9999-0000000000/resourcegroups/rg/providers/microsoft.network/privateendpoints/00000000-1111-2222-3333-4444444444'' restored successfully.