Wykonywanie zapytań z poziomu edytora SQL usługi Lakebase

Edytor SQL Lakebase uruchamia zapytania w bazach danych Lakebase bezpośrednio z aplikacji Lakebase. Oferuje funkcje natywne dla bazy danych Postgres, takie jak EXPLAIN/ANALYZE, psql-style metapolecenia i eksportowanie wyników do pliku CSV/JSON/XLSX.

Uwaga / Notatka

Bazę danych usługi Lakebase można również odpytywać w edytorze SQL w Lakehouse, który udostępnia wizualizacje, dashboardy, funkcje współpracy i możliwość łączenia danych Lakebase z innymi tabelami Katalogu Unity. Zobacz Zapytanie z edytora SQL (Lakehouse).

Korzystanie z edytora SQL lakebase

Aby użyć edytora SQL:

  1. Otwórz aplikację Lakebase i wybierz projekt.
  2. Wybierz pozycję Edytor SQL na pasku bocznym, a następnie wybierz gałąź i bazę danych.
  3. Wprowadź zapytanie w edytorze i kliknij przycisk Uruchom , aby wyświetlić wyniki.

Edytor SQL LKB

Użyj następującego zapytania, aby wypróbować edytor SQL. Zapytanie tworzy tabelę, dodaje dane i pobiera dane z tabeli.

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;

Uruchamianie wielu instrukcji zapytania jednocześnie zwraca oddzielny zestaw wyników dla każdej instrukcji. Zestawy wyników są wyświetlane na osobnych kartach ponumerowanych w kolejności wykonywania.

Aby wyczyścić edytor, zaznacz zawartość pola tekstowego i usuń go.

Wyjaśnij i przeanalizuj

Edytor SQL Lakebase posiada funkcje Explain i Explain (Analyze).

LKB SQL Editor Explain and Analyze

  • Funkcja Wyjaśnij uruchamia określone zapytanie za pomocą polecenia Postgres EXPLAIN , które zwraca plan wykonywania zapytania. Funkcja Wyjaśnij zwraca tylko plan z oszacowaniami. Nie uruchamia kwerendy.
  • Funkcja Explain (Analyze) uruchamia określone zapytanie za pomocą EXPLAIN ANALYZE. Parametr ANALYZE wykonuje zapytanie i zwraca rzeczywiste liczby wierszy i czasy uruchamiania dla węzłów planu wraz z EXPLAIN oszacowaniami. Explain (Analyze) dodaje również opcje PREFETCH i FILECACHE, które raportują statystyki prefetch i lokalnej pamięci podręcznej plików dla zapytania.

Warning

Explain (Analyze) wykonuje polecenie. Uruchomienie go na instrukcji modyfikującej dane, takiej jak INSERT, UPDATE, DELETE, lub MERGE modyfikuje Twoje dane.

Zrozumienie informacji dostarczanych przez funkcje Explain and Explain (Analyze) wymaga znajomości polecenia Postgres EXPLAIN i jego ANALYZE parametru. Zapoznaj się z dokumentacją EXPLAIN oraz z sekcją „Używanie EXPLAIN” w dokumentacji PostgreSQL.

Eksportuj dane do formatów CSV, JSON i XLSX

Edytor SQL Lakebase obsługuje eksportowanie danych do JSON, CSVi XLSX. Uzyskaj dostęp do przycisku pobierania w prawym dolnym rogu strony edytora SQL . Przycisk pobierania jest wyświetlany tylko wtedy, gdy istnieje zestaw wyników do pobrania.

Eksport edytora SQL LKB

Rozwiń sekcję wyników w oknie edytora SQL

Rozwiń sekcję wyników okna edytora SQL, wybierając przycisk rozwiń okno w prawym dolnym rogu strony edytora SQL .

Rozwiń edytor SQL LKB

Meta-komendy

Edytor SQL lakebase obsługuje używanie meta-poleceń Postgres, które działają jak skróty do interakcji z bazą danych. Jeśli znasz już meta-polecenia z interfejsu psql wiersza polecenia, możesz użyć wielu tych samych poleceń w edytorze SQL Lakebase.

Meta-polecenia mogą przyspieszyć przepływ pracy, zapewniając szybki dostęp do schematów bazy danych i innych krytycznych informacji bez konieczności pisania pełnych zapytań SQL.

Poniżej przedstawiono niektóre często używane meta-polecenia w edytorze SQL Lakebase:

  • \dt — Wymień wszystkie tabele w bieżącej bazie danych
  • \d [table_name] — Opisz strukturę tabeli
  • \l — Wyświetlanie wszystkich baz danych
  • \? — Ściągawka z dostępnymi meta-poleceniami
  • \h [NAME] — Uzyskaj pomoc dla dowolnego polecenia Postgres (np. \h SELECT)

Uwaga / Notatka

Nie wszystkie psql meta-polecenia są obsługiwane w edytorze SQL. Aby uzyskać listę obsługiwanych poleceń, użyj polecenia \?.

Aby uzyskać pełną listę meta-poleceń i sposób ich użycia, zobacz Meta-polecenia w psql.

Jak używać meta-poleceń

Aby użyć meta-polecenia w edytorze SQL, wprowadź meta-polecenie w edytorze (podobnie jak zapytanie SQL) i kliknij przycisk Uruchom. Wynik zostanie wyświetlony w okienku danych wyjściowych.

Wybierz rolę Postgres

Zapytania w Edytorze SQL Lakebase działają jako konkretna rola Postgres, a uprawnienia tej roli decydują o tym, które dane możesz czytać i jakie zmiany wprowadzać. Edytor SQL zawiera selektor ról, dzięki któremu możesz wybrać rolę, jako którą się łączysz. Domyślnie SQL Editor łączy się jako najlepsza dostępna rola dla Ciebie.

Aby uruchamiać zapytania jako inną rolę, otwórz selektor ról i wybierz rolę, którą chcesz. Zapytania wykonywane po przełączeniu wykorzystują wybraną rolę.

Aby otworzyć Edytor SQL z konkretną rolą zamiast automatycznie wybranej, dodaj role parametr zapytania do adresu URL strony, na przykład ?role=<role-name>. Użyj tego, aby dodać do zakładek lub udostępnić link, który otwiera edytor z określoną rolą.

Aby poznać role Postgres dostępne w Twoim projekcie i uprawnienia, które posiadają, zobacz Role i uprawnienia.

Ograniczenia edytora SQL, gdy dostęp publiczny jest wyłączony

Jeśli w obszarze roboczym skonfigurowano Private Link przy wyłączonym dostępie publicznym, Edytor SQL pośredniczy w przesyłaniu zapytań przez backend Lakebase zamiast korzystać z bezpośredniego połączenia z bazą danych. Większość zapytań działa identycznie z bezpośrednim połączeniem, ale serwer proxy jest bezstanowy i uruchamia każdą instrukcję jako niezależne żądanie HTTP, które wprowadza następujące ograniczenia:

Co działa:

  • Zapytania z jedną instrukcją (SELECT, INSERT, , UPDATEDELETE, UPSERT)
  • Instrukcje DDL (CREATE, ALTER, DROP TABLE, CREATE INDEX i inne)
  • EXPLAIN oraz polecenia DESCRIBE (\d, \dt, \di)
  • Obsługa pełnego typu danych Postgres (tablice, dane JSON/JSONB, numeryczne, znaczniki czasu, wartości logiczne)
  • Wyniki zapytań i komunikaty o błędach

Co nie działa:

Funkcja Limitation
Transactions BEGIN, COMMIT, ROLLBACK, i SAVEPOINT nie działają zgodnie z oczekiwaniami. Każda instrukcja jest automatycznie zatwierdzana niezależnie, bez gwarancji atomowości.
Stan sesji SET i SET LOCAL dotyczą tylko bieżącego żądania. Tabele tymczasowe, przygotowane polecenia, kursory i blokady doradcze nie są dostępne w kolejnych instrukcjach.
NASŁUCHIWANIE/POWIADAMIANIE Wymaga trwałego połączenia dla powiadomień asynchronicznych, które serwer proxy nie obsługuje.
KOPIUJ ZE STDIN Nie można strumieniować danych po stronie klienta przez serwer proxy.
\watch Okresowe ponowne wykonywanie zapytań nie jest dostępne za pośrednictwem bezstanowego serwera proxy.
Anulowanie zapytania Anulowanie jest tylko najlepszym rozwiązaniem. Zapytanie może nadal działać w zapleczu po żądaniu anulowania.
Skrypty z wieloma instrukcjami Instrukcje są wykonywane bez współdzielonej transakcji. Błąd częściowego skryptu powoduje częściowe zatwierdzenie.
Limit rozmiaru wyników Wyniki zapytania są ograniczone do 32 MB.

W przypadku obciążeń wymagających transakcji lub stanu sesji połącz się bezpośrednio z bazą danych przy użyciu klienta Postgres. Zobacz Nawiązywanie połączenia za pomocą narzędzia psql.

Rozwiązywanie problemów

Jeśli edytor SQL wyświetla komunikat „Failed to fetch” lub „Unknown error”, a Twój workspace korzysta z Private Link, potwierdź, że przychodzący punkt końcowy Private Link na poziomie workspace (port 443) jest poprawnie skonfigurowany. Zobacz Rozwiązywanie problemów z łącznością Private Link.