カテゴリ：

システム関数 （システム情報）

SYSTEM$GET_PRIVATELINK_CONFIG

Snowflake サービス または 内部ステージ へのプライベート接続のセルフサービス構成を容易にするために必要なSnowflakeアカウント情報の JSON 表現を返します。

構文

SYSTEM$GET_PRIVATELINK_CONFIG()

引数

なし。

使用上の注意

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

出力

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

AWS

{
  "privatelink-account-name": "<account_identifier>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>"
}

Microsoft Azure

{
  "privatelink-account-name": "<account_identifier>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url":"<privatelink_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>"
}

Google Cloud Platform

{
  "privatelink-account-name": "<account_identifier>",
  "privatelink-account-url":"<privatelink_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>"
}

条件:

privatelink-account-name

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

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

+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| SYSTEM$GET_PRIVATELINK_CONFIG()                                                                                                                                                                                                                                  |
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| {"privatelink-account-name": "<account_identifier>","privatelink-internal-stage": "<privatelink_stage_endpoint>","privatelink-account-url": "<privatelink_account_url>","privatelink-ocsp-url": "<privatelink_ocsp_url>","privatelink-vpce-id": "<aws_vpce_id>"} |
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

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

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| SYSTEM$GET_PRIVATELINK_CONFIG()                                                                                                                                                                                                                                                   |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| {"privatelink-account-name": "<account_identifier>","privatelink-internal-stage": "<privatelink_stage_endpoint>","privatelink-account-url": "<privatelink_account_url>","privatelink-ocsp-url": "<privatelink_ocsp_url>","privatelink-pls-id": "<azure_private_link_service_id>"} |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

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

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| SYSTEM$GET_PRIVATELINK_CONFIG()                                                                                                                                                                                             |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| {"privatelink-account-name": "<account_name>","privatelink-account-url": "<privatelink_account_url>","privatelink-ocsp-url": "<privatelink_ocsp_url>","privatelink-gcp-service-attachment": "<snowflake_service_endpoint>"} |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

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

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

+------------------------------------------------------------------+
| KEY                        | VALUE                               |
+------------------------------------------------------------------+
| privatelink-account-name   | "<account_identifier>"              |
+------------------------------------------------------------------+
| privatelink-internal-stage | "<privatelink_stage_endpoint>"      |
+------------------------------------------------------------------+
| privatelink-account-url    | "<privatelink_account_url>"         |
+------------------------------------------------------------------+
| privatelink-pls-id         | "<azure_private_link_service_id>"   |
+------------------------------------------------------------------+
| privatelink-ocsp-url       | "<privatelink_ocsp_url>"            |
+------------------------------------------------------------------+