Erstellen und Verwalten einer Datenbankinstanz

Um mit OLTP-Workloads zu beginnen, erstellen Sie eine Bereitgestellte Lakebase-Datenbankinstanz mithilfe der Azure Databricks-BEnutzeroberfläche, des API-Aufrufs, des Python SDK oder der CLI.

Erstellen einer Datenbankinstanz

Erstellen Sie eine Datenbankinstanz mit empfohlenen Standardwerten. Sie müssen einen Instanznamen angeben (nur 1-63 Zeichen, Buchstaben und Bindestriche). Als Ersteller sind Sie der Datenbankbesitzer mit der databricks_superuser Rolle.

Die meisten Arbeitsbereichsbenutzer können standardmäßig Datenbankinstanzen erstellen. Wenn Berechtigungsprobleme auftreten, finden Sie Informationen zu Datenbankinstanzberechtigungen.

Benutzeroberfläche

1. Klicken Sie auf " Berechnen" in der Arbeitsbereich-Randleiste.
2. Klicken Sie auf die Registerkarte "Lakebase Provisioned ".
3. Klicken Sie auf "Datenbankinstanz erstellen".
4. Geben Sie einen Datenbankinstanznamen ein (nur 1-63 Zeichen, Buchstaben und Bindestriche).
5. Klicken Sie auf "Erstellen".

Python SDK

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}")

Befehlszeilenschnittstelle (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
  }'

cURL

Erstellen Sie eine Datenbankinstanz, und geben Sie ein Aufbewahrungsfenster an.

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

Erweiterte Einstellungen

Sie können diese Features auch während der Erstellung oder nach der Erstellung konfigurieren, indem Sie Ihre Instanz bearbeiten:

Beenden oder Starten einer Instanz

Um eine Datenbankinstanz zu beenden oder zu starten, müssen Sie über die entsprechenden Berechtigungen CAN MANAGE verfügen. Verwenden Sie zum Beenden oder Starten einer Instanz die Azure Databricks-Benutzeroberfläche, den API-Aufruf, das Python SDK oder die CLI.

Benutzeroberfläche

1. Klicken Sie auf " Berechnen" in der Arbeitsbereich-Randleiste.
2. Klicken Sie auf die Registerkarte "Lakebase Provisioned ".
3. Klicken Sie auf die Datenbankinstanz, die Sie beenden oder starten möchten.
4. Klicken Sie in der oberen rechten Ecke der Seite auf "Beenden" oder " Start" .

Python SDK

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}")

Befehlszeilenschnittstelle (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
  }'

cURL

Der folgende API-Aufruf stoppt eine Datenbankinstanz.

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

Der folgende API-Aufruf startet eine Datenbankinstanz.

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

Verhalten beim Anhalten

Verhalten der Datenbankinstanz:

• Die Daten bleiben erhalten.
• Die Instanz kann nicht für Lese- oder Schreibvorgänge verwendet werden.
• Synchronisierte Tabellen unterstützen keine Lesevorgänge.
• Lakeflow Spark Declarative Pipelines (LDP) erkennen keine beendeten Instanzen und geben möglicherweise Fehler zurück.
• Registrierte Kataloge für beendete Instanzen zeigen keine Schemadetails in der Benutzeroberfläche an.

Funktionale Einschränkungen:

• Sie können weder DatabaseTables noch DatabaseCatalogs erstellen oder löschen.
• Sie können eine angehaltene Instanz löschen oder die Größe ändern. Kapazitätsänderungen werden wirksam, wenn die Instanz neu gestartet wird.
• Sie können Pipelines anhalten.

Verhalten beim Starten

• Die Instanz wechselt in den STARTING Zustand und wird zu AVAILABLE, wenn sie bereit ist.

Einschränkungen

• LDP erkennt keine beendeten Instanzen und kann Fehler zurückgeben.
• Registrierte Kataloge für beendete Instanzen zeigen keine Schemadetails in der Benutzeroberfläche an.

Löschen einer Instanz

Seien Sie beim Löschen der Datenbankinstanz vorsichtig, da dadurch alle zugehörigen Daten gelöscht werden.

Sie müssen über Berechtigungen für die Datenbankinstanz verfügen CAN MANAGE . Wenn Sie nicht der Besitzer der Tabellen oder Kataloge sind, müssen Sie den Besitz auf sich selbst übertragen. Arbeitsbereichsadministratoren können Datenbankinstanzen löschen, die sie nicht besitzen.

Databricks empfiehlt, alle zugeordneten Unity-Katalogkataloge, synchronisierte Tabellen und untergeordnete Instanzen zu löschen, bevor die Datenbankinstanz gelöscht wird. Andernfalls führt der Versuch, Kataloge anzuzeigen oder SQL-Abfragen auszuführen, die auf sie verweisen, zu Fehlern.

Benutzeroberfläche

1. Klicken Sie auf " Berechnen" in der Arbeitsbereich-Randleiste.
2. Klicken Sie auf die Registerkarte "Lakebase Provisioned ".
3. Wählen Sie die Datenbankinstanz aus, die Sie löschen möchten.
4. Klicken Sie auf die Registerkarte "Kataloge ", um die vollständige Liste der Datenbankkataloge anzuzeigen, die der Datenbankinstanz zugeordnet sind.
5. Löschen Sie für jeden Datenbankkatalog alle synchronisierten Tabellen, einschließlich derjenigen, die sich in verwalteten Katalogen befinden und nicht als Datenbankkataloge registriert sind.
6. Klicken Sie auf >Katalog löschen.

Python SDK

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
)

Befehlszeilenschnittstelle (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
  }'

cURL

purge=true muss angegeben werden, um eine Datenbankinstanz zu löschen.

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

Aktualisieren einer serverlosen Budgetrichtlinie einer Datenbankinstanz

Serverlose Budgetrichtlinien bestehen aus Tags, die auf jede serverlose Computeaktivität angewendet werden, die von einem Benutzer verursacht wird, der der Richtlinie zugewiesen ist. Indem Sie eine Datenbankinstanz mit einer Verwendungsrichtlinie kategorisieren, können Sie Abrechnungs- und Nutzungskosten bestimmten Richtlinien zuordnen, wodurch die Ausgaben für serverlose Ressourcen leichter nachverfolgt, verwaltet und gesteuert werden können.

Verwenden Sie die Benutzeroberfläche, um die Budgetrichtlinie einer Datenbankinstanz zu aktualisieren:

1. Klicken Sie auf " Berechnen" in der Arbeitsbereich-Randleiste.
2. Klicken Sie auf die Registerkarte "Lakebase Provisioned ".
3. Wählen Sie die Datenbankinstanz aus, für die Sie die Abrechnungsrichtlinie aktualisieren möchten.
4. Klicken Sie oben rechts auf "Bearbeiten ".
5. Wählen Sie eine Serverless-Budgetrichtlinie aus.
6. Klicken Sie auf "Speichern".

Nächste Schritte

• Synchronisieren von Daten aus vorhandenen Unity-Katalogtabellen.
• Verbinden sie Ihre Datenbankinstanz über externe Tools, den SQL-Editor oder ein Notizbuch, und fragen Sie sie ab.
• Registrieren sie die Datenbankinstanz im Unity-Katalog.
• Ermöglichen Sie anderen Benutzern den Zugriff auf die Datenbankinstanz von Azure Databricks. Siehe Verwalten von Berechtigungen und Verwalten von Postgres-Rollen.

Einschränkungen und Anforderungen

In den folgenden Abschnitten werden Grenzwerte und Konfigurationsanforderungen für verwaltete Datenbankinstanzen beschrieben. Einschränkungen für die Erstellung und Nutzung von Instanzen finden Sie unter Einschränkungen und Überlegungen.

Anforderungen an den Instanznamen

• Muss 1 bis 63 Zeichen lang sein.
• Muss mit einem Buchstaben beginnen.
• Kann nur alphanumerische Zeichen und Bindestriche enthalten.
• Darf nicht zwei aufeinanderfolgende Bindestriche enthalten.