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.

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

Alle vom Anbieter durchgeführten Analysen in einem Clean Room werden den Verbrauchern 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.enable_templates_for_provider_run auf und gibt an, welche Warehouse-Größen und -Typen mit welchen Vorlagen verwendet werden können.

  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

Tipp

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.

  6. 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.