Vytvoření a správa instance databáze

Důležité

Lakebase Provisioned je původní nabídka Lakebase, která používá zřízené výpočetní prostředky, které škálujete ručně. Podporované oblasti najdete v tématu Dostupnost oblastí. Nejnovější verzi Lakebase s automatickým škálováním výpočetních prostředků, škálováním na nulu, větvení a okamžitým obnovením najdete v tématu Automatické škálování Lakebase.

Od 12. března 2026 se nové instance Lakebase vytvářejí jako projekty automatického škálování. Stávající zřízené instance se upgradují automaticky na automatické škálování od června 2026. Podrobnosti najdete v tématu Upgrade na automatické škálování LakeBase.

Pokud chcete začít s úlohami OLTP, vytvořte instanci zřízené databáze Lakebase pomocí uživatelského rozhraní Azure Databricks, volání rozhraní API, Python SDK nebo rozhraní příkazového řádku.

Vytvoření instance databáze

Vytvořte instanci databáze s doporučenými výchozími nastaveními. Potřebujete zadat název instance (pouze 1–63 znaků, písmena a pomlčky). Jako tvůrce jste vlastníkem databáze s databricks_superuser rolí.

Většina uživatelů pracovního prostoru může ve výchozím nastavení vytvářet instance databáze. Pokud narazíte na problémy s oprávněními, podívejte se na oprávnění instance databáze.

uživatelské rozhraní

Klikněte na Aplikace v pravém horním rohu a vyberte Lakebase Postgres.
Kliknutím na Zřízeno otevřete stránku Zřízené instance .
Klikněte na Vytvořit instanci databáze.
Nakonfigurujte svou instanci:
- Název: Zadejte název instance databáze (pouze 1–63 znaků, písmena a pomlčky).
- Kapacita: Vyberte velikost výpočetních prostředků (výchozí hodnota: 2 CU). Viz Velikost instance.
- Zásady použití bez serveru: Vyberte zásadu využití, která přiřadí bezserverové využití a fakturaci (volitelné). Viz Zásady použití bez serveru.
(Volitelné) Rozbalte rozšířené nastavení a nakonfigurujte:
- Vytvoření z nadřazeného objektu: Vytvoření klonu kopírování při zápisu z existující instance, včetně dat až do určitého bodu v čase. Viz Vytvoření z nadřazeného objektu.
- Povolení vysoké dostupnosti: Povolte vysokou dostupnost s uzly převzetí služeb při selhání, nakonfigurujte čitelné sekundární soubory a nastavte počet uzlů vysoké dostupnosti. Viz Vysoká dostupnost.
Klikněte na Vytvořit.

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

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

kroucení

Vytvořte instanci databáze a zadejte okno uchovávání informací.

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

Rozšířené nastavení

Tyto funkce můžete také nakonfigurovat během vytváření nebo po vytvoření úpravou instance:

Vlastnost	Description
Zásady použití bez serveru	Vyberte zásady využití pro vaši instanci databáze, které přiřazují bezserverové využití a fakturaci konkrétním rozpočtům. Můžete také přidat vlastní značky.
Velikost instance	Škálujte výpočetní prostředky pro požadavky na výkon úloh (výchozí hodnota je 2 CU).
Okno Obnovit	Pro obnovení k určitému bodu v čase nastavte interval uchovávání informací (2 až 35 dnů, výchozí 7 dnů).
Vysoká dostupnost	Přidejte záložní uzly pro zajištění kontinuity podnikových činností pro produkční úlohy.
Vytvoření z nadřazeného objektu	Vytvořte klon pomocí techniky copy-on-write z existující instance databáze.

Zastavení nebo spuštění instance

Pokud chcete zastavit nebo spustit instanci databáze, musíte k ní mít CAN MANAGE oprávnění. Pokud chcete zastavit nebo spustit instanci, použijte Azure Databricks uživatelské rozhraní, volání rozhraní API, Python SDK nebo rozhraní příkazového řádku.

uživatelské rozhraní

Klikněte na Aplikace v pravém horním rohu a vyberte Lakebase Postgres.
Kliknutím na Zřízeno otevřete stránku Zřízené instance .
Klikněte na instanci databáze, kterou chcete zastavit nebo spustit.
V pravém horním rohu stránky klikněte na Zastavit nebo Spustit .

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

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

kroucení

Následující volání rozhraní API zastaví instanci databáze.

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

Následující volání rozhraní API spustí instanci databáze.

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

Chování při zastavení

Chování instance databáze:

Data se zachovají.
Instanci nelze použít pro operace čtení nebo zápisu.
Synchronizované tabulky neslouží ke čtení.
Kanály Lakeflow nezjistí zastavené instance a můžou vracet chyby.
Registrované katalogy v zastavených instancích nezobrazují podrobnosti schématu v uživatelském rozhraní.

Funkční omezení:

Nelze vytvořit nebo odstranit DatabaseTables nebo DatabaseCatalogs.
Zastavenou instanci můžete odstranit nebo změnit její velikost. Změny kapacity se projeví při restartování instance.
Kanály můžete zastavit.

Chování při spuštění

Instance přejde do stavu STARTING a stane se AVAILABLE, jakmile bude připravena.

Omezení

Kanály Lakeflow nezjistí zastavené instance a můžou vracet chyby.
Registrované katalogy v zastavených instancích nezobrazují podrobnosti schématu v uživatelském rozhraní.

Odstranění instance

Při odstraňování instance databáze buďte opatrní, protože tím odstraníte všechna přidružená data.

Musíte mít CAN MANAGE oprávnění k instanci databáze. Pokud nejste vlastníkem tabulek nebo katalogů, musíte vlastnictví znovu přiřadit sami sobě. Správci pracovního prostoru mohou odstranit instance databáze, které nevlastní.

Databricks doporučuje odstranit všechny přidružené katalogy Unity, synchronizované tabulky a podřízené instance před odstraněním instance databáze. V opačném případě při pokusu o zobrazení katalogů nebo spuštění dotazů SQL odkazujících na ně dojde k chybám.

uživatelské rozhraní

Klikněte na Aplikace v pravém horním rohu a vyberte Lakebase Postgres.
Kliknutím na Zřízeno otevřete stránku Zřízené instance .
Vyberte instanci databáze, kterou chcete odstranit.
Výběrem možnosti Katalogy na bočním panelu aplikace Lakebae zobrazíte úplný seznam katalogů databází přidružených k instanci databáze.
Pro každý katalog databází odstraňte všechny synchronizované tabulky, včetně tabulek umístěných ve spravovaných katalogech a nejsou zaregistrované jako katalogy databází.
Klikněte na >Odstranit 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
)

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

kroucení

purge=true musí být zadán k odstranění instance databáze.

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

Aktualizace zásad využití bez serveru instance databáze

Zásady použití bez serveru se skládají ze značek, které se použijí na jakoukoli bezserverovou výpočetní aktivitu, kterou uživatel přiřadil k zásadám. Označováním instance databáze pomocí zásad využití bez serveru můžete přiřazovat náklady na fakturaci a využití konkrétním zásadám, což usnadňuje sledování, správu a řízení výdajů napříč bezserverovými prostředky.

Pomocí uživatelského rozhraní aktualizujte zásady použití instance databáze:

Klikněte na Aplikace v pravém horním rohu a vyberte Lakebase Postgres.
Kliknutím na Zřízeno otevřete stránku Zřízené instance .
Vyberte instanci databáze, pro kterou chcete aktualizovat zásady fakturace.
Klikněte na Upravit v pravém horním rohu.
Vyberte zásadu použití bez serveru.
Klikněte na Uložit.

Spravovat kapacitu instance

Pokud chcete změnit velikost instance, musíte mít CAN MANAGE oprávnění. Změna velikosti může trvat několik minut a projeví se při restartování instance.

Každá jednotka kapacity přiděluje přibližně 16 GB paměti RAM spolu s odpovídajícími prostředky procesoru a místního úložiště SSD. Před škálováním otestujte a optimalizujte dotazy. Úložiště se škáluje automaticky.

uživatelské rozhraní

Klikněte na Aplikace v pravém horním rohu a vyberte Lakebase Postgres.
Kliknutím na Zřízeno otevřete stránku Zřízené instance .
Vyberte instanci databáze, u které chcete změnit velikost.
Klikněte na Upravit v pravém horním rohu.
Pomocí rozevírací nabídky Kapacita vyberte novou velikost instance.
Klikněte na Uložit.

kroucení

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

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

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

Monitorování instance databáze

K metrikám se dostanete na kartě Monitorování na stránce s podrobnostmi o instanci.

Klikněte na Aplikace v pravém horním rohu a vyberte Lakebase Postgres.
Kliknutím na Zřízeno otevřete stránku Zřízené instance .
Vyberte instanci databáze, kterou chcete monitorovat.
Na bočním panelu aplikace Lakebase vyberte Monitorování .

Pomocí následujících metrik můžete analyzovat trendy výkonu, identifikovat potenciální kritické body a vyhodnotit, jestli chcete optimalizovat využití aplikací nebo škálovat instanci:

Transakce za sekundu: Zobrazuje potvrzenou propustnost transakcí. Tento postup slouží k pochopení vzorů úloh a identifikaci období špičky transakcí. Pokud je tato hodnota konzistentně vysoká, zvažte optimalizaci chování klienta nebo zvětšení velikosti instance.
Řádky za sekundu: Zobrazí počet načtených, vrácených, vložených, aktualizovaných a odstraněných řádků. Načtené řádky označují počet řádků vrácených klientům. Vrácené řádky odkazují na počet řádků přečtených podle dotazů. Pomáhá diagnostikovat typ úlohy a její dopad na systém. Pokud je výkon omezený, zvažte přidání indexů nebo optimalizaci vzorů dotazů.
Otevřená připojení: Zobrazí počet otevřených aktivních připojení. Připojení spotřebovávají prostředky instance. Použijte k vyhodnocení, jestli je potřeba sdružování připojení na straně klienta. Projděte si omezení maximálního počtu povolených připojení.
Využití úložiště: Označuje aktuální využití úložiště pro instanci. Pokud se využití blíží k limitům zajištěným pro Lakebase, odeberte nepotřebná data nebo indexy. Případně kontaktujte podporu a požádejte o navýšení kvóty.
Využití procesoru (%): Měří využití procesoru pro instanci databáze. Vysoké využití procesoru může znamenat úlohu náročnou na výpočty. Zvažte optimalizace na straně aplikace nebo zvětšení velikosti instance.
Propustnost čtení stránky (%): Odráží, jak blízko je instance ke své kapacitě čtení stránky, což je obvykle způsobeno výskytem chyb v mezipaměti. Pokud je hodnota vysoká, snižte zatížení nebo pracovní sadu, přidejte indexy, dotazy do mezipaměti na straně klienta nebo data zefektivněte.
Míra zásahu do cache vyrovnávací paměti (%): Určuje procento čtení provedených z paměti. Úlohy s vysokým výkonem by měly vidět hodnoty nad 99%. Nízké sazby naznačují, že úloha překračuje kapacitu mezipaměti nebo může těžit z optimalizací.
Rychlost zásahů do místní mezipaměti SSD (%): Sleduje procento čtení obsluhovaných z mezipaměti SSD po selhání mezipaměti vyrovnávací paměti. Nízká hodnota může zvýšit propustnost čtení stránky. Použijte podobné optimalizace jako u vyrovnávací paměti, nebo zvažte větší instanci.
Deadlocky za sekundu: Měří, jak často transakce narazí na deadlock. K těmto operacím obvykle dochází v případě, že více transakcí přistupuje ke stejným prostředkům v konfliktních pořadích. Prozkoumejte a refaktorujte úlohy, abyste zabránili zablokování.

Další zdroje informací

Poskytovat data lakehouse prostřednictvím synchronizovaných tabulek
Připojení a dotazování instance databáze
Zaregistrujte instanci databáze v katalogu Unity.
Povolte jiným uživatelům přístup k instanci databáze z Azure Databricks. Viz Správa oprávnění a role Postgres.

Omezení a požadavky

Následující části popisují omezení a požadavky na konfiguraci pro spravované instance databáze.

Pracovní prostor umožňuje mít maximálně deset instancí.
Každá instance podporuje až 1 000 souběžných připojení.
Logická velikost všech databází v instanci je 2 TB.
Instance databází jsou omezeny na jeden pracovní prostor.

Požadavky na název instance

Musí mít délku 1 až 63 znaků.
Musí začínat písmenem.
Může obsahovat pouze alfanumerické znaky a spojovníky.
Nelze zahrnout dvě po sobě jdoucí pomlčky.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-07-10

Vytvoření a správa instance databáze

Vytvoření instance databáze

uživatelské rozhraní

Python SDK

CLI

kroucení

Rozšířené nastavení

Zastavení nebo spuštění instance

uživatelské rozhraní

Python SDK

CLI

kroucení

Chování při zastavení

Chování při spuštění

Omezení

Odstranění instance

uživatelské rozhraní

Python SDK

CLI

kroucení

Aktualizace zásad využití bez serveru instance databáze

Spravovat kapacitu instance

uživatelské rozhraní

kroucení

Python SDK

CLI

Monitorování instance databáze

Další zdroje informací

Omezení a požadavky

Požadavky na název instance

Váš názor

Další materiály