Enregistrez votre base de données dans Unity Catalog

info

Lakebase Provisioned est l'offre originale de Lakebase qui utilise un compute provisionné que vous mettez à l'échelle manuellement. Pour les régions prises en charge, consultez la disponibilité des régions. Pour la dernière version de Lakebase, avec compute à dimensionnement automatique, mise à l'échelle jusqu'à zéro, création de branches et restauration instantanée, consultez Lakebase Autoscaling.

Depuis le 12 mars 2026, les nouvelles instances Lakebase sont créées en tant que projets de dimensionnement automatique. Les instances provisionnées existantes sont mises à niveau automatiquement vers la mise à l'échelle automatique, à compter de juin 2026. Pour plus de détails, consultez Mise à niveau vers le dimensionnement automatique Lakebase.

Cette page explique comment enregistrer votre base de données Lakebase en tant que catalogue Unity Catalog en lecture seule. Cela vous permet d'utiliser les privilèges Unity Catalog pour gérer l'accès aux données et tirer parti d'intégrations telles que la synchronisation de données gérée.

Propriété et autorisations

• Si la base de données n’existe pas , elle peut être créée en même temps que le catalogue. Dans ce cas, la propriété des objets suivra ces directives.
• Le créateur du catalogue doit en outre disposer des privilèges CREATE CATALOG sur le métastore Unity Catalog.

Créer un catalogue

Pour enregistrer une base de données avec Unity Catalog, utilisez l’interface utilisateur Databricks, l’appel d’API, le SDK Python ou la CLI.

UI

1. Cliquez sur Applications dans le coin supérieur droit et sélectionnez Lakebase Postgres .

2. Cliquez sur **Provisionné** pour ouvrir la page **Instances provisionnées**.

3. Sélectionnez votre instance de base de données.

4. Sélectionnez la page Catalogues dans la barre latérale de l'application Lakebase.

5. Cliquez sur Ajouter un catalogue en haut à droite.

6. Dans la boîte de dialogue **Ajouter un catalogue** :

   • **Nom du catalogue** : Saisissez le nom de catalogue Unity Catalog souhaité.
   • **Base de données Postgres** : Sélectionnez une base de données Postgres existante dans le menu déroulant (pardatabricks_postgres exemple,), ou saisissez un nouveau nom de base de données pour la créer avec le catalogue.

7. Cliquez sur Créer .

8. Après la création, cliquez sur le catalogue dans la liste **Catalogues** pour voir l'affichage de l'Explorateur de catalogues.

Python SDK

Python

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.database import DatabaseCatalog

# Initialize the Workspace client
w = WorkspaceClient()

# Register an existing database as a UC catalog
catalog = w.database.create_database_catalog(
    DatabaseCatalog(
        name="my_catalog",                    # Name of the UC catalog to create
        database_instance_name="my-instance", # Name of the database instance
        database_name="databricks_postgres",  # Name of the existing Postgres database
    )
)
print(f"Created database catalog: {catalog.name}")

# Create a new database and register it as a UC catalog
catalog = w.database.create_database_catalog(
    DatabaseCatalog(
        name="new_catalog",                   # Name of the UC catalog to create
        database_instance_name="my-instance", # Name of the database instance
        database_name="new_database",         # Name of the Postgres database to register (and optionally create)
        create_database_if_not_exists=True    # Create the database if it doesn't exist
    )
)
print(f"Created new database and catalog: {catalog.name}")

CLI

Bash

# Register an existing database as a UC catalog
databricks database create-database-catalog my_catalog my-instance databricks_postgres

# Create a new database and register it as a UC catalog
databricks database create-database-catalog new_catalog my-instance new_database \
  --create-database-if-not-exists

curl

Bash

export PG_DATABASE_NAME="<name of the PG database to sync to UC>"
export CATLAOG_NAME="<name of UC catalog to create>"

Bash

// Optional
export CREATE_DATABASE_IF_NOT_EXISTS="<whether to create a new database>"

Bash

curl -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/catalogs \
--data-binary @- << EOF
{
  "name": "$CATALOG_NAME",
  "database_name": "$PG_DATABASE_NAME",
  "instance_name": "$INSTANCE_NAME",
  "create_database_if_not_exists": "$CREATE_DATABASE_IF_NOT_EXISTS" // optional
}

Limitations

• Les noms de base de données doivent contenir uniquement des caractères alphanumériques ou des traits de soulignement. Veuillez noter que les noms de base de données ne peuvent pas inclure de tirets.

• Le catalogue créé dans Unity Catalog à partir de la base de données est en lecture seule.

• Les instances de base de données sont limitées à un seul Workspace et ne prennent pas en charge l'accès inter-Workspace. Les utilisateurs peuvent voir ces tables dans l'Explorateur de catalogues s'ils disposent des autorisations Unity Catalog requises des autres workspaces associés au même metastore, mais ils ne peuvent pas accéder au contenu de la table.

• Les noms de Catalogue doivent respecter les contraintes existantes pour les noms d'objets sécurisables Unity Catalog.

Explorer les objets Postgres dans Unity Catalog via un Catalogue de bases de données

Pour afficher le catalogue, assurez-vous d’avoir un SQL Warehouse Serverless en cours d’exécution attaché.

1. Cliquez sur Catalogue dans la barre latérale de l'Workspace.
2. Dans le navigateur Catalog , cliquez sur le cluster et sélectionnez un SQL Warehouse Serverless en cours d'exécution comme Ressource de compute.
3. Cliquez sur Start et fermer .

Lorsque vous ouvrez le catalogue, les schémas et les tables, les synchronisations devraient être Trigger automatiquement. Cependant, l'interface utilisateur peut mettre en cache les données afin de réduire le nombre de requêtes Postgres ; par conséquent, les nouveaux objets risquent de ne pas apparaître immédiatement.

Pour Trigger une full refresh, cliquez sur .

Supprimer un catalogue de base de données dans Unity Catalog

Vous devez être le propriétaire d'un catalogue de base de données ou un administrateur du métastore pour le supprimer.

Databricks vous recommande de supprimer d'abord toutes les tables synchronisées du catalogue de base de données. Chaque table source ne peut être utilisée que pour créer 20 tables synchronisées, et il peut falloir jusqu'à trois jours pour que les tables synchronisées soient nettoyées dans Unity Catalog après la suppression d'un catalogue de bases de données. Les tables synchronisées en attente de suppression dans Unity Catalog sont prises en compte dans la limite de 20 tables synchronisées par table source.

Utilisez l'interface utilisateur Databricks, le SDK Python, la CLI ou l'API pour supprimer un catalogue de base de données.

UI

1. Cliquez sur Applications dans le coin supérieur droit et sélectionnez Lakebase Postgres .
2. Cliquez sur **Provisionné** pour ouvrir la page **Instances provisionnées**.
3. Sélectionnez votre instance de base de données.
4. Sélectionnez la page Catalogues dans la barre latérale de l'application Lakebase.
5. Pour le catalogue que vous souhaitez supprimer, cliquez sur sur le côté droit de la ligne.
6. Cliquez sur **Supprimer**.

Python SDK

Python

from databricks.sdk import WorkspaceClient

# Initialize the Workspace client
w = WorkspaceClient()

# Delete a database catalog
catalog_name = "my_catalog"
w.database.delete_database_catalog(name=catalog_name)
print(f"Deleted database catalog: {catalog_name}")

CLI

Bash

# Delete a database catalog
databricks database delete-database-catalog my_catalog

curl

Bash

curl -X DELETE --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/catalogs/$CATALOG_NAME

Après la suppression du catalogue, vous pouvez renommer ou supprimer la base de données Postgres.