- カテゴリ:
システム関数 (システム情報)
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$WHITELIST_PRIVATELINK からの出力と一致する必要があります。
URL 形式の詳細については、 アカウント識別子 をご参照ください。
privatelink-ocsp-url
AWS PrivateLink、Microsoft Azure Private Link、またはGoogle Cloud Private Service Connectを使用するSnowflakeアカウント識別子に対応するOCSP URL。
この値を使用して、DNS 解決のための標準的な名前(つまり、 CNAME)を作成します。この URL は SYSTEM$WHITELIST_PRIVATELINK からの出力と一致する必要があります。
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>" | +------------------------------------------------------------------+