Créer et gérer une instance de base de données

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.

Pour commencer avec les workloads OLTP, créez une instance de base de données Lakebase provisionnée à l'aide de l'interface utilisateur Databricks, de l'appel API, du SDK Python ou de la CLI.

Créer une instance de base de données

Créez une instance de base de données avec les default recommandés. Vous devez fournir un nom d'instance (1-63 caractères, lettres et tirets uniquement). En tant que créateur, vous êtes le propriétaire de la base de données avec le rôle databricks_superuser.

La plupart des utilisateurs de Workspace peuvent créer des instances de base de données par default. Si vous rencontrez des problèmes d'autorisations, consultez les autorisations d'instance 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. Cliquez sur Créer une instance de base de données .

4. Configurez votre instance :

   • Nom : saisissez un nom d'instance de base de données (1 à 63 caractères, lettres et tirets uniquement).
   • Capacité : Sélectionnez la taille du compute (default : 2 CU). Voir taille de l'instance.
   • **Politique d’utilisation serverless** : Sélectionnez une politique d'utilisation pour attribuer l'utilisation serverless et la facturation (facultatif). Voir les politiques d’utilisation Serverless.

5. (Facultatif) Développez les Paramètres avancés pour configurer :

   • Créer à partir du parent : Créez un clone de copie sur écriture à partir d'une instance existante, y compris les données jusqu'à un point précis dans le temps. Consultez Créer à partir du parent.
   • Activer la haute disponibilité : activez la haute disponibilité avec les nœuds de basculement, configurez les secondaires lisibles et définissez le nombre de nœuds HA. Consultez Haute disponibilité.

6. Cliquez sur Créer .

Python SDK

Python

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

# Initialize the Workspace client
w = WorkspaceClient()

# Create a database instance
instance = w.database.create_database_instance(
    DatabaseInstance(
        name="my-database-instance",
        capacity="CU_1"
    )
)

print(f"Created database instance: {instance.name}")
print(f"Connection endpoint: {instance.read_write_dns}")

CLI

Bash

# Create a database instance
databricks database create-database-instance my-database-instance \
  --capacity CU_1

# Create with advanced options (using JSON for more complex parameters)
databricks database create-database-instance \
  --json '{
    "name": "my-database-instance",
    "capacity": "CU_2",
    "retention_window_in_days": 14
  }'

curl

Créez une instance de base de données et spécifiez une fenêtre de rétention.

Bash

export PAT=<YOUR_PAT>
export INSTANCE_NAME="instance_name"

> curl -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://[your databricks workspace]/api/2.0/database/instances \
--data-binary @- << EOF
{
  "name": "$INSTANCE_NAME",
  "capacity": "CU_1",
  "retention_window_in_days": 14
}
EOF

Paramètres avancés

Vous pouvez également configurer ces fonctionnalités pendant ou après la création en modifiant votre instance :

Fonctionnalité	Description
Politique d’utilisation serverless	Sélectionnez une politique d'utilisation pour votre instance de base de données afin d'attribuer l'utilisation serverless et la facturation à des budgets spécifiques. Vous pouvez également ajouter des tags personnalisés.
Taille de l'instance	Monter en charge les Ressources compute pour les exigences de performance de votre charge de travail (valeur default : 2 CU).
Fenêtre de restauration	Définissez la fenêtre de rétention (de 2 à 35 jours, default 7 jours) pour la récupération à un point dans le temps.
Haute disponibilité	Ajoutez des nœuds de basculement pour assurer la continuité des activités pour les charges de travail de production.
Créer à partir du parent	Créer un clone copy-on-write à partir d'une instance de base de données existante.

Fonctionnalité	Description
Politique d’utilisation serverless	Sélectionnez une politique d'utilisation pour votre instance de base de données afin d'attribuer l'utilisation serverless et la facturation à des budgets spécifiques. Vous pouvez également ajouter des tags personnalisés.
Taille de l'instance	Monter en charge les Ressources compute pour les exigences de performance de votre charge de travail (valeur default : 2 CU).
Fenêtre de restauration	Définissez la fenêtre de rétention (de 2 à 35 jours, default 7 jours) pour la récupération à un point dans le temps.
Haute disponibilité	Ajoutez des nœuds de basculement pour assurer la continuité des activités pour les charges de travail de production.
Créer à partir du parent	Créer un clone copy-on-write à partir d'une instance de base de données existante.

Arrêter ou start une instance

Pour arrêter ou start une instance de base de données, vous devez disposer des autorisations CAN MANAGE sur celle-ci. Pour arrêter ou start une instance, utilisez l'interface utilisateur Databricks, l'appel 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. Cliquez sur l'instance de base de données que vous souhaitez arrêter ou start.
4. Cliquez sur Arrêter ou start dans le coin supérieur droit de la page.

Python SDK

Python

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

# Initialize the Workspace client
w = WorkspaceClient()

# Stop a database instance
instance_name = "my-database-instance"
w.database.update_database_instance(
    name=instance_name,
    database_instance=DatabaseInstance(
        name=instance_name,
        stopped=True
    ),
    update_mask="*"
)
print(f"Stopped database instance: {instance_name}")

# Start a database instance
w.database.update_database_instance(
    name=instance_name,
    database_instance=DatabaseInstance(
        name=instance_name,
        stopped=False
    ),
    update_mask="*"
)
print(f"Started database instance: {instance_name}")

CLI

Bash

# Stop a database instance
databricks database update-database-instance my-database-instance '*' \
  --json '{
    "stopped": true
  }'

# Start a database instance
databricks database update-database-instance my-database-instance '*' \
  --json '{
    "stopped": false
  }'

curl

L'appel d'API suivant arrête une instance de base de données.

Bash

-X PATCH --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME \
--data-binary @- << EOF
{
  "stopped": true
}
EOF

L'appel d'API suivant start une instance de base de données.

Bash

curl -X PATCH --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME \
--data-binary @- << EOF
{
  "stopped": false
}
EOF

Comportement à l'arrêt

Comportement de l'instance de la base de données :

• Les données sont conservées.
• L'instance ne peut pas être utilisée pour les opérations de lecture ou d'écriture.
• Les tables synchronisées ne prennent pas en charge les lectures.
• Les LakeFlow Pipelines ne détectent pas les instances arrêtées et peuvent renvoyer des erreurs.
• Les catalogues enregistrés sur les instances arrêtées n'affichent pas les détails du schéma dans l'interface utilisateur.

Limitations fonctionnelles :

• Vous ne pouvez pas créer ou supprimer DatabaseTables ou DatabaseCatalogs.
• Vous pouvez supprimer ou redimensionner une instance arrêtée. Les modifications de capacité prennent effet lorsque l'instance redémarre.
• Vous pouvez arrêter les pipelines.

Comportement au start

• L'instance passe à l'état STARTING et devient AVAILABLE lorsqu'elle est prête.

Limitations

• Les Lakeflow pipelines ne détectent pas les instances arrêtées et peuvent renvoyer des erreurs.
• Les catalogues enregistrés sur les instances arrêtées n'affichent pas les détails du schéma dans l'interface utilisateur.

Supprimer une instance

Soyez prudent lorsque vous supprimez l'instance de la base de données, car cela entraînera la suppression de toutes les données associées.

Vous devez disposer des autorisations CAN MANAGE sur l'instance de base de données. Si vous n'êtes pas le propriétaire des tables ou des catalogues, vous devez vous réattribuer la propriété. Les administrateurs du Workspace peuvent supprimer les instances de base de données qu'ils ne possèdent pas.

Databricks recommande de supprimer tous les catalogues Unity Catalog associés, les tables synchronisées et les instances enfants avant de supprimer l'instance de base de données. Sinon, toute tentative de consulter les catalogues ou d'exécuter des queries SQL qui y font référence entraînera des erreurs.

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 l'instance de base de données que vous souhaitez supprimer.
4. Sélectionnez Catalogues dans la barre latérale de l'application Lakebae pour afficher la liste complète des catalogues de bases de données associés à l'instance de base de données.
5. Pour chaque catalogue de base de données, supprimez toutes les tables synchronisées, y compris celles qui se trouvent dans des catalogues gérés et ne sont pas enregistrées en tant que catalogues de base de données.
6. Cliquez sur > Supprimer le catalogue .

Python SDK

Python

from databricks.sdk import WorkspaceClient

# Initialize the Workspace client
w = WorkspaceClient()

# Delete a database instance
instance_name = "my-database-instance"
w.database.delete_database_instance(
    name=instance_name,
    purge=True  # Required to delete the instance
)
print(f"Deleted database instance: {instance_name}")

# Delete with force option (to delete child instances too)
w.database.delete_database_instance(
    name=instance_name,
    force=True,  # Delete child instances too
    purge=True
)

CLI

Bash

# Delete a database instance
databricks database delete-database-instance my-database-instance \
  --purge

# Delete with force option (to delete child instances too)
databricks database delete-database-instance my-database-instance \
  --json '{
    "force": true,
    "purge": true
  }'

curl

purge=true doit être spécifié pour supprimer une instance de base de données.

Bash

curl -X DELETE --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME?purge=true

Mettre à jour une politique d'utilisation Serverless d'une instance de base de données

Les politiques d'utilisation Serverless consistent en des tags qui sont appliqués à toute activité de compute Serverless effectuée par un utilisateur attribué à la politique. En étiquetant une instance de base de données avec une politique d'utilisation serverless, vous pouvez attribuer les coûts de facturation et d'utilisation à des politiques particulières, ce qui facilite le suivi, la gestion et le contrôle des dépenses sur l'ensemble des ressources serverless.

Utilisez l'interface utilisateur pour mettre à jour la politique d'utilisation d'une instance de base de données :

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 l'instance de base de données pour laquelle vous souhaitez mettre à jour la politique de facturation.
4. Cliquez sur **Modifier** en haut à droite.
5. Sélectionnez une **politique d'utilisation serverless**.
6. Cliquez sur Enregistrer .

Gérer la capacité de l'instance

Pour redimensionner une instance, vous devez disposer des autorisations CAN MANAGE. Le redimensionnement peut prendre plusieurs minutes et prend effet lorsque l'instance est redémarrée.

Chaque unité de capacité alloue environ 16 Go de RAM, ainsi que les ressources CPU et SSD locaux associées. Avant la mise à l'échelle, testez et optimisez les requêtes. Le stockage Monter en charge automatiquement.

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 l'instance de base de données que vous souhaitez redimensionner.
4. Cliquer sur Modifier dans le coin supérieur droit.
5. Utilisez le menu déroulant Capacité pour sélectionner la nouvelle taille d'instance.
6. Cliquez sur Enregistrer .

curl

Bash

curl -X PATCH --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME \
--data-binary @- << EOF
{
  "capacity": "CU_4"
}
EOF

Python SDK

Python

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

w = WorkspaceClient()
instance_name = "my-database-instance"
w.database.update_database_instance(
    name=instance_name,
    database_instance=DatabaseInstance(name=instance_name, capacity="CU_4"),
    update_mask="*"
)

CLI

Bash

databricks database update-database-instance my-database-instance '*' --capacity CU_4

Surveiller une instance de base de données

Accédez aux métriques depuis l’onglet Monitoring sur la page des détails de l’instance.

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 l'instance de base de données que vous souhaitez surveiller.
4. Sélectionnez **Monitoring** dans la barre latérale de l'application Lakebase.

Utilisez les indicateurs suivants pour analyser les tendances de performance, identifier d'éventuels goulets d'étranglement et évaluer s'il convient d'optimiser l'utilisation de l'application ou de monter en charge votre instance :

• Transactions par seconde : Indique le throughput des transactions validées. Utilisez ceci pour comprendre les modèles de workload et identifier les périodes de pointe des transactions. Si cette valeur est constamment élevée, envisagez d'optimiser le comportement du client ou d'augmenter la taille de l'instance.

• Lignes par seconde : affiche le nombre de lignes récupérées, renvoyées, insérées, mises à jour et supprimées. Les lignes récupérées désignent le nombre de lignes renvoyées aux clients. Les lignes renvoyées désigne le nombre de lignes lues par les queries. Permet de diagnostiquer le type de charge de travail et son impact sur le système. Si les performances sont limitées, envisagez d'ajouter des index ou d'optimiser les modèles de query.

• Connexions ouvertes : affiche le nombre de connexions actives ouvertes. Les connexions consomment des ressources d’instance. Utilisez ceci pour évaluer si le regroupement de connexions côté client est nécessaire. Consultez les limites relatives au nombre maximal de connexions autorisées.

• Utilisation du stockage : indique l'utilisation actuelle du stockage pour l'instance. Si l'utilisation approche les limites de Lakebase Provisionné, supprimez les données ou les index inutiles. Vous pouvez également contacter le support pour demander une augmentation de quota.

• Utilisation du CPU (%) : Mesure l'utilisation du CPU pour l'instance de base de données. Une utilisation élevée du CPU peut indiquer une charge de travail gourmande en calcul. Envisagez des optimisations côté application ou l'augmentation de la taille de l'instance.

• Throughput de lecture de page (%) : Reflète la proximité de l'instance avec sa capacité de lecture de page, généralement causée par des échecs de cache. Si la valeur est élevée, réduisez la charge de travail ou le jeu de travail, ajoutez des index, mettez en cache les queries côté client ou optimisez les données.

• Taux d'accès au cache tampon (%) : indique le pourcentage de lectures servies à partir de la mémoire. Les charges de travail haute performance devraient atteindre des valeurs supérieures à 99 %. Des taux faibles suggèrent que la charge de travail dépasse la capacité du cache ou pourrait bénéficier d'optimisations.

• **Taux de réussite du cache SSD local (%) :** Indique le pourcentage de lectures servies par le cache SSD après un échec du cache tampon. Une valeur faible peut augmenter le throughput de lecture des pages. Utilisez des optimisations similaires à celles du cache tampon, ou envisagez une instance plus grande.

• Blocages par seconde : Mesure la fréquence à laquelle les transactions rencontrent des blocages. Celles-ci se produisent généralement lorsque plusieurs transactions accèdent aux mêmes ressources dans un ordre conflictuel. Examiner et refactoriser les charges de travail pour éviter les interblocages.

Ressources supplémentaires

• Servir les données lakehouse avec des tables synchronisées.
• Connectez-vous et interrogez votre instance de base de données.
• Enregistrer une instance de base de données dans Unity Catalog.
• Autorisez les autres utilisateurs à accéder à l'instance de base de données depuis Databricks. Voir Gérer les autorisations et les rôles Postgres.

Limitations et exigences

Les sections suivantes décrivent les limites et les exigences de configuration pour les instances de base de données gérées.

• Un Workspace autorise un maximum de dix instances.
• Chaque instance prend en charge jusqu’à 1 000 connexions simultanées.
• La limite de taille logique de toutes les bases de données d'une instance est de 2 To.
• Les instances de base de données sont limitées à un seul workspace.

Exigences relatives au nom de l'instance

• Doit contenir entre 1 et 63 caractères.
• Doit commencer par une lettre.
• Ne peut contenir que des caractères alphanumériques et des traits d'union.
• Ne peut pas inclure deux tirets consécutifs.