Vom Anbieter durchgeführte Analyse¶

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 aktiviert der Anbieter Enable run analysis & query neben dem eigenen Konto, um alle Vorlagen in diesem Clean Room auszuführen, die Anbieter unterstützen.

   • Diese Einstellung kann nicht mehr geändert werden, nachdem ein Clean Room erstellt wurde. Wenn Sie die Berechtigung für ein bestimmtes Konto zum Ausführen von Abfragen in einem veröffentlichten Clean Room ändern möchten, müssen Sie den Clean Room löschen und einen neuen erstellen.

3. Verbrauchende treten bei und konfigurieren den Clean Room als normal für alle Vorlagen im Clean Room, einschließlich aller Vorlagen, die Anbieteranalysen unterstützen. Wenn Verbrauchende nicht möchten, dass ein Anbieter eine bestimmte Vorlage ausführt, können sie die erforderlichen Details für diese Vorlage weglassen.

   • Wenn Verbrauchende dem Clean Room beitreten, werden sie vor dem Beitritt gewarnt, dass die vom Anbieter durchgeführte Analyse für diesen Clean Room aktiviert ist.

   • Verbrauchende können Abfragen ausführen, sobald der Clean Room verknüpft ist, aber es gibt eine Verzögerung von bis zu 30 Minuten, bevor der Anbieter die Vorlage ausführen kann. Diese Setup-Verzögerung tritt nur beim ersten Verknüpfungsschritt auf. Wenn der Anbieter später weitere vom Anbieter ausgeführte Vorlagen hinzufügt, kann der Anbieter diese ausführen, sobald die Verbrauchenden ihren Clean Room für diese Vorlage konfiguriert haben.

4. Der Clean Room ist jetzt für beides verfügbar: für:ref:vom Anbieter ausgeführte <label-web_app_provider_run> (nach der anfänglichen Verzögerung bei der Einrichtung) und von Verbrauchenden ausgeführte Analysen (keine Verzögerung).

   • Den Verbrauchenden werden alle Analysen in diesem Clean Room in Rechnung gestellt, unabhängig davon, ob sie vom Anbieter oder von Verbrauchenden ausgeführt wurden.

Der Anbieter kann sowohl die vom Anbieter als auch von Verbrauchenden in einem Clean Room durchgeführte Analyse aktivieren und deaktivieren, indem er die entsprechenden API-Aufrufe aktiviert.

Jedes Mal, wenn der Anbieter die Einstellung für die vom Anbieter durchgeführte Analyse ändert, muss der Clean Room von allen Verbrauchenden neu installiert werden, damit die Änderung wirksam wird. Da es schwierig sein kann, alle Teilnehmenden zur Neuinstallation eines Clean Rooms zu zwingen, ist es zuverlässiger, wenn der Anbieter einen veröffentlichten, freigegebenen Clean Room löscht, wenn er die Analyseberechtigungen ändert, und dann einen neuen Clean Room mit den gewünschten Berechtigungen erstellt.

Im Folgenden finden Sie den allgemeinen Ablauf für die Einrichtung eines neuen Clean Room, der vom Anbieter durchgeführte Analysen ermöglicht:

1. Anbieter

   1. Erstellen und konfigurieren Sie Ihren Clean Room und Ihre Daten und Richtlinien auf die übliche Weise.

   2. Fügen Sie Verbraucher auf die übliche Weise hinzu.

   3. Aktivieren Sie vom Anbieter durchgeführte Analysen für bestimmte Verbraucherkonten im Clean Room, indem Sie provider.enable_provider_run_analysis aufrufen. Rufen Sie diese Prozedur erst auf, nachdem Sie Verbrauchende zu einem Clean Room hinzugefügt haben, aber bevor Verbrauchende den Clean Room installieren. Jedes Verbraucherkonto muss diese Anfrage separat genehmigen, da die entsprechenden Daten sonst für vom Anbieter durchgeführte Analysen in diesem Clean Room nicht zugänglich sind.

   4. Veröffentlichen Sie den Clean Room.

   5. Teilen Sie Ihren Verbrauchern mit, dass der Clean Room zur Verfügung steht, den Namen des Clean Room und die Vorlagen, die Sie im Clean Room ausführen möchten.

2. Verbraucher

   1. Installieren Sie den Clean Room und verknüpfen Sie Ihre Daten auf die herkömmliche Art.

   2. Legen Sie Verknüpfungs- und Spaltenrichtlinien für Ihre Daten fest. Wenn Sie nicht beide Richtlinien in einem Clean Room festlegen, kann der Anbieter keine Vorlage mit Ihren Daten ausführen. Das ist bei Analysen, die von Verbrauchenden ausgeführt werden, anders: Das vollständige Fehlen einer Richtlinie bedeutet hier, dass alle Spalten für diesen Richtlinientyp zugelassen sind.

   3. Erlauben Sie Anbieteranalysen für bestimmte Vorlagen im Clean Room, indem Sie entweder consumer.enable_templates_for_provider_run (für mehrere Vorlagen) oder consumer.approve_template (für eine Vorlage) aufrufen.

   • Wenn der Anbieter eine Vorlage ändert, nachdem sie von Verbrauchenden genehmigt wurde, müssen die Verbrauchenden die Vorlage erneut genehmigen. Bis zur erneuten Genehmigung der Vorlage wird die alte zwischengespeicherte Version der genehmigten Vorlage vom Anbieter ausgeführt.

   1. (*Optional) Vom Anbieter durchgeführte Analysen finden im Konto der Verbrauchenden statt und werden den Verbrauchenden in Rechnung gestellt. Wenn Sie den Warehouse-Typ oder die Größen, die einem Anbieter bei der Ausführung einer Vorlage zur Verfügung stehen, begrenzen möchten, rufen Sie consumer.set_provider_run_configuration auf.

   2. Teilen Sie dem Anbieter mit, dass Sie den Clean Room installiert und die vom Anbieter durchgeführten Analysen genehmigt haben.

3. Anbieter

   1. Nachdem der Verbraucher den Clean Room installiert hat, müssen Sie Ihren Analysen den Zugriff auf Verbraucherdaten ermöglichen, indem Sie die Datenfreigabe zwischen Verbraucher- und Anbieterkonto aktivieren. Der Prozess hierfür hängt davon ab, ob sich Anbieter und Verbraucher in derselben Cloudregion oder in verschiedenen Cloudregionen befinden:

      • Wenn sich Anbieter und Verbraucher in derselben Cloudregion befinden, ruft der Anbieter provider.mount_request_logs_for_all_consumers auf. Wenn ein neues Verbraucherkonto den Clean Room später installiert und Sie dessen Daten in dieser Vorlage verwenden möchten, müssen Sie diese Prozedur erneut ausführen, um auf diese Daten zugreifen zu können.

      • Wenn sich Anbieter und Verbraucher in verschiedenen Cloudregionen befinden, müssen Anbieter und Verbraucher die Cloud-übergreifende automatische Ausführung aktivieren.

   2. Führen Sie die Analyse aus, indem Sie provider.submit_analysis_request mit dem Namen der Vorlage, den Tabellennamen und den Argumenten der Vorlage aufrufen. Sie können optional eine Größe und einen Typ des Warehouse angeben, wie weiter unten unter diesem Thema gezeigt.

      • Speichern Sie die Antwort-ID, die erforderlich ist, um den Status und die Ergebnisse der Analyse zu überprüfen.

   3. Überprüfen Sie den Status der Analyse, indem Sie provider.check_analysis_status aufrufen. Wenn der Status als COMPLETED gemeldet wird, rufen Sie provider.get_analysis_result auf, um die Analyseergebnisse abzurufen.

Tipp

Wenn Sie die Einstellung für die vom Anbieter durchgeführte Analyse für Ihren Clean Room ändern, müssen Sie den Clean Room deinstallieren und dann neu installieren, damit die Änderung wirksam wird.

Festlegen von Warehouse-Beschränkungen und Auswählen eines Warehouse-Typs

Hier erfahren Sie, wie Verbrauchende eine Beschränkung der Warehouse-Größe und des Typ festlegen und wie ein Anbieter ein Warehouse auswählt, wenn er eine Analyse durchführt:

1. Verbrauchende rufen consumer.set_provider_run_configuration auf und geben an, welche Warehouse-Größen und -Typen ein Anbieter für eine bestimmte Vorlage verwenden kann.

   CALL samooha_by_snowflake_local_db.consumer.set_provider_run_configuration(
     $cleanroom_name,
     {
       $template1: {
         'warehouse_type': 'STANDARD',
         'warehouse_size': ['MEDIUM', 'LARGE']}
     });
   

   Copy

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

   CALL samooha_by_snowflake_local_db.provider.view_warehouse_sizes_for_template(
     $cleanroom_name,
     $template_name,
     $consumer_account_loc
   );
   

   Copy

3. Der Anbieter gibt in seiner Analyseausführungsanfrage an, welche Größe und welcher Typ des Warehouse verwendet werden soll. Ein Anbieter kann nur Warehouse-Größen und -Typen angeben, die Verbrauchende für diese Vorlage zulassen.

   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',      -- Any other value would cause the request to fail.
       'warehouse_size', 'LARGE'          -- Only MEDIUM and LARGE supported.
     )
   );
   

   Copy

Beispielcode installieren und ausführen

Sie können ein komplettes laufendes Beispiel eines Clean Room herunterladen und installieren, das eine vom Anbieter durchgeführte Analyse ermöglicht und ausführt. Um dieses Beispiel auszuführen, benötigen Sie zwei Snowflake Konten in derselben Organisation und Cloud-Hosting-Region mit der installierten Clean Room-Umgebung.

1. Laden Sie das Beispiel-Notebook herunter.

2. Installieren Sie das Notizbuch sowohl in Ihren Anbieter- als auch in Ihren Verbraucherkonten.

   Um ein Notizbuch hochzuladen, gehen Sie wie folgt vor:

   1. Wählen Sie im Navigationsmenü die Option Projects » Notebooks aus.

   2. Wählen Sie + Notebook » Import .ipynb file aus.

   3. Wählen Sie die heruntergeladene .ipynb-Datei aus.

   4. Benennen Sie die Datei wie gewünscht, und wählen Sie eine Datenbank und ein Schema.

   5. Behalten Sie das Standard-Warehouse APP_WH bei.

   6. Wählen Sie Create aus.

   7. Öffnen Sie das Notebook im Anbieterkonto und füllen Sie den Anbieterteil aus, um den Clean Room zu erstellen.

   8. Öffnen Sie das Notebook im Verbraucherkonto und füllen Sie den Verbraucherteil aus, um den Clean Room zu installieren und zu konfigurieren und die Vorlage auszuführen.