Přidání prostředku Lakebase do aplikace Databricks

Přidejte databáze Lakebase jako prostředky Databricks Apps, abyste zachovali data napříč nasazeními. Tyto prostředky založené na PostgreSQL umožňují vaší aplikaci vytvářet a spravovat schémata a tabulky, které uchovávají stav.

K dispozici jsou následující typy databázových prostředků Lakebase:

  • Automatické škálování LakeBase: Uspořádá prostředky jako projekty obsahující větve a databáze.

Oba typy používají stejný model připojení PostgreSQL a poskytují vaší aplikaci stejné proměnné prostředí.

Přidejte databázový prostředek

Než přidáte databázi Lakebase jako prostředek, projděte si požadavky na prostředek aplikace.

Poznámka:

Po 12. březnu 2026 nemůžete vytvářet nové zřízené databáze, ale existující databáze můžete přidat jako prostředky aplikace. Viz Upgrade na automatické škálování.

  1. V části Prostředky aplikace při vytváření nebo úpravě aplikace klikněte na + Přidat databázi prostředků>.
  2. Zvolte databázi. Pro automatické škálování LakeBase vyberte projekt, větev a databázi. Pro službu Lakebase Provisioned vyberte instanci databáze a databázi v této instanci.
  3. Vyberte odpovídající úroveň oprávnění pro vaši aplikaci. V současné době je jediným dostupným oprávněním Možnost připojit se a vytvořit.
  4. (Volitelné) Zadejte vlastní klíč prostředku, což je způsob, jakým odkazujete na databázi v konfiguraci aplikace. Výchozí klíč je postgres pro automatické škálování LakeBase a database pro Lakebase Provisioned.

Abyste ho mohli přidat jako prostředek aplikace, musíte mít CAN MANAGE oprávnění k projektu Lakebase.

Když přidáte databázový prostředek:

  • Azure Databricks vytvoří ve vybrané databázi roli PostgreSQL. Název role odpovídá ID klienta hlavní služby. Pokud už tato role existuje, Azure Databricks ji znovu použije.
  • Azure Databricks uděluje služebnímu objektu CONNECT a CREATE oprávnění pro vybranou databázi. Tato oprávnění umožňují aplikaci vytvářet schémata a tabulky v databázi.
  • Pro přidání zdroje v rámci automatického škálování LakeBase musí mít uživatel CAN MANAGE oprávnění k projektu.

Proměnné prostředí

Když nasadíte aplikaci s databázovým prostředkem, Azure Databricks nastaví následující proměnné prostředí pro první databázový prostředek.

Pokud vaše aplikace používá více databází PostgreSQL, tyto proměnné odrážejí pouze první databázi. Použijte valueFrom s klíčem prostředku k načtení podrobností o připojení pro databázi. Viz Použití proměnných prostředí pro přístup k prostředkům.

Proměnná Popis
PGAPPNAME Název aplikace
PGDATABASE Název databáze
PGHOST Název hostitele serveru PostgreSQL
PGPORT Port pro server PostgreSQL
PGSSLMODE Režim SSL pro připojení
PGUSER Client ID a název role Service Principal

Odstraňte databázový prostředek

Pokud z aplikace odeberete databázové prostředky, aplikace se pokusí znovu přiřadit všechny objekty vlastněné služebním principálem uživateli, jenž daný prostředek odebírá.

Logika, kterou aplikace používá, závisí hlavně na tom, jestli máte v databázi roli:

Vaše oprávnění Role v databázi? Výsledek
CAN MANAGE Ano Azure Databricks znovu přiřadí všechny objekty vlastněné služebním objektem a odstraní roli služebního objektu.
CAN MANAGE Ne Azure Databricks vytvoří roli služby pro vás, předá vám všechny objekty vlastněné rolí hlavního objektu služby a odstraní roli hlavního objektu služby.
Ne CAN MANAGE není k dispozici Azure Databricks odebere prostředek, ale neodstraní roli ani znovu nepřiřazuje vlastnictví. V uživatelském rozhraní se zobrazí upozornění a později musíte roli a vlastněné objekty ručně vyčistit.

Poznámky

Při přidávání databází jako prostředků aplikace zvažte následující skutečnosti:

  • Pokud odvoláte CONNECT a CREATE z jedné databáze a udělíte je v jiné ve stejné aktualizaci, Azure Databricks aktualizuje oprávnění, ale nevytváří roli hlavního objektu služby.
  • Databáze uchovávají stav. Všechna schémata nebo tabulky vytvořené aplikací zůstanou i po opětovném nasazení nebo zastavení aplikace.

  • Pokud máte existující aplikaci, která používá prostředek Lakebase Provisioned database, bude po přechodu na automatické škálování nadále fungovat. Podrobnosti o připojení, proměnné prostředí a role Postgres se nemění. Pro nové aplikace přidejte prostředek databáze automatického škálování LakeBase.

    Important

    Neměňte v existující konfiguraci aplikace prostředek database na postgres. Typy prostředků database a postgres vytvářejí samostatné role v systému Postgres. Změna typu vytvoří novou roli a přeruší přístup vaší aplikace k existujícím datům.

  • Last updated on