- 类别：
系统函数 （系统信息）
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶
返回您预置的所有专用连接端点的状态。端点可以是服务端点或资源端点，具体取决于托管 Snowflake 账户的云平台。
语法¶
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO()
返回¶
返回具有以下字段的 JSON 对象：
AWS：
provider_service_name服务或资源的名称。
snowflake_endpoint_nameSnowflake 账户中的 VPC 端点 ID。此字段包含创建端点时的临时名称。在端点创建且
endpoint_state变为CREATED后，此名称也会随之发生变更。endpoint_stateSnowflake 中的端点状态。此字段可以包含以下状态之一：
PENDING_CREATION：端点仍在创建中。
CREATED：表示 Snowflake 收到了来自云提供商的响应，指出端点已成功创建并可供使用。
FAILED：云服务提供商的端点处于意外状态，无法使用。
PENDING_DELETION：端点位于删除队列中，但可以恢复。
DELETING：端点正在云服务提供商上删除，无法恢复。host用于连接到服务的主机名。
statusAWS 上的端点配置状态。此字段可以包含以下状态之一：
Pending：端点仍在创建中。
Available：端点已创建，可随时使用。
Azure：
provider_resource_id端点所连接资源的 Azure 资源 ID。
subresource端点所连接的 Azure 资源的子资源。
snowflake_resource_id连接到 Azure 资源的专用端点的 Azure 资源 ID。
host用于连接资源的主机名。
endpoint_stateSnowflake 中的端点状态。此字段可以包含以下状态之一：
PENDING_CREATION：端点仍在创建中。
CREATED：表示 Snowflake 收到了来自云提供商的响应，指出端点已成功创建并可供使用。
FAILED：云服务提供商的端点处于意外状态，无法使用。
PENDING_DELETION：端点位于删除队列中，但可以恢复。
DELETING：端点正在云服务提供商上删除，无法恢复。statusMicrosoft Azure 上的端点配置状态。使用此字段确定 Microsoft Azure 是否已批准与资源的专用端点连接。此字段可以包含以下状态之一：
APPROVED
PENDING
DISCONNECTED
REJECTED
Google Cloud：
provider_resource_id专用连接端点连接到的资源 ID（服务附件 ID）。
snowflake_resource_id专用连接端点的标识符。
host访问使用此端点的提供商服务或资源时使用的主机名。
endpoint_stateSnowflake 侧端点状态。
statusGoogle Cloud 上的连接状态。NO CONNECTION 可能会在创建专用连接端点后不久出现，因为云提供商需要时间来完成连接设置。此字段可以包含以下状态之一：
ACCEPTED
NO CONNECTION
REJECTED
使用说明¶
此函数大约需要 5 分钟的运行时间，因为它取决于在云平台（Snowflake 之外）中检索专用连接端点的流程。
示例¶
AWS：
执行以下 SQL 语句，列出具有 Amazon S3 外部访问权限的所有 PrivateLink 端点：
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"
},
...
对于您在 Amazon Web Services 上的 Snowflake 账户，返回特定资源标识符的专用连接端点：
Azure：
对于 Microsoft Azure 上的 Snowflake 账户，请列出已配置的专用连接端点以及每个端点关联的服务名称：
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "/subscriptions/11111111-2222-3333-4444-5555555555/...", "subresource": "sqlServer", "snowflake_resource_id": "/subscriptions/fa57a1f0-b4e6-4847-9c00-95f39520f...", "host": "testdb.database.windows.net", "endpoint_state": "CREATED", "status": "Approved", } ]
Google Cloud
对于 Google Cloud 上的 Snowflake 账户，请列出已配置的专用连接端点以及每个端点关联的服务名称：
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "projects/my-project/regions/us-east4/serviceAttachments/...", "snowflake_resource_id": "abcd0000000000000001", "host": "my-service.com", "endpoint_state": "CREATED", "status": "ACCEPTED", } ]