Snowflake Data Clean Rooms の概要¶

clean room環境のインストール¶

Snowflake Data Clean Rooms 環境 は、Snowflakeアカウントの ACCOUNTADMIN 権限を持つユーザーによって、(ユーザーごと、またはclean roomごとではなく) Snowflake アカウント全体で 一度 インストールされます。

管理者は環境を構成する際に、clean roomの作成やクエリの実行を許可するユーザー、 API へのアクセスを許可するユーザー、clean roomへのコラボレーターの招待が許可されるアカウント、clean room作成者がclean roomにインポートできるデータ、このアカウントで作成されたclean roomからクエリ結果をエクスポートするために使用できるサードパーティサービス (もしあれば) を指定します。

お客様のアカウントにclean room環境がすでにインストールされている場合は、clean room管理者に問い合わせてアクセスを依頼してください。アカウントにclean room環境がインストールされていない場合は、 環境のインストール方法 をご覧ください。

環境のインストールと構成を行った後、clean room UI、 API、 またはその両方を使用する権限が、管理者によって他のSnowflakeユーザーに付与されます。

clean roomの作成¶

Snowflakeアカウント管理者は、Snowflakeアカウントのユーザーにclean roomの作成権限を付与します。clean roomを作る人は、そのclean roomの プロバイダー と呼ばれます。プロバイダーは、他のSnowflakeアカウントのユーザー (またはSnowflake以外のユーザー) とclean roomを構成し、共有することができます。clean roomを共有する人は、そのclean roomの コンシューマー と呼ばれます。

clean roomを作成した後、プロバイダーは (リンク) テーブルやビューをclean roomにインポートし、そのデータに対して実行可能なクエリ、そのデータ内で結合したり結果を表示したりできる列、結果に対して実行可能な処理を指定します。(後ほど、標準的なclean roomのバリエーションの作成について説明します)。

その後、プロバイダーはclean roomに参加するコンシューマーを招待し、自分のテーブルとビューをインポートして、プロバイダーが指定したクエリのいずれかを実行します。コンシューマーがclean roomに招待されるには、clean room管理者が事前に承認する必要があります。

clean roomへの参加¶

clean roomを作成および構成した後、プロバイダーは他のアカウントのユーザーに、clean roomへの招待を送信します。招待されたユーザーは、 コンシューマー または コラボレーター と呼ばれます。clean room UI を通して招待されたコンシューマーは、clean roomへの招待メールを受け取ります。Snowflakeユーザーがclean roomに招待されるには、clean room環境がインストールされている必要がありますが、 Snowflake以外のユーザー をclean roomに招待することもできます。clean roomの作成者がユーザーを招待するには、そのSnowflakeアカウントがclean room管理者によって許可リストに登録されている必要があります。

(clean room UI では、コンシューマーがclean roomの招待を受け入れることを、「参加する」とも「インストールする」とも言います。これは、clean roomが文字どおりコンシューマーのclean room環境にインストールされる必要があるからです)。

clean roomに参加した後、コンシューマーはclean roomのテンプレートに必要なデータをインポート (リンク) し、どの列に結合や投影を許可するかなど、データへのアクセス方法を指定し、テンプレート固有のフィルターやその他のパラメーターを入力して、テンプレートを実行します。コンシューマーは、必要に応じてテンプレートの繰り返し実行を指定できます。結果はブラウザで表示したり、ダウンロードしたりできます。プロバイダーがアクティベーションを有効にし、コンシューマーが承認した場合、コンシューマーは承認された場所 (自身のSnowflakeアカウント、またはプロバイダーが指定したサードパーティのアクティベーションコネクタ) に結果をエクスポートできます。

clean roomにインポートされたデータは、プロバイダーやコンシューマーのいずれの側からも、直接クエリしたり表示したりできませんが、clean room内のテンプレートからアクセスすることだけはできます。テンプレートとは、プロバイダーやコンシューマーがclean room内にインストールする SQL クエリのことです。clean room内で使用するには相手方の許可が必要です。

また、それぞれの側でアクセスルールを設定し、どの列の結合、投影、またはエクスポートを許可するか、どのテンプレートの実行をclean roomで許可するかなどを各自のデータに設定します。それぞれの側からいつでもclean roomのデータを削除できます。

デフォルトでは、clean roomでテンプレートを実行できるのはコンシューマーだけですが、プロバイダーは指定したテンプレートをclean roomで実行するようコンシューマーに依頼できます。

クエリの実行¶

すべてのclean roomには、1つ以上の テンプレート が設置されています。テンプレートは SQL クエリであり、テンプレートを実行するユーザーが入力するランタイムパラメーターを含めることができます。これらのパラメーターで、ユーザーは、クエリで使用するclean roomのテーブル、クエリで使用する列、 WHERE 句フィルターなどを指定します。clean roomで任意の SQL クエリを実行することはできず、 SQL クエリに評価されるテンプレートを作成し、そのテンプレートを実行する許可を相手側に求める必要があります。

Snowflakeには、ウェブアプリで使用する標準テンプレートがセットで用意されています。これらのテンプレートにより、オーディエンスの重複、オーディエンスのlookalike、在庫予測、および任意の SQL クエリなどの一般的なユースケースが可能になります。開発者は、clean roomで使用するカスタムテンプレートも作成できます。

テンプレートはclean room UI またはコードで実行できます。テンプレートの結果は表示またはダウンロードすることや、あるいは アクティベーション がそのclean roomで許可されていれば、プロバイダー、コンシューマー、および承認されたサードパーティと共有することもできます。

Clean roomのバリエーション¶

最も一般的なclean roomでは、上記で説明したように、プロバイダーがデータをインポートし、そのデータに対して実行できる1つ以上の特定のクエリと、その結果の共有方法を指定する場所です。また、コンシューマーが自分のデータをインポートし、結合されたデータに対して許可されたクエリを実行することもできます。ただし、プロバイダーは標準的なclean roomにさまざまなバリエーションを加えることができます：

• プロバイダーからコンシューマーデータに対して独自のクエリを実行できます。デフォルトでは、clean roomでクエリを実行できるのはコンシューマーだけです。clean roomが有効な場合、プロバイダーはコンシューマーに対して、clean room内で指定したクエリを実行する許可をリクエストできます。

• クエリ結果を、クエリを実行してるユーザーのSnowflakeアカウント、またはSnowflakeが承認したサードパーティアカウント (Meta Ads ManagerやThe Trade Deskなど) にエクスポート (アクティベート) できます。clean room外にデータをエクスポートするには、クエリするデータを共有しているすべての関係者の承認が必ず必要です。

• いずれかの側が カスタムなPythonコードを追加し、 それを実行中のクエリから呼び出すことができます。このコードは通常、クエリの実行中に何らかの方法でデータのフィルターや操作を行います。ファイルの保存、データのエクスポート、その他の操作の実行など、外部の操作を行うことはできません。

• クエリから 他のclean roomのデータにアクセス できますが、アクセスされるすべてのclean roomのプロバイダーの承認が必要です。

• 複数のクエリを連鎖させることができます。

プロバイダーとコンシューマーについて¶

Clean roomのコラボレーターは、特定のclean roomの プロバイダー または コンシューマー のどちらかに分類されます。プロバイダーはclean roomを作成するアカウントで、コンシューマーはclean roomを共有されるアカウントです。clean roomを作成したのと同じアカウント内のユーザーを、そのclean roomのコンシューマーとして招待することはできません。同じSnowflakeアカウント内のすべてのユーザーに、そのアカウント内の同じclean roomのロール (プロバイダーまたはコンシューマー) が割り当てられます。

プロバイダーであるかコンシューマーであるかは、Snowflakeのロールやその他の権限ではなく、常にclean roomを作成したのか、共有されたかによって決定します。

プロバイダーとコンシューマーのロールについて、以降で詳しく説明します。

Clean room UI¶

Snowflake Data Clean Roomは、ブラウザで管理および実行できます。clean room UI を使用し、プロバイダーまたはコンシューマーとしてclean roomを作成、管理、使用したり、管理アカウント、サードパーティコネクタ、 UI ユーザー向け機能など、さまざまなアカウントレベルの機能を構成したりできます。

権限とアクセス： clean room UI を使用するには、clean room管理者からアクセスを許可 される必要があります。

clean room UI にログインするたｍに、メールアドレス、名前、パスワードが必要です。メールアドレスはSnowflakeアカウントのメールアドレスと同じである必要はなく、clean room管理者が指定します。ユーザー名とパスワードは自分で決めます。

Snowflakeのウェブアプリケーションである Snowsight からclean room UI へのアクセスは、別の URL で行われます。その URL はアカウントごとに異なります。

clean room UI を使ってみたい方は、 clean room UI チュートリアル をお試しいただくか、 clean room UI の詳細をご覧ください。

API¶

Snowflakeには、clean roomを作成または実行するためのストアドプロシージャが多数用意されています。これらのプロシージャは、Snowsightノートブックやワークシート、またはSnowflakeアカウントでストアドプロシージャを実行できるその他のコマンドラインインターフェイスから呼び出すことができます。

これらのプロシージャにより、プロバイダーまたはコンシューマーとしてclean roomを作成、管理、使用するために必要な操作のほとんどを実行できます。API では管理者の操作は行えません。clean roomを管理するには、ウェブアプリを使用する必要があります。API のリファレンスドキュメントをお読みください。

権限とアクセス： API を使用するには、Snowflake アカウントのclean room管理者から samooha_app_roleを使用するためのアクセス許可 を付与される必要があります。

clean room API の説明をご覧になるか、 または API チュートリアル をお試しください。

Snowflakeアカウントにclean room環境がインストールされていない場合¶

以降では、clean room UI または API がアカウントにインストールされているかどうかを確認する方法を説明します：