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

SYSTEM$GET_PRIVATELINK_CONFIG¶

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

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

構文¶

SYSTEM$GET_PRIVATELINK_CONFIG()

引数¶

なし。

使用上の注意¶

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

現在、この関数は AWS us-west-2 地域のSnowflakeアカウントのみで使用できます。

出力¶

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

AWS

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

Azure

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

条件：

privatelink-account-name
Snowflakeによって割り当てられた <アカウント> の名前。

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

private-link-account-url
URL は、AWS PrivateLink またはAzure Private Linkを介してSnowflakeに接続するために使用されました。

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

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_name>","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_name>","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_name>"                    |
------------------------------------------------------------------+
| privatelink-account-url   | "<privatelink_account_url>"         |
------------------------------------------------------------------+
| privatelink-vpce-id       | "<aws_vpce_id>"                     |
------------------------------------------------------------------+
| privatelink-ocsp-url      | "<privatelink_ocsp_url>"            |
------------------------------------------------------------------+