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サポートにお問い合わせください。