Bagikan melalui

Kueri dari Editor SQL di Lakehouse

Penting

Lakebase Autoscaling berada di Beta di wilayah berikut: eastus2, , westeuropewestus.

Lakebase Autoscaling adalah versi terbaru Lakebase dengan komputasi penskalaan otomatis, skala-ke-nol, percabangan, dan pemulihan instan. Untuk perbandingan fitur dengan Lakebase Provisioned, lihat memilih antar versi.

Halaman ini menjelaskan cara mengkueri database dalam proyek Lakebase Anda dari editor SQL di Lakehouse menggunakan dua metode koneksi yang berbeda.

Editor SQL di Lakehouse adalah ruang kerja SQL kolaboratif tempat Anda dapat menulis kueri, menelusuri katalog data, membuat visualisasi, dan berbagi hasil dengan kolega. Ini menyediakan fitur lanjutan untuk analitik, kolaborasi, dan otomatisasi.

Nota

Untuk fitur asli Postgres seperti EXPLAIN/ANALYZE dan meta-commands (\dt, , \d\l), gunakan Editor Lakebase SQL. Lihat Query dari Editor Lakebase SQL.

Untuk informasi lengkap tentang kemampuan editor SQL, lihat Menulis kueri dan menjelajahi data di editor SQL.

Metode koneksi

Anda dapat menyambungkan ke database Lakebase Anda dari editor SQL menggunakan dua metode:

  1. Koneksi komputasi langsung: Sambungkan langsung ke komputasi Lakebase Anda untuk akses kueri segera ke proyek dan cabang tertentu.
  2. Pendaftaran Katalog Unity: Daftarkan database Anda di Unity Catalog untuk mengaktifkan kueri federasi, tata kelola terpadu, dan analitik lintas sumber.

Pilih metode koneksi Anda

Fitur Koneksi komputasi langsung Pendaftaran Katalog Unity
akses data Akses baca-tulis penuh ke database Lakebase Anda Akses baca-saja melalui Katalog Unity
Pilihan terbaik untuk Bekerja terutama dengan data Lakebase tanpa menggabungkannya dengan sumber data lain Menggabungkan data Lakebase dengan tabel Unity Catalog lainnya dalam kueri gabungan
Kompleksitas penyiapan Akses langsung ke kueri database tertentu tanpa pendaftaran Memerlukan pendaftaran katalog dan hak istimewa Katalog Unity
Pemerintahan Tidak ada fitur tata kelola Katalog Unity Kontrol tata kelola terpadu (izin, silsilah data, log audit)
Kontrol akses Izin berbasis peran hanya untuk PostgreSQL Penemuan terpusat dan kontrol akses di beberapa sumber data
Skenario penggunaan Operasi dan modifikasi database langsung Dasbor dan aplikasi yang mengintegrasikan data transaksional dan analitik

Metode 1: Sambungkan langsung ke komputasi Lakebase

Gunakan metode ini untuk menyambungkan langsung ke komputasi Lakebase Anda untuk akses kueri segera.

Sebelum Anda mulai

Jika Anda bukan pemilik proyek, verifikasi bahwa Anda memiliki:

  • Peran Postgres: Peran Postgres yang sesuai untuk mengakses database. Lihat Mengelola peran Postgres.
  • Izin database: Izin yang diperlukan untuk mengakses database, skema, atau tabel. Lihat Mengelola izin.

Jika Anda tidak memiliki peran atau izin yang diperlukan, hubungi pemilik proyek untuk meminta akses.

Nota

Komputasi Lakebase harus dalam keadaan aktif agar dapat dilampirkan padanya. Jika komputer menganggur, Anda tidak dapat menyambungkan. Komputasi biasanya menjadi tidak aktif ketika skala ke nol diaktifkan dan tidak ada aktivitas database.

Untuk mengaktifkan komputasi diam, jalankan kueri di Editor Lakebase SQL atau nonaktifkan skala ke nol untuk memastikan komputasi Anda tetap aktif. Lihat Menskalakan ke nol.

Untuk terhubung langsung ke komputasi Lakebase Anda:

  1. Gunakan pengalih aplikasi untuk menavigasi ke Lakehouse.
  2. Buka editor SQL dengan mengklik Ikon Editor SQLSQL Editor di bilah samping.
  3. Dari menu drop-down Sambungkan , pilih Lainnya...

Menu hubungkan

  1. Pada dialog Lampirkan ke sumber daya komputasi yang sudah ada , pilih Lakebase Postgres, pilih opsi Penskalaan Otomatis , lalu pilih Proyek dan Cabang Anda.

Lampirkan ke proyek dan cabang LKB

  1. Klik Lampirkan untuk menyambungkan.

Contoh kueri dengan koneksi langsung

Setelah menyambungkan, Anda dapat menjalankan kueri Postgres SQL standar terhadap database Lakebase Anda.

Buat tabel, sisipkan data, dan kueri:

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;

Mengkueri tabel tertentu:

SELECT * FROM public.playing_with_lakebase;

Penting

Batasan dengan koneksi langsung:

  • Kueri gabungan tidak didukung: Anda hanya dapat mengkueri proyek dan cabang Lakebase yang tersambung. Anda tidak dapat menggabungkan data Lakebase dengan tabel Unity Catalog lainnya dalam satu kueri.
  • Perintah meta Postgres tidak didukung: Meta-command Postgres (seperti \dt, , \d\l) yang berfungsi di Editor Lakebase SQL tidak berfungsi di editor SQL (Lakehouse).

Metode 2: Mendaftarkan database di Katalog Unity

Gunakan metode ini untuk mendaftarkan database Lakebase Anda di Unity Catalog, memungkinkan kueri federasi dan tata kelola terpadu di seluruh sumber data Anda.

Sebelum Anda mulai

Verifikasi bahwa Anda memiliki:

  • Peran Postgres: Peran Postgres yang sesuai untuk mengakses database. Lihat Mengelola peran Postgres.
  • Izin database: Izin yang diperlukan untuk mengakses database, skema, atau tabel. Lihat Mengelola izin.
  • Hak akses Unity Catalog: CREATE CATALOG hak akses pada metastore Unity Catalog untuk mendaftarkan database
  • Gudang SQL: Gudang SQL tanpa server untuk mengkueri katalog terdaftar

Jika Anda tidak memiliki peran atau izin yang diperlukan, hubungi pemilik proyek untuk meminta akses.

Mendaftarkan database Anda

Untuk mendaftarkan database Lakebase di Unity Catalog:

  1. Gunakan pengalih aplikasi untuk menavigasi ke Lakehouse.
  2. Di Catalog Explorer, klik ikon plus dan Buat katalog.
  3. Masukkan nama katalog (misalnya, lakebase_catalog).
  4. Pilih Lakebase Postgres sebagai jenis katalog, lalu pilih opsi Autoscaling .
  5. Pilih database proyek, cabang, dan Postgres Anda.
  6. Klik Buat.

Katalog muncul di Catalog Explorer, tempat Anda dapat menelusuri skema, tabel, dan tampilan.

Mengkueri melalui Katalog Unity

Setelah pendaftaran, kueri database Lakebase Anda menggunakan gudang SQL atau alat apa pun yang terhubung ke Katalog Unity.

Mengkueri database terdaftar:

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

Menggabungkan data Lakebase dan 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;

Untuk informasi tentang izin Katalog Unity dan memberikan akses ke pengguna lain, lihat Izin dan kontrol akses.

Penting

Batasan dengan pendaftaran Unity Catalog:

  • Akses baca-saja: Katalog yang terdaftar dari database Lakebase bersifat baca-saja melalui Katalog Unity. Untuk memodifikasi data, gunakan Editor Lakebase SQL atau sambungkan langsung ke database Anda.
  • Database tunggal per katalog: Setiap katalog Katalog Unity mewakili satu database Lakebase. Untuk mengekspos beberapa database, daftarkan masing-masing secara terpisah.
  • Sinkronisasi metadata: Katalog Unity menyimpan metadata untuk mengurangi permintaan Postgres. Objek baru mungkin tidak segera muncul. Klik Refresh Ikon Skema untuk memicu refresh penuh.

Untuk informasi lengkap tentang mendaftarkan database di Unity Catalog, lihat Mendaftarkan database Lakebase di Unity Catalog.

Langkah selanjutnya

  • Last updated on