管理专用连接端点：AWS¶

提供专用连接端点¶

You can use the SYSTEM$PROVISION_PRIVATELINK_ENDPOINT system function to create a private connectivity endpoint by specifying the service or resource, and the host name. You must use the ACCOUNTADMIN role when you use this system function.

For example, to create a PrivateLink endpoint that connects to Amazon S3, execute the following SQL statement to configure an endpoint for us-west-2:

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

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 函数接受提供商服务名称和主机名作为其实参。您可以通过使用 AWS 命令行的 describe-vpc-endpoint-services 子命令获取这些值。如 AWS 文档 (https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpc-endpoint-services.html) 中所述，此 AWS 子命令返回一个 JSON 对象，具有 ServiceName 字段和 PrivateDnsName 字段。使用以下表来确定 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 函数应使用哪些值：

You can create a private connectivity endpoint to a VPC endpoint service in an AWS region that is different from your Snowflake region. If you do, ensure that the VPC endpoint service supports the Snowflake region.

If the target service is a VPC endpoint service (https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html), the endpoint service must allow Snowflake to connect to it. Before you create an endpoint, add the value of privatelink-account-principal from the output of SYSTEM$GET_PRIVATELINK_CONFIG as an allowed principal (https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions) of the VPC endpoint service.

The following SQL statement configures an endpoint to a VPC endpoint service:

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  'com.amazonaws.vpce.us-west-2.vpce-svc-012345678910f1234',
  'my.onprem.storage.com'
);

在您创建端点后，使用该端点之前会有一个延迟。有关检查已创建端点状态的信息，请参阅 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO。

设置与无法直接访问的端点的连接¶

并非所有服务都允许 Snowflake 通过接口端点直接连接到特定实例。在这些情况下，您可以改为通过 设置代理并将该服务公开为 VPC 端点服务 来启用对服务的访问权限。

如需专门的 Amazon RDS 引导教程，请参阅博客文章 使用 Snowflake 的专用连接功能连接至 Amazon RDS (link removed)。

Change the host name of a private connectivity endpoint¶

You can change only the host name of a previously provisioned, private connectivity endpoint without changing its network resource. Changing the host name for an endpoint tells Snowflake that this endpoint now connects to the same service by using a different host name. To change the host name, call the SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME system function.

移除服务的一个专用连接端点¶

您可以使用 SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT 系统函数通过指定服务或资源来移除专用连接端点。

在端点被移除后，端点会被放入队列中，7 天后将被删除。

在使用此系统函数时，您需要使用 ACCOUNTADMIN 角色。

例如，要移除一个可以从外部访问 Amazon S3 的 PrivateLink，请执行以下 SQL 语句：

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

恢复服务的一个专用连接端点¶

您可以使用 SYSTEM$RESTORE_PRIVATELINK_ENDPOINT 系统函数通过指定服务或资源来恢复仍在删除队列中的已移除专用连接端点。如果在删除队列中找不到端点，则无法恢复该端点。

在使用此系统函数时，您需要使用 ACCOUNTADMIN 角色。

例如，要恢复一个可以从外部访问 Amazon S3 的 PrivateLink，请执行以下 SQL 语句：

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

列出服务的所有专用连接端点¶

您可以使用 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 系统函数列出您账户中的所有专用连接端点及其信息。

在使用此系统函数时，您需要使用 ACCOUNTADMIN 角色。

例如，要列出所有 AWS PrivateLink 端点和 AWS 服务，请执行以下 SQL 语句：

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

[
  {
    "provider_service_name": "com.amazonaws.us-west-2.s3",
    "snowflake_endpoint_name": "vpce-123456789012abcdea",
    "endpoint_state": "CREATED",
    "host": "*.s3.us-west-2.amazonaws.com",
    "status": "Available"
  },
  ...
]

有关函数返回的 JSON 对象字段的描述，请参阅 返回。