Eseguire query dall'editor SQL di Lakebase

L'editor SQL di Lakebase esegue query sui database Lakebase direttamente dall'app Lakebase. Offre funzionalità native di Postgres, ad esempio EXPLAIN/ANALYZE, meta-comandi psql-style ed esportazione dei risultati in CSV/JSON/XLSX.

Annotazioni

È anche possibile eseguire query sul database Lakebase dall'editor SQL in Lakehouse, che fornisce visualizzazioni, dashboard, funzionalità di collaborazione e la possibilità di combinare i dati di Lakebase con altre tabelle del catalogo Unity. Vedere Query dall'editor SQL (Lakehouse).

Usare l'editor SQL di Lakebase

Per usare l'editor SQL:

1. Aprire l'app Lakebase e selezionare il progetto.
2. Selezionare Editor SQL nella barra laterale, quindi selezionare un ramo e un database.
3. Immettere una query nell'editor e fare clic su Esegui per visualizzare i risultati.

Usare la query seguente per provare l'editor SQL. La query crea una tabella, aggiunge dati e recupera i dati dalla tabella.

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;

L'esecuzione di più istruzioni di query contemporaneamente restituisce un set di risultati separato per ogni istruzione. I set di risultati vengono visualizzati in schede separate, numerate in ordine di esecuzione.

Per cancellare l'editor, selezionare il contenuto della casella di testo ed eliminarlo.

Spiega e analizza

L'editor SQL di Lakebase include funzionalità di spiegazione e analisi .

• La funzionalità Explain esegue la query specificata con il comando Postgres EXPLAIN , che restituisce il piano di esecuzione per la query. La funzionalità Spiega restituisce solo un piano con stime. Non esegue la query.
• La funzionalità Analizza esegue la query specificata con EXPLAIN ANALYZE. Il ANALYZE parametro esegue la query e restituisce i conteggi effettivi delle righe e i tempi di esecuzione per i nodi del piano insieme alle EXPLAIN stime.

Per comprendere le informazioni fornite dalle funzionalità Di spiegazione e analisi , è necessario acquisire familiarità con il comando Postgres EXPLAIN e il relativo ANALYZE parametro. Consultare la documentazione EXPLAIN e Using EXPLAIN nella documentazione di PostgreSQL.

Esportare dati in csv, JSON e XLSX

L'editor SQL di Lakebase supporta l'esportazione dei dati in JSON, CSVe XLSX. Accedere al pulsante di download nell'angolo in basso a destra della pagina Editor SQL . Il pulsante di download viene visualizzato solo quando è presente un set di risultati da scaricare.

Espandere la sezione risultati della finestra dell'editor SQL

Espandere la sezione dei risultati della finestra dell'editor SQL selezionando il pulsante espandi finestra nell'angolo in basso a destra della pagina Editor SQL .

Meta-comandi

L'editor SQL di Lakebase supporta l'uso dei metacomando Postgres, che funzionano come collegamenti per interagire con il database. Se si ha già familiarità con l'uso di meta-comandi dall'interfaccia della psql riga di comando, è possibile usare molti di questi stessi comandi nell'editor SQL di Lakebase.

I metacomando possono velocizzare il flusso di lavoro fornendo accesso rapido agli schemi di database e ad altre informazioni critiche senza dover scrivere query SQL complete.

Ecco alcuni metacomandi comunemente usati nell'editor SQL di Lakebase.

• \dt — Elencare tutte le tabelle nel database corrente
• \d [table_name] — Descrivere la struttura di una tabella
• \l — Elencare tutti i database
• \? — Un foglio informativo dei meta-comandi disponibili
• \h [NAME] — Ottenere assistenza per qualsiasi comando Postgres (ad esempio, \h SELECT)

Annotazioni

Non tutti i psql metacom command sono supportati nell'editor SQL. Per ottenere un elenco di comandi supportati, usare \?.

Per un elenco completo dei meta-comandi e del relativo utilizzo, vedere Meta-commands in psql.

Come usare i meta-comandi

Per usare un metacom command nell'editor SQL, immettere il metacom command nell'editor (proprio come una query SQL) e fare clic su Esegui. Il risultato verrà visualizzato nel riquadro di output.

Limitazioni dell'editor SQL quando l'accesso pubblico è disabilitato

Quando l'area di lavoro ha collegamento privato configurato con accesso pubblico disabilitato, l'editor SQL esegue le query tramite il back-end Lakebase invece di usare una connessione diretta al database. La maggior parte delle query funziona in modo identico a una connessione diretta, ma il proxy è senza stato ed esegue ogni istruzione come richiesta HTTP indipendente, che introduce le limitazioni seguenti:

Cosa funziona:

• Query a istruzione singola (SELECT, INSERT, UPDATE, DELETE, UPSERT)
• Istruzioni DDL (CREATE, ALTER, DROP TABLE, CREATE INDEX e altre)
• EXPLAIN e comandi DESCRIBE (\d, \dt, \di)
• Supporto completo dei tipi di dati Postgres (matrici, JSON/JSONB, numeric, timestamp, booleani)
• Risultati delle query e messaggi di errore

Cosa non funziona:

Feature	Limitation
Transazioni	BEGIN COMMIT, ROLLBACK, e SAVEPOINT non funzionano come previsto. Ogni istruzione viene confermata automaticamente in modo indipendente, senza alcuna garanzia di atomicità.
Stato della sessione	SET e SET LOCAL si applicano solo alla richiesta corrente. Le tabelle temporanee, le istruzioni preparate, i cursori e i blocchi di avviso non sono disponibili nelle istruzioni successive.
LISTEN/NOTIFY	Richiede una connessione permanente per le notifiche asincrone, che il proxy non supporta.
COPIA DA STDIN	Impossibile trasmettere i dati sul lato client tramite il proxy.
\watch	La riesecuzione periodica delle query non è disponibile tramite il proxy senza stato.
Annullamento della query	L'annullamento viene eseguito solo nei limiti del possibile. Una query può continuare a essere in esecuzione nel back-end dopo una richiesta di annullamento.
Script con più istruzioni	Le istruzioni sono eseguite senza una transazione condivisa. Un errore di script parziale genera un commit parziale.
Limite di dimensioni dei risultati	I risultati delle query sono limitati a 32 MB.

Per i carichi di lavoro che richiedono transazioni o stato sessione, connettersi direttamente al database usando un client Postgres. Vedere Connettersi con psql.

Troubleshoot

Se nell'editor SQL viene visualizzato un messaggio di errore "Impossibile recuperare" o "Errore sconosciuto" e l'area di lavoro usa collegamento privato, verificare che la collegamento privato in ingresso (a livello di area di lavoro, porta 443) sia configurata correttamente. Consulta Risoluzione dei problemi di connettività di collegamento privato.