Gérer les bases de données

Une base de données est un conteneur pour les objets SQL tels que les schémas, les tables, les vues, les fonctions et les index. Dans Lakebase, une base de données existe au sein d'une Branch de projet, avec une limite de 500 bases de données par Branch.

Aperçu de la base de données

La Branch databricks_postgres de chaque projet est créée avec une base de données appelée , qui appartient au rôle Postgres pour votre identité Databricks (par exemple, user@databricks.com).

Les bases de données créées dans l’application Lakebase sont créées dans le schéma Postgres public default.

Si vous gérez votre projet avec Terraform et souhaitez intégrer cette base de données databricks_postgres implicite à la gestion IaC, consultez Configuration de projet Lakebase type avec Terraform pour le modèle d'adoption replace_existing.

Si vous utilisez plutôt des Declarative Automation Bundles, consultez la configuration de projet Lakebase typique avec les Declarative Automation Bundles pour le même modèle.

remarque

Les bases de données sont indépendantes entre les branches. Lorsque vous créez une Branch, celle-ci reflète les bases de données Postgres du parent au moment de la création de la branche. Après le branchement, les bases de données de chaque branch évoluent indépendamment — les bases de données créées ou supprimées sur une branch n’ont aucun effet sur les autres branchs, y compris la branch parente. Il n’y a pas de synchronisation automatique des bases de données entre les branches.

Afficher les bases de données

Pour afficher les bases de données d'une Branch, naviguez jusqu'à l'onglet Rôles et bases de données de votre Branch dans l'application Lakebase.

La section des bases de données affiche les informations sur toutes les bases de données dans la Branch sélectionnée :

Détail	Description
Nom de la base de données	Le nom de la base de données
Propriétaire	Le rôle Postgres qui possède tous les privilèges sur la base de données
Créé	Lorsque la base de données a été créée
Dernière mise à jour	La dernière fois que la base de données a été mise à jour

Détail	Description
Nom de la base de données	Le nom de la base de données
Propriétaire	Le rôle Postgres qui possède tous les privilèges sur la base de données
Créé	Lorsque la base de données a été créée
Dernière mise à jour	La dernière fois que la base de données a été mise à jour

Créer une base de données

Vous pouvez créer des bases de données Postgres supplémentaires sur votre branch en utilisant l'application Lakebase ou des commandes SQL.

Pour créer une base de données à l’aide de l’application Lakebase :

1. Accédez à la tab Rôles et bases de données de votre Branch dans l'application Lakebase.
2. Cliquez sur Ajouter une base de données , saisissez un nom de base de données conformément aux conventions de nommage de Postgres, et sélectionnez le rôle du propriétaire.

important

Certains noms de base de données sont réservés et ne peuvent pas être utilisés : databricks_postgres (déjà utilisé comme nom de base de données par default), postgres, template0, template1.

Gérer les bases de données avec SQL

Créer une base de données

Créez des bases de données à l'aide de commandes SQL Postgres standard :

SQL

CREATE DATABASE my_application_db
    WITH OWNER = my_app_role
    ENCODING = 'UTF8';

remarque

Les bases de données créées à l'aide de commandes SQL apparaîtront automatiquement dans l'application Lakebase sous le tab Rôles & Bases de données de votre Branch.

Liste des bases de données

Afficher toutes les bases de données dans votre projet :

SQL

SELECT datname FROM pg_database WHERE datistemplate = false;

Basculer entre les bases de données

Passez à une autre base de données :

• Dans l'éditeur Lakebase SQL: Sélectionnez la base de données dans le menu déroulant de la base de données.

• Dans le client SQL psql :

  SQL

  \c my_application_db

Surveiller la taille de la base de données

Vérifiez la taille logique d'une base de données :

SQL

SELECT
    datname AS database_name,
    pg_size_pretty(pg_database_size(datname)) AS size
FROM pg_database
WHERE datistemplate = false
ORDER BY pg_database_size(datname) DESC;

Supprimer une base de données

important

La suppression d'une base de données supprime définitivement tous les schémas, tables et données au sein de cette base de données. Cette action ne peut pas être annulée.

Pour supprimer une base de données à l'aide de l'application Lakebase :

1. Accédez à la tab Rôles et bases de données de votre Branch dans l'application Lakebase.
2. Cliquez sur le menu de la base de données, sélectionnez Supprimer la base de données et saisissez le nom de la base de données pour confirmer.

Pour supprimer à l'aide de SQL :

SQL

-- Drop the database
DROP DATABASE database_to_delete;