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:
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 nameInstalled 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_nameInstalled 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;
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;
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();
Erfahren Sie, wie Sie die Nutzungskosten für Ihre Aufgaben und Warehouses anzeigen können.
Aufgabenname |
Beschreibung |
Warehouse |
Entitätsebene |
|---|---|---|---|
|
Führt die geplanten Berichte für jedes Warehouse aus. Verwendet das Warehouse, zu dem Berichte erstellt werden. Standardzeitplan: 1 Tag |
|
Pro Clean Room-Bericht |
|
Führt die Berichte aus, die auf automatische Ausführung eingestellt sind Standardzeitplan: 1 Tag |
Das vom Benutzer gewählte Warehouse |
Pro Konto |
|
Berechnet Basiskennzahlen für verknüpfte Clean Rooms Standardzeitplan: 3 Stunden |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
Berechnet Basiskennzahlen für erstellte Clean Rooms Standardzeitplan: 3 Stunden |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
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 |
|
Aktualisiert die native App automatisch, wenn neue Versionen veröffentlicht werden Standardzeitplan: Wird durch Anforderung ausgelöst |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
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 |
|
Einbinden, Reparieren und Validieren eingehender Freigaben von Teilnehmern. Standardzeitplan: 30 Minuten |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
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 |
|
Interne Nutzung. Standardzeitplan: 30 Minuten |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
Bindet die eingehende Freigabe für Aktivierungen für jeden Verbraucher ein Standardzeitplan: 15 Minuten |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
Überprüft jede Vorlage im Clean Room jedes Anbieters auf Privatsphäre- und Sicherheitsprobleme Standardzeitplan: 30 Minuten |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
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 |
|
Pro Clean Room |
|
Verarbeitet das Budget für differentielle Privatsphäre für einen Clean Room. Standardzeitplan: Wird durch Anforderung ausgelöst |
SAMOOHA_TASK_WAREHOUSE |
Pro Teilnehmer |
|
Verarbeitet die Vorlagenanfragen für einen Clean Room. Standardzeitplan: Wird durch Anforderung ausgelöst |
SAMOOHA_TASK_WAREHOUSE |
Pro Teilnehmer |
|
Setzt das Privatsphärebudget für alle Clean Rooms zurück. Standardzeitplan: 1 Tag |
SAMOOHA_TASK_WAREHOUSE |
Pro Clean Room |
|
Einmal pro Tabelle erstellt. Standardzeitplan: 1 Tag |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
Richtet Berichte zur automatischen Ausführung ein Standardzeitplan: 60 Minuten |
SAMOOHA_TASK_WAREHOUSE |
Pro Konto |
|
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 |
|
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 |