Kueri dari Editor Lakebase SQL

Lakebase SQL Editor menjalankan kueri pada database Lakebase Anda langsung dari Aplikasi Lakebase. Ini menawarkan fitur asli Postgres seperti EXPLAIN/ANALYZE, psql-style meta-commands, dan mengekspor hasil ke CSV/JSON/XLSX.

Nota

Anda juga dapat mengkueri database Lakebase Anda dari editor SQL di Lakehouse, yang menyediakan visualisasi, dasbor, fitur kolaborasi, dan kemampuan untuk menggabungkan data Lakebase dengan tabel Unity Catalog lainnya. Lihat Kueri dari editor SQL (Lakehouse).

Menggunakan Editor Lakebase SQL

Untuk menggunakan Editor SQL:

1. Buka Aplikasi Lakebase dan pilih proyek Anda.
2. Pilih Editor SQL dari bar samping, lalu pilih cabang dan database.
3. Masukkan kueri ke editor dan klik Jalankan untuk menampilkan hasilnya.

Gunakan kueri berikut untuk mencoba Editor SQL. Kueri membuat tabel, menambahkan data, dan mengambil data dari tabel.

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;

Menjalankan beberapa pernyataan kueri sekaligus mengembalikan hasil yang terpisah untuk setiap pernyataan. Kumpulan hasil ditampilkan di tab terpisah, bernomor dalam urutan eksekusi.

Untuk menghapus editor, pilih konten kotak teks dan hapus.

Menjelaskan dan menganalisis

Editor Lakebase SQL memiliki fitur Jelaskan dan Analisis .

• Fitur Jelaskan menjalankan kueri yang ditentukan dengan perintah Postgres EXPLAIN , yang mengembalikan rencana eksekusi untuk kueri. Fitur Jelaskan hanya mengembalikan rencana dengan perkiraan. Ini tidak menjalankan kueri.
• Fitur Analisis menjalankan kueri yang ditentukan dengan EXPLAIN ANALYZE. Parameter ANALYZE tersebut menjalankan kueri dan mengembalikan jumlah baris aktual serta waktu eksekusi untuk setiap simpul rencana, beserta estimasi EXPLAIN.

Memahami informasi yang disediakan oleh fitur Jelaskan dan Analisis memerlukan keakraban dengan perintah Postgres EXPLAIN dan parameternya ANALYZE . Lihat dokumentasi EXPLAIN dan Menggunakan EXPLAIN dalam dokumentasi PostgreSQL.

Mengekspor data ke CSV, JSON, dan XLSX

Editor Lakebase SQL mendukung ekspor data Anda ke JSON, CSV, dan XLSX. Akses tombol unduh dari sudut kanan bawah halaman Editor SQL . Tombol unduh hanya muncul ketika ada hasil yang diatur untuk diunduh.

Perluas bagian hasil dari jendela editor SQL

Perluas bagian hasil dari jendela Editor SQL dengan memilih tombol perluas jendela dari sudut kanan bawah halaman Editor SQL .

Meta-commands

Lakebase SQL Editor mendukung penggunaan meta-command Postgres, yang bertindak seperti pintasan untuk berinteraksi dengan database Anda. Jika Anda sudah terbiasa menggunakan meta-command dari psql antarmuka baris perintah, Anda dapat menggunakan banyak perintah yang sama di Editor Lakebase SQL.

Meta-command dapat mempercepat alur kerja Anda dengan menyediakan akses cepat ke skema database dan informasi penting lainnya tanpa perlu menulis kueri SQL lengkap.

Berikut adalah beberapa meta-command yang umum digunakan dalam Editor Lakebase SQL:

• \dt — Mencantumkan semua tabel dalam database saat ini
• \d [table_name] — Menjelaskan struktur tabel
• \l — Mencantumkan semua database
• \? — Lembar contekan dari meta-command yang dapat digunakan
• \h [NAME] — Dapatkan bantuan untuk perintah Postgres apa pun (misalnya, \h SELECT)

Nota

Tidak semua psql meta-command didukung di Editor SQL. Untuk mendapatkan daftar perintah yang didukung, gunakan \?.

Untuk daftar lengkap meta-command dan penggunaannya, lihat Meta-commands di psql.

Cara menggunakan meta-commands

Untuk menggunakan meta-command di Editor SQL, masukkan meta-command di editor (sama seperti kueri SQL) dan klik Jalankan. Hasilnya akan ditampilkan di panel output.

Batasan Editor SQL saat akses publik dinonaktifkan

Saat Private Link dikonfigurasi pada ruang kerja Anda dengan akses publik dinonaktifkan, Editor SQL memproksikan kueri melalui backend Lakebase alih-alih menggunakan koneksi basis data langsung. Sebagian besar kueri bekerja secara identik dengan koneksi langsung, tetapi proksi tanpa status dan menjalankan setiap pernyataan sebagai permintaan HTTP independen, yang memperkenalkan batasan berikut:

Apa yang berfungsi:

• Kueri pernyataan tunggal (SELECT, , INSERT, UPDATEDELETE, UPSERT)
• Pernyataan DDL (CREATE, ALTER, DROP TABLE, CREATE INDEX, dan lainnya)
• EXPLAIN dan perintah DESCRIBE (\d, \dt, \di)
• Dukungan jenis data Postgres penuh (array, JSON/JSONB, numerik, tanda waktu, boolean)
• Hasil kueri dan pesan kesalahan

Apa yang tidak berfungsi:

Feature	Batasan
Transactions	BEGIN, , COMMITROLLBACK, dan SAVEPOINT tidak berfungsi seperti yang diharapkan. Setiap pernyataan berkomitmen otomatis secara independen tanpa jaminan atomitas.
Status sesi	SET dan SET LOCAL hanya berlaku untuk permintaan saat ini. Tabel sementara, pernyataan yang disiapkan, kursor, dan kunci saran tidak tersedia dalam pernyataan berikutnya.
PANTAU/NOTIFIKASI	Memerlukan koneksi persisten untuk pemberitahuan asinkron, yang tidak didukung proksi.
SALIN DARI STDIN	Tidak dapat mengalirkan data sisi klien melalui proksi.
\watch	Eksekusi ulang kueri berkala tidak tersedia melalui proksi stateless.
Pembatalan kueri	Pembatalan hanya diupayakan sebisa mungkin. Kueri dapat terus berjalan pada sistem backend setelah permintaan pembatalan dikirimkan.
Skrip dengan beberapa pernyataan	Pernyataan dijalankan tanpa transaksi bersama. Kegagalan sebagian skrip mengakibatkan komit parsial.
Batas ukuran hasil	Hasil kueri dibatasi hingga 32 MB.

Untuk beban kerja yang memerlukan transaksi atau status sesi, sambungkan langsung ke database Anda menggunakan klien Postgres. Lihat Menyambungkan dengan psql.

Troubleshoot

Jika Editor SQL menampilkan pesan "Failed to fetch" atau "Unknown error" dan ruang kerja Anda menggunakan Private Link, pastikan bahwa Private Link inbound (level ruang kerja, port 443) telah dikonfigurasi dengan benar. Lihat Memecahkan masalah konektivitas Private Link.