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

Pour bien démarrer avec les charges de travail OLTP, créez une instance de base de données provisionnée Lakebase à l’aide de l’interface utilisateur Azure Databricks, de l’appel d’API, du SDK Python ou de l’interface CLI.

Créer une instance de base de données

Créez une instance de base de données avec les valeurs par défaut recommandées. Vous devez fournir un nom d’instance (1 à 63 caractères, lettres et traits d’union uniquement). En tant que créateur, vous êtes le propriétaire de la base de données avec le databricks_superuser rôle.

La plupart des utilisateurs de l’espace de travail peuvent créer des instances de base de données par défaut. Si vous rencontrez des problèmes d’autorisation, consultez les autorisations d’instance de base de données.

IU

1. Cliquez sur Calcul dans la barre latérale de l’espace de travail.
2. Cliquez sur l’onglet Lakebase Provisionné.
3. Cliquez sur Créer une instance de base de données.
4. Entrez un nom d’instance de base de données (1 à 63 caractères, lettres et traits d’union uniquement).
5. Cliquez sur Créer.

Kit de développement logiciel (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}")

Interface de ligne de commande (CLI)

# 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
  }'

friser

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

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 lors de la création ou après la création en modifiant votre instance :

Arrêter ou démarrer une instance

Pour arrêter ou démarrer une instance de base de données, vous devez disposer CAN MANAGE des autorisations nécessaires. Pour arrêter ou démarrer une instance, utilisez l’interface utilisateur Azure Databricks, l’appel d’API, le SDK Python ou l’interface CLI.

IU

1. Cliquez sur Calcul dans la barre latérale de l’espace de travail.
2. Cliquez sur l’onglet Lakebase Provisionné.
3. Cliquez sur l’instance de base de données que vous souhaitez arrêter ou démarrer.
4. Cliquez sur Arrêter ou Démarrer dans le coin supérieur droit de la page.

Kit de développement logiciel (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}")

Interface de ligne de commande (CLI)

# 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
  }'

friser

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

-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 démarre une instance de base de données.

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

Comportement en cas d’arrêt

Comportement de l’instance de 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 la lecture.
• Les pipelines déclaratifs Lakeflow Spark ne détectent pas les instances arrêtées et peuvent retourner des erreurs.
• Les catalogues enregistrés sur les instances arrêtées n’affichent pas les détails du schéma dans l’interface.

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 démarrage

• L’instance entre dans l’état STARTING et devient AVAILABLE prête.

Limites

• LDP ne détecte pas les instances arrêtées et peut 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.

Supprimer une instance

Soyez prudent lors de la suppression de l’instance de base de données, car cela supprime toutes les données associées.

Vous devez disposer CAN MANAGE d’autorisations sur l’instance de base de données. Si vous n’êtes pas propriétaire des tables ou des catalogues, vous devez vous réassigner la propriété. Les administrateurs d’espace de travail peuvent supprimer des instances de base de données qu’ils ne possèdent pas.

Databricks recommande de supprimer tous les catalogues de catalogue Unity associés, les tables synchronisées et les instances enfants avant de supprimer l’instance de base de données. Sinon, la tentative d’affichage des catalogues ou l’exécution de requêtes SQL qui les référencent entraînent des erreurs.

IU

1. Cliquez sur Calcul dans la barre latérale de l’espace de travail.
2. Cliquez sur l’onglet Lakebase Provisionné.
3. Sélectionnez l’instance de base de données à supprimer.
4. Cliquez sur l’onglet Catalogues 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 bases de données, supprimez toutes les tables synchronisées, y compris celles qui se trouvent dans des catalogues managés et qui ne sont pas inscrites en tant que catalogues de base de données.
6. Cliquez sur >Supprimez le catalogue.

Kit de développement logiciel (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
)

Interface de ligne de commande (CLI)

# 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
  }'

friser

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

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

Mettre à jour une stratégie de budget serverless d’une instance de base de données

Les stratégies de budget serverless se composent d’étiquettes appliquées à toute activité de calcul serverless générée par un utilisateur affecté à la stratégie. En étiquetant une instance de base de données avec une stratégie d’utilisation, vous pouvez attribuer des coûts de facturation et d’utilisation à des stratégies particulières, ce qui facilite le suivi, la gestion et le contrôle des dépenses sur les ressources serverless.

Utilisez l’interface utilisateur pour mettre à jour la stratégie budgétaire d’une instance de base de données :

1. Cliquez sur Calcul dans la barre latérale de l’espace de travail.
2. Cliquez sur l’onglet Lakebase Provisionné.
3. Sélectionnez l’instance de base de données pour laquelle vous souhaitez mettre à jour la stratégie de facturation.
4. Cliquez sur Modifier en haut à droite.
5. Sélectionnez une stratégie de budget serverless.
6. Cliquez sur Enregistrer.

Étapes suivantes

• Synchronisez les données à partir de tables de catalogue Unity existantes.
• Connectez et interrogez votre instance de base de données à partir d’outils externes, de l’éditeur SQL ou d’un notebook.
• Inscrire une instance de base de données dans le catalogue Unity.
• Autoriser d’autres utilisateurs à accéder à l’instance de base de données à partir d’Azure Databricks. Consultez Gérer les autorisations et gérer 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 managées. Pour connaître les contraintes relatives à la création et à l’utilisation de l’instance, consultez Limitations et considérations.

Configuration requise pour le nom de l’instance

• Doit être de 1 à 63 caractères.
• Doit commencer par une lettre.
• Peut contenir uniquement des caractères alphanumériques et des traits d’union.
• Impossible d’inclure deux traits d’union consécutifs.