SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS¶

接続をSnowflakeサービスにルーティングできる、登録済みのプライベートエンドポイントを返します。

構文¶

SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS()

Copy

引数¶

なし。

戻り値¶

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();

Copy

[
  {
    "consumerEndpointId": "148896251...",
    "consumerEndpointType": "Aws Id",
    "pinnedConsumerEndpointId": "vpce-0be92fc5953c0...",
    "providerServiceEndpoint": "vpce-svc-0dcda6d2e9d14..."
  }
]

Copy

Azure:

 use role accountadmin;

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS();

Copy

[
  {
    "consumerEndpointId": "/subscriptions/a92a429f-83ba-4249.../..../snowflake-private-link",
    "consumerEndpointType": "Azure Endpoint Connection Id",
    "pinnedConsumerEndpointId": "184549...",
    "providerServiceEndpoint": "sf-pvlinksvc-azcanadacentral.70f..."
  }
]

Copy