Snowflake Data Clean Rooms: インストールの詳細¶
このトピックでは、クリーンルーム環境をインストールする際にアカウントに作成されるオブジェクトに関する情報を提供します。
Snowflake Native App¶
Snowflake Data Clean Rooms は Snowflake Native App をインストールします。
SAMOOHA_BY_SNOWFLAKE¶
この Snowflake Native App は、Snowflake Data Clean Roomsを駆動します。クリーンルームの作成と管理に使用されるすべてのコア機能とアプリケーションロジックが含まれています。
このアプリには以下のスキーマがあります。
ADMIN¶
このスキーマには、アプリケーションの管理に必要なテーブルやビューが含まれます。アプリケーションのバージョン、パッチ、デプロイメントを追跡するために使用できます。主な内容は次のとおりです。
バージョン情報(番号)
適用されたパッチ(バージョン、コマンド)
APP SCHEMA¶
このスキーマには、クリーンルームのすべてのフローを円滑にするために必要な関数およびプロシージャが含まれています。主な内容は次のとおりです。
暗号化関数と復号関数。
クリーンルームの作成、インストール、およびクリーンルームを使用するために、開発者 APIs およびウェブアプリで使用するクリーンルームのプロシージャ。
TEMPLATES¶
このスキーマには、 SQL Jinjaの標準テンプレートが含まれており、開発者 APIs、またはウェブアプリを使用して分析を実行することができます。
これらの構築済みテンプレートは、 Snowflake Data Clean Rooms 内での安全なデータコラボレーションのために、すぐに使える SQL クエリを提供します。Jinjaのテンプレート機能を活用してカスタマイズすることで、特定のデータ共有シナリオに合わせてクエリを調整することができます。
アプリケーションパッケージ¶
Snowflake Data Clean Rooms は以下のアプリケーションパッケージをインストールします。
SAMOOHA_CLEANROOM_*¶
このアプリケーションパッケージは、プロバイダーアカウントにのみインストールされます。これは、プロバイダーによって作成されたクリーンルームのすべてのコアアプリケーションロジックを含んでいます。また、クリーンルームとデータを共有するために使用される安全なビューと、クリーンルームの状態を保存するいくつかのテーブルも含まれています。これらには、コンシューマーの現在の差分プライバシー予算、列と結合のポリシー、クリーンルームにリンクされたテーブルの名前を記録したテーブルが含まれます。
データベース¶
Snowflake Data Clean Rooms は以下のデータベースをインストールします。
SAMOOHA_BY_SNOWFLAKE_LOCAL_DB¶
このデータベースは、Snowflakeのインストールプロセス中にWebアプリによって作成されます。それはあなたのアカウントにローカルです。これはアプリケーションではありませんが、アプリケーションロジックを含んでいます。
これには2つの要素があります。
あなたとウェブアプリがクリーンルームの作成と管理に使用する開発者 APIs。
ID解決などのフロー中に PUBLIC スキーマに保存される、あなただけが所有する中間データセット。例えば、 LiveRamp の解像度とトランスコード処理からの出力テーブルは、 PUBLIC スキーマに保存され、ウェブアプリによってクリーンルームにリンクされるビューに結合されます。
データベースには以下のスキーマがあります。
ADMIN¶
このスキーマは、アカウントに関連する特定のクリーンルーム機能を操作するために必要な情報を含みます。
クロスクラウド自動複製を利用して、リージョンやクラウドプラットフォームを超えたコラボレーションを実現します。
クリーンルームのメタデータ更新は、クリーンルームを開発者 APIs からウェブアプリに登録するために必要です。
Snowflakeアカウントを使用したウェブアプリの機能に関連する現在のプロシージャのバージョンアップ。
コラボレーターから共有されるクリーンルーム共有のセットの変更をリスニングし、変更に基づいて必要に応じてクリーンルームを有効/無効にするタスクとストリーム。
CONSUMER/CONSUMER_INIT¶
このスキーマには、クリーンルームのインストールや、アカウントに関連するコンシューマー機能などを操作するために必要なプロシージャが含まれています。
クロスクラウドの自動フルフィルメントのクリーンルームのリクエストに必要なクリーンルームのリスト詳細を共有。
結合/列ポリシーの使用とクリーンルームでのデータベース登録に関する機能。
クリーンルームのインストールと編集、分析の実行、追加されたテンプレートの表示をサポート。
ID_HUB¶
このスキーマには、IDハブに関連するプロシージャおよび中間テーブルが含まれます。
INFORMATION_SCHEMA¶
他のSnowflakeデータベースと同様に、このデータベースには INFORMATION_SCHEMA スキーマ(「Data Dictionary」)が含まれます。このスキーマは、システム定義のビューとテーブル関数のセットで構成され、アカウントで作成されたオブジェクトに関する広範なメタデータ情報を提供します。
LIBRARY¶
このスキーマには、クリーンルームコネクタを有効にするために必要な手続きや、プロバイダーとコンシューマーの両方に適用可能な以下のような機能が含まれています。
ID ハブと外部テーブルとの統合を容易にするAdsコネクタ手順の設定。
クロスクラウドの自動フルフィルメントの有効/無効を制御するデータベースプロシージャの登録。
パッチの適用、データベースの登録解除、クリーンルームの記録の更新。
PROVIDER¶
このスキーマは、アクティベーション(プロバイダーのアクティベーションを促進するためのストリームおよび手順)、保存された分析レポート、 Snowflake Data Clean Rooms アカウントに設定されたコネクタに関連するメタ情報、およびアカウントによって作成されたクリーンルーム記録に関連するデータまたは情報を含みます。
PUBLIC¶
このスキーマには、あなたとウェブアプリがクリーンルームの作成と管理に使用する開発者 APIs が含まれます。また、ID解決などのフロー中に PUBLIC スキーマに保存される、あなただけが所有する中間データセットも含まれます。例えば、 LiveRamp の解像度とトランスコード処理からの出力テーブルは、 PUBLIC スキーマに保存され、ウェブアプリによってクリーンルームにリンクされるビューに結合されます。
このスキーマには以下のテーブルがあります。
CLEANROOM_RECORD: このテーブルには、クリーンルームのステータス(作成済み、削除済み)、ユーザー、最終更新のタイムスタンプが含まれます。更新がウェブアプリで行われた場合、ユーザーはサービスアカウントのユーザーとなります。更新が開発者 APIs を使用して Snowsight で行われた場合、ユーザーは API を呼び出した実際のユーザーとなります。クリーンルームのデータベース名は、このテーブルでカスタマイズできます。
CONNECTOR_CONFIGURATION: このテーブルは、アカウントに設定されているコネクタのリストです。
REPORTS: このテーブルには、コンシューマーがウェブアプリに保存したレポートのリストが含まれます。標準レポートのトップレベルの結果はテーブルに保存されます。
HORIZONTAL_ANALYSIS_<report ID>: SQL クエリテンプレートとウェブアプリで実行されたカスタムテンプレートで実行された分析の出力。
データベースには、そこから作成される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 は、 APIs からウェブアプリ登録リクエストに使用され、 ADMIN.RESOURCE_MONITOR_USAGE は、管理されたアカウントによってのみ使用状況をログするために使用される。
SAMOOHA_CLEANROOM_REQUESTS_*¶
これはプロバイダー側のデータベースであり、コンシューマー側の共有です。これは、コンシューマーがクリーンルームをインストールするプロセスの一環として、コンシューマーからクリーンルームのプロバイダーに送り返される共有に相当します。このデータベースは、コンシューマーがクリーンルームに対して提起したすべてのリクエストに関する情報を含み、コンシューマーによる差分プライバシー予算の使用状況を追跡するために使用されます。
SAMOOHA_CLEANROOM_CONSUMER_*¶
このデータベースはコンシューマーアカウントにのみインストールされます。コンシューマデータのクリーンルームへのセキュアビューや、コンシューマーの列/結合ポリシー(適用されている場合)などのオブジェクトを共有するために使用されます。以下のテーブルがあります。
SAMOOHA_CLEANROOM_CONSUMER_<cleanroom>.SHARED.REQUESTS.このテーブルは、コンシューマーが実行しようとしたクエリ(コンシューマー SQL テンプレートの出力クエリとして PROPOSED_QUERY)を正確に示しています。
SAMOOHA_SAMPLE_DATABASE¶
このデータベースには、クリーンルームで分析を実行し、アプリケーションに慣れるために使用できるサンプルデータセットが含まれています。
タスク¶
Snowflake Data Clean Rooms は以下のタスクをインストールします。
EXPECTED_VERSION_TASK¶
このタスクは、新しいバージョンがリリースされると、Snowflake Data Clean Roomsの Snowflake Native App を自動的にアップグレードします。SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN スキーマに存在します。
タスクを有効にしてクリーンルーム環境を自動的に更新するには、開発者 API を使用して、 enable_local_db_auto_upgrades
コマンドを実行します。例えば、 Snowsight を使って以下を実行します。
CALL samooha_by_snowflake_local_db.library.enable_local_db_auto_upgrades();
ウェアハウス¶
Snowflake Data Clean Rooms は以下のウェアハウスをインストールします。
ウェアハウス名 |
メモ |
---|---|
APP_WH |
Snowflake Data Clean Rooms は、ウェアハウスを選択することができないアクションのために、このウェアハウスを使用します。APP_WH がアカウントにまだ存在しない場合、Snowflakeは XS ウェアハウスとして作成します。 |
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> |
プロバイダーが実行する分析を実行するコンシューマーアカウントのウェアハウス。 |