Lägga till en Lakebase-resurs i en Databricks-app

Lägg till Lakebase-databasinstanser som Databricks Apps-resurser för att spara data mellan distributioner. Med dessa PostgreSQL-stödda resurser kan din app skapa och hantera scheman och tabeller som behåller tillståndet.

Viktigt!

Lakebase-databasinstanser finns i offentlig förhandsversion. Administratören för arbetsytan måste aktivera dem innan du kan lägga till dem som en appresurs.

Lägga till en databasresurs

Innan du lägger till en Lakebase-databasinstans som en resurs granskar du kraven för appresursen.

1. När du skapar eller redigerar en app går du till steget Konfigurera .
2. I avsnittet Appresurser klickar du på + Lägg till resurs.
3. Välj Databas som resurstyp.
4. Välj en databasinstans.
5. Välj en databas i den instansen.
6. Välj lämplig behörighetsnivå för din app. För närvarande är den enda tillgängliga behörigheten Kan ansluta och skapa.
7. (Valfritt) Ange en anpassad resursnyckel, vilket är hur du refererar till databasen i appkonfigurationen. Standardnyckeln är database.

När du lägger till en databasresurs:

• Azure Databricks skapar en PostgreSQL-roll i den valda databasinstansen. Rollnamnet matchar tjänstens huvudnamns klient-ID. Om rollen redan finns återanvänder Azure Databricks den.
• Azure Databricks ger tjänsthuvudnamn CONNECT och CREATE behörigheter för den valda databasen. Med de här behörigheterna kan appen skapa scheman och tabeller i databasen.

Miljövariabler

När du distribuerar en app med en databasresurs anger Azure Databricks följande miljövariabler för den första databasresursen.

Om din app använder flera databaser återspeglar dessa variabler bara den första. Använd valueFrom med resursnyckeln för att hämta databasens värdnamn. Se Använda miljövariabler för att komma åt resurser.

Variabel	Beskrivning
PGAPPNAME	Appnamn
PGDATABASE	Namnet på databasen
PGHOST	PostgreSQL-serverns värdnamn
PGPORT	Port för PostgreSQL-servern
PGSSLMODE	SSL-läge för anslutningen
PGUSER	Tjänstens huvudobjekts klient-ID och rollnamn

Ta bort en databasresurs

Om du tar bort databasresurser från en app försöker appen omtilldela alla objekt som ägs av tjänstens huvudnamn till användaren som tar bort resursen.

Logiken som appen använder beror främst på om du har en roll i databasinstansen:

Dina behörigheter	Roll i databasinstansen?	Resultat
CAN MANAGE	Ja	Azure Databricks omtilldelar alla objekt som ägs av tjänstens huvudnamn till dig och tar bort tjänstens huvudnamnsroll.
CAN MANAGE	Nej	Azure Databricks skapar en roll åt dig, omtilldelar alla objekt som ägs av tjänstens huvudnamnsroll till dig och tar bort tjänstens huvudnamnsroll.
Nej CAN MANAGE	Inte tillgänglig	Azure Databricks tar bort resursen, men tar inte bort rollen eller omtilldelar ägarskapet. En varning visas i användargränssnittet och du måste rensa rollen och ägda objekt manuellt senare.

Noteringar

Tänk på följande när du lägger till databaser som appresurser:

• Om du återkallar CONNECT och CREATE från en databas och beviljar dem på en annan i samma uppdatering uppdaterar Azure Databricks behörigheterna men återskapar inte tjänstens huvudnamnsroll.
• Databaser bevarar tillstånd. Alla scheman eller tabeller som skapats av en app finns kvar även efter att du har distribuerat om eller stoppat appen.