Een Lakebase-resource toevoegen aan een Databricks-app

Voeg Lakebase-databases 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.

De volgende typen Lakebase-databasebronnen zijn beschikbaar:

  • Lakebase Autoscaling: organiseert resources als projecten met branches en databases.
  • Lakebase ingericht: organiseert bronnen als database-instanties.

Beide typen gebruiken hetzelfde PostgreSQL-verbindingsmodel en bieden dezelfde omgevingsvariabelen aan uw app.

Een databaseresource toevoegen

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

Opmerking

U kunt geen nieuwe ingerichte databases maken na 12 maart 2026, maar u kunt bestaande databases toevoegen als app-resources. Zie automatisch schalen standaard.

  1. Klik in de sectie App-resources wanneer u een app maakt of bewerkt op + Resourcedatabase> toevoegen.
  2. Kies een database. Voor Automatisch schalen van Lakebase selecteert u een project, vertakking en database. Selecteer voor Lakebase Voorzien een database-instantie en een database binnen die instantie.
  3. Selecteer het juiste machtigingsniveau voor uw app. Momenteel is de enige beschikbare machtiging Kan verbinding maken en creëren.
  4. (Optioneel) Geef een aangepaste resourcesleutel op. Dit is de wijze waarop u naar de database in uw app-configuratie verwijst. De standaardsleutel is postgres voor Lakebase Autoscaling en database voor Lakebase ingesteld.

U moet gemachtigd zijn CAN MANAGE voor het Lakebase-project om het toe te voegen als een app-resource.

Wanneer u een databaseresource toevoegt:

  • Azure Databricks maakt een PostgreSQL-rol in de geselecteerde database. De rolnaam komt overeen met de client-id van de service-principal . Als de rol al bestaat, Azure Databricks deze opnieuw gebruikt.
  • 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.
  • Voor Lakebase autoscaling moet de gebruiker die de resource toevoegt over CAN MANAGE machtigingen beschikken voor het project.

Omgevingsvariabelen

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

Als uw app meerdere PostgreSQL-databases gebruikt, weerspiegelen deze variabelen alleen de eerste. Gebruik valueFrom met de resource sleutel om de verbindingsgegevens 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 in de database hebt:

Uw machtigingen Rol in database? Resultaat
CAN MANAGE Ja Azure Databricks alle objecten die eigendom zijn van de service-principal, opnieuw aan u toewijst en de rol van de service-principal verwijdert.
CAN MANAGE Nee. Azure Databricks maakt een rol voor u aan, wijst 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 uit de ene database intrekt en deze aan een andere database toekent in dezelfde update, werkt Azure Databricks de bevoegdheden bij maar maakt het de rol van de service-principal niet opnieuw.
  • 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.
  • Last updated on