Verwenden der Entwickler-API zum Hinzufügen verbraucherdefinierter Vorlagen hinzuzufügen¶

Anfragen an einen Anbieter senden¶

Ein Verbraucher führt den Befehl consumer.create_template_request aus, um eine Anfrage an den Anbieter eines Reinraums zu senden. Diese Anfrage enthält den Namen der Vorlage zusammen mit dem Jinja-Code, der die Vorlage definiert.

Nehmen wir zum Beispiel an, der Anbieter gibt den Reinraum dcr_cleanroom für einen Verbraucher frei. Der Kunde möchte dem Reinraum eine Vorlage mit dem Namen my_overlap_analysis hinzufügen. Um eine Anfrage an den Anbieter des Reinraums zu senden, führt der Verbraucher den folgenden Befehl aus:

CALL samooha_by_snowflake_local_db.consumer.create_template_request('dcr_cleanroom',
  'my_analysis',
  $$
  SELECT
      identifier({{ dimensions[0] | column_policy }})
  FROM
      identifier({{ my_table[0] }}) c
    INNER JOIN
      identifier({{ source_table[0] }}) p
        ON
          c.identifier({{ consumer_id  }}) = identifier({{ provider_id | join_policy }})
       {% if where_clause %} where {{ where_clause | sqlsafe | join_and_column_policy }} {% endif %};
  $$);

Das dritte Argument ist der Jinja-Code, der die Vorlage definiert.

Eine Referenzdokumentation für den Befehl consumer.create_template_request finden Sie im Abschnitt „Verbraucherdefinierte Vorlagen“ unter Snowflake Data Clean Rooms: Verbraucher-API-Referenzhandbuch.

Auf neue Anfragen von Verbrauchern prüfen¶

Um zu prüfen, ob neue Anfragen von Verbrauchern vorliegen, führt ein Anbieter den Befehl provider.list_template_requests aus und analysiert dann die Ergebnisse, um Anfragen mit dem Status PENDING zu ermitteln. Der Status PENDING zeigt an, dass der Verbraucher eine neue Anfrage gestellt hat, auf die der Anbieter noch nicht reagiert hat. Die Antwort an provider.list_template_requests enthält den Jinja-Code der Vorlage, mit dem der Anbieter entscheiden kann, ob er die Anfrage genehmigen oder ablehnen möchte.

Nehmen wir zum Beispiel an, der Name des Reinraums des Anbieters ist dcr_cleanroom. Um zu prüfen, ob der Verbraucher eine neue Anfrage zum Hinzufügen einer Vorlage gesendet hat, führt der Anbieter die folgenden Befehle aus:

CALL samooha_by_snowflake_local_db.provider.list_template_requests('dcr_cleanroom');

SELECT * FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())) WHERE status = 'PENDING';

Die Antwort auf den Befehl provider.list_template_requests enthält für jede Anfrage zur Vorlage Folgendes:

• UUID, die die Anfrage eindeutig identifiziert

• Das Konto des Verbrauchers, von dem die Anfrage stammt, im Format des Konto-Locators.

• Name der Vorlage, den der Verbraucher beim Senden der Anfrage angegeben hat.

• Jinja-Code, der die Vorlage definiert.

• Status der Anfrage, der einer der folgenden sein kann: PENDING, APPROVED oder REJECTED.

Eine Referenzdokumentation für den Befehl provider.list_template_requests finden Sie im Abschnitt „Verbraucherdefinierte Vorlagen“ unter Snowflake Data Clean Rooms: Anbieter-API-Referenzhandbuch.

Eine Anfrage genehmigen oder ablehnen¶

Nachdem der Anbieter eine Anfrage zum Hinzufügen einer verbraucherdefinierten Vorlage erhalten hat, entscheidet er, ob er die Anfrage genehmigt oder ablehnt.

Eine Anfrage genehmigen

Anbieter führen den Befehl provider.approve_template_request aus, um eine Anfrage zum Hinzufügen einer Vorlage zu genehmigen. Der Anbieter gibt an, welche Vorlage genehmigt werden soll, indem er den Bezeichner der Anfrage als Argument angibt.

Nehmen wir zum Beispiel an, der Name des Reinraums des Anbieters ist dcr_cleanroom und der Anfrage des Verbrauchers, eine Vorlage hinzuzufügen, wurde der Bezeichner 01b4d41d-0001-b572 zugewiesen. Um die Anfrage zu genehmigen und die Vorlage zum Reinraum hinzuzufügen, führt der Anbieter den folgenden Befehl aus:

CALL samooha_by_snowflake_local_db.provider.approve_template_request('dcr_cleanroom',
  '01b4d41d-0001-b572');

Eine Anfrage ablehnen

Anbieter führen den Befehl provider.reject_template_request aus, um eine Anfrage zum Hinzufügen einer Vorlage abzulehnen. Der Anbieter gibt an, welche Vorlage abgelehnt werden soll, indem er den Bezeichner der Anfrage als Argumentangibt.

Nehmen wir zum Beispiel an, der Name des Reinraums des Anbieters ist dcr_cleanroom und der Anfrage des Verbrauchers, eine Vorlage hinzuzufügen, wurde der Bezeichner 01b4d41d-0001-b572 zugewiesen. Nach Prüfung der Jinja-Vorlage stellt der Anbieter fest, dass diese ein Sicherheitsrisiko für den Reinraum darstellt, weshalb er die Anfrage mit einer entsprechenden Begründung ablehnen möchte. Um die Anfrage zum Hinzufügen der Vorlage abzulehnen, führt der Anbieter den folgenden Befehl aus:

CALL samooha_by_snowflake_local_db.provider.reject_template_request('dcr_cleanroom',
  '01b4d41d-0001-b572',
  'Failed security assessment');

Eine Referenzdokumentation für die Befehle provider.approve_template_request und provider.reject_template_request finden Sie im „Verbraucherdefinierte Vorlagen“ unter Snowflake Data Clean Rooms: Anbieter-API-Referenzhandbuch.

Status der Anfrage als Verbraucher prüfen¶

Der Verbraucher kann jederzeit den Befehl consumer.list_template_requests ausführen, um den Status seiner Anfrage zum Hinzufügen einer Vorlage zu überprüfen. Der Befehl gibt die folgenden Informationen zurück:

• UUID, die die Anfrage eindeutig identifiziert

• Konto des Anbieters, an den die Anfrage gesendet wurde, im Format des Konto-Locators

• Name der Vorlage, den der Verbraucher beim Senden der Anfrage angegeben hat.

• Jinja-Code, der die Vorlage definiert.

• Status der Anfrage, der einer der folgenden sein kann: PENDING, APPROVED oder REJECTED.

• Wenn die Anfrage abgelehnt wurde, den Grund für die Maßnahme des Anbieters

Nehmen wir zum Beispiel an, der Verbraucher hat eine Anfrage geschickt, um eine Vorlage zum Reinraum dcr_cleanroom hinzuzufügen. Um den Status der Anfrage zu überprüfen und festzustellen, ob sie genehmigt wurde, führt der Verbraucher den folgenden Befehl aus:

CALL samooha_by_snowflake_local_db.consumer.list_template_requests('dcr_cleanroom');

Eine Referenzdokumentation für den Befehl consumer.list_template_requests finden Sie im Abschnitt „Verbraucherdefinierte Vorlagen“ unter Snowflake Data Clean Rooms: Verbraucher-API-Referenzhandbuch.