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.

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śnienie i analiza

Edytor SQL Lakebase ma funkcje Wyjaśnij i Analizuj .

• 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 Analizuj uruchamia określone zapytanie za pomocą EXPLAIN funkcji ANALYZE. Parametr ANALYZE wykonuje zapytanie i zwraca rzeczywiste liczby wierszy i czasy uruchamiania dla węzłów planu wraz z EXPLAIN oszacowaniami.

Zrozumienie informacji dostarczonych przez funkcje Wyjaśnij i Analizuj wymaga znajomości polecenia Postgres EXPLAIN i jego parametru ANALYZE . Zapoznaj się z dokumentacją EXPLAIN oraz z sekcją „Używanie EXPLAIN” w dokumentacji PostgreSQL.

Eksportowanie danych do plikó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.

Rozwiń sekcję wyników okna edytora SQL

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

Metapolecenia

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 — Wyświetlanie listy wszystkich tabel w bieżącej bazie danych
• \d [table_name] — Opisywanie struktury tabeli
• \l — Wyświetlanie listy wszystkich baz danych
• \? — opracowanie dostępnych meta-poleceń
• \h [NAME] — Uzyskaj pomoc dotyczącą 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ę Postgresa

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 i 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, , COMMITROLLBACKi 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 mają zastosowanie tylko do 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.