SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS¶
接続をSnowflakeサービスにルーティングできる、登録済みのプライベートエンドポイントを返します。
構文¶
SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS()
引数¶
なし。
戻り値¶
JSON オブジェクトのリストを返します。各 JSON オブジェクトは、登録されたプライベート接続エンドポイントを指定します。アカウントにSnowflakeサービスへのプライベート接続エンドポイントが登録されていない場合は、空の JASON 配列("[]"
)を含む文字列が返されます。
条件:
consumerEndpointId
登録された VPC エンドポイントを含む AWS アカウントID、または登録されたプライベートエンドポイントを含むAzureリソースグループ識別子を指定します。
consumerEndpointType
登録されているプライベート接続エンドポイントの型を指定します。
pinnedConsumerEndpointId
Snowflakeに登録するプライベート接続エンドポイント識別子を指定します。
providerServiceEndpoint
Snowflake VPC のプライベート接続サービスエンドポイントの識別子を指定します。
使用上の注意¶
アカウント管理者(ACCOUNTADMIN ロールを持つユーザー)のみが、この関数を呼び出すことができます。
例¶
接続をSnowflakeサービスにルーティングする、登録済みのプライベート接続エンドポイントを返します。
AWS:
use role accountadmin; SELECT SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS();
[ { "consumerEndpointId": "148896251...", "consumerEndpointType": "Aws Id", "pinnedConsumerEndpointId": "vpce-0be92fc5953c0...", "providerServiceEndpoint": "vpce-svc-0dcda6d2e9d14..." } ]
Azure:
use role accountadmin; SELECT SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS();
[ { "consumerEndpointId": "/subscriptions/a92a429f-83ba-4249.../..../snowflake-private-link", "consumerEndpointType": "Azure Endpoint Connection Id", "pinnedConsumerEndpointId": "184549...", "providerServiceEndpoint": "sf-pvlinksvc-azcanadacentral.70f..." } ]