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

Lägg till Lakebase-databaser 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.

Följande typer av Lakebase-databasresurser är tillgängliga:

• Autoskalning av Lakebase: Organiserar resurser som projekt som innehåller grenar och databaser.
• Lakebase Provisioned: Organiserar resurser som databasinstanser.

Båda typerna använder samma PostgreSQL-anslutningsmodell och tillhandahåller samma miljövariabler till din app.

Lägga till en databasresurs

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

Anmärkning

Du kan inte skapa nya etablerade databaser efter den 12 mars 2026, men du kan lägga till befintliga som appresurser. Se Autoskalning som standardinställning.

1. I avsnittet Appresurser när du skapar eller redigerar en app klickar du på + Lägg till resursdatabas>.
2. Välj en databas. För Autoskalning av Lakebase väljer du ett projekt, en gren och en databas. För Lakebase Provisioned väljer du en databasinstans och en databas i den instansen.
3. 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.
4. (Valfritt) Ange en anpassad resursnyckel, vilket är hur du refererar till databasen i appkonfigurationen. Standardnyckeln är postgres för Lakebase Autoscaling och database för Lakebase Provisioned.

Du måste ha CAN MANAGE behörighet för Lakebase-projektet för att kunna lägga till det som en appresurs.

När du lägger till en databasresurs:

• Azure Databricks skapar en PostgreSQL-roll i den valda databasen. Rollnamnet matchar tjänstens huvudnamns klient-ID. Om rollen redan finns återanvänder Azure Databricks den.
• Azure Databricks ger tjänsthuvudnamnet CONNECT och CREATE behörighet till den valda databasen. Med de här behörigheterna kan appen skapa scheman och tabeller i databasen.
• För Autoskalning av Lakebase måste användaren som lägger till resursen ha CAN MANAGE behörighet för projektet.

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 PostgreSQL-databaser återspeglar dessa variabler bara den första. Använd valueFrom med resursnyckeln för att hämta anslutningsinformationen för databasen. 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 databasen:

Dina behörigheter	Roll i databasen?	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 Azure Databricks uppdaterar 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.