- カテゴリ:
システム関数 (システム情報)
SYSTEM$GET_PRIVATELINK_CONFIG¶
SnowflakeサービスまたはSnowflake内部ステージへのプライベート接続のセルフサービス構成を容易にするために必要な、Snowflakeアカウント情報の JSON 表現を返します。
構文¶
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>" | +--------------------------------------|--------------------------------------+