Snowflake Data Clean Rooms 環境のインストール¶

アカウントおよびユーザーの要件¶

Snowflakeアカウントに Snowflake Data Clean Rooms をインストールするための要件は以下のとおりです：

• アカウントは、必要な Snowflake Edition である必要があります。

  • clean roomを作成するには、Enterprise Editionまたはそれ以上が必要です。

  • 他のアカウントで作成されたclean roomに参加して使用 するには、Standard Editionまたはそれ以上が必要です。

• リーダーアカウントはサポートされていません。リーダーアカウントでは、クリーンルームアプリケーションのインストールと実行に必要なデータ共有が許可されないためです。

• アカウントが キーペア認証 を許可し、それを認証のサービスプロバイダーが使用する必要があります。

• データ共有条件に同意する必要があります。 Snowflakeお客様管理データシェア機能利用規約 に同意されていない場合は、 Snowflake サポート までご連絡ください。Snowflake Data Clean Roomsで使用する リスト は、Snowflakeサービスの一部であり、Snowflakeの利用規約（Snowflakeお客様管理データ共有機能利用規約や Snowflakeで認められる使用のポリシー）が適用されます。

• アカウントレベルのデフォルト 照合順序 を定義しないでください。照合順序の状態は、以下のコマンドで確認できます： SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

• (Clean room UI のみ) Snowflakeアカウントは容量アカウントである必要があります。 容量アカウントは、前もって容量を約束するアカウントを言います。Snowflake On-Demandアカウントでは、clean room UI にアクセスできません。

• (Clean room UI のみ) 多要素認証 (MFA) を、 サポート対象の認証アプリ で使用する必要があります。

これらの要件をすべて満たしておらず、アップグレードが必要な場合は、 Snowflakeサポート までご連絡ください。

インストールの際のユーザー要件¶

clean room環境をインストールするユーザーには、次の要件があります：

• clean room環境をSnowflakeアカウントにインストールするために、 ACCOUNTADMIN ロールがそのアカウントに必要です。

• ACCOUNTADMINロールを持つユーザーは、そのユーザーオブジェクトに有効な姓、名、メールが定義されている必要があります。確認するには、 DESCRIBE USER を実行してください。

1.ネイティブアプリケーションのインストール¶

Marketplace からネイティブアプリケーションをインストールします。

1. 現在のロールを ACCOUNTADMIN にセットします

2. Snowflake Data Clean Roomsアプリケーション をSnowflake Marketplaceからインストールします。

3. Get を選択し、デフォルトオプションを受け入れます。

インストールには数分かかります。

2. クリーンルーム API のインストール¶

クリーンルーム API は、クリーンルームのプログラムによる作成と使用に使用されます。

Snowflake アカウントでクリーンルーム API をインストールするステップは次のとおりです。

1. ネイティブアプリケーションをインストールした後、Snowflakeでそれを起動します： Data products » Apps » Snowflake Data Clean Rooms » Launch app。SQL コマンドを含むワークシートが開きます。

2. クリーンルーム API をインストールするために、SQL コマンドを実行します。注意事項は次のとおりです。

   • インストール中にネイティブアプリケーションの名前を変更した場合は、スクリプトのコメントに示されているように、スクリプトを修正する必要があります。

   • インストールスクリプトの実行前に全体を確認したい場合は、 DRY_RUN=TRUE のスクリプト行のコメントを解除し、すべてのコマンドを実行すると、スクリプトの内容が表示されます。ここで表示される インストールスクリプトを手動で実行しないでください。 インストールが途中で終了します。

   • インストールには数分かかります。

3. APIにアクセスできることを確認してください：

   USE ROLE samooha_app_role;
   USE WAREHOUSE app_wh;
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();
   

   Copy

   FALSE と表示された場合は、以下のトラブルシューティングのセクションを参照してください。

4. Snowflakeアカウントの他のユーザーに API へのアクセス許可を付与します：

   • clean roomを作成・管理のための フルアクセス を持つユーザーを追加するには、 GRANT ROLE SAMOOHA_APP_ROLE to USER USER を実行します。

   • コンシューマーの実行アクセスのみ が許可されたユーザーを追加するには、1つ以上のSnowflakeロールを作成し、このロールへのアクセス許可をユーザーに付与します。その後、 consumer.grant_run_on_cleanrooms_to_role を呼び出すことで、特定のclean roomの実行アクセスを許可します。

5. (オプション) clean room UI をインストールして、clean roomへのノーコードアクセスやスケジュールクエリなどの機能を有効にします。

3.clean room UI を有効にする¶

クリーンルーム UI は、クリーンルームアカウントを管理し、クリーンルームを作成して分析を実行するための簡単なノーコード環境を提供します。また、一部の 追加機能 はクリーンルーム API では利用できません (スケジュールされたクエリ、サードパーティのアクティベーション、便利な定義済みテンプレートなど)。

Snowflakeアカウントでclean room UI を有効にするには、以下の手順に従います：

1. ネットワークポリシーを構成して clean room UI からSnowflake アカウントへのアクセスを許可します。(Snowflakeアカウントでネットワークポリシーを使用してネットワークトラフィックを制御する場合のみ必要です。)

2. UI セットアップを完了します。 このステップでは、クリーンルーム UI が Snowflake と通信するために使用するサービスユーザー [*] を構成します。

   1. Snowflakeの認証情報で clean room UI にサインインします。

   2. Admin » Snowflake Admin » Connect to Snowflake account を開きます。

   3. Enable the Data Clean Rooms UI の下で、Quick Setup または Manual Setup を選択します。

      • Quick Setup - これにより、サービスユーザーが作成されます。このアカウントの一意のサービスユーザー名を指定します。

      • Manual Setup - サービスユーザーを自分で作成する場合、または既存のサービスユーザーを再利用する場合は、このオプションを選択します。クリーンルームはサービスユーザーを管理して変更するので、サービスユーザーが他の何かに使用されないように注意してください。サービスユーザーの作成方法についての詳細。

   4. 一意のサービスユーザー名を入力して、Finish を選択します。

3. 次のセクションに記載するように、**クリーンルーム環境を構成します*。