Registrys¶

Übersicht¶

Um eine Ressource wie eine Vorlage oder ein Datenangebot in einer Collaboration zu verwenden, müssen Sie sie zunächst in einer Registry registrieren. Eine Registry ist ein Container auf Kontoebene, in dem diese Ressourcen gespeichert werden. Nach der Registrierung kann jede Ressource in der Registry von jedem Benutzer in Ihrem Konto, der sowohl Zugriff auf die Registry als auch über die erforderlichen Berechtigungen für diese spezielle Zusammenarbeit hat, mit einer Collaboration verknüpft werden. Insbesondere sind Registrys unabhängig von bestimmten Collaborations. Eine registrierte Ressource kann mit einer beliebigen Anzahl von oder gar keinen Collaborations innerhalb dieses Kontos verknüpft werden.

Jedes Snowflake-Konto unterstützt eine Standard-Registry. Sie können weitere kundenspezifische Registrys für Ihr Konto erstellen. Kundenspezifische Registrys sind eine gute Möglichkeit, den Zugriff auf Ihre Ressourcen zu gruppieren und zu verwalten. Sie könnten z. B. eine kundenspezifische Registry für die Umsatzdaten und eine weitere für die Ausgabendaten erstellen und dann den entsprechenden Benutzenden über :doc:`DCR-Rollen und benutzerdefinierte RBAC-Rollen </user-guide/cleanrooms/manage-access> ` Zugriff auf diese Registrys gewähren.

Registry-Regeln¶

Hier sind die wichtigsten Regeln für Registrys:

• Registrys sind Objekte auf Kontoebene. Benutzer können nur Registrys in ihrem eigenen Konto anzeigen und darauf zugreifen. Wenn jedoch eine Ressource in einer Registry mit einer Collaboration verknüpft ist, ist die Ressource für jeden sichtbar, der gemäß der Spezifikation auf sie zugreifen kann. Ein Zugriff auf die enthaltene Registry ist nicht erforderlich.

• Jede kundenspezifische Registrierung unterstützt einen einzigen Ressourcentyp (Vorlage, Datenangebot usw.). Der Ressourcentyp wird angegeben, wenn Sie die Registry erstellen. Die Standard-Registry unterstützt alle Ressourcentypen.

• Es gibt kein Limit für die Anzahl der kundenspezifischen Registrys, die Sie in einem Konto erstellen können.

• Wenn Sie eine Ressource registrieren, können Sie den optionalen Parameter für den Registrierungsnamen verwenden, um eine kundenspezifische Registry anzugeben. Wenn Sie keine kundenspezifische Registry angeben, wird die Ressource in der Standardregistrierung für das Konto registriert.

• Alle Benutzer haben Zugriff auf die Standardregistrierung in einem Konto. Kundenspezifische Registrys sind jedoch zunächst privat für den Erstellenden, und zusätzlichen Benutzenden muss explizit Zugriff gewährt werden, indem Sie GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE aufrufen.

• Ein Konto kann mehrere Registrys haben, die denselben Ressourcentyp speichern.

• Registrys haben keine maximale Anzahl von Ressourcen.

• Eine Ressource muss in allen Registrys in diesem Konto für Ressourcen dieses Typs einen eindeutigen Namen haben. Sie können zum Beispiel eine Vorlage mit dem Namen sales und ein Datenangebot mit dem Namen sales im selben Konto haben, aber nicht zwei Vorlagen mit dem Namen sales entweder in derselben oder in verschiedenen Registrys in demselben Konto. Der Ressourcenname ist als der name-Wert der höchsten Ebene in der Spezifikation definiert.

• Wenn zwei verschiedene Konten Ressourcen mit demselben Namen und Typ mit einer Collaboration verknüpfen, ist dies zulässig. Die Zusammenarbeitsspezifikation zeigt identisch benannte Ressourcen an, aber das System weiß, welche Ressource vorgesehen ist – die Ressource mit diesem Namen wird von dem Konto verwendet, das die Ressource mit der Collaboration verknüpft hat.

Beispiel¶

In diesem Beispiel wird eine kundenspezifische Registry erstellt, darin eine Vorlage registriert und einer neuen Rolle Lesezugriff auf diese Registry gewährt. Benutzer mit dieser Rolle können Vorlagen in dieser Registry mit einer Collaboration verknüpfen.

-- Create a custom registry that can hold templates.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.CREATE_REGISTRY(
  'SALES',
  'TEMPLATE'
);

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.REGISTER_TEMPLATE(
'SALES',
$$
api_version: 2.0.0
spec_type: template
name: alice_only_template
version: v1
type: sql_analysis
description: Joins two tables on hashed email and counts matches grouped by status.
template:
  SELECT t1.status, COUNT(*)
    FROM IDENTIFIER( {{ source_table[0] }} ) AS t1
    JOIN IDENTIFIER( {{ source_table[1] }} ) AS t2
    ON t1.hashed_email_b64_encoded = t2.hashed_email_b64_encoded
    GROUP BY t1.status;
$$
);

-- Create a role and grant it access to the registry.
CREATE ROLE MARKETING_USERS;
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE(
  'READ',
  'REGISTRY',
  'SALES',
  'MARKETING_USERS'
);

-- Grant access to the registry for a user by assigning the role.
GRANT ROLE MARKETING_USERS to USER willy_loman;