Snowflake Open Catalogのプライベート接続エンドポイントの管理: Azure¶

始める前に¶

Open CatalogのSnowflake CLI 接続を作成するには、Open Catalogのアカウント識別子が必要です。アカウント識別子には、Snowflake組織名とOpen Catalogアカウント名が含まれます。例えば、 <orgname>.<my-snowflake-open-catalog-account-name> のようになります。

• Snowflake 組織名（<orgname>）を調べるには、 アカウントの組織名とアカウント名を調べる <https://docs.snowflake.com/en/user-guide/admin-account-identifier.html#label-account-name-find>_ をご参照ください。

• Snowflake Open Catalog アカウント名（<my-snowflake-open-catalog-account-name>）を検索するには、 Snowflake Open Catalogアカウントのアカウント名を検索 <https://other-docs.snowflake.com/en/opencatalog/find-account-name>_ をご参照ください。

Snowflake Open Catalog用にSnowflake CLI 接続を追加する¶

プライベート接続を有効にしたいSnowflake Open Catalogアカウントの接続を追加します。

• 以下の値で 接続を追加 <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ をします。その他のパラメーターについては、 Enter を押して、パラメーターの値の指定をスキップします。

  接続構成パラメーター	値
  この接続の名前	接続の名前を指定します（例: myopencatalogconnection）。
  アカウント名	Snowflake組織名の後にOpen Catalogのアカウント名をこの形式で指定します。 <orgname>-<my-snowflake-open-catalog-account-name>。 例えば、 ABCDEFG-MYACCOUNT1 です。 これらの名前を調べるには、 はじめに_ をご参照ください。
  ユーザー名	Open Catalogのユーザー名を指定します（例: jsmith）。
  パスワード [任意]	Open Catalogの接続を作成する場合、このパラメーターはオプション ではありません。 Open Catalogのパスワードを入力してください（例: MyPassword123456789）。
  接続のロール [任意]	Open Catalogの接続を作成する場合、このパラメーターはオプション ではありません。 POLARIS_ACCOUNT_ADMIN を入力する必要があります

Snowflake CLI 接続のテスト¶

• CLI 接続をテストするには、以下の例に従ってください。 myopencatalogconnection の接続をテストします。

  snow connection test -c myopencatalogconnection
  

  Copy

  応答は次のようになります。

  +------------------------------------------------------------------------------+
  | key              | value                                                     |
  |----------------------------+-------------------------------------------------|
  | Connection name  | myopencatalogconnection                                   |
  | Status           | OK                                                        |
  | Host             | ABCDEFG-MYACCOUNT1.snowflakecomputing.com                 |
  | Account          | ABCDEFG-MYACCOUNT1                                        |
  | User             | jsmith                                                    |
  | Role             | POLARIS_ACCOUNT_ADMIN                                     |
  | Database         | not set                                                   |
  | Warehouse        | not set                                                   |
  +------------------------------------------------------------------------------+
  

  Copy

Snowflake Open CatalogのSnowflake CLI 接続をデフォルトに設定する¶

使用する接続に必要な POLARIS_ACCOUNT_ADMIN ロールが常に付与されるようにするには、Open Catalog用に作成したSnowflake CLI 接続をデフォルトの接続として設定します。デフォルト接続の詳細については、 デフォルト接続の設定 <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_ をご参照ください。

1. この例に従います。これは、 myopencatalogconnection 接続をデフォルトとして設定します。

   snow connection set-default myopencatalogconnection
   

   Copy

2. 正しいユーザーとロールを使用していることを確認するには、以下を実行してください。

   snow sql -q "Select current_user(); select current_role();"
   

   Copy

   応答はOpen Catalogのユーザー名を返し、 CURRENT ROLE は POLARIS_ACCOUNT_ADMIN である必要があります。

   +----------------+
   | CURRENT_USER() |
   |----------------|
   | JSMITH        |
   +----------------+
   select current_role();
   +-----------------------+
   | CURRENT_ROLE()        |
   |-----------------------|
   | POLARIS_ACCOUNT_ADMIN |
   +-----------------------+
   

   Copy

例: データレイクストレージのストレージアカウントに対してプライベート接続エンドポイントをプロビジョニングする¶

Icebergテーブルの保存にデータレイクストレージのストレージアカウントを使用する場合、アカウントに2つのプライベート接続エンドポイントをプロビジョニングする必要があります。詳細については、Azureドキュメントの プライベートエンドポイントの作成 をご参照ください。

例:

BLOBエンドポイントにプライベートエンドポイントをプロビジョニングする

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
'/subscriptions/mysubscriptionid/resourceGroups/mystorage/providers/Microsoft.Storage/storageAccounts/storagedemo',
  'storagedemo.blob.core.windows.net',
  'blob'
);

DFS エンドポイントにプライベートエンドポイントをプロビジョニングする

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
'/subscriptions/mysubscriptionid/resourceGroups/mystorage/providers/Microsoft.Storage/storageAccounts/storagedemo',
  'storagedemo.dfs.core.windows.net',
  'dfs'
);

新規カタログのプライベート接続の有効化¶

Azureストレージを使用してカタログを作成するの手順に従います。カタログに対して、 Private Link トグルが 有効 になっていることを確認します。

既存カタログへのプライベート接続の有効化¶

1. オープンカタログにサインインします。

2. ナビゲーションメニューで、 カタログ を選択します。

3. カタログのリストで、プライベート接続を有効にするカタログを選択します。

4. カタログの詳細タブで、 PrivateLink トグルを 有効 に設定します。

Open Catalogでテーブルのスキーマを表示できない¶

症状

Open Catalogで、カタログのテーブル（例えば、 catalog1）を選択しましたが、次のエラーメッセージ、「このリソースへのアクセス許可がありません。」を受け取りました。

原因

Azureで、 VPC エンドポイントを介してネットワークトラフィックをルーティングするために、ストレージアカウントのネットワーク設定を正常に更新しました。しかし、Open Catalogではこのカタログのプライベート接続を有効にしていないため、Open Catalogはあなたのバケットにアクセスできません。

解決策

カタログ（例えば、catalog1）のプライベート接続を有効にします。詳細については、 カタログのプライベート接続を有効にするをご参照ください。

クエリエンジンで「サブスコープ認証情報の取得に失敗しました」エラーメッセージを受け取った¶

症状

クエリエンジンを使用してテーブルにデータを読み書きしようとしましたが、以下のエラーメッセージが表示されました: 「サブスコープ認証情報の取得に失敗しました。」

原因

ストレージアカウントをロックダウンしましたが、プライベート接続エンドポイントをプロビジョニングしていないか、Open Catalogアカウントでプライベート接続を有効にしていません。その結果、Open Catalogはサブスコープ認証情報を生成してクエリエンジンに返すことができず、クエリエンジンはストレージにアクセスできません。

解決策

以下のステップを実行します。

• プライベート接続エンドポイントをまだプロビジョニングしていない場合は、 ストレージアカウントのプライベート接続エンドポイントをプロビジョニングするをご参照ください。

• カタログのプライベート接続をまだ有効にしていない場合は、 カタログのプライベート接続を有効にするをご参照ください。

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT コマンド実行時の「Business Critical」エラー¶

症状

Snowflake CLI 接続で、 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT コマンドを実行しましたが、次のエラーメッセージが表示されて失敗しました: 「この操作にはBusiness Criticalまたはそれ以上のエディションが必要です。有効なエディションにアップグレードしてから、再試行してください」。

原因

あなたのOpen CatalogアカウントのエディションはBusiness Criticalではありません。

プライベート接続エンドポイントのプロビジョニングを含む、送信ネットワークトラフィックのプライベート接続を有効にするには、Snowflake Open Catalogアカウントの エディション がBusiness Criticalである必要があります。

解決策

Open CatalogアカウントのBusiness Criticalへのアップグレードについては、 Snowflakeサポート までご連絡ください。