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.

Skalowanie automatyczne bazy danych Lakebase

1. Podczas tworzenia lub edytowania aplikacji przejdź do kroku Konfigurowanie .
2. W sekcji Zasoby aplikacji kliknij pozycję + Dodaj zasób.
3. W polu Typ zasobu wybierz pozycję Baza danych.
4. Wybierz projekt, gałąź i bazę danych.
5. Wybierz odpowiedni poziom uprawnień dla aplikacji. Obecnie jedynym dostępnym uprawnieniem jest Możliwość nawiązania połączenia i utworzenia.
6. (Opcjonalnie) Określ niestandardowy klucz zasobu, w jaki sposób odwołujesz się do bazy danych w konfiguracji aplikacji. Kluczem domyślnym jest postgres.

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

Udostępniono Lakebase

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. Podczas tworzenia lub edytowania aplikacji przejdź do kroku Konfigurowanie .
2. W sekcji Zasoby aplikacji kliknij pozycję + Dodaj zasób.
3. Wybierz pozycję Baza danych jako typ zasobu.
4. Wybierz instancję bazy danych.
5. Wybierz bazę danych w tym wystąpieniu.
6. Wybierz odpowiedni poziom uprawnień dla aplikacji. Obecnie jedynym dostępnym uprawnieniem jest Możliwość nawiązania połączenia i utworzenia.
7. (Opcjonalnie) Określ niestandardowy klucz zasobu, w jaki sposób odwołujesz się do bazy danych w konfiguracji aplikacji. Kluczem domyślnym jest database.

Po dodaniu zasobu bazy danych:

• Usługa Azure Databricks tworzy rolę PostgreSQL w wybranej bazie danych. Nazwa roli jest zgodna z identyfikatorem klienta podmiotu usługi. Jeśli rola już istnieje, usługa Azure Databricks używa jej ponownie.
• Azure Databricks udziela głównej jednostce usługi CONNECT oraz CREATE uprawnień do wybranej bazy 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 usługa 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	Usługa Azure Databricks ponownie przypisuje do ciebie wszystkie obiekty należące do jednostki usługi i usuwa rolę jednostki usługi.
CAN MANAGE	Nie.	Usługa Azure Databricks tworzy rolę dla Ciebie, ponownie przypisuje wszystkie obiekty należące do roli jednostki usługi, której jesteś właścicielem, i usuwa rolę tej jednostki usługi.
Nie CAN MANAGE	N/A	Usługa 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 cofniesz CONNECT i CREATE z jednej bazy danych i przyznasz je innej w ramach tej samej aktualizacji, usługa Azure Databricks zaktualizuje uprawnienia, ale nie odtworzy ponownie roli jednostki usługi.
• Bazy danych utrwalają stan. Wszystkie schematy lub tabele utworzone przez aplikację pozostają nawet po ponownym wdrożeniu lub zatrzymaniu aplikacji.