Dodawanie zasobu usługi Lakebase do aplikacji usługi Databricks

Dodaj bazy danych Lakebase jako zasoby usługi Databricks Apps, aby utrwalać dane we wdrożeniach. Te zasoby oparte na usłudze PostgreSQL umożliwiają aplikacji tworzenie schematów i tabel, które zachowują stan oraz zarządzać nimi.

Dostępne są następujące typy zasobów bazy danych Lakebase:

• Skalowanie automatyczne w usłudze Lakebase: organizuje zasoby jako projekty zawierające gałęzie i bazy danych.
• Aprowizowana baza danych Lakebase: organizuje zasoby jako wystąpienia bazy danych.

Oba typy używają tego samego modelu połączenia PostgreSQL i udostępniają te same zmienne środowiskowe aplikacji.

Dodawanie zasobu bazy danych

Przed dodaniem bazy danych Lakebase jako zasobu zapoznaj się z wymaganiami wstępnymi dotyczącymi zasobów aplikacji.

Uwaga / Notatka

Nie można utworzyć nowych aprowizowanych baz danych po 12 marca 2026 r., ale możesz dodać istniejące jako zasoby aplikacji. Zobacz Autoskalowanie domyślnie.

1. W sekcji Zasoby aplikacji podczas tworzenia lub edytowania aplikacji kliknij pozycję + Dodaj bazę danych zasobów>.
2. Wybierz bazę danych. W obszarze Skalowanie automatyczne usługi Lakebase wybierz projekt, gałąź i bazę danych. Dla Lakebase Provisioned, wybierz wystąpienie bazy danych i bazę danych w tym wystąpieniu.
3. Wybierz odpowiedni poziom uprawnień dla aplikacji. Obecnie jedynym dostępnym uprawnieniem jest Możliwość nawiązania połączenia i utworzenia.
4. (Opcjonalnie) Określ niestandardowy klucz zasobu, w jaki sposób odwołujesz się do bazy danych w konfiguracji aplikacji. Domyślnym kluczem dla funkcji Lakebase Autoscaling jest postgres, a dla funkcji Lakebase Provisioned jest database.

Musisz mieć CAN MANAGE uprawnienia do projektu Lakebase, aby dodać go jako zasób aplikacji.

Po dodaniu zasobu bazy danych:

• Azure Databricks tworzy rolę PostgreSQL w wybranej bazie danych. Nazwa roli jest zgodna z identyfikatorem klienta podmiotu usługi. Jeśli rola już istnieje, Azure Databricks ponownie ją używa.
• Azure Databricks przyznaje jednostce usługi uprawnienia CONNECT i CREATE w wybranej bazie danych. Te uprawnienia umożliwiają aplikacji tworzenie schematów i tabel w bazie danych.
• W przypadku skalowania automatycznego w usłudze Lakebase użytkownik dodający zasób musi mieć CAN MANAGE uprawnienia do projektu.

Zmienne środowiskowe

Podczas wdrażania aplikacji z zasobem bazy danych Azure Databricks ustawia następujące zmienne środowiskowe dla pierwszego zasobu bazy danych.

Jeśli aplikacja używa wielu baz danych PostgreSQL, te zmienne odzwierciedlają tylko pierwszą. Użyj valueFrom z kluczem zasobu, aby pobrać dane połączenia do bazy danych. Zobacz Używanie zmiennych środowiskowych do uzyskiwania dostępu do zasobów.

Zmienna	Opis
PGAPPNAME	Nazwa aplikacji
PGDATABASE	Nazwa bazy danych
PGHOST	Nazwa hosta serwera PostgreSQL
PGPORT	Port serwera PostgreSQL
PGSSLMODE	Tryb SSL dla połączenia
PGUSER	Identyfikator klienta jednostki usługi i nazwa jej roli

Usuwanie zasobu bazy danych

Jeśli usuniesz zasoby bazy danych z aplikacji, aplikacja podejmie próbę ponownego przypisania wszystkich obiektów należących do jednostki usługi do użytkownika usuwającego zasób.

Logika używana przez aplikację zależy przede wszystkim od tego, czy masz rolę w bazie danych:

Twoje uprawnienia	Rola w bazie danych?	Wynik
CAN MANAGE	Tak	Azure Databricks ponownie przypisuje wszystkie obiekty należące do jednostki usługi do ciebie i usuwa rolę jednostki usługi.
CAN MANAGE	Nie.	Azure Databricks tworzy dla Ciebie rolę, ponownie przypisuje wszystkie obiekty należące do roli głównego usługi do Ciebie i usuwa rolę głównego usługi.
Nie CAN MANAGE	N/A	Azure Databricks usuwa zasób, ale nie usuwa roli ani ponownego przypisania własności. W interfejsie użytkownika zostanie wyświetlone ostrzeżenie i musisz ręcznie wyczyścić rolę i należące do niego obiekty później.

Notatki

Podczas dodawania baz danych jako zasobów aplikacji należy wziąć pod uwagę następujące kwestie:

• Jeśli odwołasz CONNECT i CREATE z jednej bazy danych i przyznasz je innej w tej samej aktualizacji, Azure Databricks aktualizuje uprawnienia, ale nie odtworzy roli jednostki usługi.
• Bazy danych utrwalają stan. Wszystkie schematy lub tabele utworzone przez aplikację pozostają nawet po ponownym wdrożeniu lub zatrzymaniu aplikacji.