カテゴリ：: システム関数（システム情報）

SYSTEM$GET_PRIVATELINK_CONFIG¶

AWS PrivateLink またはAzure Private Linkのセルフサービス構成を容易にするために必要なSnowflakeアカウント情報の JSON 表現を返します。

詳細については、次をご参照ください。

構文¶

SYSTEM$GET_PRIVATELINK_CONFIG()

引数¶

なし。

使用上の注意¶

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

出力¶

この関数は、次の名前/値のペアを含む JSON オブジェクトを返します：

AWS

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

Azure

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

条件：

privatelink-account-name
Snowflakeアカウント用の識別子。

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

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

privatelink-account-url
AWS PrivateLink またはAzure Private Linkを使用して、Snowflakeアカウントに接続するための URL。

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

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

privatelink-ocsp-url
AWS PrivateLink またはAzure Private Linkを使用するSnowflakeアカウント識別子に対応する OCSP URL。

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

privatelink-vpce-id
アカウント識別子の AWS VPCE ID。

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

privatelink-pls-id
アカウント識別子用のAzure Private Linkサービス ID。

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

例¶

AWS PrivateLink とAzure Private Link上のアカウントの JSON 情報を取得します。

-- AWS

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

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

-- Azure

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

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

オプションで、次のコマンドを実行して JSON 出力をフラット化できます。

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

+-----------------------------------------------------------------+
| KEY                       | VALUE                               |
+-----------------------------------------------------------------+
| privatelink-account-name  | "<account_identifier>"              |
+-----------------------------------------------------------------+
| privatelink-account-url     | "<privatelink_account_url>"         |
+-----------------------------------------------------------------+
| privatelink-vpce-id       | "<aws_vpce_id>"                     |
+-----------------------------------------------------------------+
| privatelink-ocsp-url      | "<privatelink_ocsp_url>"            |
+-----------------------------------------------------------------+