Snowflake Data Clean Rooms: Installierte Objekte

In diesem Thema finden Sie Informationen über die Objekte, die in Ihrem Konto erstellt werden, wenn Sie eine Reinraumumgebung installieren.

High-level overview

The following diagram shows a high-level view of the main objects installed in provider and consumer accounts:

High-level diagram of clean room components
  • Clean rooms UI: Users accessing a clean room using the clean rooms UI go through a service user account, configured once per account by the clean room installer, to the clean rooms API.

  • API user: API users and the clean rooms UI both use the same clean rooms API. This API is defined by the local DB in your account.

  • Local DB: Defines the clean rooms API. There is one local DB per account (not per clean room). The actual name of this object is SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.

  • Clean room application package: Created on the provider’s account when the provider creates a clean room. There is one package per clean room, named SAMOOHA_CLEANROOM_cleanroom name. This package produces the clean room app installed by the consumer.

  • Back shares: Back shares must be mounted by the provider to get messages and data from the consumer to the provider. Native apps support data flows only from the provider to the consumer, so a back share must be mounted to enable data to flow from the consumer to the provider. Two back shares are mounted in the provider’s account: a governance back share, which stores provider-run and provider activation data; and a request log back share, which stores messaging and responses from the consumer to the provider, such as consumer custom template requests, or consumer approvals of provider run requests. (The share itself lives in the consumer’s account.)

  • Installed app: Created by an application package, the installed app defines a clean room on the consumer side. The installed app follows the naming convention SAMOOHA_CLEANROOM_APP_cleanroom_name.

  • Consumer DB: Contains read-only views of the datasets registered in the consumer’s account. The consumer creates these views when they link datasets into the clean room. The consumer’s account contains one consumer DB per clean room, named SAMOOHA_CLEANROOM_CONSUMER_clean room ID.

  • Clean room: A clean room at a high level can be considered as comprising the application package and back shares on the provider side, plus the installed app and consumer DB on the consumer side.

Anwendungspakete

The following application packages can be installed in your account:

SAMOOHA_CLEANROOM_cleanroom name

Installed in the provider’s account, one application package per clean room created. It contains all the core application logic of a clean room created by the provider. It also contains the secure views used to share data with the clean room and several tables that store the clean room state. These include tables that record the current differential privacy budget of consumers, the column and join policy, and names of tables linked to the clean room.

Applications

The following applications can be installed in your account:

SAMOOHA_CLEANROOM_APP_cleanroom_name

Installed in the consumer’s account when they install (join) a clean room.

Datenbanken

SAMOOHA_BY_SNOWFLAKE

Diese Datenbank enthält alle zentralen Funktionen und die Anwendungslogik, die zur Erstellung und Verwaltung von Clean Rooms benötigt werden. Diese Datenbank hat die folgenden Schemas:

ADMIN-Schema

Dieses Schema enthält Details auf App-Ebene wie die folgenden:

  • Angewendete Patches (Version, Befehle)

  • Versionsinformationen (Nummer)

APP_SCHEMA-Schema

Dieses Schema enthält Funktionen und Prozeduren, die notwendig sind, um alle Abläufe im Clean Room zu erleichtern. Die wichtigsten Details sind:

  • Funktionen zum Verschlüsseln und Entschlüsseln

  • Prozeduren für Clean Rooms, die Sie mit den Entwickler-APIs und der Clean Rooms-UI zum Erstellen und Installieren von Clean Rooms sowie zum Arbeiten mit diesen verwenden.

TEMPLATES-Schema

Dieses Schema enthält die von Snowflake bereitgestellten SQL-Jinja-Vorlagen.

Diese vorgefertigten Vorlagen bieten gebrauchsfertige SQL-Abfragen für die sichere Datenzusammenarbeit (Data Collaboration) innerhalb von Snowflake Data Clean Rooms. Sie nutzen die Jinja-Vorlagen zur Anpassung, sodass Sie Abfragen auf bestimmte Szenarios der Datenfreigabe zuschneiden können.

SAMOOHA_BY_SNOWFLAKE_LOCAL_DB

Diese Datenbank wird von der Clean Rooms-UI während des Snowflake-Installationsprozesses erstellt. Sie ist für Ihr Konto lokal. Er ist keine Anwendung, enthält aber Anwendungslogik.

Diese Datenbank hat zwei Arten von Daten:

  • Die Entwickler-APIs, die Sie und die Clean Rooms-UI zum Erstellen und Verwalten von Clean Rooms verwenden.

  • Zwischendatensets, die Ihnen gehören und die bei Abläufen wie der Auflösung von Identitäten im Schema PUBLIC gespeichert werden. So werden beispielsweise die Ausgabetabellen aus dem Auflösungs- und Transcodierungsprozess von LiveRamp im Schema PUBLIC gespeichert und mit der Ansicht verbunden, die von der Webanwendung mit der Clean Rooms-UI verknüpft wird.

Die Datenbank hat die folgenden Schemas:

ADMIN-Schema

Dieses Schema enthält Informationen, die für die Operation bestimmter mit dem Konto verbundener Reinraum-Features erforderlich sind, wie z. B.:

  • Verwenden Sie die Cloud-übergreifende automatische Ausführung, um über Regionen oder Cloud-Plattformen hinweg zusammenzuarbeiten.

  • Aktualisierungen der Metadaten für Clean Rooms, die benötigt werden, um Clean Rooms von Entwickler-APIs in der Clean Rooms-UI zu registrieren.

  • Versionierung der aktuellen Verfahren im Zusammenhang mit der Funktionsweise der Clean Rooms-UI mit dem Snowflake-Konto.

  • Aufgaben und Streams, die auf Änderungen in der Menge der von den Teilnehmern zurückgemeldeten Clean Room-Freigaben achten, um Clean Rooms basierend auf den Änderungen je nach Bedarf zu aktivieren/deaktivieren.

CONSUMER-Schema

Dieses Schema enthält die Definitionen der Verbraucher-API-Prozeduren sowie einige allgemeine Verbraucheraufgaben.

INFORMATION_SCHEMA-Schema

Wie alle Snowflake Datenbanken enthält diese Datenbank das Schema INFORMATION_SCHEMA („Datenwörterbuch“), das aus einer Reihe von systemdefinierten Ansichten und Tabellenfunktionen besteht, die umfangreiche Metadateninformationen über die in Ihrem Konto erstellten Objekte liefern.

LIBRARY-Schema

Dieses Schema enthält die Definitionen der API-Prozeduren des library-Namespace sowie einige allgemeine Aufgaben und Prozeduren, die sowohl von Anbietern als auch von Verbrauchern verwendet werden.

PROVIDER-Schema

Dieses Schema enthält die Definitionen der Anbieter-API-Prozeduren sowie einige allgemeine Anbieteraufgaben.

PUBLIC-Schema

Dieses Schema enthält die Entwickler-APIs, die Sie und die Clean Rooms-UI verwenden, um Clean Rooms zu erstellen und zu verwalten. Er enthält auch Zwischendatensätze, die ausschließlich Ihnen gehören und die bei Abläufen wie der Auflösung der Identität im Schema PUBLIC gespeichert werden. So werden beispielsweise die Ausgabetabellen aus dem Auflösungs- und Transcodierungsprozess von LiveRamp im Schema PUBLIC gespeichert und mit der Ansicht verbunden, die von der Webanwendung mit der Clean Rooms-UI verknüpft wird.

Dieses Schema enthält die folgenden Tabellen:

  • CLEANROOM_RECORD: Diese Tabelle enthält den Status eines Clean Rooms (erstellt, gelöscht) sowie Informationen zum Benutzer und Zeitstempel der letzten Aktualisierung. Wenn die Aktualisierung in der Clean Rooms-UI durchgeführt wurde, ist der Benutzer der Benutzer des Dienstkontos. Wenn die Aktualisierung in der Snowsight mithilfe von Entwickler-APIs durchgeführt wurde, ist der Benutzer der tatsächliche Benutzer, der die API aufgerufen hat. Der Name der Reinraumdatenbank kann in dieser Tabelle angepasst werden.

  • CONNECTOR_CONFIGURATION: Diese Tabelle ist die Liste der im Konto konfigurierten Konnektoren.

  • REPORTS: Diese Tabelle enthält die Liste der Berichte, die der Verbraucher in der Clean Rooms-UI gespeichert hat. Die wichtigsten Ergebnisse aus Standardberichten werden in der Tabelle gespeichert.

  • HORIZONTAL_ANALYSIS_<report ID>: Ausgabe von Analysen, die mit der SQL-Abfragevorlage und kundenspezifischen Vorlagen in der Clean Rooms-UI ausgeführt wurden.

  • CONSUMER_ACTIVATION_SUMMARY: Ergebnisse der Verbraucheraktivierung.

  • PROVIDER_ACTIVATION_SUMMARY: Ergebnisse der Anbieteraktivierung.

Aus der Datenbank werden drei Freigaben erstellt:

  • SAMOOHA_INTERNAL_GOVERNANCE_SUMMARY SHARE_NAV2: Diese Freigabe enthält Ansichten auf die Tabellen GOVERNACE_SUMMARY und ACTIVATION im Schema PUBLIC. Dies wird mit allen Anbietern geteilt, die über dieses Konto installierte Reinräume erstellt haben, und wird verwendet, um Governance-Informationen und Anbieteraktivierungen auszutauschen.

  • SAMOOHA_INTERNAL_LOGS_SHARE_NAV2: Diese Freigabe befindet sich auf der Tabelle LOG_EVENTS und dient in erster Linie dazu, Protokolle darüber auszutauschen, wie ID-Prozeduren zur Lösung von Problemen zurück zu Snowflake gelangen, da sie native Apps von Drittanbietern verwenden. Es werden keine PII oder Daten zurückgegeben, sondern nur der Erfolg/Misserfolg der für die Transkodierung/Auflösung verwendeten Drittanbieter-App-APIs.

  • SAMOOHA_INTERNAL_PROVIDER_METADATA_NAV2: Diese Freigabe befindet sich auf zwei Tabellen: ADMIN.METADATA_UPDATE_REQUESTS, die zum Senden von Registrierungsanfragen von der API an die UI und ADMIN verwendet wird, und RESOURCE_MONITOR_USAGE, die nur von verwalteten Konten zur Protokollierung der Nutzung verwendet wird.

SAMOOHA_CLEANROOM_cleanroom ID

Each clean room published (as a creator) or installed (as a consumer) has an associated database that includes all the details of that clean room, including any templates installed, request logs, LAF status, and much more. This database includes the following schemas:

  • Admin: Kryptografische Schlüssel, Privatsphärebudget, Anfrageprotokolle, Anfragen für Anbieteranalysen und mehr.

  • Shared_schema: Verknüpfungsrichtlinie, LAF-Status, verknüpfte Tabellen und Versionen.

  • Templates: Liste der Aktivierungsvorlagen, benutzerdefinierten Vorlagen und Vorlagenketten in diesem Clean Room.

SAMOOHA_CLEANROOM_REQUESTS_clean room ID

Dies ist eine Datenbank auf der Anbieterseite und eine Freigabe auf der Verbraucherseite. Er entspricht dem Anteil, der von einem Verbraucher an den Anbieter eines Reinraums im Rahmen der Installation des Reinraums durch den Verbraucher zurückgeschickt wird. Diese Datenbank enthält Informationen über alle Anfragen, die der Verbraucher an den Reinraum gestellt hat, und dient dazu, die Nutzung des Differential Privacy-Budgets durch den Verbraucher zu verfolgen.

SAMOOHA_CLEANROOM_CONSUMER_clean room ID

Diese Datenbank wird nur in Verbraucherkonten installiert. Es wird verwendet, um Objekte wie die sichere Ansicht der Verbraucherdaten für den Reinraum und ggf. Verbraucherspalten-/Verknüpfungsrichtlinien freizugeben. Sie enthält die folgende Tabelle:

  • SAMOOHA_CLEANROOM_CONSUMER_clean room ID.SHARED.REQUESTS. Diese Tabelle zeigt dem Verbraucher genau an, welche Abfrage eine Ausführung versucht hat, wobei PROPOSED_QUERY die Abfrage ist, die aus der Vorlage des Verbrauchers gerendert wird.

SAMOOHA_SAMPLE_DATABASE

Diese Datenbank enthält Beispiel-Datensets mit den Namen DEMO.CUSTOMERS und DEMOCUSTOMERS_2, die Sie als Testdaten verwenden können.

Bemerkung

Die Tabelle CUSTOMERS_2 wurde im September 2025 hinzugefügt. Wenn Sie Ihre Clean Room-Umgebung bereits zuvor installiert haben, ist diese Beispieltabelle möglicherweise nicht installiert. Um zu sehen, ob CUSTOMERS_2 installiert ist, können Sie den folgenden SQL-Code ausführen:

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

Wenn die Antwort keine Zeilen enthält, müssen Sie oder jemand mit der ACCOUNTADMIN-Rolle den folgenden Befehl ausführen, um die Beispieltabelle zu installieren:

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

Aufgaben

Hier finden Sie einige Aufgaben, die von Clean Rooms verwendet werden und in Ihrer Umgebung möglicherweise ausgeführt werden:

Mit der folgenden Prozedur können Sie weitere Informationen zu einer bestimmten Aufgabe abrufen:

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.DCR_HEALTH.DCR_TASKS_HEALTH_CHECK();
Copy

Erfahren Sie, wie Sie die Nutzungskosten für Ihre Aufgaben und Warehouses anzeigen können.

Clean Room-Aufgaben

Aufgabenname

Beschreibung

Warehouse

Entitätsebene

AUTO_RUN_warehouse

Führt die geplanten Berichte für jedes Warehouse aus. Verwendet das Warehouse, zu dem Berichte erstellt werden.

Standardzeitplan: 1 Tag

DCR_WH_warehouse

Pro Clean Room-Bericht

AUTO_RUN_TASK

Führt die Berichte aus, die auf automatische Ausführung eingestellt sind

Standardzeitplan: 1 Tag

Das vom Benutzer gewählte Warehouse

Pro Konto

COMPUTE_DATA_STATS_​FOR_ACCOUNT_consumer locator

Berechnet Basiskennzahlen für verknüpfte Clean Rooms

Standardzeitplan: 3 Stunden

SAMOOHA_TASK_WAREHOUSE

Pro Konto

COMPUTE_DATA_STATS_​FOR_ACCOUNT_provider locator

Berechnet Basiskennzahlen für erstellte Clean Rooms

Standardzeitplan: 3 Stunden

SAMOOHA_TASK_WAREHOUSE

Pro Konto

DISTINCT_COLUMN_VALUES​_TASK

Berechnet unterschiedliche Werte für Datensets, die in einem Clean Room verknüpft sind, um Filter-Dropdowns zu ermöglichen.

Standardzeitplan: 1 Tag

SAMOOHA_TASK_WAREHOUSE

Pro Clean Room

EXPECTED_VERSION_TASK

Aktualisiert die native App automatisch, wenn neue Versionen veröffentlicht werden

Standardzeitplan: Wird durch Anforderung ausgelöst

SAMOOHA_TASK_WAREHOUSE

Pro Konto

LISTEN_TO_REQUESTS

Einbinden, Reparieren und Validieren eingehender Freigaben von Teilnehmern, wenn für das Konto differentielle Privatsphäre aktiviert ist. Die gleiche Aufgabe mit einer höheren Häufigkeit wird hinzugefügt, um zu verhindern, dass die Analyse überschrieben wird, wenn DP aktiviert ist. Diese Aufgabe koste etwa 6 Credits pro Tag.

Standardzeitplan: 1 Minute

Serverlos

Pro Konto

LISTEN_TO_REQUESTS_NODP

Einbinden, Reparieren und Validieren eingehender Freigaben von Teilnehmern.

Standardzeitplan: 30 Minuten

SAMOOHA_TASK_WAREHOUSE

Pro Konto

LISTEN_TO_REQUESTS​_1_COLLABORATOR

Richtet Listen für die Rückgabeanfragen ein, die vom Verbraucher an den Anbieter zurückgesendet werden. Stellt fest, ob ein Clean Room aktiviert wurde.

Standardzeitplan: Wird durch Anforderung ausgelöst

SAMOOHA_TASK_WAREHOUSE

Pro Teilnehmer

MONITORING_SUMMARY_CRON_TASK

Interne Nutzung.

Standardzeitplan: 30 Minuten

SAMOOHA_TASK_WAREHOUSE

Pro Konto

MOUNT_PROVIDER_ACTIVATIONS_TASK

Bindet die eingehende Freigabe für Aktivierungen für jeden Verbraucher ein

Standardzeitplan: 15 Minuten

SAMOOHA_TASK_WAREHOUSE

Pro Konto

PRIVACY_AND_SECURITY_SCANNER

Überprüft jede Vorlage im Clean Room jedes Anbieters auf Privatsphäre- und Sicherheitsprobleme

Standardzeitplan: 30 Minuten

SAMOOHA_TASK_WAREHOUSE

Pro Konto

PROCESS_ACTIVATIONS

Entschlüsselt die vom Verbraucher zurückgesendeten Aktivierungsdaten

Standardzeitplan: Wird durch Anforderung ausgelöst

SAMOOHA_TASK_WAREHOUSE

Pro Konto

PROCESS_PROVIDER_ANALYSIS_REQUESTS

Führt die eigentliche Anbieteranalyse aus.

Standardzeitplan: Wird durch Anforderung ausgelöst

PROVIDER_RUN_UUID

Pro Clean Room

PROCESS_REQUESTS_​BUDGET_COLLABORATOR_1

Verarbeitet das Budget für differentielle Privatsphäre für einen Clean Room.

Standardzeitplan: Wird durch Anforderung ausgelöst

SAMOOHA_TASK_WAREHOUSE

Pro Teilnehmer

PROCESS_TEMPLATE_REQUESTS​_COLLABORATOR

Verarbeitet die Vorlagenanfragen für einen Clean Room.

Standardzeitplan: Wird durch Anforderung ausgelöst

SAMOOHA_TASK_WAREHOUSE

Pro Teilnehmer

RESET_PRIVACY_BUDGET

Setzt das Privatsphärebudget für alle Clean Rooms zurück.

Standardzeitplan: 1 Tag

SAMOOHA_TASK_WAREHOUSE

Pro Clean Room

SAMOOHA_INTERNAL_UID_​OUTPUT_TABLE_REFRESH_TABLE_DATA_TASK

Einmal pro Tabelle erstellt.

Standardzeitplan: 1 Tag

SAMOOHA_TASK_WAREHOUSE

Pro Konto

SETUP_AUTO_RUN

Richtet Berichte zur automatischen Ausführung ein

Standardzeitplan: 60 Minuten

SAMOOHA_TASK_WAREHOUSE

Pro Konto

SETUP_PROVIDER_ANALYSIS​_REQUESTS

Richtet die Infrastruktur für die Anbieteranalyse ein und verarbeitet die Anfragen für die Anbieteranalyse.

Standardzeitplan: Wird durch Anforderung ausgelöst

SAMOOHA_TASK_WAREHOUSE

Pro Clean Room

TRIGGER_REFRESH_FOR_LAF_CLEANROOMS

Löst die Datenaktualisierung für Clean Rooms aus, für die die Cloud-übergreifende automatische Ausführung aktiviert ist.

Standardzeitplan: 30 Minuten

SAMOOHA_TASK_WAREHOUSE

Pro Konto

Warehouses

Snowflake Data Clean Rooms installiert die folgenden Warehouses in Ihrem Konto. Sie können die Größe jedes Warehouses nach Bedarf ändern.

Erläuterungen zum Anzeigen der Nutzungskosten Ihres Warehouses.

Name des Warehouses

Anmerkungen

APP_WH

XSMALL-Warehouse hat Zugriff auf die API, richtet neue Clean Rooms ein, verwaltet Berechtigungen und Datenfreigaben.

DCR_WH_SMALL

Reguläres, SMALL Warehouse

DCR_WH_Medium

Reguläres, MEDIUM Warehouse

DCR_WH_Large

Reguläres, LARGE Warehouse

DCR_WH_XLarge

Reguläres, XLARGE Warehouse

DCR_WH_2XLARGE

Reguläres, XXLARGE Warehouse

DCR_WH_4XLarge

Reguläres, X4LARGE Warehouse

DCR_WH_OPT_XLarge

Snowpark-optimiertes XLARGE-Warehouse

DCR_WH_OPT_2XLarge

Snowpark-optimiertes XXLARGE-Warehouse

DCR_WH_OPT_4XLarge

Snowpark-optimiertes X4LARGE-Warehouse

PROVIDER_RUN_<cleanroom_identifier>

Warehouse im Konto des Verbrauchers, das die vom Anbieter durchgeführten Analysen ausführt.

SAMOOHA_TASK_WAREHOUSE

XSMALL-Warehouse, das für viele Dinge verwendet wird, z. B. für Privatsphäre- und Sicherheitsscans, für die Verarbeitung von automatisch ausgeführten Berichten, für das Berechnen von Datenstatistiken und für das Verarbeiten von Verbraucheranfragen zu Vorlagen.

DCR_ACTIVATION_WAREHOUSE

Wird verwendet, um die an den Anbieter gesendeten Aktivierungsergebnisse zu entschlüsseln. Die Standardgröße ist XL, aber die Größe kann durch Aufruf von provider.update_activation_warehouse geändert werden.