Daten registrieren¶

Unter diesem Thema wird beschrieben, wie Sie Daten registrieren, damit sie mit einem Snowflake Data Clean Room verknüpft werden können.

Unterstützte Objekte¶

Die Arten von Objekten, die mit einem Reinraum verknüpft werden können, unterscheiden sich, je nachdem, ob er in der Web-App oder mithilfe der Entwickler-APIs erstellt wird. Bestimmte Objekte dieser Art müssen registriert werden, bevor sie verknüpft werden können.

Web-App:

Die Web-App für Snowflake Data Clean Rooms unterstützt die folgenden Objekte:

Tabellen
Externe Tabellen
Apache Iceberg™-Tabellen
Ansichten
Materialisierte Ansichten
Sichere Ansichten. Der Eigentümer einer sicheren Ansicht muss die Rolle SAMOOHA_APP_ROLE haben.

Entwickler-API:

Da Snowflake Data Clean Rooms auf dem Snowflake Native App Framework basieren, können Sie jedes Objekt verknüpfen, das vom Snowflake Native App Framework unterstützt wird.

Bemerkung

Das Verknüpfen von externen Tabellen und Iceberg-Tabellen in einem Reinraum muss ausdrücklich erlaubt sein. Weitere Informationen dazu finden Sie unter Snowflake Data Clean Rooms: Externe und Iceberg-Tabellen.

Registrieren von Datenobjekten¶

Bevor Benutzer Daten in einen Snowflake Data Clean Room verknüpfen können, müssen die Daten auf Datenbank-, Schema- oder Objektebene registriert werden. Wenn Sie eine Datenbank oder ein Schema registrieren, werden alle Objekte in dieser Datenbank oder diesem Schema registriert.

Sie können Datenbanken, Schemas und Objekte mit Snowsight oder den Entwickler-APIs registrieren. Die Verwendung von Snowsight ist einfacher, erfordert aber, dass Sie die Rolle ACCOUNTADMIN haben. Mit den Entwickler-APIs kann der Eigentümer eines Objekts dieses registrieren, auch wenn er kein Kontoadministrator ist.

Durch die Registrierung einer Datenbank, eines Schemas oder eines Objekts wird der Zugriff auf die Rolle SAMOOHA_APP_ROLE gewährt. Dies ist die Rolle, die Entwickler verwenden, wenn sie den Entwickler-APIs ausführen.

Bemerkung

Durch die Registrierung einer Datenbank oder eines Schemas werden Objekte, die nach der Registrierung hinzugefügt werden, nicht automatisch registriert. Sie müssen das neue Objekt entweder einzeln registrieren oder die Option Snowflake Admin der Web-App verwenden, um zum Abschnitt Database Registration zurückzukehren, und dann Resync wählen.

Daten registrieren in Snowsight¶

Um eine Datenbank, ein Schema oder ein Objekt in Snowsight zu registrieren, gehen Sie wie folgt vor:

Melden Sie sich bei der Web-App an.
Wählen Sie Admin » Snowflake Admin aus.
Wählen Sie Login to Snowflake aus, und authentifizieren Sie sich als Benutzer mit der Rolle ACCOUNTADMIN.
Wählen Sie im Abschnitt Database Registration die Option Edit, und wählen Sie dann die Datenbank, das Schema oder das Objekt aus.
Wählen Sie Save aus.

Daten über den Entwickler-APIs registrieren¶

Mit Entwickler-APIs können Kontoadministratoren Datenbanken, Schemas und Objekte programmgesteuert registrieren. Der Eigentümer der Datenbank, des Schemas oder des Objekts kann es registrieren.

Die folgenden APIs sind verfügbar:

Aufgabe	API	Eingabe
Eine Datenbank registrieren	`provider.register_db` (für Anbieter) `consumer.register_db` (für Verbraucher)	Name der Datenbank (string)
Ein Schema registrieren	`library.register_schema`	Schema-Namen (Array von Zeichenfolgen)
Ein verwaltetes Zugriffsschema registrieren	`library.register_managed_access_schema`	Namen von verwalteten Zugriffsschemas (Array von Zeichenfolgen)
Jede Art von Objekt registrieren	`library.register_table_or_view`	Objektnamen (Array von Zeichenfolgen) is_view (boolean) is_iceberg (boolean) is_external (boolean) is_under_managed_access_schema (boolean)
Eine Tabelle registrieren	`library.register_table`	Tabellennamen (Array von Zeichenfolgen)
Eine Ansicht registrieren	`library.register_view`	Ansichtsnamen (Array von Zeichenfolgen)
Eine Tabelle in einem verwalteten Zugriffsschema registrieren	`library.register_managed_access_table`	Tabellennamen (Array von Zeichenfolgen)
Eine Ansicht in einem verwalteten Zugriffsschema registrieren	`library.register_managed_access_view`	Ansichtsnamen (Array von Zeichenfolgen)

Der Eigentümer eines Schemas MY_SCHEMA kann es zum Beispiel registrieren, indem er die folgenden Befehle in einem Arbeitsblatt ausführt:

CALL samooha_by_snowflake_local_db.library.register_schema(['MY_DB.MY_SCHEMA']);

Copy

Aufheben der Registrierung von Daten mit den Entwickler-APIs¶

Sie können die folgenden APIs verwenden, um die Registrierung von Datenbanken, Schemas und Objekten rückgängig zu machen:

Aufgabe	API	Eingabe
Aufheben der Registrierung einer Datenbank	`library.unregister_db`	Name der Datenbank (string)
Aufheben der Registrierung eines Schemas	`library.unregister_schema`	Schema-Namen (Array von Zeichenfolgen)
Aufheben der Registrierung eines verwalteten Zugriffsschemas	`library.unregister_managed_access_schema`	Namen von verwalteten Zugriffsschemas (Array von Zeichenfolgen)
Aufheben der Registrierung eines beliebigen Objekttyps	`library.unregister_table_or_view`	Objektnamen (Array von Zeichenfolgen) is_view (boolean) is_iceberg (boolean) is_external (boolean) is_under_managed_access_schema (boolean)
Aufheben der Registrierung einer Tabelle	`library.unregister_table`	Tabellennamen (Array von Zeichenfolgen)
Aufheben der Registrierung einer Ansicht	`library.unregister_view`	Ansichtsnamen (Array von Zeichenfolgen)
Aufheben der Registrierung einer Tabelle in einem verwalteten Zugriffsschema	`library.unregister_managed_access_table`	Tabellennamen (Array von Zeichenfolgen)
Aufheben der Registrierung einer Ansicht in einem verwalteten Zugriffsschema	`library.unregister_managed_access_view`	Ansichtsnamen (Array von Zeichenfolgen)