Abfrage aus lakebase SQL Editor

Der Lakebase SQL-Editor führt Abfragen in Ihren Lakebase-Datenbanken direkt aus der Lakebase-App aus. Es bietet Postgres-native Features wie EXPLAIN, /, ANALYZE und Metabefehle psql-style, sowie das Exportieren von Ergebnissen in CSV/JSON/XLSX.

Hinweis

Sie können Ihre Lakebase-Datenbank auch aus dem SQL-Editor in Lakehouse abfragen, der Visualisierungen, Dashboards, Zusammenarbeitsfeatures und die Möglichkeit bietet, Lakebase-Daten mit anderen Unity-Katalogtabellen zu kombinieren. Siehe Abfrage aus dem SQL-Editor (Lakehouse).

Verwenden des SQL-Editors für Lakebase

So verwenden Sie den SQL-Editor:

  1. Öffnen Sie die Lakebase-App, und wählen Sie Ihr Projekt aus.
  2. Wählen Sie in der Randleiste den SQL-Editor aus, und wählen Sie dann eine Verzweigung und Datenbank aus.
  3. Geben Sie eine Abfrage in den Editor ein, und klicken Sie auf "Ausführen" , um die Ergebnisse anzuzeigen.

LKB SQL-Editor

Verwenden Sie die folgende Abfrage, um den SQL-Editor zu testen. Die Abfrage erstellt eine Tabelle, fügt Daten hinzu und ruft die Daten aus der Tabelle ab.

CREATE TABLE IF NOT EXISTS playing_with_lakebase(id SERIAL PRIMARY KEY, name TEXT NOT NULL, value REAL);
INSERT INTO playing_with_lakebase(name, value)
SELECT LEFT(md5(i::TEXT), 10), random() FROM generate_series(1, 10) s(i);
SELECT * FROM playing_with_lakebase;

Wenn Mehrere Abfrageanweisungen gleichzeitig ausgeführt werden, wird für jede Anweisung ein separates Resultset zurückgegeben. Die Resultsets werden in separaten Registerkarten angezeigt, nummeriert in der Reihenfolge der Ausführung.

Um den Editor zu löschen, markieren Sie den Inhalt des Textfelds, und löschen Sie ihn.

Erläutern und Analysieren

Der SQL-Editor von Lakebase verfügt über Erläuterungs - und Analysefunktionen .

LKB SQL Editor Erklären und Analysieren

  • Das Feature "Erklären " führt die angegebene Abfrage mit dem Befehl Postgres EXPLAIN aus, der den Ausführungsplan für die Abfrage zurückgibt. Das Feature "Erklären " gibt nur einen Plan mit Schätzungen zurück. Die Abfrage wird nicht ausgeführt.
  • Das Feature "Analysieren" führt die angegebene Abfrage mit EXPLAIN ANALYZE aus. Der ANALYZE Parameter führt die Abfrage aus und gibt tatsächliche Zeilenanzahlen und Laufzeiten für Planknoten zusammen mit den EXPLAIN Schätzungen zurück.

Das Verständnis der Informationen, die von den Features " Erklären " und "Analysieren " bereitgestellt werden, erfordert Kenntnisse mit dem Befehl "Postgres EXPLAIN " und seinem ANALYZE Parameter. Siehe die EXPLAIN-Dokumentation und Verwenden von EXPLAIN in der PostgreSQL-Dokumentation.

Exportieren von Daten in CSV, JSON und XLSX

Der Lakebase SQL-Editor unterstützt das Exportieren Ihrer Daten nach JSON, CSVund XLSX. Greifen Sie in der unteren rechten Ecke der SQL-Editor-Seite auf die Downloadschaltfläche zu. Die Schaltfläche "Herunterladen" wird nur angezeigt, wenn ein Resultset zum Herunterladen vorhanden ist.

LKB SQL Editor Export

Abschnitt "Ergebnisse erweitern" im SQL-Editor-Fenster

Erweitern Sie den Ergebnisabschnitt des SQL-Editor-Fensters, indem Sie die Schaltfläche "Fenster erweitern" in der unteren rechten Ecke der SQL-Editor-Seite auswählen.

LKB SQL Editor Erweitern

Metabefehle

Der Lakebase SQL-Editor unterstützt die Verwendung von Metabefehlen von Postgres, die wie Tastenkombinationen für die Interaktion mit Ihrer Datenbank fungieren. Wenn Sie bereits mit der Verwendung von Metabefehlen über die psql Befehlszeilenschnittstelle vertraut sind, können Sie viele der gleichen Befehle im Lakebase SQL-Editor verwenden.

Metabefehle können Ihren Workflow beschleunigen, indem sie schnellen Zugriff auf Datenbankschemas und andere wichtige Informationen bereitstellen, ohne vollständige SQL-Abfragen schreiben zu müssen.

Im Folgenden sind einige häufig verwendete Metabefehle im Lakebase SQL-Editor aufgeführt:

  • \dt — Alle Tabellen in der aktuellen Datenbank auflisten
  • \d [table_name] — Beschreiben der Struktur einer Tabelle
  • \l — Alle Datenbanken auflisten
  • \? — Ein Spickzettel der verfügbaren Metabefehle
  • \h [NAME] — Hilfe für jeden Postgres-Befehl erhalten (z. B. \h SELECT)

Hinweis

Nicht alle psql Metabefehle werden im SQL-Editor unterstützt. Verwenden Sie \?zum Abrufen einer Liste der unterstützten Befehle .

Eine vollständige Liste der Metabefehle und deren Verwendung finden Sie unter Metabefehle in psql.

So verwenden Sie Metabefehle

Wenn Sie einen Metabefehl im SQL-Editor verwenden möchten, geben Sie den Metabefehl im Editor ein (genau wie eine SQL-Abfrage), und klicken Sie auf "Ausführen". Das Ergebnis wird im Ausgabebereich angezeigt.

Einschränkungen des SQL-Editors, wenn der öffentliche Zugriff deaktiviert ist

Wenn Ihr Arbeitsbereich für den Private Link konfiguriert ist und der öffentliche Zugriff deaktiviert ist, leitet der SQL-Editor Abfragen über das Lakebase-Backend weiter, anstatt eine direkte Datenbankverbindung zu verwenden. Die meisten Abfragen funktionieren identisch mit einer direkten Verbindung, aber der Proxy ist zustandslos und führt jede Anweisung als unabhängige HTTP-Anforderung aus, wodurch die folgenden Einschränkungen eingeführt werden:

Was funktioniert:

  • Abfragen mit einer einzelnen Anweisung (SELECT, INSERT, UPDATE, DELETE, UPSERT)
  • DDL-Anweisungen (CREATE, ALTER, DROP TABLE, CREATE INDEX und andere)
  • EXPLAIN und DESCRIBE-Befehle (\d, \dt, \di)
  • Volle Unterstützung für Postgres-Datentypen (Arrays, JSON/JSONB, numerische Typen, Zeitstempel, boolesche Werte)
  • Abfrageergebnisse und Fehlermeldungen

Was funktioniert nicht:

Funktion Einschränkung
Transaktionen BEGIN, COMMIT, ROLLBACKund SAVEPOINT funktionieren nicht wie erwartet. Jede Anweisung wird unabhängig automatisch festgeschrieben, ohne Garantie für Atomarität.
Sitzungszustand SET und SET LOCAL gilt nur für die aktuelle Anforderung. Temporäre Tabellen, vorbereitete Anweisungen, Cursor und Empfehlungssperren sind in nachfolgenden Anweisungen nicht verfügbar.
LISTEN/BENACHRICHTIGEN Erfordert eine dauerhafte Verbindung für asynchrone Benachrichtigungen, die der Proxy nicht unterstützt.
KOPIEREN VON STDIN Clientseitige Daten können nicht über den Proxy gestreamt werden.
\watch Die periodische Neuausführung von Abfragen ist über den zustandslosen Proxy nicht verfügbar.
Abfrage abbrechen Eine Stornierung erfolgt nur nach bestem Bemühen. Eine Abfrage kann nach einer Abbruchanforderung weiterhin im Back-End ausgeführt werden.
Skripte mit mehreren Anweisungen Anweisungen werden ohne gemeinsame Transaktion ausgeführt. Ein Teilskriptfehler führt zu einem teilweisen Commit.
Beschränkung der Ergebnisgröße Abfrageergebnisse sind auf 32 MB beschränkt.

Stellen Sie für Workloads, die Transaktionen oder sitzungsstatus erfordern, eine direkte Verbindung mit Ihrer Datenbank mithilfe eines Postgres-Clients her. Siehe Verbinden mit psql.

Problembehandlung

Wenn der SQL-Editor eine Meldung "Fehler beim Abrufen" oder "Unbekannter Fehler" anzeigt, und Ihr Arbeitsbereich Private Link verwendet, vergewissern Sie sich, dass eingehende Private Link (Arbeitsbereichsebene, Port 443) ordnungsgemäß konfiguriert ist. Siehe Fehlerbehebung bei der Private Link-Konnektivität.