Enregistrement des données

Cette rubrique décrit comment enregistrer des données afin qu’elles puissent être liées à Snowflake Data Clean Room.

Objets pris en charge

Les types d’objets pouvant être liés à une salle blanche diffèrent selon qu’ils sont créés dans l’application Web ou à l’aide des APIs du développeur. Les objets spécifiques de ces types doivent être enregistrés avant de pouvoir être liés.

Application Web:

L’application Web de Snowflake Data Clean Rooms prend en charge les objets suivants :

  • Tables

  • Tables externes

  • Tables Apache Iceberg™

  • Vues

  • Vues matérialisées

  • Vues sécurisées. Le propriétaire d’une vue sécurisée doit être le rôle SAMOOHA_APP_ROLE.

API du développeur:

Comme les Snowflake Data Clean Rooms reposent sur le Snowflake Native App Framework, vous pouvez lier n’importe quel objet pris en charge par le Snowflake Native App Framework.

Note

Les tables externes et les tables Iceberg doivent être explicitement autorisées à être liées dans une salle blanche. Pour plus d’informations, voir Snowflake Data Clean Rooms : tables externes et Iceberg.

Enregistrement des objets de données

Avant que les utilisateurs puissent lier des données dans Snowflake Data Clean Room, les données doivent être enregistrées au niveau de la base de données, du schéma ou de l’objet. Si vous enregistrez une base de données ou un schéma, tous les objets de cette base de données ou de ce schéma sont enregistrés.

Vous pouvez enregistrer des bases de données, des schémas et des objets à l’aide de Snowsight ou les APIs du développeur <label-cleanrooms_register_api>. L’utilisation de Snowsight est plus simple, mais nécessite que vous ayez le rôle ACCOUNTADMIN. Avec les APIs du développeur, le propriétaire d’un objet peut l’enregistrer même s’il n’est pas administrateur de compte.

L’enregistrement d’une base de données, d’un schéma ou d’un objet donne accès au rôle SAMOOHA_APP_ROLE, qui est le rôle que les développeurs utilisent lorsqu’ils exécutent les APIs du développeur.

Note

L’enregistrement d’une base de données ou d’un schéma n’enregistre pas automatiquement les objets ajoutés après l’enregistrement. Vous devez enregistrer le nouvel objet individuellement, ou utiliser l’option Snowflake Admin dev l’application Web pour revenir à la section Database Registration, puis sélectionner Resync.

Enregistrer les données dans Snowsight

Pour enregistrer une base de données, un schéma ou un objet dans Snowsight, procédez comme suit :

  1. Connectez-vous à l’application Web.

  2. Sélectionnez Admin » Snowflake Admin.

  3. Sélectionnez Login to Snowflake et authentifiez-vous en tant qu’utilisateur avec le rôle ACCOUNTADMIN.

  4. Dans la section Database Registration, sélectionnez Edit, puis sélectionnez la base de données, le schéma ou l’objet.

  5. Sélectionnez Save.

Enregistrer les données à l’aide des APIs du développeur

Les APIs du développeur permettent aux administrateurs de compte d’enregistrer des bases de données, des schémas et des objets par programmation. Le propriétaire de la base de données, du schéma ou de l’objet peut l’enregistrer.

Les APIs suivantes sont disponibles :

Tâche

API

Entrée

Enregistrer une base de données

  • provider.register_db (pour les fournisseurs)

  • consumer.register_db (pour les consommateurs)

Nom de la base de données (string)

Enregistrer un schéma

library.register_schema

Noms de schéma (tableau de chaînes)

Créer un schéma d’accès géré

library.register_managed_access_schema

Noms de schéma d’accès géré (tableau de chaînes)

Enregistrer tout type d’objet

library.register_table_or_view

  • Noms d’objets (tableau de chaînes)

  • is_view (boolean)

  • is_iceberg (boolean)

  • is_external (boolean)

  • is_under_managed_access_schema (boolean)

Enregistrer une table

library.register_table

Noms de table (tableau de chaînes)

Enregistrer une vue

library.register_view

Voir les noms (tableau de chaînes)

Enregistrer une table dans un schéma d’accès géré

library.register_managed_access_table

Noms de table (tableau de chaînes)

Enregistrer une vue dans un schéma d’accès géré

library.register_managed_access_view

Voir les noms (tableau de chaînes)

Par exemple, le propriétaire d’un schéma MY_SCHEMA peut l’enregistrer en exécutant les commandes suivantes dans une feuille de calcul :

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

Désenregistrer les données à l’aide des APIsdu développeur

Vous pouvez utiliser les APIs suivantes pour inverser l’enregistrement des bases de données, des schémas et des objets :

Tâche

API

Entrée

Annuler l’enregistrement d’une base de données

library.unregister_db

Nom de la base de données (string)

Annuler l’enregistrement d’un schéma

library.unregister_schema

Noms de schéma (tableau de chaînes)

Annuler l’enregistrement d’un schéma d’accès géré

library.unregister_managed_access_schema

Noms de schéma d’accès géré (tableau de chaînes)

Annuler l’enregistrement de tout type d’objet

library.unregister_table_or_view

  • Noms d’objets (tableau de chaînes)

  • is_view (boolean)

  • is_iceberg (boolean)

  • is_external (boolean)

  • is_under_managed_access_schema (boolean)

Annuler l’enregistrement d’une table

library.unregister_table

Noms de table (tableau de chaînes)

Annuler l’enregistrement d’une vue

library.unregister_view

Voir les noms (tableau de chaînes)

Annuler l’enregistrement d’une table dans un schéma d’accès géré

library.unregister_managed_access_table

Noms de table (tableau de chaînes)

Annuler l’enregistrement d’une vue dans un schéma d’accès géré

library.unregister_managed_access_view

Voir les noms (tableau de chaînes)
Langage: Français