Wykonywanie zapytań z poziomu edytora SQL w obszarze roboczym

Na tej stronie opisano sposób wykonywania zapytań dotyczących baz danych w projekcie Lakebase z poziomu edytora SQL w obszarze roboczym analizy i sztucznej inteligencji przy użyciu dwóch różnych metod połączenia.

Edytor SQL w obszarze roboczym to wspólny obszar roboczy SQL, w którym można tworzyć zapytania, znajdować wykazy danych, tworzyć wizualizacje i udostępniać wyniki współpracownikom. Oferuje zaawansowane funkcje analizy, współpracy i automatyzacji.

Uwaga / Notatka

W przypadku funkcji natywnych Postgres, takich jak EXPLAIN/ANALYZE i meta-polecenia (\dt, \d, \l), użyj edytora Lakebase SQL. Zobacz Zapytanie z edytora SQL Lakebase.

Aby uzyskać pełne informacje na temat możliwości edytora SQL, zobacz Pisanie zapytań i eksplorowanie danych w edytorze SQL.

Metody połączenia

Możesz nawiązać połączenie z bazą danych Lakebase z poziomu edytora SQL przy użyciu dwóch metod:

  1. Bezpośrednie połączenie obliczeniowe: Połącz się bezpośrednio z zasobami obliczeniowymi Lakebase, aby uzyskać natychmiastowy dostęp do zapytań dla konkretnego projektu i gałęzi.
  2. Rejestracja w Katalogu Unity: Zarejestruj swoją bazę danych w Katalogu Unity, aby umożliwić federacyjne zapytania, zunifikowane zarządzanie oraz analitykę wieloźródłową.

Wybierz metodę połączenia

Funkcja Bezpośrednie połączenie obliczeniowe Rejestracja katalogu Unity
Dostęp do danych Pełny dostęp do odczytu i zapisu w bazie danych Lakebase Dostęp tylko do odczytu przez Unity Catalog
Najlepsze dla Praca przede wszystkim z danymi lakebase bez łączenia ich z innymi źródłami danych Łączenie danych usługi Lakebase z innymi tabelami Unity Catalog w zapytaniach federacyjnych
Złożoność instalacji Natychmiastowy dostęp do zapytania o określoną bazę danych bez rejestracji Wymaga rejestracji w katalogu i uprawnień Unity Catalog.
Zarządzanie Brak funkcji zarządzania katalogiem Unity Ujednolicone mechanizmy kontroli zarządzania (uprawnienia, dane źródłowe, dzienniki inspekcji)
Kontrola dostępu Tylko uprawnienia oparte na rolach w Postgres Scentralizowane odnajdywanie i kontrola dostępu w wielu źródłach danych
Przykłady użycia Bezpośrednie operacje i modyfikacje bazy danych Pulpity nawigacyjne i aplikacje integrujące dane transakcyjne i analityczne

Metoda 1: Połącz się bezpośrednio z obliczeniami Lakebase

Użyj tej metody, aby połączyć się bezpośrednio z obliczeniami usługi Lakebase w celu uzyskania bezpośredniego dostępu do zapytań.

Prerequisites

Jeśli nie jesteś właścicielem projektu, sprawdź, czy masz:

Jeśli nie masz niezbędnej roli lub uprawnień, skontaktuj się z właścicielem projektu, aby zażądać dostępu.

Uwaga / Notatka

Aby można było do niego dołączyć, zasoby obliczeniowe Lakebase muszą być w stanie aktywnym. Jeśli środowisko obliczeniowe jest bezczynne, nie można dołączyć. Obliczenia zwykle stają się nieaktywne, gdy skalowanie do zera jest włączone i nie ma aktywności bazy danych.

Aby aktywować bezczynne zasoby obliczeniowe, uruchom zapytanie w edytorze SQL Lakebase lub wyłącz skalowanie do zera, aby upewnić się, że obliczenia pozostają aktywne. Zobacz Skalowanie do zera.

Aby nawiązać bezpośrednie połączenie z obliczeniami usługi Lakebase:

  1. Użyj przełącznika aplikacji, aby przejść do analityki i AI.
  2. Otwórz edytor SQL, klikając pozycję Edytor SQL IconSQL Editor na pasku bocznym.
  3. Z rozwijanego menu obliczeń wybierz pozycję Więcej...

menu „Połącz”

  1. W oknie dialogowym Dołącz do istniejącego zasobu obliczeniowego wybierz Lakebase Postgres, a następnie wybierz swój Project i Branch.

Dołącz do Project i gałęzi LKB

  1. Kliknij przycisk Dołącz , aby nawiązać połączenie.

Przykładowe zapytania z połączeniem bezpośrednim

Po nawiązaniu połączenia można uruchamiać standardowe zapytania Sql Postgres względem bazy danych Lakebase.

Utwórz tabelę, wstaw dane i wykonaj na niej zapytanie:

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;

Wykonaj zapytanie dotyczące konkretnej tabeli:

SELECT * FROM public.playing_with_lakebase;

Ważne

Ograniczenia przy bezpośrednim połączeniu:

  • Zapytania federacyjne nie są obsługiwane: Możesz wykonywać zapytania tylko do połączonego elementu Project i gałęzi Lakebase. Nie można połączyć danych Lakebase z innymi tabelami Unity Catalog w jednym zapytaniu.
  • Meta-komendy Postgres nie są obsługiwane: Meta-komendy Postgres (takie jak \dt, \d, \l), które działają w edytorze SQL Lakebase, nie działają w edytorze SQL (Lakehouse).

Metoda 2: Rejestracja bazy danych w Unity Catalog

Użyj tej metody, aby zarejestrować bazę danych Lakebase w Unity Catalog, umożliwiając zapytania federacyjne i ujednolicone zarządzanie w twoich źródłach danych.

Prerequisites

Sprawdź, czy masz:

  • Rola Postgres: odpowiednia rola Postgres umożliwiająca dostęp do bazy danych. Zobacz Zarządzanie rolami postgresu.
  • Uprawnienia bazy danych: niezbędne uprawnienia do dostępu do bazy danych, schematu lub tabeli. Zobacz Zarządzanie uprawnieniami.
  • Uprawnienia Unity Catalog: CREATE CATALOG uprawnienia do rejestracji bazy danych w metastore Unity Catalog
  • Obliczenia: bezserwerowa hurtownia SQL lub bezserwerowe obliczenia dla notebooków i zadań. Pro and Classic SQL Warehouses oraz Classic Compute nie są obsługiwane i zwracają błąd PERMISSION_DENIED.

Jeśli nie masz niezbędnej roli lub uprawnień, skontaktuj się z właścicielem projektu, aby zażądać dostępu.

Ważne

Katalogi produktu Lakebase wymagają bezserwerowych zasobów obliczeniowych. Jeśli zobaczysz błąd PERMISSION_DENIED podczas wykonywania zapytania w edytorze SQL, otwórz listę rozwijaną hurtowni i przełącz się na bezserwerową hurtownię SQL.

Rejestrowanie bazy danych

Aby zarejestrować bazę danych Lakebase w Unity Catalog:

  1. Użyj przełącznika aplikacji, aby przejść do analityki i AI.
  2. W Eksploratorze wykazu kliknij przycisk plus i utwórz wykaz.
  3. Wprowadź nazwę katalogu (na przykład lakebase_catalog).
  4. Wybierz pozycję Lakebase Postgres jako typ wykazu, a następnie wybierz opcję Skalowanie automatyczne .
  5. Wybierz projekt, gałąź i bazę danych Postgres.
  6. Kliknij pozycję Utwórz.

Wykaz jest wyświetlany w Eksploratorze wykazu, w którym można znaleźć schematy, tabele i widoki.

Wykonywanie zapytań przez Unity Catalog

Po rejestracji wysyłaj zapytania do swojej bazy danych Lakebase z bezserwerowego magazynu SQL lub z notebooków i zadań działających w bezserwerowym przetwarzaniu.

Wykonaj zapytanie do zarejestrowanej bazy danych:

-- Query a registered Lakebase database
SELECT * FROM chatbot_catalog.public.conversations
WHERE created_at >= current_date - INTERVAL 7 DAYS;

Połącz dane z Lakebase i Lakehouse:

-- Join Lakebase and Unity Catalog data
SELECT
  c.conversation_id,
  c.user_id,
  c.agent_response,
  u.user_name,
  u.subscription_tier
FROM chatbot_catalog.public.conversations c
JOIN main.user_analytics.users u
  ON c.user_id = u.user_id;

Aby uzyskać informacje o uprawnieniach Unity Catalog i udzielaniu dostępu innym użytkownikom, zobacz Uprawnienia i kontrola dostępu.

Ważne

Ograniczenia rejestracji w Katalogu Unity:

  • Dostęp tylko do odczytu: katalogi zarejestrowane w bazach danych Lakebase są tylko do odczytu przez Unity Catalog. Aby zmodyfikować dane, użyj edytora SQL lakebase lub połącz się bezpośrednio z bazą danych.
  • Pojedyncza baza danych na katalog: Każdy katalog Unity Catalog reprezentuje jedną bazę danych Lakebase. Aby uwidocznić wiele baz danych, zarejestruj je osobno.
  • Synchronizacja metadanych: Katalog Unity buforuje metadane, aby zmniejszyć liczbę żądań Postgres. Nowe obiekty mogą nie pojawiać się natychmiast. Kliknij pozycję Odśwież ikonę schematu , aby wyzwolić pełne odświeżanie.
  • Rejestracja rozgałęzionej bazy danych: Rejestracja rozgałęzionej bazy danych jako osobnego katalogu nie jest jeszcze obsługiwana. Gałęzie dziedziczą metadane rejestracji Unity Catalog od swojego elementu nadrzędnego, co powoduje, że rejestracja nowego katalogu kończy się niepowodzeniem.

Aby uzyskać pełne informacje na temat rejestrowania baz danych w katalogu Unity, zobacz Rejestrowanie bazy danych Lakebase w katalogu Unity.

Dodatkowe źródła