SYSTEM$GET_PRIVATELINK_CONFIG¶

構文¶

SYSTEM$GET_PRIVATELINK_CONFIG()

引数¶

なし。

戻り値¶

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

AWS

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "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>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>",
  "privatelink-account-principal": "<aws_principal_arn>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "app-service-privatelink-url": "<privatelink_streamlit_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Microsoft Azure

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "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>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Google Cloud Platform

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

条件:

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に接続するためのアプリケーションおよびツール のクライアントでこの値を使用します。

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

privatelink-connection-ocsp-urls

クライアント接続のリダイレクト で使用する OCSP URLs のリスト。

値のリストは、 SYSTEM$ALLOWLIST_PRIVATELINK 関数の OCSP_CLIENT_FAILOVER の出力と一致する必要があります。

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）の出力と一致する必要があります。

regionless-privatelink-account-url

組織名とアカウント名を含むプライベート接続 URL。

この値は、 SYSTEM$ALLOWLIST_PRIVATELINK 関数の SNOWFLAKE_DEPLOYMENT_REGIONLESS の出力値と一致します。

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-account-principal

VPC エンドポイントサービスへのアウトバウンドプライベート接続を許可する AWS プリンシパル ARN。

この値を使用して、エンドポイントサービスの 許可プリンシパル を設定し、Snowflakeが AWS PrivateLink 経由でエンドポイントサービスに接続できるようにします。

privatelink-pls-id

エイリアス形式のアカウント識別子用のMicrosoft Azure Private Linkサービス ID。例:

sf-pvlinksvc-azurecentralus.<unique_identifier>.centralus.azure.privatelinkservice

ここで <unique_identifier> は GUID/UUID 形式です。

この値を使用して、Azure Private Linkプライベートエンドポイントを作成します。プライベートエンドポイントの作成中にエラーが発生した場合は、 Snowflakeサポート に連絡して、このエイリアス値に関連付けられたリソース ID を要求してください。

privatelink-gcp-service-attachment

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

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

"regionless-privatelink-ocsp-url

アカウント識別子 の OCSP URL。

値は次のように記録されます。

"ocsp.org_name-account_name.privatelink.snowflakecomputing.com"

条件:

• org_name は、Snowflake組織の名前です。

• account_name は、組織内にあるアカウントの一意の名前です。

app-service-privatelink-url

AWS PrivateLink 経由でStreamlitアプリケーショントラフィックをルーティングするために必要なワイルドカード URL。

privatelink-dashed-urls-for-duo

ハイフン区切りの URLs のリストは、ホスト名にアンダースコアが含まれている場合のみに表示されます。これらの URLs はDuo多要素認証に使用されます。

使用上の注意¶

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

• Microsoft AzureでのSnowflakeアカウントで、関数を呼び出してクエリ時間が1分を超える場合は、 Snowflakeサポート にお問い合わせください。

例¶

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

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

Copy

オプションで、次のコマンドを実行して 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>"               |
|--------------------------------------+--------------------------------------|
| privatelink-connection-ocsp-urls     | "<client_redirect_ocsp_url_list>"    |
|--------------------------------------+--------------------------------------|
| 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>"    |
|--------------------------------------+--------------------------------------|
| regionless-privatelink-account-url   | "<privatelink_org_account_url>"      |
|--------------------------------------+--------------------------------------|
| privatelink-ocsp-url                 | "<privatelink_ocsp_url>"             |
|--------------------------------------+--------------------------------------|
| regionless-privatelink-ocsp-url      | "<privatelink_org_ocsp_url>"         |
+--------------------------------------+--------------------------------------+

Copy