- Categories:
系统函数 (System Control)
SYSTEM$REGISTER_PRIVATELINK_ENDPOINT¶
注册专用连接端点,将您的连接路由到 Snowflake 服务。
语法¶
AWS
Azure
必填实参¶
AWS
aws_private_endpoint_vpce_id指定 Amazon Web Services (AWS) 虚拟私有云端点 (AWS VPCEID) 的标识符。
要获取 AWS VPCEID 值,请浏览 AWS 控制台或使用以下命令:
aws_account_id用于唯一标识您的 Amazon Web Services (AWS) 账户的 12 位标识符(字符串)。
要获取 AWS 账户 ID 值,请浏览 AWS 控制台或使用以下命令:
Azure
azure_private_endpoint_link_id指定 Microsoft Azure (Azure) 虚拟私有云端点链接 (Azure LinkID) 的标识符。
要获取 Azure LinkID 值,请执行以下操作:
azure_private_endpoint_resource_id此标识符以字符串形式唯一标识您在 Microsoft Azure (Azure) 中的 Snowflake 账户。
要获取 Azure Private Endpoint 资源 ID,请使用以下命令:
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:
对于 Snowflake on Azure:
有关限制访问令牌范围的更多信息,请参阅:
对于 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
Azure