Categories:: 系统函数 (System Control)

SYSTEM$REGISTER_PRIVATELINK_ENDPOINT¶

注册专用连接端点，将您的连接路由到 Snowflake 服务。

语法¶

AWS

SYSTEM$REGISTER_PRIVATELINK_ENDPOINT(
  '<aws_private_endpoint_vpce_id>',
  '<aws_account_id>',
  '<token>',
  [ <delay_time> ]
  )

Azure

SYSTEM$REGISTER_PRIVATELINK_ENDPOINT(
  '<azure_private_endpoint_link_id>',
  '<azure_private_endpoint_resource_id>',
  '<token>',
  [ <delay_time> ]
  )

必填实参¶

AWS

aws_private_endpoint_vpce_id

指定 Amazon Web Services (AWS) 虚拟私有云端点 (AWS VPCEID) 的标识符。

要获取 AWS VPCEID 值，请浏览 AWS 控制台或使用以下命令：

aws ec2 describe-vpc-endpoints

aws_account_id

用于唯一标识您的 Amazon Web Services (AWS) 账户的 12 位标识符（字符串）。

要获取 AWS 账户 ID 值，请浏览 AWS 控制台或使用以下命令：

aws sts get-caller-identity

Azure

azure_private_endpoint_link_id

指定 Microsoft Azure (Azure) 虚拟私有云端点链接 (Azure LinkID) 的标识符。

要获取 Azure LinkID 值，请执行以下操作：

运行 SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS 系统函数。

azure_private_endpoint_resource_id

此标识符以字符串形式唯一标识您在 Microsoft Azure (Azure) 中的 Snowflake 账户。

要获取 Azure Private Endpoint 资源 ID，请使用以下命令：

az network private-endpoint list --resource-group my_resource_group

token

指定用于验证专用连接端点所有权的访问令牌。

要获取令牌，您必须至少对专用连接端点具有相应的读取或描述权限。有关更多信息，请参阅：

AWS 端点策略 (https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html)
Azure Private Endpoint 权限 (https://learn.microsoft.com/en-us/azure/private-link/rbac-permissions#private-endpoint)

要获取令牌，请使用以下命令：

对于 Snowflake on AWS：

aws sts get-federation-token --name snowflake --policy '{ "Version": "2012-10-17", "Statement"
: [ { "Effect": "Allow", "Action": ["ec2:DescribeVpcEndpoints"], "Resource": ["*"] } ] }'

对于 Snowflake on Azure：
```
az account get-access-token --subscription <subscription_id>
```

有关限制访问令牌范围的更多信息，请参阅：

对于 Snowflake on AWS：在 Amazon Web Services 上管理访问令牌范围
对于 Snowflake on Azure：在 Microsoft Azure 上管理访问令牌范围

可选实参¶

delay_time

指定在强制执行专用端点注册之前要等待的分钟数。

范围：0 到 1440 分钟（24 小时）

0 分钟：立即强制执行注册。

默认值：60（1 小时）

有关延迟时间和强制执行的更多信息，请参阅使用延迟时间实参管理执行。

返回¶

返回有关专用连接端点注册的状态消息。

如果指定了延迟时间，该函数将返回一条消息，说明何时将强制执行注册，并提醒您，当您将多个账户固定到同一专用端点时，强制执行会基于最早的注册。

使用说明¶

只有账户管理员（具有 ACCOUNTADMIN 角色的用户）才能调用此函数。
您可以为 Snowflake 账户注册多个专用连接端点。

示例¶

调用 SYSTEM$REGISTER_PRIVATELINK_ENDPOINT 系统函数将 VPC 端点注册到您的 Snowflake 账户。token 实参包含截断值，延迟时间单位为分钟：

AWS

SELECT SYSTEM$REGISTER_PRIVATELINK_ENDPOINT(
  'vpce-0c1...',
  '123.....',
  '{
    "Credentials": {
      "AccessKeyId": "ASI...",
      "SecretAccessKey": "alD...",
      "SessionToken": "IQo...",
      "Expiration": "2024-12-10T08:20:20+00:00"
    },
    "FederatedUser": {
      "FederatedUserId": "0123...:snowflake",
      "Arn": "arn:aws:sts::174...:federated-user/snowflake"
    },
    "PackedPolicySize": 9,
    }',
  120
  );

Azure

SELECT SYSTEM$REGISTER_PRIVATELINK_ENDPOINT(
  '123....',
  '/subscriptions/0cc51670-.../resourceGroups/dbsec_test_rg/providers/Microsoft.Network/
  privateEndpoints/...',
  'eyJ...',
  120
);