Utwórz wystąpienie bazy danych i zarządzaj nim

Ważne

Ta funkcja jest dostępna w wersji próbnej w następujących regionach: westus, westus2, eastus, eastus2, centralus, southcentralus, northeurope, westeurope, australiaeast, brazilsouth, canadacentral, centralindia, southeastasia, uksouth.

Aby rozpocząć pracę z obciążeniami OLTP, utwórz wystąpienie bazy danych usługi Lakebase Provisioned przy użyciu interfejsu użytkownika usługi Azure Databricks, wywołania interfejsu API, zestawu SDK języka Python lub interfejsu wiersza polecenia.

Utwórz wystąpienie bazy danych

Utwórz wystąpienie bazy danych z zalecanymi wartościami domyślnymi. Musisz podać nazwę wystąpienia (tylko 1–63 znaki, litery i łączniki). Jako twórca jesteś właścicielem bazy danych z rolą databricks_superuser .

Większość użytkowników obszaru roboczego domyślnie może tworzyć wystąpienia bazy danych. Jeśli wystąpią problemy z uprawnieniami, zobacz uprawnienia wystąpienia bazy danych.

interfejs użytkownika

Kliknij pozycję Obliczenia na pasku bocznym obszaru roboczego.
Kliknij kartę Lakebase Provisioned.
Kliknij Utwórz instancję bazy danych.
Wprowadź nazwę wystąpienia bazy danych (tylko 1–63 znaki, litery i łączniki).
Kliknij pozycję Utwórz.

Zestaw SDK dla języka 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

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

skręt

Utwórz wystąpienie bazy danych i określ okno przechowywania.

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

Ustawienia zaawansowane

Te funkcje można również skonfigurować podczas tworzenia lub po jego utworzeniu, edytując wystąpienie:

Funkcja	Description
Zasady budżetu bezserwerowego	Wybierz zasady budżetu dla wystąpienia bazy danych, aby przypisywać użycie bezserwerowe i rozliczenia do określonych budżetów. Możesz również dodać tagi niestandardowe.
Rozmiar wystąpienia	Skalowanie zasobów obliczeniowych pod kątem wymagań dotyczących wydajności obciążenia (domyślnie to 2 cu).
Okno przywracania	Ustaw okno przechowywania (2–35 dni, domyślne 7 dni) dla odzyskiwania do punktu w czasie.
Wysoka dostępność	Dodaj węzły trybu failover, aby zapewnić ciągłość działania dla obciążeń produkcyjnych.
Utwórz na podstawie elementu nadrzędnego	Utwórz klon kopii na zapis z istniejącego wystąpienia bazy danych.

Zatrzymywanie lub uruchamianie wystąpienia

Aby zatrzymać lub uruchomić wystąpienie bazy danych, musisz mieć na to uprawnienia CAN MANAGE. Aby zatrzymać lub uruchomić wystąpienie, użyj interfejsu użytkownika usługi Azure Databricks, wywołania interfejsu API, zestawu SDK języka Python lub interfejsu wiersza polecenia.

interfejs użytkownika

Kliknij pozycję Obliczenia na pasku bocznym obszaru roboczego.
Kliknij kartę Lakebase Provisioned.
Kliknij wystąpienie bazy danych, które chcesz zatrzymać lub uruchomić.
Kliknij Zatrzymaj lub Rozpocznij w prawym górnym rogu strony.

Zestaw SDK dla języka 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

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

skręt

Następujące wywołanie API zatrzymuje instancję bazy danych.

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

Następujące wywołanie interfejsu API uruchamia instancję bazy danych.

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

Zachowanie po zatrzymaniu

Zachowanie wystąpienia bazy danych:

Dane są zachowywane.
Nie można użyć instancji do operacji odczytu ani zapisu.
Zsynchronizowane tabele nie obsługują odczytów.
Potoki deklaratywne Lakeflow Spark (LDP) nie wykrywają zatrzymanych instancji i mogą zwracać błędy.
Zarejestrowane wykazy zatrzymanych wystąpień nie pokazują szczegółów schematu w interfejsie użytkownika.

Ograniczenia funkcjonalne:

Nie można tworzyć ani usuwać DatabaseTables ani DatabaseCatalogs.
Możesz usunąć lub zmienić rozmiar zatrzymanego wystąpienia. Zmiany pojemności wchodzą w życie po ponownym uruchomieniu wystąpienia.
Potoki można zatrzymać.

Zachowanie po uruchomieniu

Wystąpienie przechodzi do STARTING stanu i staje się AVAILABLE gotowe.

Ograniczenia

Protokół LDP nie wykrywa zatrzymanych wystąpień i może zwracać błędy.
Zarejestrowane wykazy zatrzymanych wystąpień nie pokazują szczegółów schematu w interfejsie użytkownika.

Usuwanie wystąpienia

Zachowaj ostrożność podczas usuwania wystąpienia bazy danych, ponieważ spowoduje to usunięcie wszystkich skojarzonych danych.

Musisz mieć CAN MANAGE uprawnienia do instancji bazy danych. Jeśli nie jesteś właścicielem tabel lub katalogów, musisz ponownie przypisać własność do siebie. Administratorzy obszaru roboczego mogą usuwać wystąpienia bazy danych, których nie posiadają.

Usługa Databricks zaleca usunięcie wszystkich skojarzonych katalogów Unity Catalog, zsynchronizowanych tabel i wystąpień podrzędnych przed usunięciem wystąpienia bazy danych. W przeciwnym razie próba wyświetlenia wykazów lub uruchomienia zapytań SQL odwołujących się do nich powoduje błędy.

interfejs użytkownika

Kliknij pozycję Obliczenia na pasku bocznym obszaru roboczego.
Kliknij kartę Lakebase Provisioned.
Wybierz wystąpienie bazy danych, które chcesz usunąć.
Kliknij kartę Katalogi, aby wyświetlić pełną listę katalogów baz danych powiązanych z instancją bazy danych.
Dla każdego wykazu baz danych usuń wszystkie zsynchronizowane tabele, w tym te, które znajdują się w wykazach zarządzanych i nie są zarejestrowane jako wykazy baz danych.
Kliknij >Usuń katalog.

Zestaw SDK dla języka 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

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

skręt

Aby usunąć wystąpienie bazy danych, należy określić purge=true.

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

Aktualizowanie bezserwerowych zasad budżetu wystąpienia bazy danych

Bezserwerowe zasady budżetowe składają się z tagów, które są stosowane do wszelkich bezserwerowych działań obliczeniowych poniesionych przez użytkownika przypisanego do zasad. Tagując wystąpienie bazy danych przy użyciu zasad użycia, można przypisywać koszty rozliczeń i użycia do określonych zasad, co ułatwia śledzenie i kontrolowanie wydatków na zasoby bezserwerowe oraz zarządzanie nimi.

Użyj interfejsu użytkownika, aby zaktualizować zasady budżetu wystąpienia bazy danych:

Kliknij pozycję Obliczenia na pasku bocznym obszaru roboczego.
Kliknij kartę Lakebase Provisioned.
Wybierz wystąpienie bazy danych, dla którego chcesz zaktualizować zasady rozliczeniowe.
Kliknij przycisk Edytuj w prawym górnym rogu.
Wybierz zasady budżetu bezserwerowego.
Kliknij przycisk Zapisz.

Dalsze kroki

Synchronizuj dane z istniejących tabel Unity Catalog.
Połącz się z instancją bazy danych i zapytaj o nią za pomocą narzędzi zewnętrznych, edytora SQL lub notatnika.
Zarejestruj wystąpienie bazy danych w katalogu Unity.
Zezwól innym użytkownikom na dostęp do instancji bazy danych z Azure Databricks. Zobacz Zarządzanie uprawnieniami i Zarządzanie rolami Postgres.

Ograniczenia i wymagania

W poniższych sekcjach opisano limity i wymagania dotyczące konfiguracji dla wystąpień zarządzanej bazy danych. Aby poznać ograniczenia dotyczące tworzenia i używania wystąpienia, zobacz Ograniczenia i zagadnienia.

Wymagania dotyczące nazwy wystąpienia

Musi mieć długość od 1 do 63 znaków.
Musi zaczynać się literą.
Może zawierać tylko znaki alfanumeryczne i łączniki.
Nie można dołączyć dwóch kolejnych łączników.

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-12-19

Udostępnij przez

Utwórz wystąpienie bazy danych i zarządzaj nim