Snowflake Data Clean Rooms 入門¶

前提条件¶

Snowflake Data Clean Room を使用するには、次のようなアカウントが必要です。

• 容量アカウントである。

• 必要なSnowflakeエディション を持っている。

• プロバイダー& コンシューマー規約 に同意している。

特定の要件を満たさず、アップグレードが必要な場合は、 Snowflakeサポート までご連絡ください。

Snowflake Data Clean Room 環境にサインアップします。¶

クリーンルーム環境にサインアップし、ログインするには：

1. サインアップページ にアクセスしてください。

2. Snowflakeアカウントのアカウント識別子を、 アカウント名形式 のハイフン付き形式（つまり、 orgname-acctname）で入力します。

3. メールアドレスを入力します。

4. 会社名を指定します。これは、ユーザーがサインインするときにクリーンルーム環境を識別するために使用されます。

5. Sign Up を選択します。メールが送信されます。

メール受信後、以下の操作を行ってください：

1. Verify Email を選択します。サインアップページが再度開きます。

2. Name と Password を指定します。

3. Sign up を選択します。

4. 新しいページにリダイレクトされたら、 クリーンルーム環境にサインイン します。

IPアドレスを許可リストに追加する¶

Snowflakeアカウントが ネットワークポリシー を使用してネットワークトラフィックを制御する場合、WebアプリがSnowflakeアカウントとの通信に使用する IP アドレスからのトラフィックを明示的に許可する必要があります。

以下を使用して、Amazon Web Service（AWS）、Microsoft Azure（Azure）、またはGoogle Cloud上のSnowflakeアカウントのリージョンに基づいて、ネットワークポリシーで許可する必要がある IP アドレスを決定します。

Snowflakeアカウントを設定する¶

ACCOUNTADMINロールを持つSnowflakeユーザーは、ユーザーがクリーンルームを作成して使用する前に、クリーンルーム環境に関連付けられたSnowflakeアカウントを設定する必要があります。

Snowflakeアカウントを設定する際に、以下の一般的なタスクを実行します。

• クリーンルームがSnowflakeアカウントにアクセスできるように、クリーンルーム環境を表すサービスアカウントユーザーを作成します。

• クリーンルームがSnowflakeアカウントのデータとやり取りできるようにするための Snowflake Native App をインストールします。

• クリーンルーム内でコラボレーションがアクセスできるデータを含むデータベースを登録します。

これらのタスクを完了するには、次のステップを実行します。

1. クリーンルーム環境で Snowflake Admin コンソールにアクセスします。次の操作を実行します。

   1. Snowflake Data Clean Roomsのログインページ に移動します。

   2. メールアドレスを入力し、 Continue を選択します。

   3. パスワードを入力してください。

   4. 複数のクリーンルーム環境に関連している場合は、設定するSnowflakeアカウントを選択します。

   5. 左側のナビゲーションで Snowflake Admin を選択します。

   6. Login to Snowflake を選択し、ACCOUNTADMIN ロールを持つSnowflakeユーザーとして認証します。

2. クリーンルームがSnowflakeとやり取りするために使用するサービスアカウントユーザーの詳細を指定します。次のステップで必要になりますので、これらの詳細は必ず覚えておいてください。実装後、Snowflakeはサービスアカウントユーザーの認証に、ユーザー名/パスワードではなく、キーペア認証を使用することに注意してください。次の操作を実行します。

   1. サービスアカウントユーザーに関連付けられているメールアドレスを入力してください。

   2. New Snowflake Username フィールドに、Snowflakeアカウントに固有の名前を指定します。

   3. パスワードを指定します。

   4. Create をクリックしてサービスアカウントを作成します。

3. 新しいサービスアカウントユーザーのメールを確認します。次の操作を実行します。

   1. Log into your Snowflake account を選択します。

   2. サービスアカウントユーザーの認証情報を使用して、 Snowsight にサインインします。前のステップで指定しました。プロンプトが表示された場合は、多要素認証（MFA）に 登録しないでください。

   3. ユーザーメニュー を開くには、サービスアカウントユーザーのユーザー名を選択し、 My profile を選択します。

   4. Resend verification email を選択します。サービスアカウントユーザーのメールアドレスに認証メールが送信されます。

   5. サービスアカウントユーザーのメール受信箱にアクセスし、認証メールを開き、 Validate Your Email を選択します。

   6. クリーンルーム環境の Snowflake Admin コンソールに戻り、 Verify Status を選択します。

4. Snowflake Data Clean Rooms （SAMOOHA_BY_SNOWFLAKE）に関連する Snowflake Native App をインストールするには、次のステップに従います。

   1. オプション: Setup Scripts セクションを使用して、 Snowflake Native App をインストールするためにアカウントで実行されるコードを確認してください。このコードを手動で 実行しないでください。

   2. アプリケーションのデフォルト名は変更しないでください。

   3. Snowflake Native App をインストールするには Install を選択します。

      Snowflake Native App のインストールには時間がかかります。次のステップに進む前に、定期的に Refresh を選択し、完了しているかどうかを確認します。

5. Database Registration セクションで、クリーンルームでコラボレーターがアクセスできるようにするデータを含むデータベースを選択します。データベースまたはスキーマを登録すると、そのデータベースまたはスキーマ内のすべてのオブジェクトが登録されます。

   Snowflake Data Clean Rooms のウェブアプリは以下のオブジェクトをサポートしています。

   • テーブル

   • 外部テーブル

   • Apache Iceberg™ テーブル

   • ビュー

   • マテリアライズドビュー

   • セキュアビュー。さらに、セキュアビューの所有者は SAMOOHA_APP_ROLE ロールでなければなりません。

   注釈

   これらのステップを完了すると、登録されたデータベースに追加された新しいオブジェクトは、クリーンルームのコラボレーターがすぐに利用できるようになるわけではありません。オブジェクトが追加された場合、ウェブアプリの Snowflake Admin オプションを使って Database Registration セクションに戻り、 Resync を選択する必要があります。

Snowflake Data Clean Rooms を使用する際にSnowflakeアカウントにインストールされるものについては、 Snowflake Data Clean Rooms: インストールの詳細 をご参照ください。

キーペア認証を許可する¶

クリーンルーム環境がSnowflakeアカウントとの通信に使用するサービスアカウントユーザーは、 キーペア認証 を使用して認証します。Snowflake アカウントが 認証ポリシー を使用してユーザーの認証方法を制御している場合、サービスアカウントユーザーを制御する認証ポリシーは、キーペア認証を許可する必要があります。

キーペア認証を許可するには、認証ポリシーを AUTHENTICATION_METHODS = ALL または AUTHENTICATION_METHODS = KEYPAIR で作成する必要があります。Snowflakeアカウントに、キーペア認証を許可しないアカウントレベルの認証ポリシーがある場合は、適切なパラメーターを持つ新しい認証ポリシーを作成し、インストールプロセス中に作成されたサービスアカウントユーザーにポリシーを割り当てる必要があります。

異なるリージョンでコンシューマーとのコラボレーションを有効にする¶

アカウントがお客様のアカウントと異なる地域にあるSnowflakeの顧客とコラボレーションを行うには、お客様のクリーンルーム環境で クロスクラウド自動複製 を有効にする必要があります。ACCOUNTADMIN ロールを持つSnowflakeユーザーは、クリーンルーム管理者が他のリージョンのアカウントをコラボレーターとして追加する 前 に、クロスクラウド自動複製を有効にする必要があります。

クリーンルーム環境を設定し、コラボレーターが別のリージョンにいることを許可するには：

1. Snowflake Data Clean Roomsのログインページ に移動します。

2. メールアドレスを入力し、 Continue を選択します。

3. パスワードを入力してください。

4. 複数のクリーンルーム環境に関連している場合は、設定するSnowflakeアカウントを選択します。

5. Admin » Snowflake Admin を選択します。

6. Login to Snowflake を選択し、ACCOUNTADMIN ロールを持つSnowflakeユーザーとして認証します。

7. Cross-Cloud Auto-Fulfillment を切り替えます。

トラブルシューティング¶

このセクションは、このトピックのステップを完了した後に発生する可能性のある問題のトラブルシューティングに使用します。

症状: 権限が不十分である

解決策: ウェブアプリに関連する IP アドレスがネットワークポリシーで許可されていることを確認してください。これらの IP アドレスのリストについては、 IPアドレスを許可リストに追加する をご参照ください。

症状: インストールは成功したが、ウェブアプリが正しく機能しない。

解決策#1: DESCRIBE USER コマンドを使用して、Snowflakeの設定に使用したSnowflakeユーザーが有効な姓、名、メールアドレスを持っていることを再確認します。これらのいずれかが欠けている場合は、 ALTER USER コマンドを実行して指定します。

解決策2: Snowflake Data Clean Rooms の Snowflake Native App をアンインストールしてから、再インストールします。

• アプリをアンインストールするには、 Snowflake Native Appのアンインストール をご参照ください。アプリケーションをデフォルトの名前でインストールした場合、その名前は SAMOOHA_BY_SNOWFLAKE となります。

• アプリを再インストールするには:

  1. ウェブアプリにサインインする。

  2. 左側のナビゲーションで Snowflake Admin を選択します。

  3. Login to Snowflake を選択し、ACCOUNTADMIN ロールを持つSnowflakeユーザーとして認証します。

  4. DESCRIBE USER コマンドを使用して、先ほど認証に使用した ACCOUNTADMIN ロールを持つSnowflakeユーザーの姓、名、およびメールアドレスが有効であることを確認します。これらのいずれかが欠けている場合は、 ALTER USER コマンドを実行して指定します。

  5. Snowflake Native App をインストールするには、 Install を選択します。

  6. インストール時に、アプリケーションのデフォルト名を受け入れます。

次のステップ¶

ユーザーやコラボレーターの追加など、クリーンルーム環境のセットアップに必要な追加手順については、 Snowflake Data Clean Rooms: 管理者のタスク をご参照ください。