Een Lakebase-resource toevoegen aan een Databricks-app

Voeg Lakebase-database-exemplaren toe als Databricks Apps-resources om gegevens over implementaties vast te houden. Met deze met PostgreSQL ondersteunde resources kunt u met uw app schema's en tabellen maken en beheren die de status behouden.

Belangrijk

Lakebase-database-exemplaren bevinden zich in openbare preview. Uw werkruimtebeheerder moet deze inschakelen voordat u ze als app-resource kunt toevoegen.

Een databaseresource toevoegen

Voordat u een Lakebase-database-exemplaar als resource toevoegt, controleert u de vereisten voor de app-resource.

1. Wanneer u een app maakt of bewerkt, gaat u naar de stap Configureren .
2. Klik in de sectie App-resources op + Resource toevoegen.
3. Selecteer Database als het resourcetype.
4. Kies een database-exemplaar.
5. Kies een database in dat exemplaar.
6. Selecteer het juiste machtigingsniveau voor uw app. Momenteel is de enige beschikbare machtiging Kan verbinding maken en maken.
7. (Optioneel) Geef een aangepaste resourcesleutel op. Dit is de wijze waarop u naar de database in uw app-configuratie verwijst. De standaardsleutel is database.

Wanneer u een databaseresource toevoegt:

• Azure Databricks maakt een PostgreSQL-rol in het geselecteerde database-exemplaar. De rolnaam komt overeen met de client-id van de service-principal . Als de rol al bestaat, wordt deze opnieuw gebruikt door Azure Databricks.
• Azure Databricks verleent de service-principal CONNECT en CREATE bevoegdheden voor de geselecteerde database. Met deze bevoegdheden kan de app schema's en tabellen in de database maken.

Omgevingsvariabelen

Wanneer u een app met een databaseresource implementeert, stelt Azure Databricks de volgende omgevingsvariabelen in voor de eerste databaseresource.

Als uw app meerdere databases gebruikt, weerspiegelen deze variabelen alleen de eerste. Gebruik valueFrom met de resourcesleutel om de hostnaam van de database op te halen. Zie Omgevingsvariabelen gebruiken voor toegang tot resources.

Veranderlijk	Beschrijving
PGAPPNAME	App-naam
PGDATABASE	Naam van de database
PGHOST	Hostnaam van de PostgreSQL-server
PGPORT	Poort voor de PostgreSQL-server
PGSSLMODE	SSL-modus voor de verbinding
PGUSER	Client-id en rolnaam van de service-principal

Een databaseresource verwijderen

Als u databaseresources uit een app verwijdert, probeert de app alle objecten die eigendom zijn van de service-principal opnieuw toe te staan aan de gebruiker die de resource verwijdert.

De logica die door de app wordt gebruikt, is voornamelijk afhankelijk van of u een rol hebt in het database-exemplaar:

Uw machtigingen	Rol in database-exemplaar?	Resultaat
CAN MANAGE	Ja	Azure Databricks wijs alle objecten die eigendom zijn van de service-principal opnieuw aan u toe en verwijdert de rol van de service-principal.
CAN MANAGE	Nee.	Azure Databricks maakt een rol voor u, wijs alle objecten die eigendom zijn van de rol van de service-principal aan u toe en verwijdert de rol van de service-principal.
Nee CAN MANAGE	Niet van toepassing.	Azure Databricks verwijdert de resource, maar verwijdert de rol niet en wijst het eigendom niet opnieuw toe. Er wordt een waarschuwing weergegeven in de gebruikersinterface en u moet de rol- en eigendomsobjecten later handmatig opschonen.

Opmerkingen

Houd rekening met het volgende wanneer u databases toevoegt als app-resources:

• Als u CONNECT en CREATE intrekt uit de ene database en deze verleent aan een andere in dezelfde update, werkt Azure Databricks de bevoegdheden bij, maar wordt de rol van de service-principal niet opnieuw ingesteld.
• Databases blijven de status behouden. Alle schema's of tabellen die door een app zijn gemaakt, blijven behouden, zelfs nadat u de app opnieuw hebt geïmplementeerd of gestopt.