Azureの外部ボリュームを構成する¶

前提条件¶

外部ボリュームを構成する前に、以下のものが必要です。

• Azureストレージコンテナー。

  • 外部で管理されるIcebergテーブルに外部ボリュームを使用するには、すべてのテーブルデータとメタデータファイルをコンテナー内に配置する必要があります。

  • データ復旧をサポートするには、 外部クラウドストレージの場所のバージョン管理を有効にします。

• IAM ポリシーとロールを作成および管理するためのAzureにおける権限。Azure管理者でない場合は、Azure管理者にこれらのタスクを実行するよう依頼します。

Azureストレージファイアウォールを使用してストレージアカウントへの不正なトラフィックをブロックしている場合は、 Allow the VNet subnet IDs の説明に従って、SnowflakeにAzureストレージアカウントへのアクセスを明示的に許可してください。

SQL を使用して外部ボリュームを構成する¶

CREATE EXTERNAL VOLUME exvol
  STORAGE_LOCATIONS =
    (
      (
        NAME = 'my-azure-northeurope'
        STORAGE_PROVIDER = 'AZURE'
        STORAGE_BASE_URL = 'azure://exampleacct.blob.core.windows.net/my_container_northeurope/'
        AZURE_TENANT_ID = 'a123b4c5-1234-123a-a12b-1a23b45678c9'
      )
    );

SELECT SYSTEM$VERIFY_EXTERNAL_VOLUME('my_external_volume');

Error assuming AWS_ROLE:
STS is not activated in this region for account:<external volume id>. Your account administrator can activate STS in this region using the IAM Console.

Snowsight で外部ボリュームを構成する¶

1. Snowsight にサインインします。

2. 左下隅にある自身の名前 » Switch role を選択し、次に ACCOUNTADMIN または CREATE EXTERNAL VOLUME 権限を持つロールを選択します。

   詳細については、 プライマリロールの変更 をご参照ください。

3. ナビゲーションメニューで Catalog » External data を選択します。

4. External volumes タブを選択します。

5. + Create を選択します。

6. Select Microsoft Azure & OneLake and then select Next.

7. Prerequisites ページから、 Azure tenant ID に、Azureテナント ID を指定します。

   Azureテナント ID を見つけるには、Microsoft Entraドキュメント内の Microsoft Entraテナント ID を見つける方法 をご参照ください。

8. Next を選択します。

9. Grant storage access ページから、Snowflakeにストレージの場所へのアクセス権を付与するには、次のステップに従います。

   1. Snowflakeがお使いのAzureストレージまたはMicrosoft OneLake に接続することに同意するには、 Provide consent を選択します。

      Microsoftの権限リクエストページが、新しいブラウザのタブに開きます。

   2. Microsoftの権限リクエストページから、 Accept を選択します。このアクションは、Snowflakeアカウント用に作成されたAzureサービスプリンシパルが、テナント内の指定したリソースでアクセストークンを取得できるようにします。アクセストークンの取得が成功するのは、サービスプリンシパルにストレージアカウントレベルで適切な権限を付与した場合のみです（次のステップを参照）。

      Microsoftの権限リクエストページは、Snowflakeの企業サイト（snowflake.com）にリダイレクトされます。

   3. Snowflakeで、 Multi-tenant app name フィールドから、アカウント用に作成されたSnowflakeクライアントアプリケーションの名前をテキストエディターにコピーします。次のステップでは、このアプリケーションに許可されたストレージの場所でアクセストークンを取得するための権限を付与します。

10. 許可されたストレージの場所でアクセストークンを取得する権限をアプリケーションに付与するには、次のステップに従います。

    1. Microsoft Azureポータルにログインします。

    2. Azure Services » Storage Accounts に移動します。Snowflakeサービスプリンシパルがアクセスする必要があるストレージアカウント名を選択します。

       注釈

       外部ボリュームの IAM 権限はコンテナレベルではなく、ストレージアカウントレベルで設定する必要があります。

    3. Access Control (IAM) » Add role assignment を選択します。

    4. Storage Blob Data Contributor ロールを選択して、Snowflakeサービスプリンシパルに読み取りと書き込みのアクセスを許可します。

       注釈

       Storage Blob Data Contributor ロールは外部ボリュームの場所への書き込みアクセスを許可します。書き込みアクセスを完全に構成するには、外部ボリュームの ALLOW_WRITES パラメーターを TRUE （デフォルト値）に設定します。

    5. + Select members を選択します。

    6. Snowflakeサービスプリンシパルを検索します。

       これは、前のステップでSnowflakeからコピーした マルチテナントアプリ名 です。

       重要

       • このセクションのMicrosoftリクエストページでリクエストされたSnowflakeサービスプリンシパルをAzureが作成するのに、1時間以上かかる場合があります。サービスプリンシパルがすぐに利用できない場合は、1～2時間待ってから、もう一度検索してください。

       • サービスプリンシパルを削除すると、外部ボリュームは機能しなくなります。

       

    7. Review + assign を選択します。

       注釈

       ロールを割り当てると、変更が有効になるまで最大10分かかることがあります。詳細については、Microsoft Azureドキュメントの 症状 - ロールの割り当て変更が検出されない をご参照ください。

11. Snowflakeで、 Next を選択します。

12. Snowflakeで外部ボリュームを構成するには、 Configure external volume ページで次のフィールドに入力します。

    フィールド	説明
    External volume name	外部ボリュームの名前を入力します。
    Storage base URL	クラウドストレージの場所のベース URL を指定します。
    Access scope	外部ボリュームに対して書き込み操作を許可するかどうかを指定します。次のテーブルの場合 Allow writes に設定する必要があります。 Snowflakeをカタログとして使用するIcebergテーブル。 外部カタログを使用し、書き込み可能なIcebergテーブル。外部で管理されているIcebergテーブルは、 ALLOWED_WRITE_OPERATIONS パラメーターが TRUE に設定された、カタログにリンクされたデータベースを通じてアクセスすると書き込み可能です。 Deltaテーブルファイルから作成されたIcebergテーブルの場合、このパラメーターを Allow writes に設定すると、SnowflakeがIcebergメタデータを外部ストレージに書き込めるようになります。詳細については、 Deltaベーステーブル をご参照ください。 このパラメーターの値は、指定した各ストレージの場所のクラウドストレージアカウントに設定した権限と一致する必要があります。 注釈 外部管理Icebergテーブルの読み取りに外部ボリュームを使用する場合は、このフィールドをOffに設定します。外部Icebergカタログのテーブルを読み取る場合、SnowflakeはデータやIcebergメタデータファイルをクラウドストレージに書き込みません。
    Scope	この外部ボリュームを、将来のIcebergテーブルのデフォルト保存先として設定する場所を選んでください。可能な値は次のとおりです。 Do not set a default:外部ボリュームをどこでもデフォルトとして設定しないでください。 Account:アカウント全体の下で作成されるIcebergテーブルのデフォルトとして外部ボリュームを設定します。 Specific database:指定したデータベース下に作成されるIcebergテーブルのデフォルトとして外部ボリュームを設定します。このデータベースを指定するには、 Specific database を選択したときに表示される Database ドロップダウンを使用します。 Specific schema:指定したスキーマ下に作成されるIcebergテーブルのデフォルトとして外部ボリュームを設定します。このスキーマを指定するには、表示される Database ドロップダウンを使用して、最初にスキーマの親データベースを選択してからスキーマを選択します。
    Comment (optional)	外部ボリュームのコメントを指定します。
    Connectivity	セキュリティ体制を強化するためにアウトバウンドプライベート接続を使用するかどうかを指定します。アウトバウンドプライベート接続の使用に関する情報については、 Microsoft Azure の外部ボリュームへのプライベート接続 をご参照ください。可能な値は次のとおりです。 Public (default):公共のインターネットを使用します。 Private (Azure Private Endpoint):アウトバウンドプライベート接続を使用します。

13. Next を選択します。

    Verify connection & create volume ページでは、SnowflakeはAzureへの接続を確認し、「正常に接続されました」メッセージを表示します。

    注釈

    Snowflakeが接続を確認できない場合は、権限または外部ボリュームの構成を確認して、 Verify again を選択してください。

14. Create を選択します。

次のステップ¶

外部ボリュームを構成したら、Icebergテーブルを作成できます。

• 外部カタログを使用する読み取り専用のIcebergテーブルを作成するには、 カタログ統合の構成 をご参照ください。

• SnowflakeプラットフォームをフルサポートするIcebergテーブルを作成するには、 Snowflake管理のテーブルを作成する を参照してください。