Snowflake Data Clean Room 環境と一緒にインストールされるアイテム

このトピックは、 Snowflake Data Clean Room 環境をインストールし、コラボレーションを作成またはコラボレーションに参加する際に、アカウントに作成されるオブジェクトに関する情報を提供します。プロバイダーとコンシューマーのクリーンルームに関する情報については、 Snowflake Data Clean Rooms: インストールされたオブジェクト をご参照ください。

上位レベルの概要

次の図は、2者間によるコラボレーションを簡略化したものです。

2人の参加者とのコラボレーションの概要

図に関する注記:

この図は、Data Clean Rooms Collaboration API を使用してコラボレーションを作成および管理している2人のコラボレーターを示しています。

  • 図のコラボレーション定義 YAML に示されているように、コラボレーターAは所有者および作成者です。

  • 図のデータ提供共有で示されているように、コラボレーターAとBの両方がデータプロバイダーです。

  • コラボレーション定義が許可されている場合、コラボレーターAとBの両方が分析実行者として機能するようになります。

  • コラボレーターBは、コラボレーションにテンプレートを追加しました。

  • Secure Collaboration Orchestrator ( SCO )は、リージョン内のすべてのアカウントのコラボレーションを管理するために使用される専用のSnowflakeアカウントです。各リージョンに SCO があります。コラボレーションの SCO は、所有者のアカウントリージョンに基づいて決定されます。

  • 各コラボレーションについて、 SCO はリストとともにアプリパッケージを作成します。コラボレーターはこのリストから SFDCR_collaboration_name という名前のアプリケーションをインストールすると、コラボレーションへのアクセスが付与されます。

  • コラボレーターは、ローカル SAMOOHA_BY_SNOWFLAKE_LOCAL_DB で DCR コラボレーション API を使用してコラボレーションを操作します。

コラボレーターはデータ提供を作成し、SCO はコラボレーション定義に従ってそのデータをコラボレーターと共有します。SCO は、コラボレーション、データ提供、テンプレート、および分析の仕様を使用して、どのテンプレートを使用して誰がどのデータにアクセスできるか、どのデータを誰がアクティブ化できるか、自由形式の SQL アクセスが提供されるかどうかなどのコラボレーションポリシーを適用します。

アプリケーション

Snowflake Data Clean Rooms 環境をインストール、またはコラボレーションへ参加すると、次のアプリケーションがインストールされます。

データクリーンルームネイティブアプリケーション SAMOOHA_BY_SNOWFLAKE

Snowflake Data Clean Rooms 環境のインストール中にインストールされるアプリケーション。各アカウントには、Snowflake Data Clean Rooms Marketplaceリストからこのブートストラップアプリケーションがインストールされています。ローカル DB で使用されるライブラリプロシージャ、委任ロール、ヘルパー関数を提供し、ローカル DB とクリーンルームのオブジェクトを操作します。

コラボレーションアプリケーション SFDCR_collaboration_name

アカウントが参加するコラボレーションごとにインストールされるアプリケーション。インストールアカウントに絞り込まれたセキュアビュー( DATA_OFFERINGS 、 TEMPLATE_SPECS 、 CODE_SPECS など)を持つ COLLABORATION スキーマと、結合、実行、終了操作を処理するためのストアドプロシージャを持つ COLLABORATION_INTERNAL スキーマを提供します。クリーンルームのローカル DB に書き込み、 SCO にメッセージを送り返します。

データベース

Snowflake Data Clean Rooms 環境をインストール、またはコラボレーションへ参加すると、次のデータベースが作成されます。

SFDCR_LOCAL_collaboration_name

アクティブ化されたデータ、ローカルのみのデータのビューなど、インストールされたコラボレーションのローカル情報が含まれます。

SAMOOHA_BY_SNOWFLAKE_LOCAL_DB

このデータベースは、アカウントにSnowflake Data Clean Rooms環境をインストールすると作成されます。それはあなたのアカウントにローカルです。これはアプリケーションではありませんが、アプリケーションロジックを含んでいます。

データベースには以下のスキーマがあります。

ADMIN スキーマ

権限管理、バージョン情報、外部テーブル分析の有効化などを含む管理機能のためのローカル DB のスキーマ。

COLLABORATION スキーマ

コラボレーションのクリーンルーム機能のためのローカル DB のメインスキーマ。メッセージ処理のためのタスク、ストリーム、およびプロシージャが含まれます。

REGISTRY スキーマ

登録されたテンプレート、データ提供、コード仕様、オブジェクトからレジストリへのマッピングテーブルを格納します。

registry_name_REGISTRY スキーマ

カスタムレジストリの作成時に作成されるスキーマ。たとえば、 sales_data という名前のカスタムを作成した場合、システムは sales_data_registry というスキーマを作成します。

共有とリスト

以下は、コラボレーションで定義されたロールに応じて、コラボレーションごとに関係し、作成される共有とリストです。

オブジェクト名/形式

説明

SFDCR: SCO collaboration_id

受信リスト

作成する、または招待されるすべてのコラボレーションの SCO によって共有されるリスト。

SCO_DATA_OFFERINGS_LISTING_hash

送信リスト

データプロバイダーからコラボレーターに共有されるデータ提供のリスト名。

SCO_ACTIVATION_LISTING_hash

送信リスト

分析実行者が別のコラボレーターに共有するアクティベーション結果のリスト名。

SCO_STAGED_CODE_LISTING_hash

送信リスト

コード実行のために、コードプロバイダーから分析実行者に共有されるステージングされたコードのリスト名。

SCO_DATA_OFFERINGS_SHARE_hash

送信共有

データプロバイダーがデータ提供(データセット、ポリシー)をコラボレーターに共有するために作成した共有。

SCO_ACTIVATION_SHARE_hash

送信共有

アクティベーション結果を別のコラボレーターと共有するために、分析実行者が作成した共有。

SCO_STAGED_CODE_SHARE_hash

送信共有

コードプロバイダーがコード実行のために分析実行者に作成した共有。

タスク

以下は、新しいSnowflake Data Clean Rooms環境の運用に関連するタスクです。従来のプロバイダーおよびコンシューマーのクリーンルームに関連するタスクについては、 Snowflake Data Clean Rooms: インストールされたオブジェクト をご参照ください。

タスク名

説明

ウェアハウス

EXPECTED_VERSION_TASK

新しいバージョンがリリースされると、ネイティブアプリとローカルDBを自動的にアップグレードします。

頻度:リクエストによってトリガーされました。

SAMOOHA_TASK_WAREHOUSE

collaboration_name_hash_OWNER_AUTO_JOIN

所有者が開始するコラボレーションに自動参加するために有効化したタスク。

頻度:1分ごと。1時間後に一時停止します。

ユーザー指定のウェアハウス

サンプルデータ

サンプルデータは SAMOOHA_SAMPLE_DATABASE データベースに保存されます。このデータベースには、テストデータとして使用できる DEMO.CUSTOMERS および DEMO.CUSTOMERS_2という名前のサンプルデータテーブルが含まれています。

注釈

CUSTOMERS_2テーブルは2025年9月に追加されました。それ以前にクリーンルーム環境をインストールした場合、このサンプルテーブルはインストールされていない可能性があります。CUSTOMERS_2がインストールされているかどうかを確認するために、以下の SQL コードを実行できます。

SHOW TABLES LIKE 'CUSTOMERS_2' IN SCHEMA SAMOOHA_SAMPLE_DATABASE.DEMO;

応答に行が含まれていない場合は、あなた、または ACCOUNTADMIN ロールを持つ誰かが、次のコマンドを実行してサンプルテーブルをインストールする必要があります。

USE ROLE ACCOUNTADMIN;
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

ウェアハウス

Snowflake Data Clean Rooms は以下のウェアハウスをアカウントにインストールします。必要に応じてウェアハウスのサイズを変更できます。一般的なクリーンルームの編集、作成、または削除コマンドのためには、XSウェアハウスを使用することをお勧めします。機械学習ワークロードなどの大規模な分析を実行する場合は、より大きなウェアハウス、またはSnowparkに最適化されたウェアハウスの使用を検討してください。

ウェアハウスの使用コストを表示する方法を学びます。

ウェアハウス名

メモ

APP_WH

デフォルトで SAMOOHA_APP_ROLE へのアクセスが提供される XSMALL ウェアハウス。

SAMOOHA_TASK_WAREHOUSE

自動アップグレードなどの操作に使用される XSMALL ウェアハウス。