Freigeben über

Hinzufügen einer Lakebase-Ressource zu einer Databricks-App

Fügen Sie Lakebase-Datenbanken als Databricks-Apps-Ressourcen hinzu, um Daten über Bereitstellungen hinweg zu speichern. Mit diesen postgreSQL-gesicherten Ressourcen können Ihre App Schemas und Tabellen erstellen und verwalten, die den Zustand beibehalten.

Die folgenden Typen von Lakebase-Datenbankressourcen sind verfügbar:

  • Lakebase Autoscaling: Organisiert Ressourcen als Projekte, die Verzweigungen und Datenbanken enthalten.
  • Lakebase Provisioned: Organisiert Ressourcen als Datenbankinstanzen.

Beide Typen verwenden dasselbe PostgreSQL-Verbindungsmodell und stellen ihrer App dieselben Umgebungsvariablen bereit.

Hinzufügen einer Datenbankressource

Bevor Sie eine Lakebase-Datenbank als Ressource hinzufügen, überprüfen Sie die Voraussetzungen für die App-Ressource.

Hinweis

Sie können nach dem 12. März 2026 keine neuen bereitgestellten Datenbanken erstellen, sie können jedoch vorhandene Datenbanken als App-Ressourcen hinzufügen. Siehe Automatische Skalierung standardmäßig.

  1. Klicken Sie im Abschnitt "App-Ressourcen" beim Erstellen oder Bearbeiten einer App auf + Ressource hinzufügen>, und wählen Sie Datenbank.
  2. Wählen Sie eine Datenbank aus. Wählen Sie für lakebase Autoscaling ein Projekt, eine Verzweigung und eine Datenbank aus. Wählen Sie für Lakebase Provisioned eine Datenbankinstanz und eine Datenbank in dieser Instanz aus.
  3. Wählen Sie die entsprechende Berechtigungsstufe für Ihre App aus. Derzeit ist die einzige verfügbare Berechtigung can connect and create.
  4. (Optional) Geben Sie einen benutzerdefinierten Ressourcenschlüssel an, mit dem Sie in der App-Konfiguration auf die Datenbank verweisen. Der Standardschlüssel ist postgres für Lakebase Autoscaling und database für Lakebase Provisioned.

Sie müssen CAN MANAGE über die Berechtigung für das Lakebase-Projekt verfügen, um es als App-Ressource hinzuzufügen.

Wenn Sie eine Datenbankressource hinzufügen:

  • Azure Databricks erstellt eine PostgreSQL-Rolle in der ausgewählten Datenbank. Der Rollenname entspricht der Client-ID des Dienstprinzipals . Wenn die Rolle bereits vorhanden ist, verwendet Azure Databricks sie wieder.
  • Azure Databricks gewährt dem Dienstprinzipal CONNECT und CREATE Berechtigungen für die ausgewählte Datenbank. Mit diesen Berechtigungen können die App Schemas und Tabellen in der Datenbank erstellen.
  • Für Lakebase Autoscaling muss der Benutzer, der die Ressource hinzufügt, die Berechtigung CAN MANAGE für das Projekt haben.

Umgebungsvariablen

Wenn Sie eine App mit einer Datenbankressource bereitstellen, legt Azure Databricks die folgenden Umgebungsvariablen für die erste Datenbankressource fest.

Wenn Ihre App mehrere PostgreSQL-Datenbanken verwendet, spiegeln diese Variablen nur den ersten wider. Verwenden Sie valueFrom mit dem Ressourcenschlüssel, um die Verbindungsdetails für die Datenbank abzurufen. Weitere Informationen finden Sie unter Verwenden von Umgebungsvariablen für den Zugriff auf Ressourcen.

Variable BESCHREIBUNG
PGAPPNAME App-Name
PGDATABASE Name der Datenbank
PGHOST Hostname des PostgreSQL-Servers
PGPORT Port für den PostgreSQL-Server
PGSSLMODE SSL-Modus für die Verbindung
PGUSER Client-ID und Rollenname des Service Principals

Entfernen einer Datenbankressource

Wenn Sie Datenbankressourcen aus einer App entfernen, versucht die App, alle Objekte, die dem Dienstprinzipal gehören, dem Benutzer zuzuweisen, der die Ressource entfernt.

Die Logik, die die App verwendet, hängt in erster Linie davon ab, ob Sie eine Rolle in der Datenbank haben:

Ihre Berechtigungen Rolle in der Datenbank? Ergebnis
CAN MANAGE Ja Azure Databricks weist alle dem Dienstprinzipal gehörenden Objekte Ihnen neu zu und löscht die Rolle des Dienstprinzipals.
CAN MANAGE Nein Azure Databricks erstellt eine Rolle für Sie, weist alle Objekte, die der Rolle des Dienstprinzipals gehören, Ihnen zu und löscht die Rolle des Dienstprinzipals.
Nein CAN MANAGE Nicht verfügbar Azure Databricks entfernt die Ressource, löscht jedoch nicht die Rolle und weist den Besitz nicht neu zu. In der Benutzeroberfläche wird eine Warnung angezeigt, und Sie müssen die Rolle und die im Besitz befindlichen Objekte später manuell bereinigen.

Hinweise

Beachten Sie Folgendes, wenn Sie Datenbanken als App-Ressourcen hinzufügen:

  • Wenn Sie CONNECT und CREATE aus einer Datenbank widerrufen und in einem anderen Update gewähren, Azure Databricks die Berechtigungen aktualisiert, aber die Rolle des Dienstprinzipals nicht neu erstellt.
  • Datenbanken bewahren ihren Zustand. Alle von einer App erstellten Schemas oder Tabellen bleiben auch nach der erneuten Bereitstellung oder Beendigung der App bestehen.
  • Last updated on