Ajouter une ressource Lakebase à une application Databricks

Ajoutez des bases de données Lakebase en tant que ressources Databricks Apps pour conserver les données entre les déploiements. Ces ressources PostgreSQL sauvegardées permettent à votre application de créer et de gérer des schémas et des tables qui conservent l’état.

Les types de ressources de base de données Lakebase suivants sont disponibles :

• Mise à l’échelle automatique Lakebase : organise les ressources en tant que projets contenant des branches et des bases de données.
• Lakebase Provisioned : organise les ressources en tant qu’instances de base de données.

Les deux types utilisent le même modèle de connexion PostgreSQL et fournissent les mêmes variables d’environnement à votre application.

Ajouter une ressource de base de données

Avant d’ajouter une base de données Lakebase en tant que ressource, passez en revue les prérequis des ressources d’application.

Note

Vous ne pouvez pas créer de bases de données approvisionnées après le 12 mars 2026, mais vous pouvez ajouter des bases de données existantes en tant que ressources d’application. Consultez la mise à l’échelle automatique par défaut.

1. Dans la section Ressources de l’application lorsque vous créez ou modifiez une application, cliquez sur + Ajouterune> ressources.
2. Choisissez une base de données. Pour la mise à l’échelle automatique Lakebase, sélectionnez un projet, une branche et une base de données. Pour Lakebase Provisioned, sélectionnez une instance de base de données et une base de données dans cette instance.
3. Sélectionnez le niveau d’autorisation approprié pour votre application. Actuellement, la seule autorisation disponible est Can connect and create.
4. (Facultatif) Spécifiez une clé de ressource personnalisée, c’est-à-dire la façon dont vous référencez la base de données dans la configuration de votre application. La clé par défaut est postgres pour la mise à l’échelle automatique Lakebase et database pour Lakebase Provisioned.

Vous devez disposer CAN MANAGE d’autorisations sur le projet Lakebase pour l’ajouter en tant que ressource d’application.

Lorsque vous ajoutez une ressource de base de données :

• Azure Databricks crée un rôle PostgreSQL dans la base de données sélectionnée. Le nom du rôle correspond à l’ID client du principal de service . Si le rôle existe déjà, Azure Databricks le réutilise.
• Azure Databricks accorde au principal de service CONNECT et les privilèges CREATE sur la base de données sélectionnée. Ces privilèges permettent à l’application de créer des schémas et des tables dans la base de données.
• Pour la mise à l’échelle automatique Lakebase, l’utilisateur qui ajoute la ressource doit avoir CAN MANAGE l’autorisation sur le projet.

Variables d’environnement

Lorsque vous déployez une application avec une ressource de base de données, Azure Databricks définit les variables d’environnement suivantes pour la première ressource de base de données.

Si votre application utilise plusieurs bases de données PostgreSQL, ces variables reflètent uniquement la première. Utilisez valueFrom avec la clé de ressource pour récupérer les détails de connexion de la base de données. Consultez Utiliser des variables d’environnement pour accéder aux ressources.

Variable	Descriptif
PGAPPNAME	Nom de l’application
PGDATABASE	Nom de la base de données
PGHOST	Nom d’hôte du serveur PostgreSQL
PGPORT	Port pour le serveur PostgreSQL
PGSSLMODE	Mode SSL pour la connexion
PGUSER	ID client et nom du rôle du principal de service

Supprimer une ressource de base de données

Si vous supprimez des ressources de base de données d’une application, l’application tente de réaffecter tous les objets appartenant au principal du service à l’utilisateur qui supprime la ressource.

La logique utilisée par l’application dépend principalement du fait que vous disposez d’un rôle dans la base de données :

Vos autorisations	Rôle dans la base de données ?	Résultat
CAN MANAGE	Oui	Azure Databricks réaffecte tous les objets appartenant au principal de service à vous et supprime le rôle du service principal.
CAN MANAGE	Non	Azure Databricks crée un rôle pour vous, réaffecte tous les objets appartenant au rôle du principal de service et supprime le rôle du principal de service.
Non CAN MANAGE	N/A	Azure Databricks supprime la ressource, mais ne supprime pas le rôle ou réaffecte la propriété. Un avertissement apparaît dans l’interface utilisateur et vous devez nettoyer manuellement le rôle et les objets détenus ultérieurement.

Remarques

Tenez compte des éléments suivants lorsque vous ajoutez des bases de données en tant que ressources d’application :

• Si vous révoquez CONNECT et CREATE d'une base de données et que vous les accordez sur une autre dans la même mise à jour, Azure Databricks met à jour les privilèges, mais ne recrée pas le rôle du principal de service.
• Les bases de données conservent l’état. Tous les schémas ou tables créés par une application restent même après avoir redéployé ou arrêté l’application.