Vorlagen¶

Vorlagen sind JinjaSQL-Clean Room-Vorlagen, die von festgelegten Teilnehmenden ausgeführt werden können. Jeder Teilnehmer kann eine Vorlage mit anderen Teilnehmern einer Zusammenarbeit freigeben. Sie können nur Vorlagen hinzufügen oder entfernen, die in Ihrem Konto registriert sind.

Lesen Sie weiter, um zu erfahren, wie Sie eine Vorlage registrieren und zu einer Zusammenarbeit hinzufügen können:

Registrieren einer Vorlage¶

Gehen Sie wie folgt vor, um eine Vorlage zu registrieren:

Entwerfen Sie eine Vorlage für die Zusammenarbeit, und betten Sie sie in eine Vorlagenspezifikation ein.
Registrieren Sie die Vorlage, indem Sie REGISTER_TEMPLATE aufrufen. Dies gibt eine Vorlagen-ID zurück, die Sie für die Verknüpfung der Vorlage verwenden werden.

Nachdem die Vorlage registriert wurde, kann sie von jedem, der Lesezugriff auf diese Registry hat, mit einer Zusammenarbeit verknüpft werden.

Hinzufügen einer Vorlage¶

Der Vorgang zum Hinzufügen einer Vorlage, hängt davon ab, ob die Zusammenarbeit schon existiert oder nicht.

Um eine Vorlage vor der Erstellung der Zusammenarbeit hinzuzufügen, geben Sie die Vorlagen-ID an den Eigentümer der Zusammenarbeit weiter. Dieser fügt sie in die Zusammenarbeit ein und legt fest, wer die Vorlage ausführen darf. Im folgenden Zusammenarbeits-Ausschnitt erhält alice Zugriff, um die Vorlage bob_template_v1 auszuführen.
```
...
analysis_runners:
  alice:
    templates:
    - id: bob_template_v1
...
```

Um eine Vorlage zu einer bestehenden Zusammenarbeit hinzuzufügen, senden Sie eine Anfrage an alle potenziellen Datenanbieter indem Sie die folgenden Schritte ausführen:
1. Rufen Sie ADD_TEMPLATE_REQUEST mit der Vorlagen-ID auf, um den Genehmigungsablauf zu starten und die Vorlage zu einer bestimmten Zusammenarbeit für bestimmte Benutzende hinzuzufügen.
  
  Alle von der Vorlage betroffenen Teilnehmenden sehen die Anfrage, wenn sie VIEW_UPDATE_REQUESTS aufrufen.
2. Teilnehmende, denen die Anfrage mit dem Status PENDING_MY_APPROVAL angezeigt wird, sollten APPROVE_UPDATE_REQUEST oder REJECT_UPDATE_REQUEST aufrufen.
  - Wenn ein Teilnehmender die Anfrage ablehnt, wird die Aktualisierungsanfrage abgelehnt.
  - Eine einmal erteilte Zustimmung kann später nicht mehr in eine Ablehnung geändert werden – und umgekehrt ebenso wenig.
  - Die Vorlage wird erst dann freigegeben, wenn alle angefragten Parteien der Anfrage zugestimmt haben.
  - Mitarbeitende können später eine Genehmigung nicht in eine Ablehnung oder eine Ablehnung in eine Genehmigung ändern.
  - Nachdem Sie die Genehmigung erteilt haben, ändert sich der Status in PENDING_PARTNER_APPROVAL, wenn andere Teilnehmende die Genehmigung noch benötigen.
3. Wenn alle erforderlichen Teilnehmenden die Genehmigung erhalten haben, ändert sich der Status in APPROVED, und die Aktualisierung wird automatisch angewendet. Die Endstatus für eine Aktualisierungsanforderung sind COMPLETED und FAILED. Wenn der Status der Anfrage COMPLETED ist, steht die Vorlage den in der Anfrage zum Hinzufügen einer Vorlage angegebenen Benutzenden zur Verfügung. Wenn die Anfrage den Status FAILED aufweist, finden Sie in der Spalte DETAILS in VIEW_UPDATE_REQUESTS entsprechende Fehlerdetails. Wenn ein Teilnehmender die Anfrage ablehnt, lautet der Status REJECTED, und jeder von der ablehnenden Seite angegebene Grund ist im Anfragebericht sichtbar.
4. Nachdem eine Vorlage von allen Benutzenden genehmigt wurde, kann es eine kurze Verzögerung geben, bevor die Vorlage verfügbar ist. Rufen Sie VIEW_TEMPLATES auf, um zu bestätigen, dass die Vorlage zur Verwendung bereit ist.

Tipp

Um zu sehen, welche Vorlagen Sie registriert haben, rufen Sie VIEW_REGISTERED_TEMPLATES auf.

In Analyse ausführen erfahren Sie, wie Sie eine Analyse ausführen.

Vorlagenentwurf¶

Zusammenarbeitsvorlagen entsprechen den Vorlagen für Anbieter- und Verbraucher-Clean-Rooms, mit einigen besonderen Hinweisen:

Die Variable source_table der Vorlage wird mit den Datenangeboten der Zusammenarbeit gefüllt. In den meisten Vorlagen für die Zusammenarbeit ist source_table die einzige verwendete Datenquellenvariable.
my_table der Vorlage wird nur verwendet, wenn ein Analysis Runner die Snowflake Standard Edition nutzt und keine Datenangebote zu einer Zusammenarbeit beitragen kann.
Spalten aus den ursprünglichen Datenquellen können umbenannt werden, wenn sie für die Vorlage oder den Benutzer zugänglich sind. Unter Umbenennen der Quellspalte erfahren Sie mehr darüber, wie und wann Quellspalten umbenannt werden. Vorlagen und vom Benutzenden bereitgestellte Argumente (z. B. der Name einer Verknüpfungsspalte) sollten den endgültigen Namen und nicht den ursprünglichen Namen verwenden, wenn die Spalte umbenannt wird.
Aktivierungsvorlagen in einer Zusammenarbeit müssen nicht activation_<template_name> benannt werden. Alle anderen Anforderungen an die Aktivierungsvorlage gelten weiterhin.

Informationen zur benutzerdefinierten Vorlagensyntax in Snowflake Data Clean Rooms finden Sie unter benutzerdefinierten Design-Vorlagen.