Condividi tramite


Eseguire query dall'editor SQL in Lakehouse

Importante

La scalabilità automatica di Lakebase si trova in Beta nelle aree seguenti: eastus2, westeurope, westus.

Lakebase Autoscaling è la versione più recente di Lakebase con calcolo autoscalante, riduzione a zero, ramificazione e ripristino istantaneo. Per il confronto delle funzionalità con Lakebase Provisioned, vedere scegliere tra le versioni.

Questa pagina descrive come eseguire query sui database nel progetto Lakebase dall'editor SQL in Lakehouse usando due metodi di connessione diversi.

L'editor SQL in Lakehouse è un'area di lavoro SQL collaborativa in cui è possibile creare query, esplorare i cataloghi dati, creare visualizzazioni e condividere i risultati con i colleghi. Offre funzionalità avanzate per l'analisi, la collaborazione e l'automazione.

Annotazioni

Per le funzionalità native di Postgres, ad esempio EXPLAIN/ANALYZE e i metacom command (\dt, \d, \l), usare l'editor SQL di Lakebase. Consulta Query dall'editor SQL di Lakebase.

Per informazioni complete sulle funzionalità dell'editor SQL, vedere Scrivere query ed esplorare i dati nell'editor SQL.

Metodi di connessione

È possibile connettersi al database Lakebase dall'editor SQL usando due metodi:

  1. Connessione di calcolo diretta: connettersi direttamente al calcolo Lakebase per l'accesso immediato alle query a un progetto e a un ramo specifici.
  2. Registrazione del catalogo Unity: Registrare il database in Unity Catalog per abilitare query federate, governance unificata e analisi tra più origini.

Scegliere il metodo di connessione

Caratteristica / Funzionalità Connessione di calcolo diretta Registrazione del catalogo Unity
Accesso ai dati Accesso in lettura/scrittura completo al database Lakebase Accesso in sola lettura tramite Unity Catalog
migliore per Uso principalmente dei dati lakebase senza combinarlo con altre origini dati Combinazione dei dati di Lakebase con altre tabelle del catalogo Unity nelle query federate
Configurare la complessità Accesso immediato per eseguire query su un database specifico senza registrazione Richiede la registrazione del catalogo e i privilegi del catalogo Unity
Governance Nessuna funzionalità di governance del catalogo Unity Controlli di governance unificata (autorizzazioni, provenienza, log di controllo)
Controllo di accesso Solo autorizzazioni basate su ruoli Postgres Individuazione centralizzata e controllo di accesso tra più origini dati
Casi d'uso Operazioni e modifiche dirette del database Dashboard e applicazioni che integrano dati transazionali e analitici

Metodo 1: Connettersi direttamente al calcolo Lakebase

Usare questo metodo per connettersi direttamente al calcolo Lakebase per l'accesso immediato alle query.

Prima di iniziare

Se non si è il proprietario del progetto, verificare di avere:

Se non si dispone del ruolo o delle autorizzazioni necessarie, contattare il proprietario del progetto per richiedere l'accesso.

Annotazioni

Il calcolo Lakebase deve trovarsi in uno stato attivo per collegarlo. Se il calcolo è inattivo, non è possibile connettere. Le risorse di calcolo diventano in genere inattive quando la scalabilità è abilitata su zero e non è presente alcuna attività del database.

Per attivare un calcolo inattico, eseguire una query nell'editor SQL di Lakebase o disabilitare la scalabilità su zero per assicurarsi che il calcolo rimanga attivo. Vedere Ridimensionare a zero.

Per connettersi direttamente al calcolo Lakebase:

  1. Usare il commutatore delle app per passare a Lakehouse.
  2. Aprire l'editor SQL facendo clic su SQL Editor IconEditor SQL SQL nella barra laterale.
  3. Dal menu a discesa Connetti selezionare Altro...

Menu di Connessione

  1. Nella finestra di dialogo Collega a una risorsa di calcolo esistente selezionareLakebase Postgres, scegliere l'opzione Scalabilità automatica e quindi selezionare il progetto e il ramo.

Collegarsi al progetto e al ramo LKB

  1. Fare clic su Connetti per connettersi.

Query di esempio con connessione diretta

Dopo la connessione, è possibile eseguire query SQL Postgres standard sul database Lakebase.

Creare una tabella, inserire dati ed eseguirne una query:

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;

Eseguire un'interrogazione su una tabella specifica:

SELECT * FROM public.playing_with_lakebase;

Importante

Limitazioni con connessione diretta:

  • Query federate non supportate: è possibile eseguire query solo sul progetto e sul ramo connected Lakebase. Non è possibile combinare i dati di Lakebase con altre tabelle del catalogo Unity in una singola query.
  • Meta-comandi Postgres non supportati: i metacomcomi Postgres (ad esempio \dt, \d, \l) che funzionano nell'editor SQL di Lakebase non funzionano nell'editor SQL (Lakehouse).

Metodo 2: Registrare il database nel catalogo unity

Usate questo metodo per registrare il database Lakebase in Unity Catalog, consentendo query federate e governance unificata tra le vostre fonti di dati.

Prima di iniziare

Verificare di avere:

  • Ruolo Postgres: Un ruolo Postgres corrispondente per accedere al database. Vedere Gestire i ruoli di Postgres.
  • Autorizzazioni per il database: autorizzazioni necessarie per accedere al database, allo schema o alla tabella. Vedere Gestire le autorizzazioni.
  • Privilegi del catalogo Unity: CREATE CATALOG privilegi nel metastore del catalogo Unity per registrare il database
  • SQL Warehouse: un data warehouse SQL senza server per eseguire query sul catalogo registrato

Se non si dispone del ruolo o delle autorizzazioni necessarie, contattare il proprietario del progetto per richiedere l'accesso.

Registrare il database

Per registrare un database Lakebase nel catalogo unity:

  1. Usare il commutatore delle app per passare a Lakehouse.
  2. In Esplora cataloghi fare clic sull'icona con il segno più e creare un catalogo.
  3. Immettere un nome di catalogo , ad esempio lakebase_catalog.
  4. Selezionare Lakebase Postgres come tipo di catalogo e quindi scegliere l'opzione Scalabilità automatica .
  5. Selezionare il progetto, il ramo e il database Postgres.
  6. Clicca su Crea.

Il catalogo viene visualizzato in Esplora cataloghi, in cui è possibile esplorare schemi, tabelle e viste.

Eseguire query tramite Unity Catalog

Dopo la registrazione, eseguire una query sul database Lakebase usando sql warehouse o qualsiasi strumento che si connette a Unity Catalog.

Eseguire query su un database registrato:

-- Query a registered :re[LKB] database
SELECT * FROM chatbot_catalog.public.conversations
WHERE created_at >= current_date - INTERVAL 7 DAYS;

Combinare i dati di Lakebase e Lakehouse:

-- Join :re[LKB] 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;

Per informazioni sulle autorizzazioni del catalogo Unity e sulla concessione dell'accesso ad altri utenti, vedere Autorizzazioni e controllo di accesso.

Importante

Limitazioni con la registrazione del catalogo Unity:

  • Accesso in sola lettura: i cataloghi registrati dai database Lakebase sono di sola lettura tramite il catalogo Unity. Per modificare i dati, usare l'editor SQL di Lakebase o connettersi direttamente al database.
  • Database singolo per catalogo: ogni catalogo di Unity Catalog rappresenta un database Lakebase. Per esporre più database, registrare ognuno separatamente.
  • Sincronizzazione dei metadati: Il catalogo unity memorizza nella cache i metadati per ridurre le richieste Postgres. I nuovi oggetti potrebbero non essere visualizzati immediatamente. Fare clic su Aggiorna icona schema per attivare un aggiornamento completo.

Per informazioni complete sulla registrazione dei database nel catalogo unity, vedere Registrare un database Lakebase nel catalogo unity.

Passaggi successivi