SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶

语法¶

SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO()

返回¶

返回具有以下字段的 JSON 对象：

AWS：

provider_service_name

服务或资源的名称。

snowflake_endpoint_name

Snowflake 账户中的 VPC 端点 ID。此字段包含创建端点时的临时名称。在端点创建且 endpoint_state 变为 CREATED 后，此名称也会随之发生变更。

endpoint_state

Snowflake 中的端点状态。此字段可以包含以下状态之一：

• PENDING_CREATION：端点仍在创建中。

• CREATED：表示 Snowflake 收到了来自云提供商的响应，指出端点已成功创建并可供使用。

• FAILED：云服务提供商的端点处于意外状态，无法使用。

• PENDING_DELETION：端点位于删除队列中，但可以恢复。

• DELETING：端点正在云服务提供商上删除，无法恢复。

host

用于连接到服务的主机名。

status

AWS 上的端点配置状态。此字段可以包含以下状态之一：

• Pending：端点仍在创建中。

• Available：端点已创建，可随时使用。

Azure：

provider_resource_id

端点所连接资源的 Azure 资源 ID。

subresource

端点所连接的 Azure 资源的子资源。

snowflake_resource_id

连接到 Azure 资源的专用端点的 Azure 资源 ID。

host

用于连接资源的主机名。

endpoint_state

Snowflake 中的端点状态。此字段可以包含以下状态之一：

• PENDING_CREATION：端点仍在创建中。

• CREATED：表示 Snowflake 收到了来自云提供商的响应，指出端点已成功创建并可供使用。

• FAILED：云服务提供商的端点处于意外状态，无法使用。

• PENDING_DELETION：端点位于删除队列中，但可以恢复。

• DELETING：端点正在云服务提供商上删除，无法恢复。

status

Microsoft Azure 上的端点配置状态。使用此字段确定 Microsoft Azure 是否已批准与资源的专用端点连接。此字段可以包含以下状态之一：

• APPROVED

• PENDING

• DISCONNECTED

• 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"
  },
  ...
]

Azure：

对于 Microsoft Azure 上的 Snowflake 账户，请列出已配置的专用连接端点以及每个端点关联的服务名称：

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy