SYSTEM$GET_PRIVATELINK_CONFIG¶

構文¶

SYSTEM$GET_PRIVATELINK_CONFIG()

引数¶

なし。

使用上の注意¶

アカウント管理者（つまり、ACCOUNTADMIN ロールを持つユーザー）のみがこの関数を実行できます。

出力¶

この関数は、Snowflakeアカウントが配置されているクラウドプラットフォームに基づいて、次の名前と値のペアを含む JSON オブジェクトを返します。

AWS

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>"
}

Microsoft Azure

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url":"<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>"
}

Google Cloud Platform

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>"
}

条件:

regionless-snowsight-privatelink-url

組織 が、Snowflakeサービスへのプライベート接続を使用してSnowsightにアクセスするための URL。

この URL を使用して、DNS 解決のための正規名（つまり、 CNAME）を作成します。この URL は、 SYSTEM$ALLOWLIST_PRIVATELINK 関数からの SNOWSIGHT_DEPLOYMENT_REGIONLESS （つまり TYPE）の出力と一致する必要があります。

詳細については、 アカウント識別子 および Snowsight: Snowflakeウェブインターフェイス をご参照ください。

privatelink-account-name

Snowflakeアカウント用の識別子。

Snowflakeへの接続 のクライアントでこの値を使用します。

詳細については、 アカウント識別子 をご参照ください。

snowsight-privatelink-url

Snowsightにアクセスするための クラウドリージョン を含む URL と、Snowflakeサービスへのプライベート接続を使用する Snowflake Marketplace。

この URL を使用して、DNS 解決のための正規名（つまり、 CNAME）を作成します。この URL は、 SYSTEM$ALLOWLIST_PRIVATELINK 関数からの SNOWSIGHT_DEPLOYMENT （つまり TYPE）の出力と一致する必要があります。

詳細については、 アカウント識別子 および Snowsight: Snowflakeウェブインターフェイス をご参照ください。

privatelink-internal-stage

AWS PrivateLink またはAzure Private Linkを使用してSnowflake内部ステージに接続するためのエンドポイント。

Snowflake内部ステージへのプライベート接続でこの値を使用します。

このキーの可視性とクエリ結果に対応する値は、 ENABLE_INTERNAL_STAGES_PRIVATELINK パラメーターの設定によって異なります。このパラメーターのデフォルト設定は FALSE です。クエリ結果で内部ステージエンドポイントを取得するには、このシステム関数を実行する前に、このパラメーターを TRUE に設定する必要があります。

privatelink-account-url

AWS PrivateLink、Azure Private Link、またはGoogle Cloud Private Service Connectを使用してSnowflakeアカウントに接続するための URL。

この値を使用して、DNS 解決のための標準的な名前（つまり、 CNAME）を作成します。この URL は SYSTEM$ALLOWLIST_PRIVATELINK からの出力と一致する必要があります。

URL 形式の詳細については、 アカウント識別子 をご参照ください。

privatelink-connection-urls

クライアントリダイレクト の接続 URLs のリスト。

これらの URLs を使用して、 DNS 解決のための正規名（つまり、 CNAME）を作成します。これらの URL は、 SYSTEM$ALLOWLIST_PRIVATELINK 関数からの CLIENT_FAILOVER （つまり TYPE）の出力と一致する必要があります。

privatelink-ocsp-url

AWS PrivateLink、Microsoft Azure Private Link、またはGoogle Cloud Private Service Connectを使用するSnowflakeアカウント識別子に対応するOCSP URL。

この値を使用して、DNS 解決のための標準的な名前（つまり、 CNAME）を作成します。

privatelink-vpce-id

アカウント識別子の AWS VPCE ID。

この値を使用して、 AWS VPC エンドポイント（つまり、 VPCE）を作成します。

privatelink-pls-id

アカウント識別子用のMicrosoft Azure Private Linkサービス ID。

この値を使用して、Azure Private Linkプライベートエンドポイントを作成します。

privatelink-gcp-service-attachment

Google Cloud Private Service Connectを使用する場合のSnowflakeサービスのエンドポイント。

転送ルールを作成するときにこの値を使用して、 VPC のPrivate Service ConnectエンドポイントをSnowflakeサービスにルーティングします。

例¶

AWS で、Snowflakeアカウントの JSON 情報を取得します。

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

オプションで、次のコマンドを実行して JSON 出力をフラット化できます。次の出力は、Microsoft AzureのSnowflakeアカウントの例です。

select key, value from table(flatten(input=>parse_json(SYSTEM$GET_PRIVATELINK_CONFIG())));

+-----------------------------------------------------------------------------+
| KEY                                  | VALUE                                |
+-----------------------------------------------------------------------------+
| regionless-snowsight-privatelink-url | "<privatelink_org_snowsight_url>"    |
|--------------------------------------|--------------------------------------|
| privatelink-account-name             | "<account_identifier>"               |
|--------------------------------------|--------------------------------------|
| snowsight-privatelink-url            | "<privatelink_region_snowsight_url>" |
|--------------------------------------|--------------------------------------|
| privatelink-internal-stage           | "<privatelink_stage_endpoint>"       |
|--------------------------------------|--------------------------------------|
| privatelink-account-url              | "<privatelink_account_url>"          |
|--------------------------------------|--------------------------------------|
| privatelink-connection-urls          | "<privatelink_connection_url_list>"  |
|--------------------------------------|--------------------------------------|
| privatelink-pls-id                   | "<azure_private_link_service_id>"    |
|--------------------------------------|--------------------------------------|
| privatelink-ocsp-url                 | "<privatelink_ocsp_url>"             |
+--------------------------------------|--------------------------------------+