Dela via

Skapa och hantera en databasinstans

Viktigt!

Den här funktionen finns i offentlig förhandsversion i följande regioner: westus, westus2, eastus, eastus2, centralus, southcentralus, , northeuropewesteurope, australiaeast, brazilsouth, canadacentral, centralindia, . southeastasiauksouth

Kom igång med OLTP-arbetsbelastningar genom att skapa en Lakebase Provisioned-databasinstans med hjälp av Azure Databricks-användargränssnittet, API-anropet, Python SDK eller CLI.

Skapa en databasinstans

Skapa en databasinstans med rekommenderade standardvärden. Du måste ange ett instansnamn (endast 1–63 tecken, bokstäver och bindestreck). Som skapare är du databasägare med databricks_superuser rollen .

De flesta användare av arbetsytan kan skapa databasinstanser som standard. Om du stöter på behörighetsproblem kan du läsa behörigheter för databasinstanser.

Användargränssnitt (UI)

  1. Klicka på Beräkning i sidofältet för arbetsytan.
  2. Klicka på fliken Lakebase Provisioned .
  3. Klicka på Skapa databasinstans.
  4. Ange ett databasinstansnamn (endast 1–63 tecken, bokstäver och bindestreck).
  5. Klicka på Skapa.

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

Kommandoradsgränssnitt (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
  }'

lockig

Skapa en databasinstans och ange ett kvarhållningsfönster.

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

Avancerade inställningar

Du kan också konfigurera dessa funktioner under skapandet eller efter skapandet genom att redigera din instans.

Funktion Description
Serverlös budgetprincip Välj en budgetprincip för databasinstansen för att tillskriva serverlös användning och fakturering till specifika budgetar. Du kan också lägga till anpassade taggar.
Instansstorlek Skala beräkningsresurser för dina arbetsbelastningsprestandakrav (standardvärdet är 2 CU).
Återställningsfönster Ange kvarhållningsfönstret (2–35 dagar, standardvärdet 7 dagar) för återställning till tidpunkt.
Hög tillgänglighet Lägg till redundansnoder för att säkerställa affärskontinuitet för produktionsarbetsbelastningar.
Skapa från överordnad Skapa en copy-on-write-klon från en befintlig databasinstans.

Stoppa eller starta en instans

Om du vill stoppa eller starta en databasinstans måste du ha CAN MANAGE behörighet för den. Om du vill stoppa eller starta en instans använder du Azure Databricks-användargränssnittet, API-anropet, Python SDK eller CLI.

Användargränssnitt (UI)

  1. Klicka på Beräkning i sidofältet för arbetsytan.
  2. Klicka på fliken Lakebase Provisioned .
  3. Klicka på den databasinstans som du vill stoppa eller starta.
  4. Klicka på Stoppa eller Starta i det övre högra hörnet på sidan.

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

Kommandoradsgränssnitt (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
  }'

lockig

Följande API-anrop stoppar en databasinstans.

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

Följande API-anrop startar en databasinstans.

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

Beteende när det stoppas

Beteende för databasinstans:

  • Data bevaras.
  • Instansen kan inte användas för läs- eller skrivåtgärder.
  • Synkroniserade tabeller tillhandahåller inte läsningar.
  • Lakeflow Spark Deklarativa Pipelines (LDP) identifierar inte stoppade instanser och kan ge fel.
  • Registrerade kataloger på stoppade instanser visar inte schemainformation i användargränssnittet.

Funktionsbegränsningar:

  • Du kan inte skapa eller ta bort DatabaseTables eller DatabaseCatalogs.
  • Du kan ta bort eller ändra storlek på en stoppad instans. Kapacitetsändringar börjar gälla när instansen startas om.
  • Du kan stoppa rörledningar.

Beteende vid start

  • Instansen går in i STARTING tillståndet och blir AVAILABLE när den är redo.

Begränsningar

  • LDP identifierar inte stoppade instanser och kan returnera fel.
  • Registrerade kataloger på stoppade instanser visar inte schemainformation i användargränssnittet.

Ta bort en instans

Var försiktig när du tar bort databasinstansen, eftersom det tar bort alla associerade data.

Du måste ha CAN MANAGE behörighet för databasinstansen. Om du inte äger tabellerna eller katalogerna måste du omtilldela ägarskapet till dig själv. Arbetsyteadministratörer kan ta bort databasinstanser som de inte äger.

Databricks rekommenderar att du tar bort alla associerade Unity Catalog-kataloger, synkroniserade tabeller och underordnade instanser innan du tar bort databasinstansen. Annars resulterar försök att visa kataloger eller köra SQL-frågor som refererar till dem i fel.

Användargränssnitt (UI)

  1. Klicka på Beräkning i sidofältet för arbetsytan.
  2. Klicka på fliken Lakebase Provisioned .
  3. Välj den databasinstans som du vill ta bort.
  4. Klicka på fliken Kataloger för att visa den fullständiga listan över databaskataloger som är associerade med databasinstansen.
  5. För varje databaskatalog tar du bort alla synkroniserade tabeller, inklusive de som finns i hanterade kataloger och som inte är registrerade som databaskataloger.
  6. Klicka på Menyikonen för Kebab.>Ta bort katalog.

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
)

Kommandoradsgränssnitt (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
  }'

lockig

purge=true måste anges för att ta bort en databasinstans.

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

Uppdatera en serverlös budgetprincip för en databasinstans

Serverlösa budgetprinciper består av taggar som tillämpas på alla serverlösa beräkningsaktiviteter som uppstår för en användare som tilldelats principen. Genom att tagga en databasinstans med en användningsprincip kan du tilldela fakturerings- och användningskostnader till vissa principer, vilket gör det enklare att spåra, hantera och kontrollera utgifter för serverlösa resurser.

Använd användargränssnittet för att uppdatera budgetprincipen för en databasinstans:

  1. Klicka på Beräkning i sidofältet för arbetsytan.
  2. Klicka på fliken Lakebase Provisioned .
  3. Välj den databasinstans som du vill uppdatera faktureringsprincipen för.
  4. Klicka på Redigera i det övre högra hörnet.
  5. Välj en serverlös budgetprincip.
  6. Klicka på Spara.

Nästa steg

Begränsningar och krav

I följande avsnitt beskrivs begränsningar och konfigurationskrav för hanterade databasinstanser. Begränsningar för skapande och användning av instanser finns i Begränsningar och överväganden.

Krav för instansnamn

  • Måste vara mellan 1 och 63 tecken långt.
  • Måste börja med en bokstav.
  • Kan endast innehålla alfanumeriska tecken och bindestreck.
  • Det går inte att inkludera två bindestreck i följd.
  • Last updated on