Vom Anbieter durchgeführte Analyse

Die Standardkonfiguration des Clean Room ermöglicht es nur dem Verbraucher, eine Analyse im Clean Room durchzuführen. Der Anbieter kann jedoch die Erlaubnis des Verbrauchers einholen, Vorlagen mit Verbraucherdaten in einem bestimmten Clean Room auszuführen. Die vom Anbieter durchgeführte Analyse kann entweder über die Clean Room UI oder über Code aktiviert und ausgeführt werden.

Bemerkung

Es gibt zwei Möglichkeiten für einen Anbieter, eine Analyse in einem Clean Room auszuführen: als Standardvorlage, die Ergebnisse mit jeder Abfrage zurückgibt, und als Aktivierung, die die Ergebnisse in einer Datei im Konto des Anbieters speichert. Wenn Sie die Daten für sich selbst oder für den Export an einen Dritten aufbewahren müssen, oder wenn es darum geht, die Ergebnisse eines großen Datensets zu verfeinern, ist es im Allgemeinen am besten, Ergebnisse für Ihr Konto zu aktivieren. Wenn Sie eine Vorlage mit neuen Parametern oder Daten erneut ausführen möchten und die Ergebnisse nicht aufbewahren müssen, ist die Verwendung der hier beschriebenen Standardabfragen vom Anbieter die richtige Methode.

Unterstützte Vorlagen

Die vom Anbieter durchgeführte Analyse wird auf der Ebene der Vorlage innerhalb eines bestimmten Clean Room aktiviert. Die folgenden Vorlagen unterstützen vom Anbieter durchgeführte Analysen:

  • Überlappungs- und Segmentierungsanalyse

  • SQL-Abfrage (nur UI)

  • Benutzerdefinierte Vorlagen (nur API)

Details zur Abrechnung

Vom Anbieter durchgeführte Analysen werden im Konto des Verbrauchers ausgeführt, und den Verbrauchern wird eine vom Anbieter durchgeführte Analyse in Rechnung gestellt. Um keine zusätzlichen Kosten durch Anbieteranalysen zu verursachen, muss der Verbraucher den Clean Room deinstallieren.

Ein Verbraucher kann die Anzahl der Credits schätzen, die der Anbieter in den letzten N Tagen verbraucht hat, indem er die folgende Abfrage ausführt und die Anzahl der vergangenen Tage als negative Zahl angibt:

-- Estimate the number of credits consumed in the past 5 days.
SELECT * FROM TABLE(SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.PRA_CONSUMPTION_UDTF(-5));
Copy

Auswählen einer Warehouse-Größe

Clean Rooms verwenden eine automatische Skalierungslogik, die auf der Größe der Datensätze basiert, um ein Warehouse für Ihre Analyse auszuwählen. Der Anbieter kann jedoch ausdrücklich eine Warehouse-Größe aus einer Liste von Größen und Typen auswählen, die der Verbraucher zulässt. Der Anbieter wählt die Größe des Warehouse wie folgt:

  1. Der Verbraucher ruft consumer.set_provider_run_configuration auf und gibt an, welche Warehouse-Größen und -Typen für eine bestimmte Vorlage verwendet werden können, wenn sie von einem Anbieter ausgeführt werden.

  2. Der Anbieter ruft provider.view_warehouse_sizes_for_template auf, um zu erfahren, welche Warehouse-Größen und -Typen für die vom Anbieter durchgeführten Analysen zulässig sind.

  3. Der Anbieter gibt an, welche Kombination von Größe und Typ er in seiner Analyseanfrage verwenden möchte (provider.submit_analysis_request).

Ein Anbieter kann nur Warehouse-Größen und -Typen anfordern, die vom Verbraucher explizit aufgeführt sind.

Verbraucher

CALL samooha_by_snowflake_local_db.CONSUMER.enable_templates_for_provider_run(
  $cleanroom_name,
  [$template1, $template2],
  TRUE,
  {
    $template1: {'warehouse_type': 'STANDARD', 'warehouse_size': ['MEDIUM', 'LARGE']},
    $template1: {'warehouse_type': 'SNOWPARK-OPTIMIZED', 'warehouse_size': ['MEDIUM', 'XLARGE']},
    $template2: {'warehouse_type': 'STANDARD', 'warehouse_size': ['MEDIUM', 'XLARGE']}
  });
Copy

Anbieter

CALL samooha_by_snowflake_local_db.PROVIDER.VIEW_WAREHOUSE_SIZES_FOR_TEMPLATE($cleanroom_name, $template_name, $consumer_account_loc);
CALL samooha_by_snowflake_local_db.provider.submit_analysis_request(
  $cleanroom_name,
  $consumer_locator_id,
  $template1,
  ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
  ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
  object_construct(
    'dimensions', ['c.REGION_CODE'],
    'measure_type', ['AVG'],
    'measure_column', ['c.DAYS_ACTIVE'],
    'warehouse_type', 'STANDARD',        -- If this type and size pair were not listed by view_warehouse_sizes_for_template,
    'warehouse_size', 'LARGE'            -- the request will automatically fail.
  ));
Copy

Vom Anbieter durchgeführte Analysen implementieren

Wichtig

Wenn sich der Verbraucher und der Anbieter in unterschiedlichen Cloud-Regionen befinden, müssen Sie die Cloud-übergreifende automatische Ausführung in beiden Konten und für beide Clean Rooms aktivieren.

Die Berechtigung zum Ausführen von Abfragen in einem Clean Room wird in der Clean Room UI verwaltet, und zwar mithilfe des Schalters Enable run analysis & query im Bereich Share clean room im Konfigurationsfluss des Clean Room. Um vom Anbieter durchgeführte Analysen zu aktivieren oder zu deaktivieren, aktiviert der Anbieter des Clean Room den Schalter neben seinem eigenen Konto in diesem Bereich. Nach dem Erstellen des Clean Room kann dieser Schalter nicht mehr geändert werden. Wenn Sie die Berechtigung für ein bestimmtes Konto zur Ausführung von Abfragen in einem veröffentlichten Clean Room ändern möchten, müssen Sie den Clean Room löschen und einen neuen erstellen.

Hier sind die Schritte, die Sie unternehmen müssen, um eine vom Anbieter durchgeführte Analyse in einem neuen Clean Room zu ermöglichen:

  1. Der Anbieter erstellt und konfiguriert einen Clean Room, indem er eine der unterstützten Vorlagen verwendet.

  2. Im Schritt Share Clean Room der Clean Room-Konfiguration schalten Sie neben Ihrem Konto die Option Enable run analysis & query ein, damit Sie Vorlagen ausführen können, die die Anbieteranalyse in diesem Clean Room unterstützen.

  3. Wenn der Verbraucher dem Clean Room beitritt, wird er vor dem Beitritt gewarnt, dass die vom Anbieter durchgeführte Analyse für diesen Clean Room aktiviert ist.

  4. Der Verbraucher konfiguriert den Clean Room wie gewohnt für alle Vorlagen im Clean Room, einschließlich aller Vorlagen, die die Anbieteranalyse unterstützen. Wenn der Verbraucher einem Anbieter nicht erlauben möchte, eine bestimmte Vorlage auszuführen, kann er die erforderlichen Angaben für diese Vorlage weglassen. Beachten Sie, dass Vorlagen, die die Anbieteranalyse unterstützen, auch die Verbraucheranalyse unterstützen.

  5. Nachdem der Verbraucher dem Clean Room beigetreten ist und ihn konfiguriert hat, können sowohl der Anbieter als auch der Verbraucher Vorlagen im Clean Room über den normalen Analysefluss ausführen.

Berechtigungen für vom Anbieter durchgeführte Analysen können nach ihrer Vergabe nicht mehr widerrufen werden. Die einzige Möglichkeit, die vom Anbieter durchgeführten Analysen zu stoppen, besteht darin, dass der Anbieter oder Verbraucher den Clean Room löscht.