Snowflake Data Clean Rooms: インストールされたオブジェクト¶
このトピックでは、クリーンルーム環境をインストールする際にアカウントに作成されるオブジェクトに関する情報を提供します。
アプリケーションパッケージ¶
Snowflake Data Clean Rooms は以下のアプリケーションパッケージをインストールします。
SAMOOHA_CLEANROOM_cleanroom name
プロバイダーアカウントは、作成されたクリーンルームごとに1つのアプリケーションパッケージを持ちます。これは、プロバイダーによって作成されたクリーンルームのすべてのコアアプリケーションロジックを含んでいます。また、クリーンルームとデータを共有するために使用される安全なビューと、クリーンルームの状態を保存するいくつかのテーブルも含まれています。これらには、コンシューマーの現在の差分プライバシー予算、列と結合のポリシー、クリーンルームにリンクされたテーブルの名前を記録したテーブルが含まれます。
データベース¶
SAMOOHA_BY_SNOWFLAKE¶
このデータベースには、クリーンルームの作成と管理に使用されるすべてのコア機能とアプリケーションロジックが含まれています。データベースには以下のスキーマがあります。
- ADMIN スキーマ
このスキーマには、以下のようなアプリレベルの詳細が含まれます。
適用されたパッチ(バージョン、コマンド)
バージョン情報(番号)
- APP_SCHEMA スキーマ
このスキーマには、クリーンルームのすべてのフローを円滑にするために必要な関数およびプロシージャが含まれています。主な内容は次のとおりです。
暗号化関数と復号関数。
クリーンルームの作成、インストール、およびクリーンルームを使用するために、開発者 APIs およびクリーンルーム UI で使用するクリーンルームのプロシージャ。
- TEMPLATES スキーマ
このスキーマには、Snowflakeが提供する SQL Jinjaテンプレートが含まれます。
これらの構築済みテンプレートは、 Snowflake Data Clean Rooms 内での安全なデータコラボレーションのために、すぐに使える SQL クエリを提供します。Jinjaのテンプレート機能を活用してカスタマイズすることで、特定のデータ共有シナリオに合わせてクエリを調整することができます。
SAMOOHA_BY_SNOWFLAKE_LOCAL_DB¶
このデータベースは、Snowflakeのインストールプロセス中にクリーンルーム UI によって作成されます。それはあなたのアカウントにローカルです。これはアプリケーションではありませんが、アプリケーションロジックを含んでいます。
このデータベースには2つの型のデータがあります。
あなたとクリーンルーム UI がクリーンルームの作成と管理に使用する開発者 APIs。
ID解決などのフロー中に PUBLIC スキーマに保存される、あなたが所有する中間データセット。例えば、LiveRamp の解像度とトランスコード処理からの出力テーブルは、PUBLIC スキーマに保存され、クリーンルーム UI によってクリーンルームにリンクされるビューに結合されます。
データベースには以下のスキーマがあります。
- ADMIN スキーマ
このスキーマは、アカウントに関連する特定のクリーンルーム機能を操作するために必要な情報を含みます。
クロスクラウド自動複製を利用して、リージョンやクラウドプラットフォームを超えたコラボレーションを実現します。
クリーンルームのメタデータ更新は、クリーンルームを開発者 APIs からクリーンルーム UI に登録するために必要です。
Snowflakeアカウントを使用したクリーンルーム UI の機能に関連する現在のプロシージャのバージョンアップ。
コラボレーターから共有されるクリーンルーム共有のセットの変更をリスニングし、変更に基づいて必要に応じてクリーンルームを有効/無効にするタスクとストリーム。
- CONSUMER スキーマ
このスキーマには、コンシューマー API プロシージャ といくつかの一般的なコンシューマーのタスクの定義が含まれています。
- ID_HUB スキーマ
このスキーマには、IDハブに関連するプロシージャおよび中間テーブルが含まれます。
- INFORMATION_SCHEMA スキーマ
他のSnowflakeデータベースと同様に、このデータベースには INFORMATION_SCHEMA スキーマ(「Data Dictionary」)が含まれます。このスキーマは、システム定義のビューとテーブル関数のセットで構成され、アカウントで作成されたオブジェクトに関する広範なメタデータ情報を提供します。
- LIBRARY スキーマ
このスキーマには、
library
名前空間 API プロシージャと、プロバイダーとコンシューマーの両方が使用するいくつかの一般的なタスクとプロシージャの定義が含まれています。- PROVIDER スキーマ
このスキーマには、プロバイダー API プロシージャ といくつかの一般的なプロバイダータスクの定義が含まれています。
- PUBLIC スキーマ
このスキーマには、あなたとクリーンルーム UI がクリーンルームの作成と管理に使用する開発者 APIs が含まれます。また、ID解決などのフロー中に PUBLIC スキーマに保存される、あなただけが所有する中間データセットも含まれます。例えば、LiveRamp の解像度とトランスコード処理からの出力テーブルは、PUBLIC スキーマに保存され、クリーンルーム UI によってクリーンルームにリンクされるビューに結合されます。
このスキーマには以下のテーブルがあります。
CLEANROOM_RECORD:このテーブルには、クリーンルームのステータス(作成済み、削除済み)、ユーザー、最終更新のタイムスタンプが含まれます。更新がクリーンルーム UI で行われた場合、ユーザーはサービスアカウントのユーザーとなります。更新が開発者 APIs を使用する Snowsight で行われた場合、ユーザーは API を呼び出した実際のユーザーです。クリーンルームのデータベース名は、このテーブルでカスタマイズできます。
CONNECTOR_CONFIGURATION: このテーブルは、アカウントに設定されているコネクタのリストです。
REPORTS:このテーブルには、クリーンルーム UI でコンシューマーが保存したレポートのリストが含まれます。標準レポートのトップレベルの結果はテーブルに保存されます。
HORIZONTAL_ANALYSIS_<report ID>: クリーンルーム UI で実行された SQL クエリテンプレートとカスタムテンプレートで実行された分析の出力。
CONSUMER_ACTIVATION_SUMMARY:コンシューマーのアクティベーション結果。
PROVIDER_ACTIVATION_SUMMARY:プロバイダーのアクティベーション結果。
このデータベースには、そこから作成される3つの共有があります。
SAMOOHA_INTERNAL_GOVERNANCE_SUMMARY SHARE_NAV2:この共有には PUBLIC スキーマ内の GOVERNACE_SUMMARY および ACTIVATION テーブルのビューが含まれます。これは、このアカウントによってインストールされたクリーンルームを作成したプロバイダーと共有され、ガバナンス情報とプロバイダーのアクティベーションを共有するために使用されます。
SAMOOHA_INTERNAL_LOGS_SHARE_NAV2:この共有は LOG_EVENTS テーブルにあり、サードパーティのネイティブアプリを使用しているため、主に ID 解決手順の進行状況に関するログをSnowflakeに共有するために使用されます。PII またはデータが共有されることはなく、トランスコード/解決に使用されたサードパーティアプリ APIs の成功/失敗のみが共有されます。
SAMOOHA_INTERNAL_PROVIDER_METADATA_NAV2:この共有は2つのテーブルにあります。ADMIN.METADATA_UPDATE_REQUESTS は、API から UI へ登録リクエストを送信するめに使用され、ADMIN.RESOURCE_MONITOR_USAGE は、管理アカウントが使用状況をログするためにのみ使用されます。
SAMOOHA_CLEANROOM_cleanroom ID
¶
各クリーンルームには、インストールされたテンプレート、リクエストログ、LAF ステータスなど、そのクリーンルームのすべての詳細を含む関連データベースがあります。このデータベースには、次のスキーマが含まれています。
管理者:暗号化キー、プライバシーバジェット、リクエストログ、プロバイダー分析リクエストなど。
共有スキーマ:結合ポリシー、LAF ステータス、リンクテーブル、バージョン。
テンプレート:このクリーンルームのアクティベーションテンプレート、カスタムテンプレート、テンプレートチェーンのリスト。
SAMOOHA_CLEANROOM_REQUESTS_clean room ID
¶
これはプロバイダー側のデータベースであり、コンシューマー側の共有です。これは、コンシューマーがクリーンルームをインストールするプロセスの一環として、コンシューマーからクリーンルームのプロバイダーに送り返される共有に相当します。このデータベースは、コンシューマーがクリーンルームに対して提起したすべてのリクエストに関する情報を含み、コンシューマーによる差分プライバシー予算の使用状況を追跡するために使用されます。
SAMOOHA_CLEANROOM_CONSUMER_clean room ID
¶
このデータベースはコンシューマーアカウントにのみインストールされます。コンシューマデータのクリーンルームへのセキュアビューや、コンシューマーの列/結合ポリシー(適用されている場合)などのオブジェクトを共有するために使用されます。以下のテーブルがあります。
SAMOOHA_CLEANROOM_CONSUMER_clean room ID.SHARED.REQUESTS
。このテーブルは、コンシューマーが実行しようとしたクエリを正確に示しています。PROPOSED_QUERY はコンシューマーのテンプレートからレンダリングされたクエリです。
SAMOOHA_SAMPLE_DATABASE¶
このデータベースには、クリーンルームで使用できるサンプルデータセットが含まれています。
タスク¶
あなたの環境内で実行されている可能性のあるクリーンルームで使用されるいくつかのタスクを紹介します。
次のプロシージャを実行すると、指定のタスクに関する詳細情報を確認できます。
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.DCR_HEALTH.DCR_TASKS_HEALTH_CHECK();
タスク名 |
説明 |
ウェアハウス |
エンティティレベル |
---|---|---|---|
|
アカウントで差分プライバシーが有効になっている場合に、コラボレーターからの受信共有をマウント、修復、検証します。DP が有効になっている場合に、分析の過剰実行を防ぐために、より高い頻度の同じタスクが追加されます。 デフォルトのスケジュール:1分。 |
サーバーレス |
アカウントごと |
|
コラボレーターからの受信共有をマウント、修復、検証します。 デフォルトのスケジュール:30分。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
作成されたクリーンルームのベースラインメトリクスを計算します。 デフォルトのスケジュール:3時間。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
結合されたクリーンルームのベースラインメトリクスを計算します。 デフォルトのスケジュール:3時間。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
各コンシューマーのアクティブ化のために受信共有をマウントします。 デフォルトのスケジュール:15分。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
各プロバイダーのクリーンルームの各テンプレートをスキャンし、プライバシーとセキュリティの問題を検出します。 デフォルトのスケジュール:30分。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
コンシューマーから送信されたアクティベーションデータを復号化します。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
自動実行レポートを設定します。 デフォルトのスケジュール:60分。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
新しいバージョンがリリースされると、ネイティブアプリを自動的にアップグレードします。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
SAMOOHA_TASK_WAREHOUSE |
アカウントごと |
|
自動実行に設定されたレポートを実行します。 デフォルトのスケジュール:1日。 |
ユーザーが選択したウェアハウス。 |
アカウントごと |
|
コンシューマーからプロバイダーにストリームバックされる戻りリクエストのリッスンをセットアップします。クリーンルームが有効になっているかどうかを判断します。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
SAMOOHA_TASK_WAREHOUSE |
コラボレーターごと |
|
クリーンルームの差分プライバシーバジェットを処理します。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
SAMOOHA_TASK_WAREHOUSE |
コラボレーターごと |
|
クリーンルーム用のテンプレートリクエストを処理します。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
SAMOOHA_TASK_WAREHOUSE |
コラボレーターごと |
PROCESS_PROVIDER_ANALYSIS_REQUESTS |
実際のプロバイダー分析を実行します。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
|
クリーンルームごと |
|
プロバイダー分析インフラストラクチャを設定し、プロバイダー分析のリクエストを処理します。 デフォルトのスケジュール:リクエストによってトリガーされました。 |
SAMOOHA_TASK_WAREHOUSE |
クリーンルームごと |
|
すべてのクリーンルームのプライバシーバジェットをリセットします。 デフォルトのスケジュール:1日。 |
SAMOOHA_TASK_WAREHOUSE |
クリーンルームごと |
|
クリーンルームにリンクされたデータセットの異なる値を計算し、フィルタードロップダウンを有効にします。 デフォルトのスケジュール:1日。 |
SAMOOHA_TASK_WAREHOUSE |
クリーンルームごと |
|
各ウェアハウスのスケジュールされたレポートを実行します。レポートで使用するウェアハウスを使用します。 デフォルトのスケジュール:1日。 |
DCR_WH_* |
クリーンルームレポートごと |
ウェアハウス¶
Snowflake Data Clean Rooms は以下のウェアハウスをアカウントにインストールします。必要に応じてウェアウェアハウスのサイズを変更できます。
ウェアハウス名 |
メモ |
---|---|
APP_WH |
XSMALL ウェアハウスは API にアクセスでき、新しいクリーンルームを設定し、権限とデータ共有を管理します。 |
DCR_WH_SMALL |
通常、 SMALL のウェアハウス |
DCR_WH_Medium |
通常、 MEDIUM のウェアハウス |
DCR_WH_Large |
通常、 LARGE のウェアハウス |
DCR_WH_XLarge |
通常、 XLARGE のウェアハウス |
DCR_WH_2XLARGE |
通常、 XXLARGE のウェアハウス |
DCR_WH_4XLarge |
通常、 X4LARGE のウェアハウス |
DCR_WH_OPT_XLarge |
Snowpark用に最適化された、 XLARGE のウェアハウス |
DCR_WH_OPT_2XLarge |
Snowpark用に最適化された、 XXLARGE のウェアハウス |
DCR_WH_OPT_4XLarge |
Snowpark用に最適化された、 X4LARGE のウェアハウス |
PROVIDER_RUN_<cleanroom_identifier> |
プロバイダーが実行する分析を実行するコンシューマーアカウントのウェアハウス。 |
SAMOOHA_TASK_WAREHOUSE |
XSMALL プライバシーやセキュリティスキャン、自動実行レポートの処理、データ統計の計算、コンシューマーのテンプレートリクエストの処理など、多くの用途に使用されるウェアハウス。 |
DCR_ACTIVATION_WAREHOUSE |
プロバイダーに送信されたアクティベーション結果の復号化に使用されます。デフォルトのサイズは XL です。ただし、 |