Snowflake Data Clean Rooms 開発者ガイド¶

開発ツール¶

clean room用の主な開発ツールを以下に示します：

• コーディング環境： Snowflakeアカウントでストアドプロシージャを実行できる環境であれば、どのようなコーディング環境でもかまいません。ほとんどの開発者は、Snowsight（ブラウザベースのツール）または Snowflake CLI を使用しています。

• clean room UI: clean room UI を使用して、clean roomの構成、管理、作成を行います。ほとんどのclean roomアナリストは、コードではなく UI を使用しています。したがって、 UI でclean roomの使用感を確認し、テストすることをお勧めします。また、 clean room UI でのみ使用できる機能 もいくつかあります。

• Snowsight は、データベースやその他のオブジェクトを探索したり、検索したりするのに便利です。

コーディング設定¶

-- Set up environment.
USE ROLE samooha_app_role;
USE WAREHOUSE app_wh;

-- Call your clean rooms API functions.
...

GRANT USAGE ON WAREHOUSE <your warehouse> TO SAMOOHA_APP_ROLE;`

アカウント、ユーザー、ロールのセットアップ¶

クリーンルームを開発するためにクリーンルーム UI を使用する必要はありません。ほとんどのクリーンルームの機能は、ストアドプロシージャを使用して利用可能です。ただし、いくつかの機能は :ref:` UI でのみ利用可能<label-dcr_web_app_api_comparison>` であり、UI で実行するほうが速いものもあります。また、多くのユーザーが排他的に UI を使用するため、特に、作成したクリーンルームのユーザー構成ウェブフォームを作成する場合は、クリーンルームが UI 内でどのように動作するかを確認することが重要です。したがって、クリーンルーム管理者に、適切なクリーンルームアカウントのクリーンルーム管理者以上として追加してもらうことを依頼する必要があります。

ユースケースに応じて、異なるウェブホスティング地域に追加のSnowflakeアカウントを設定し、 クロスクラウドの動作 をテストしてもよいかもしれません。

テスト用のSnowflakeアカウントには、"コンシューマーアカウント"、"プロバイダーアカウント"、"クロスクラウドアカウント"など、目的をわかりやすく示す名前を付けてください。そうすれば、複数のテストアカウントがある場合に、どのアカウントにサインインすればよいかがすぐにわかります。

clean room UI とコードで同じアカウントを使用していることを確認する¶

同じSnowflakeアカウントでコーディング環境とclean room UI を開くことも少なくありません（たとえば、コードでclean roomを作成し、その表示をclean room UI で確認する場合など）。その場合は、同じSnowflakeアカウントをそれぞれに使用しているかを確認することが重要です。

Snowsightには、同じアカウントでclean room UI を開くためのメニューはなく、その逆も同様であるため、clean room UI とSnowsightが同じアカウントで開いていることを確認する必要があります。

Clean roomの名前とclean roomの ID¶

API を使用する場合、プロシージャに cleanroom_name 引数を使用し、clean roomの名前と ID のどちらを使用するかを定義する必要があります：

• API を使用してclean roomを作成した場合は、clean roomの 名前 を使用します。

• クリーンルームがクリーンルーム UI 内に作成された場合はクリーンルーム**ID**を使用します。provider.view_cleanrooms または provider.describe_cleanroom を呼び出すと、クリーンルーム名と ID の両方を見ることができます。

clean roomの変更時に更新する¶

clean roomの設定（テンプレート、権限、ポリシーなど）を変更し、それを有効にするには、 provider.create_or_update_cleanroom_listing を呼び出します。場合によっては、このプロシージャを呼び出さなくても、変更されたように見える場合がありますが、 provider.create_or_update_cleanroom_listing を呼び出すまで変更が正しく適用されません。

コードまたは UI で作成されたclean roomの相互運用性¶

API でclean roomを作成すると、一部の機能をclean room UI で変更できなくなります。例えば、 UIで作成したclean roomのコードにテンプレートを追加することは（Snowflakeのストックテンプレートであっても）できません。また、差分プライバシー設定も変更できません。

コンシューマーは、結合済みクリーンルームで結合ポリシーを設定したり、他の基本的なアクションを実行したりすることはできません。¶

clean roomが適切なロール (SAMOOHA_APP_ROLE) でインストールされたことを確認してください。clean roomをインストールする際に SAMOOHA_APP_ROLE を使用していない場合、アクセス許可のエラーをはじめとする多くの問題が発生します。そのの場合は consumer.uninstall_cleanroom までもがエラーになり、clean roomをアンインストールしてから正しいロールで再インストールするという面倒な手間が必要になります。

-- Who owns the clean room?
SHOW SHARES LIKE 'SAMOOHA_CLEANROOM_REQUESTS_<cleanroom_name>';

-- If the owner role is not SAMOOHA_APP_ROLE, you must drop the share, then
-- uninstall the clean room.
DROP SHARE SAMOOHA_CLEANROOM_REQUESTS_<cleanroom_name>;
CALL samooha_by_snowflake_local_db.consumer.uninstall_cleanroom($cleanroom_name);
USE ROLE samooha_app_role;
CALL samooha_by_snowflake_local_db.consumer.install_cleanroom($cleanroom_name, '<provider_locator>');

自分で作ったclean roomが見つからない¶

アカウントでclean roomを作成したのに、コラボレーターのアカウントで表示されない場合、以下の理由が考えられます：

• clean roomが別のクラウドホスティングリージョンで作成され、 クロスクラウド自動フルフィルメント を有効にしていない。

• provider.create_or_update_cleanroom_listing を呼び出してclean roomを公開していない。

• provider.view_cleanrooms() ではなく、 consumer.view_cleanrooms() を呼び出している（またはその逆）。

• clean roomを共有していないか、間違ったアカウントでclean roomを共有しているか、またはSnowsight/Clean roomの UI/CLI を間違ったコラボレーターアカウントで開いている。clean roomが表示されるアカウントが、clean roomを共有したアカウントであり、その共有アカウントでサインインしたことを確認してください。

• clean roomを公開した後、それがコラボレーターに表示されるまで多少時間がかかります。

不明な関数¶

プロシージャを呼び出して、次のスニペットのようなエラーが発生した場合。

Unknown user-defined function SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.CONSUMER.<procedure name>

考えられる原因はいくつかあります。

間違った名前空間を入力してしまった。

プロシージャのバージョン（ consumer または provider ）を正しく判断して呼び出してください。多くのプロシージャには、プロバイダーとコンシューマーの両方のバージョンがあります。

関数の名前を誤入力してしまった。

適切な名前については、リファレンスガイドを確認してください。

制限付きアクセス実行ロールが付与されていますが、呼び出した関数はあなたのロールで許可されていません。

次の SQL コードを実行してこれをテストします。

USE DATABASE samooha_by_snowflake_local_db;
CALL IS_DATABASE_ROLE_IN_SESSION('samooha_run_role');

Copy

コードスニペットが TRUE を返す場合、クリーンルーム API での制限付きアクセス 実行ロール 権限があります。より広範囲なアクセスが必要な場合は、クリーンルーム管理者にフルアクセスを依頼してください。許可された実行ロールプロシージャのリストは、consumer.grant_run_on_cleanrooms_to_role ドキュメント をご参照ください。

SAMOOHA_APP_ROLE がない

SAMOOHA_APP_ROLE が使用できるかどうかを確認するには、次のコマンドを実行します。

-- Get current user name.
SELECT current_user();

-- Add current user name in place as indicated.
SHOW GRANTS TO USER <current_user_name> ->> select * from $1 where "role" = 'SAMOOHA_APP_ROLE';

Copy

結果が得られない場合は、管理者に API クリーンルームへのアクセス付与を依頼してください。

ユーザーがクリーンルームをインストールしているかどうかを確認する¶

指定したユーザーが指定したクリーンルームをインストールしているかどうかは、以下の SQL コードを実行することで確認できます。$consumer_locator および $cleanroom_name をコンシューマーロケーターとクリーンルーム名に置き換えます。

SELECT * FROM snowflake.data_sharing_usage.application_state
  WHERE consumer_account_locator = $consumer_locator
    AND CONTAINS(package_name, UPPER(REPLACE($cleanroom_name, ' ', '_')));

クエリや分析履歴の確認¶

UI またはコードで実行した分析のクエリ履歴を確認できます。これらの履歴は個別に保存され、チェックされます。