Tutoriel : Configurer l’accès bidirectionnel aux tables Apache Iceberg™ dans Databricks Unity Catalog¶

Introduction¶

Ce tutoriel explique comment connecter Snowflake à un catalogue dans Databricks Unity Catalog en utilisant une base de données liée à un catalogue et accessible en écriture avec des identifiants de connexion fournis par le catalogue. Cette configuration permet une collaboration bidirectionnelle des données entre Snowflake et Databricks.

Une base de données liée à un catalogue est une base de données Snowflake connectée à un catalogue REST Iceberg externe, tel qu’un catalogue dans Unity Catalog. Snowflake se synchronise automatiquement avec le catalogue externe pour détecter les espaces de noms et les tables Iceberg et enregistre les tables distantes dans la base de données liée au catalogue. Lorsqu’une base de données liée à un catalogue est accessible en écriture, elle prend également en charge la création et la suppression de schémas ou de tables Iceberg.

Les identifiants de connexion fournis par le catalogue pour les tables Iceberg vous permettent de donner à Snowflake l’accès aux données et métadonnées de votre table dans le stockage Cloud sans utiliser de volume externe. Lorsque vous connectez Snowflake à un catalogue dans Unity Catalog en utilisant des identifiants de connexion fournis par le catalogue, Unity Catalog fournit des identifiants de connexion temporaires à Snowflake pour accéder à vos données de table dans le stockage Cloud.

Avec cette configuration, vous pouvez effectuer les tâches suivantes :

Utiliser Snowflake pour interroger les tables Iceberg gérées par Unity Catalog.
Utiliser Snowflake pour insérer des données dans les tables Iceberg gérées par Unity Catalog.
Utiliser Snowflake pour créer des tables Iceberg gérées par Unity Catalog.
Utiliser Databricks pour travailler avec des tables Iceberg gérées par Unity Catalog que vous avez créées ou modifiées depuis Snowflake.

Pour suivre les étapes de ce tutoriel sur l’utilisation de Snowflake, utilisez une feuille de calcul dans Snowsight, ou utilisez un client Snowflake tel que SnowSQL. Vous pouvez copier et coller les exemples de code, puis les exécuter. Pour suivre les étapes de ce tutoriel sur l’utilisation des Databricks, utilisez votre espace de travail Databricks pour copier et coller les exemples de code, ou suivez les instructions de la documentation Databricks liée.

Ce que vous apprendrez¶

Dans ce tutoriel, vous apprendrez à effectuer ce qui suit :

Créer un catalogue dans Unity Catalog.
Configurer les identifiants de connexion pour l’authentification que Snowflake doit utiliser en ajoutant un principal de service et un secret OAuth dans Databricks.
Utiliser Databricks pour permettre à Snowflake d’accéder à votre catalogue dans Unity Catalog.
Créer une intégration de catalogue dans Snowflake qui utilise des identifiants de connexion fournis pour connecter Snowflake à votre catalogue dans Unity Catalog.
Créer une base de données liée à un catalogue dans Snowflake qui se synchronise avec votre catalogue dans Unity Catalog et qui vous permet d’écrire dans votre catalogue dans Unity Catalog à partir de Snowflake.
Travailler avec des tables Iceberg gérées par Unity Catalog à partir de Snowflake, ce qui inclut l’interrogation et l’insertion de données dans ces tables et la création d’une table Iceberg gérée par Unity Catalog à partir de Snowflake.
Travailler avec des tables Iceberg gérées par Unity Catalog depuis Databricks.

Conditions préalables¶

Avant de commencer, vous devez vous familiariser avec les concepts suivants :

Identificateurs d’objets Snowflake et leurs exigences.
Tables Apache Iceberg et Iceberg dans Snowflake. Pour plus d’informations, voir Tables Apache Iceberg™.
Databricks Unity Catalog. Pour plus d’informations, consultez Qu’est-ce que Unity Catalog ? dans la documentation Databricks.

Vous avez besoin des éléments suivants :

Databricks

Un compte Databricks hébergé sur AWS, Azure ou Google Cloud.
Un espace de travail Databricks avec Unity Catalog activé.

Pour obtenir des instructions sur la manière d’activer un espace de travail pour Unity Catalog, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :
- Databricks sur AWS : Databricks sur AWS : Activer un espace de travail pour Unity Catalog
- Azure Databricks : Azure Databricks : Activer un espace de travail pour Unity Catalog
- Databricks sur Google Cloud : Databricks sur Google Cloud : Activer un espace de travail pour Unity Catalog
Accès requis :
- Privilège d’administrateur metastore ou privilège CREATE CATALOG sur le metastore pour créer un catalogue dans Unity Catalog.
  
  Note
  
  Dans ce tutoriel, vous allez créer un catalogue dans Unity Catalog, faisant de vous un propriétaire de ce catalogue. En tant que propriétaire de catalogue, vous pouvez accorder à un principal de service Databricks des privilèges sur votre catalogue, ce que vous ferez dans ce tutoriel.
- Privilège d’administrateur de compte ou d’administrateur d’espace de travail pour votre espace de travail Databricks pour créer un principal de service et un secret OAuth
- Privilège d’administrateur metastore pour activer l’accès aux données externes sur le metastore

Snowflake

Un utilisateur de Snowflake avec un rôle qui a les privilèges pour effectuer les actions suivantes :
Si vous utilisez un compte d’essai de 30 jours, vous pouvez vous connecter en tant qu’utilisateur créé pour ce compte. Cet utilisateur a le rôle avec les privilèges nécessaires pour créer les objets.

Si vous n’avez pas d’utilisateur ayant les autorisations nécessaires, demandez à quelqu’un qui les a d’en créer un pour vous. Les utilisateurs ayant le rôle ACCOUNTADMIN peuvent créer de nouveaux utilisateurs et leur accorder les privilèges requis.

Étape 1 : Créer un catalogue dans Databricks Unity Catalog¶

Dans Databricks, exécutez les instructions suivantes pour créer un catalogue example_sales_catalog dans Unity Catalog avec les objets suivants :

Un schéma customers
Une table customer_accounts avec quelques données d’exemple, qui sont imbriquées sous le schéma customers

CREATE CATALOG example_sales_catalog;

CREATE SCHEMA example_sales_catalog.customers;

CREATE TABLE example_sales_catalog.customers.customer_accounts (
  customer_account_id INT,
  customer_id INT,
  account_status STRING,
  created_at TIMESTAMP,
  updated_at TIMESTAMP
) USING ICEBERG;

INSERT INTO example_sales_catalog.customers.customer_accounts VALUES
  (1, 1001, 'Active', CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP()),
  (2, 1002, 'Active', CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP()),
  (3, 1003, 'Inactive', CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP()),
  (4, 1004, 'Active', CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP()),
  (5, 1005, 'Pending', CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP());

Copy

Étape 2 : Ajouter un principal de service dans Databricks¶

À cette étape, vous allez ajouter un principal de service dans Databricks.

Pour permettre à Snowflake de s’authentifier avec Unity Catalog, vous devez ajouter un principal de service dans Databricks, puis créer un secret OAuth pour votre principal de service dans Databricks.

Ajouter un principal de service dans Databricks¶

Pour ajouter un principal de service, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :
- Databricks sur AWS : Databricks sur AWS : Ajouter des principaux de service à votre compte
- Azure Databricks : Azure Databricks : Ajouter des principaux de service à votre compte
- Databricks sur Google Cloud : Databricks sur Google Cloud : Ajouter des principaux de service à votre compte
Copiez la valeur ID d’application pour votre principal de service dans un éditeur de texte et stockez-la de manière sécurisée. Vous spécifierez cette valeur ultérieurement, lorsque vous créerez une intégration de catalogue dans Snowflake.

Créer un secret OAuth pour votre principal de service¶

Pour créer un secret OAuth pour votre principal de service, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :
- Databricks sur AWS : Databricks sur AWS : Créer un secret OAuth
- Azure Databricks : Azure Databricks : Créer un secret OAuth
- Databricks sur Google Cloud : Databricks sur Google Cloud : Créer un secret OAuth
Copiez la valeur Secret que vous avez générée dans un éditeur de texte et stockez-la de manière sécurisée. Vous spécifierez cette valeur ultérieurement, lorsque vous créerez une intégration de catalogue dans Snowflake.

Important

Le secret du client n’est affiché qu’une seule fois. Assurez-vous de le copier avant de fermer la boîte de dialogue.

À l’étape suivante, vous accorderez des privilèges au principal de service que vous avez créé, ce qui permettra à Snowflake d’accéder à votre catalogue example_sales_catalog dans Unity Catalog.

Étape 3 : Activer l’accès de Snowflake à Unity Catalog¶

À cette étape, vous utilisez Databricks pour permettre à Snowflake d’accéder à votre catalogue dans Unity Catalog.

Pour permettre à Snowflake d’accéder à votre catalogue dans Unity Catalog par le biais d’identifiants de connexion fournis, tout d’abord, au niveau du metastore, vous devez activer l’accès aux données externes sur le metastore. Ensuite, vous devez accorder à votre principal de service des privilèges Unity Catalog sur votre catalogue.

Activer l’accès aux données externes sur le metastore¶

Tout d’abord, activez l’accès aux données externes sur le metastore.

Pour obtenir des instructions sur la manière d’activer l’accès aux données externes sur le metastore, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :

Accorder à votre principal de service l’accès à votre catalogue¶

Ensuite, vous devez accorder à votre principal de service les privilèges Unity Catalog. Vous devez accorder ces privilèges à votre principal de service pour permettre à Snowflake d’accéder au catalogue en fonction des privilèges que vous spécifiez.

Utilisez l’Explorateur de catalogues pour sélectionner le catalogue example_sales_catalog, puis accordez les privilèges suivants à votre principal de service au niveau du catalogue :

Pour accorder des autorisations en utilisant l’Explorateur de catalogues Databricks, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :

Important

Dans le champ Principals, vous devez saisir le nom de votre principal de service, et non l’adresse e-mail d’un utilisateur ou le nom d’un groupe.

Exécutez les instructions suivantes pour accorder à votre principal de service les privilèges nécessaires pour terminer ce tutoriel. Consultez Description des privilèges pour obtenir une description de chaque privilège.

GRANT CREATE TABLE ON CATALOG example_sales_catalog TO `<application_id>`;
GRANT EXTERNAL USE SCHEMA ON CATALOG example_sales_catalog TO `<application_id>`;
GRANT MODIFY ON CATALOG example_sales_catalog TO `<application_id>`;
GRANT SELECT ON CATALOG example_sales_catalog TO `<application_id>`;
GRANT USE CATALOG ON CATALOG example_sales_catalog TO `<application_id>`;
GRANT USE SCHEMA ON CATALOG example_sales_catalog TO `<application_id>`;

Copy

Où :

<application_id> is the Application ID for your service principal, which you copied in a previous step. 1aaa1a1a-11a1-1111-1111-1a11111aa1a est un exemple d’ID d’application pour un principal de service.

Description des privilèges¶

Le tableau suivant décrit chaque privilège de Unity Catalog que vous avez accordé à votre principal de service et l’accès que chaque privilège accorde à Snowflake :

Privilège	Description
`CREATE TABLE`	Permet à Snowflake de créer de nouvelles tables Iceberg dans le catalogue. Nécessaire pour créer des tables Iceberg gérées par Unity Catalog à partir de Snowflake.
`EXTERNAL USE SCHEMA`	Permet à Unity Catalog de générer et de fournir des identifiants de connexion temporaires et limités à Snowflake pour accéder aux données des tables dans le stockage Cloud. Important Ce privilège est requis lorsque vous utilisez des identifiants de connexion fournis avec une base de données liée à un catalogue.
`MODIFY`	Permet à Snowflake d’insérer, de mettre à jour ou de supprimer des données dans des tables existantes. Nécessaire pour écrire des données dans les tables Iceberg gérées par Unity Catalog à partir de Snowflake.
`SELECT`	Permet à Snowflake d’interroger les tables et d’accéder aux métadonnées des tables. Nécessaire pour toutes les opérations dans Snowflake, y compris la lecture de données et la découverte de tables dans la base de données liée au catalogue.
`USE CATALOG`	Permet à Snowflake d’accéder au catalogue. Nécessaire pour se connecter à tous les objets dans Unity Catalog et interagir avec eux.
`USE SCHEMA`	Permet à Snowflake d’accéder aux schémas (espaces de noms) à l’intérieur du catalogue. Nécessaire pour afficher et travailler avec des tables dans des schémas spécifiques.

Étape 4 : Rassembler les informations de votre espace de travail Databricks¶

À cette étape, vous utilisez Databricks pour collecter des informations sur votre espace de travail. Vous avez besoin de ces informations pour les spécifier ultérieurement lorsque vous créerez une intégration de catalogue dans Snowflake.

Rassemblez les informations suivantes à partir de votre espace de travail Databricks :

URL de l’espace de travail Databricks : Il s’agit de l’URL que vous utilisez pour accéder à votre espace de travail Databricks.

Pour obtenir des instructions sur la manière de trouver cette URL, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :
- Databricks sur AWS : Databricks sur AWS : Noms des instances d’espace de travail, URLs et IDs
- Azure Databricks : Azure Databricks : Déterminer l’URL par espace de travail
- Databricks sur Google Cloud : Databricks sur Google Cloud : Noms des instances d’espace de travail, URLs et IDs
Voici un exemple d’URL d’espace de travail Databricks pour chaque plateforme Cloud :
- Databricks sur AWS : https://dbc-a1a1a1a1-a1a1.cloud.databricks.com
- Azure Databricks : https://adb-1111111111111111.1.azuredatabricks.net
- Databricks sur Google Cloud : https://1111111111111111.1.gcp.databricks.com
Nom du catalogue dans Unity Catalog : Le nom du catalogue dans Unity Catalog auquel vous souhaitez accéder depuis Snowflake, qui est example_sales_catalog.
ID d’application : L’ID d’application pour le principal de service que vous avez ajouté dans Databricks.
Secret OAuth : Le secret OAuth pour le principal de service que vous avez ajouté dans Databricks.

Copiez ces valeurs dans un éditeur de texte. Vous les utiliserez lorsque vous créerez une intégration de catalogue dans Snowflake.

Étape 5 : Configurer un entrepôt et une intégration de catalogue dans Snowflake¶

Dans Snowflake, configurez votre environnement en créant un entrepôt et une intégration de catalogue pour ce tutoriel.

Créer un entrepôt¶

Exécutez les instructions suivantes pour créer un entrepôt.

CREATE WAREHOUSE catalog_linked_database_tutorial_wh
  WAREHOUSE_TYPE = STANDARD
  WAREHOUSE_SIZE = XSMALL;

USE WAREHOUSE catalog_linked_database_tutorial_wh;

Copy

Créer une intégration de catalogue¶

Dans Snowflake, créez une intégration de catalogue qui connecte Snowflake à votre catalogue example_sales_catalog dans Unity Catalog en utilisant l’authentification OAuth et les identifiants de connexion fournis.

Pour créer une intégration de catalogue pour Databricks Unity Catalog, utilisez la commande CREATE CATALOG INTEGRATION (Apache Iceberg™ REST).

L’exemple suivant crée une intégration de catalogue REST pour la connexion à votre catalogue example_sales_catalog en utilisant OAuth :

CREATE OR REPLACE CATALOG INTEGRATION my_unity_catalog_int_vended_creds
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  REST_CONFIG = (
    CATALOG_URI = '<databricks_workspace_url>/api/2.1/unity-catalog/iceberg-rest'
    CATALOG_NAME = 'example_sales_catalog'
    ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS
  )
  REST_AUTHENTICATION = (
    TYPE = OAUTH
    OAUTH_TOKEN_URI = '<databricks_workspace_url>/oidc/v1/token'
    OAUTH_CLIENT_ID = '<client_id>'
    OAUTH_CLIENT_SECRET = '<oauth_secret>'
    OAUTH_ALLOWED_SCOPES = ('all-apis')
  )
  ENABLED = TRUE;

Copy

Où :

<databricks_workspace_url> est l’URL de votre espace de travail Databricks, que vous avez trouvé à l’étape précédente.
example_sales_catalog est le nom de votre catalogue dans Unity Catalog auquel vous souhaitez vous connecter.
<client_id> est l’ID de client OAuth pour le principal de service que vous avez créé dans Databricks.

Important

Dans Databricks, cette valeur est appelée ID d’application, et non ID de client.
<oauth_secret> est le secret OAuth que vous avez généré pour le principal de service que vous avez créé dans Databricks.

Vérifier l’intégration de votre catalogue¶

Pour vérifier la configuration pour votre intégration de catalogue, appelez la fonction SYSTEM$VERIFY_CATALOG_INTEGRATION.

Pour obtenir plus d’informations, y compris un exemple, consultez Utiliser SYSTEM$VERIFY_CATALOG_INTEGRATION pour vérifier la configuration de votre intégration de catalogue.

Ensuite, vous spécifierez l’intégration de catalogue que vous avez créée lorsque vous créez une base de données liée à un catalogue qui découvre votre catalogue example_sales_catalog et se synchronise avec ce dernier dans Unity Catalog.

Étape 6 : Créer une base de données liée à un catalogue¶

À cette étape, vous créez une base de données liée à un catalogue qui se connecte à votre catalogue example_sales_catalog dans Unity Catalog en utilisant l’intégration de catalogue que vous avez créée à l’étape précédente.

Pour créer une base de données liée à un catalogue, utilisez la commande CREATE DATABASE (liée à un catalogue) :

L’exemple suivant crée une base de données liée à un catalogue qui est accessible en écriture, utilise des identifiants de connexion fournis, et spécifie un espace de noms bloqué.

CREATE DATABASE unity_linked_db
  LINKED_CATALOG = (
    CATALOG = 'my_unity_catalog_int_vended_creds'
    BLOCKED_NAMESPACES = ('information_schema')
  );

Copy

Où :

my_unity_catalog_int_vended_creds est le nom de l’intégration de catalogue que vous avez créée à l’étape précédente.

Note

Vous n’avez pas besoin de spécifier le paramètre ALLOWED_WRITE_OPERATIONS pour créer une base de données liée à un catalogue qui est accessible en écriture. Cela s’explique par le fait que la valeur par défaut de ce paramètre est ALL, ce qui signifie que votre base de données liée à un catalogue est accessible en écriture.
BLOCKED_NAMESPACES = ('information_schema') empêche Snowflake de se synchroniser avec le schéma information_schema dans votre Unity Catalog. Sinon, ce schéma renvoie des erreurs d’exécution SQL non pertinentes lorsque vous vérifiez ultérieurement l’état de synchronisation du catalogue. Ces erreurs ne sont pas pertinentes, car les tables imbriquées sous ce schéma ne sont pas compatibles avec Iceberg.

Les tables et les vues imbriquées sous le schéma information_schema sont des tables et des vues Databricks intégrées. Ce ne sont pas des tables Iceberg.
L’exemple de code configure votre base de données liée à un catalogue avec des identifiants de connexion fournis, de sorte que vous n’avez pas besoin de spécifier un volume externe.
Par défaut, le paramètre ALLOWED_WRITE_OPERATIONS est défini sur ALL, ce qui signifie que votre base de données liée à un catalogue prend en charge les opérations de lecture et d’écriture.

Maintenant que vous avez créé une base de données liée à un catalogue, Snowflake se synchronise automatiquement avec votre Unity Catalog pour découvrir les espaces de noms et les tables Iceberg. L’intervalle de synchronisation par défaut est de 30 secondes.

Étape 7 : Vérifier l’état de synchronisation du catalogue¶

Pour vérifier que Snowflake a correctement lié votre catalogue dans Unity Catalog à votre base de données, utilisez la fonction SYSTEM$CATALOG_LINK_STATUS :

SELECT SYSTEM$CATALOG_LINK_STATUS('unity_linked_db');

Copy

La fonction renvoie des informations sur l’état de synchronisation, y compris les tables qui n’ont pas réussi à se synchroniser.

Si la synchronisation réussit, vous devriez voir les espaces de noms de votre Unity Catalog apparaître comme schémas dans la base de données liée à un catalogue, et les tables Iceberg apparaître sous leurs schémas respectifs.

Note

Pour identifier les tables que Snowflake a créées mais n’a pas pu initialiser, utilisez la commande SHOW ICEBERG TABLES. Pour plus d’informations, voir Identifier les tables qui ont été créées, mais qui n’ont pas pu être initialisées.

Étape 8 : Travailler avec des tables Iceberg¶

Une fois la synchronisation des catalogues terminée, vous pouvez interroger et insérer des données dans vos tables Iceberg gérées par Unity Catalog directement depuis Snowflake et créer une table Iceberg gérée par Unity Catalog à partir de Snowflake.

Vous pouvez ensuite utiliser Databricks pour travailler avec les tables que vous avez créées ou modifiées depuis Snowflake.

Interroger des tables Iceberg depuis Snowflake¶

Pour interroger une table Iceberg gérée par Unity Catalog, procédez comme suit :

Sélectionnez votre base de données liée à un catalogue.
```
USE DATABASE unity_linked_db;
```
Copy
Interrogez une table dans votre catalogue dans Unity Catalog.

L’exemple suivant interroge la table customer_accounts, qui est imbriquée sous le schéma de niveau supérieur customers dans le catalogue example_sales_catalog dans Unity Catalog.
```
SELECT * FROM customers.customer_accounts
  LIMIT 20;
```
Copy

Note

Pour connaître les exigences relatives à l’identification d’objets dans une base de données liée à un catalogue, consultez Requirements for identifier resolution in a catalog-linked database.

Insérer des données dans les tables Iceberg depuis Snowflake¶

Avec une base de données liée à un catalogue, vous pouvez utiliser Snowflake pour insérer des données dans vos tables Iceberg gérées par Unity Catalog.

Pour insérer des données dans une table Iceberg gérée par Unity Catalog à partir de Snowflake, procédez comme suit :

Sélectionnez votre base de données liée à un catalogue.
```
USE DATABASE unity_linked_db;
```
Copy

Insérez les données dans la table customer_accounts.

INSERT INTO customers.customer_accounts (
  customer_account_id,
  customer_id,
  account_status,
  created_at,
  updated_at
)
  VALUES
    (6, 1006, 'ACTIVE', '2025-12-15 10:23:45', '2025-12-15 10:23:45');

Copy

Créer une nouvelle table Iceberg à partir de Snowflake¶

Avec une base de données liée à un catalogue, vous pouvez également utiliser Snowflake pour créer une table Iceberg gérée par Unity Catalog.

Pour créer une table Iceberg gérée par Unity Catalog à partir de Snowflake, procédez comme suit :

Sélectionnez votre base de données liée à un catalogue.
```
USE DATABASE unity_linked_db;
```
Copy
Sélectionnez le schéma de votre catalogue dans Unity Catalog dans lequel vous souhaitez créer une table Iceberg.
```
USE SCHEMA customers;
```
Copy
Créez une table Iceberg.
```
CREATE ICEBERG TABLE table_created_from_snowflake (
  id INT,
  name STRING,
  created_date DATE
);
```
Copy
Lorsque vous créez une table dans une base de données liée à un catalogue, Snowflake crée la table à la fois dans Snowflake et dans votre catalogue dans Unity Catalog. Lorsque vous mettez à jour la table en utilisant Snowflake ou Databricks, Snowflake conserve la synchronisation des deux instances de table.

Supprimer une table Iceberg de Snowflake¶

Étant donné que votre base de données liée à un catalogue est accessible en écriture, vous pouvez utiliser la commande DROP ICEBERG TABLE pour supprimer une table Iceberg de Snowflake. Pour supprimer une table de Snowflake, votre principal de service Databricks doit se voir accorder le privilège MANAGE.

Avertissement

Lorsque les autorisations d’écriture sont activées dans votre base de données liée au catalogue, Snowflake propage les suppressions de table vers le catalogue distant, ce qui supprime la table et les données des deux systèmes.

Travailler avec des tables Iceberg de Databricks¶

Dans Databricks, essayez les tâches suivantes :

Insérez des données dans la table Iceberg table_created_from_snowflake que vous avez créée depuis Snowflake.
```
USE CATALOG example_sales_catalog;
USE SCHEMA customers;
INSERT INTO table_created_from_snowflake VALUES
  (1, 'John', CURRENT_TIMESTAMP());
```
Copy
Note

Si vous recevez une erreur PERMISSION_DENIED, vous devrez peut-être d’abord accorder les privilèges MODIFY et SELECT pour la table à votre utilisateur Databricks.
Interrogez la table customer_accounts pour afficher les données que vous avez insérées depuis Snowflake.
```
USE CATALOG example_sales_catalog;
USE SCHEMA customers;
SELECT * FROM customer_accounts;
```
Copy

Actualisation automatique pour vos tables Iceberg¶

L’actualisation automatique est activée par défaut pour les tables Iceberg dans votre base de données liée à un catalogue. Par conséquent, lorsque vous mettez à jour votre table Iceberg depuis Databricks, la table Iceberg correspondante dans Snowflake est automatiquement actualisée avec les mises à jour.

Pour vérifier l’état d’actualisation automatique de vos tables Iceberg gérées par Unity Catalog, utilisez la fonction système SYSTEM$AUTO_REFRESH_STATUS dans Snowflake.

Nettoyage¶

Nettoyage dans Snowflake¶

Pour supprimer tous les objets créés pour ce tutoriel, exécutez les instructions DROP suivantes.

Remplacez les valeurs suivantes :

my_other_database par le nom d’une base de données à utiliser afin que vous puissiez supprimer celle créée pour ce tutoriel.
my_other_warehouse par le nom d’un entrepôt à utiliser afin que vous puissiez supprimer celui créé pour ce tutoriel.

USE DATABASE <my_other_database>;
DROP DATABASE unity_linked_db;
DROP CATALOG INTEGRATION my_unity_catalog_int_vended_creds;
USE WAREHOUSE <my_other_warehouse>;
DROP WAREHOUSE catalog_linked_database_tutorial_wh;

Copy

Nettoyage dans Databricks¶

Supprimez le catalogue example_sales_catalog.

DROP CATALOG example_sales_catalog cascade;

Copy

Supprimez votre principal de service.

Pour obtenir des instructions, consultez la rubrique correspondant à l’endroit où votre compte Databricks est hébergé :
- Databricks sur AWS : Databricks sur AWS : Gérer les principaux de service
- Azure Databricks : Azure Databricks : Gérer les principaux de service
- Databricks sur Google Cloud : Databricks sur Google Cloud : Gérer les principaux de service

Résumé et ressources supplémentaires¶

Dans ce tutoriel, vous avez suivi un workflow de bout en bout pour configurer l’accès bidirectionnel à Unity Catalog en utilisant une base de données liée à un catalogue avec des identifiants de connexion fournis.

En cours de route, vous avez accompli les tâches suivantes :

Pour en savoir plus sur les tables Iceberg pour Snowflake, consultez la documentation sur les tables Iceberg.