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

SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS¶

返回当前账户的授权端点列表，以便与 Snowflake 服务的专用连接结合使用。

使用这些函数时，命令输出中的端点值可用作 aws_id 或 private-endpoint-resource-id 的值：

语法¶

SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS()

Copy

实参¶

无

返回¶

返回显示键值对的 JSON 对象列表，其中键代表 endpoint Id Type，值代表 endpoint Id。对于 Azure，SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS 返回两个值，一个端点 ID 和一个链接标识符。

AWS：

endpoint Id Type
代表 AWS 端点类型的字符串标签。

endpoint Id
已获授权连接到 Snowflake 端点服务的 AWS 账户 ID。

Azure：

endpoint Id Type
代表 Azure 端点类型的字符串值。

endpoint Id
经授权连接到 Snowflake 专有链接服务的 Azure 资源 ID。

link Identifier
与 Azure 资源 ID 关联的端点链接 ID。

GCP：

endpoint Id Type
代表 Google Cloud 端点类型的字符串值。

endpoint Id
Google Cloud 项目 ID 经授权创建到 Snowflake 服务附件的 Private Service Connect 端点。

使用说明¶

只有账户管理员（即具有 ACCOUNTADMIN 角色的用户）可执行此函数。
此函数可与 Amazon Web Services (AWS)、Microsoft Azure (Azure) 和 Google Cloud 上的 Snowflake 账户一起使用。

示例¶

AWS

返回您的 Snowflake 账户的授权端点，以与 AWS 上您的 Snowflake 账户的 AWS PrivateLink 一起使用：

use role accountadmin;
select system$get_privatelink_authorized_endpoints();

Copy

您可以选择使用以下命令来扁平化查询结果。例如：

select
  value: endpointId
from
  table(
    flatten(
      input => parse_json(system$get_privatelink_authorized_endpoints())
    )
  );

Copy

返回（ AWS 上 Snowflake 账户的端点）：

+----------------------+---------------------+
| KEY:ENDPOINT ID TYPE |   VALUE:ENDPOINT ID |
+----------------------+---------------------+
|  "123456789012"      |    "123456789012"   |
+----------------------+---------------------+

Copy