Verwenden von Lakebase mit Databricks-Apps

Mit Databricks-Apps können Sie interaktive Anwendungen direkt in Ihrem Azure Databricks-Arbeitsbereich erstellen und bereitstellen. Durch das Hinzufügen von Lakebase als Ressource erhält Ihre App ein vollständig verwaltetes Postgres-Back-End. Azure Databricks erstellt einen Dienstprinzipal für Ihre App, gewährt ihr eine passende Postgres-Rolle und fügt Verbindungsdetails als Umgebungsvariablen ein. Ihre App stellt eine Verbindung mit einer vollständig verwalteten Postgres-Datenbank ohne Verwaltung von Anmeldeinformationen oder Verbindungszeichenfolgen bereit.

Dieses Lernprogramm führt Sie durch die Bereitstellung einer Vorlagen-App, die mit einer Lakebase-Datenbank verbunden ist. Am Ende verfügen Sie über eine ausgeführte App mit Daten, die Sie direkt aus Lakebase überprüfen und abfragen können, und optional in Unity Catalog neben Ihren Lakehouse-Daten registrieren.

Voraussetzungen

Bevor Sie beginnen, sollten Sie sicherstellen, dass Folgendes vorhanden ist:

• Zugriff auf einen Azure Databricks-Arbeitsbereich mit Lakebase und serverless Compute aktiviert. Wenden Sie sich bei Bedarf an Ihren Arbeitsbereichsadministrator.
• Berechtigung zum Erstellen von Computeressourcen und Apps.

Schritt 1: Bereitstellen einer Lakebase-Instanz

Ein Lakebase-Projekt ist eine verwaltete Postgres-Instanz, mit der Ihre App eine Verbindung als Ressource herstellt. Projekte sind in Verzweigungen unterteilt, die jeweils eine isolierte Datenbankumgebung darstellen.

Informationen zum Erstellen eines Lakebase-Projekts finden Sie unter „Erste Schritte mit Lakebase Autoscaling“. Lakebase erstellt Ihr Projekt mit einem production Branch und einer databricks_postgres Datenbank.

Schritt 2: Erstellen einer Databricks-App

Azure Databricks stellt drei automatisch skalierende App-Vorlagen bereit, die die Lakebase-Integration mithilfe einer Todos-App veranschaulichen: Dash, Flask und Streamlit. So erstellen Sie eine App aus einer Vorlage:

1. Klicken Sie in Ihrem Azure Databricks-Arbeitsbereich auf den App-Umschalter und wählen Sie Databricks Apps aus.
2. Klicken Sie auf +App erstellen.
3. Wählen Sie ihre bevorzugte Vorlage auf der Registerkarte "Datenbank " aus.

Schritt 3: Konfigurieren einer Datenbankressource

Das Hinzufügen von Lakebase als Ressource erstellt einen Dienstprinzipal mit den richtigen Datenbankberechtigungen und fügt Ihre Verbindungsdetails als Umgebungsvariablen in die App ein. Auf diese Weise kann die Vorlage automatisch eine Verbindung mit Ihrer Datenbank herstellen, ohne dass Verbindungszeichenfolgen im Code vorhanden sind.

Konfigurieren Sie im Schritt " Konfigurieren" die folgenden Einstellungen.

1. Wählen Sie für App-Ressourcen Ihr Lakebase-Projekt, Ihre Branch und Ihre Datenbank aus. Verzweigungsnamen werden als IDs angezeigt. Wenn Sie IDs mit Namen abgleichen möchten, sehen Sie sich die Seite mit den Verzweigungen Ihres Projekts an.
2. Wählen Sie für Computing-GrößeMittel aus. Dadurch wird die Berechnung des App-Servers gesteuert, die unabhängig von der Lakebase-Datenbank berechnet und skaliert wird.

Weitere Informationen finden Sie unter Hinzufügen einer Lakebase-Ressource zu einer Databricks-App.

Schritt 4: Überprüfen von Autorisierungen

Jede Databricks-App wird als eigener Dienstprinzipal ausgeführt, was eine dedizierte Identität beschreibt, die von den Benutzern unabhängig ist. Wenn Sie Lakebase als Ressource verbinden, erstellt Azure Databricks eine übereinstimmende Postgres-Rolle für diesen Dienstprinzipal und gewährt dem Dienstprinzipal den vollständigen Datenbankzugriff. Es ist kein manuelles Rollensetup erforderlich.

Schritt 5: Benennen Ihrer App und Installation

Lakebase verwendet den App-Namen, um einen Schemanamen im Format {app-name}_schema_{service-principal-id} zu generieren (Bindestriche, die aus der ID entfernt wurden). Sie können den App-Namen nach der Erstellung nicht ändern, aber Sie können das Schema später umbenennen. Die Vorlage ist standardmäßig auf lakebase-autoscaling-app eingestellt.

Klicken Sie auf " App erstellen" , um die App zu erstellen.

Schritt 6: Bereitstellen der App

Nachdem Sie die App erstellt haben, wird die Berechnung automatisch gestartet, und Ihre App wird in etwa 2 bis 3 Minuten ohne weitere Aktion bereitgestellt. Wenn der App-Status "Wird ausgeführt" angezeigt wird, klicken Sie auf die URL neben der App, um Ihre App zu öffnen.

Schritt 7: Überprüfen der Integration

Fügen Sie ihrer App einige Todos hinzu. Öffnen Sie in Ihrem Lakebase-Projekt Tabellen , und wählen Sie die Todos-Tabelle unter dem App-Schema aus. Der Dienstprinzipal der App hat diese Zeilen mithilfe der in Schritt 3 eingefügten Verbindungsdetails geschrieben.

Verwenden Sie den SQL-Editor in Ihrem Lakebase-Projekt, um die Daten direkt abzufragen. Da Lakebase beim Leerlauf auf Null skaliert wird, kann die erste Abfrage nach einer langen Pause einige Sekunden dauern, um zu antworten. Weitere Verbindungsoptionen finden Sie unter Herstellen einer Verbindung mit Ihrer Datenbank.

Schritt 8: Abfragen des Unity-Katalogs (optional)

Standardmäßig sind die Lakebase-Daten Ihrer App über Postgres-Verbindungen direkt zugänglich. Durch die Registrierung im Unity-Katalog können Sie sie zusammen mit Ihren Lakehouse-Daten mit standard Databricks SQL abfragen. Anschließend können Sie die Transaktionstabellen Ihrer App mit Delta-Tabellen in derselben Abfrage verknüpfen.

Öffnen Sie zum Registrieren den Katalog-Explorer, und erstellen Sie einen neuen Katalog. Wählen Sie Lakebase Postgres als Katalogtyp aus, wählen Sie Autoscaling und wählen Sie dasselbe Projekt und dieselbe Verzweigung wie Ihre App aus. Weitere Informationen finden Sie im Abschnitt Registrieren Ihrer Datenbank im Unity-Katalog.

Beachten Sie, dass Schemanamen im Unity-Katalog Bindestriche von Ihrem App-Namen beibehalten. Sowohl die Katalog- als auch die Schemanamen erfordern eine Backtick-Quotierung:

SELECT * FROM `your-catalog-name`.`lakebase-autoscaling-app_schema_aeb6ff9198ff4752af7dfc6d4cf570d0`.todos;

Weitere Informationen

• Erste Schritte mit Databricks-Apps
• Entwickeln von Databricks-Apps
• Herstellen einer Verbindung mit Ihrer Datenbank