Apache Druid

Mengenkripsi traffic jaringan

Sebaiknya enkripsi traffic jaringan antara aplikasi Looker dan database Anda. Pertimbangkan salah satu opsi yang dijelaskan di halaman dokumentasi Mengaktifkan akses database yang aman.

Mengonfigurasi cluster Apache Druid

<DRUID_BASE_DIR> mengacu pada direktori dasar tempat cluster Apache Druid diinstal di server.

Mengaktifkan SQL

Untuk mengaktifkan SQL di database Druid, tambahkan baris ini ke file konfigurasi broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

Menonaktifkan perkiraan COUNT DISTINCT (opsional)

Secara default, Druid memperkirakan COUNT DISTINCT. Untuk mendapatkan hasil yang akurat, tambahkan baris ini ke file konfigurasi broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

Membuat koneksi Looker ke database Anda

Di bagian Admin Looker, pilih Connections, lalu klik Add Connection.

Isi detail koneksi. Sebagian besar setelan sama untuk sebagian besar dialek database. Lihat halaman dokumentasi Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya. Beberapa setelan dijelaskan di bawah:

  • Nama: Nama koneksi.

  • Dialect: Apache Druid, Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x), atau Apache Druid 0.18+.

  • Host: DNS atau alamat IP Broker cluster. Anda dapat menemukannya di file broker/runtime.properties.

  • Port: Port Broker. Port default-nya adalah 8082. Jika cluster Anda diamankan oleh SSL, port default-nya adalah 8182.

  • Database: Nama database Anda. Default-nya adalah druid.

  • Nama pengguna: Nama pengguna database jika cluster Apache Druid Anda dikonfigurasi untuk menggunakan Druid Basic Security. Jika tidak, Anda dapat menentukan string apa pun.

  • Sandi: Sandi pengguna. Jika cluster Anda tidak dikonfigurasi untuk menggunakan Druid Basic Security, Anda dapat menentukan string apa pun.

  • Skema: Skema default yang akan digunakan jika tidak ada skema yang ditentukan. Memasukkan skema bersifat opsional.

  • Additional JDBC parameters: Parameter Avatica JDBC yang dipisahkan dengan tanda titik koma. Lihat bagian Parameter JDBC yang didukung di halaman ini untuk mengetahui daftar parameter yang didukung Looker.

    • Properti ini dapat ditetapkan sebagai properti koneksi:
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    Contoh: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • Jadwal Pemeliharaan: Ekspresi cron yang menunjukkan kapan Looker harus memeriksa grup data dan tabel turunan persisten. Baca selengkapnya tentang setelan ini di dokumentasi Maintenance Schedule.

  • SSL: Periksa apakah cluster Apache Druid Anda dikonfigurasi untuk menggunakan Druid TLS.

  • Verifikasi SSL: Centang untuk menerapkan verifikasi nama host yang ketat.

  • Max connections per node: Default-nya adalah 25. Setelan ini dapat dibiarkan pada nilai default pada awalnya. Lihat halaman dokumentasi Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya.

  • Connection Pool Timeout: Default-nya adalah 120 detik.

  • SQL Runner Precache: Untuk mencegah SQL Runner memuat informasi tabel secara otomatis dan hanya memuat informasi tabel saat tabel dipilih, hapus centang pada opsi ini. Baca selengkapnya tentang setelan ini di dokumentasi SQL Runner Precache.

  • Database Time Zone: Zona waktu database. Didukung di Apache Druid 0.13+ dan Apache Druid 0.18+.

Untuk memverifikasi bahwa koneksi berhasil, klik Test. Lihat halaman dokumentasi Menguji konektivitas database untuk mengetahui informasi pemecahan masalah.

Looker menjalankan kueri SELECT 1 untuk memverifikasi koneksi dasar dan melakukan uji kueri. Kueri ini tidak memvalidasi bahwa kombinasi katalog dan skema ada atau bahwa pengguna memiliki akses yang diperlukan ke skema tersebut.

Jika Anda mengalami masalah, lihat dokumentasi Menguji Koneksi.

Untuk menyimpan setelan ini, klik Connect.

Uji koneksi di SQL Runner. Buka SQL Runner, pilih koneksi dan skema Anda, lalu periksa apakah Anda dapat melihat tabel database.

Parameter JDBC yang didukung

Untuk Apache Druid, Looker mendukung parameter JDBC berikut di kolom Additional JDBC parameters untuk koneksi. Lihat dokumentasi untuk database Anda guna mengetahui informasi tentang parameter ini.

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

Dukungan fitur

Agar Looker dapat mendukung beberapa fitur, dialek database Anda juga harus mendukungnya.

Apache Druid

Apache Druid mendukung fitur berikut per Looker 26.10:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan native persisten
Tampilan stabil
Penghentian kueri
Pivot berbasis SQL
Zona waktu
SSL
Subtotal
Parameter tambahan JDBC
Peka huruf besar/kecil
Jenis lokasi
Jenis daftar
Persentil
Persentil berbeda
Proses Tampilkan SQL Runner
Tabel Jelaskan SQL Runner
Indeks Tampilkan SQL Runner
Pilih 10 SQL Runner
Jumlah SQL Runner
Jelaskan SQL
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Metrik dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom

Apache Druid 0.13.x - 0.17.x

Apache Druid 0.13.x - 0.17.x mendukung fitur berikut per Looker 26.10:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan native persisten
Tampilan stabil
Penghentian kueri
Pivot berbasis SQL
Zona waktu
SSL
Subtotal
Parameter tambahan JDBC
Peka huruf besar/kecil
Jenis lokasi
Jenis daftar
Persentil
Persentil berbeda
Proses Tampilkan SQL Runner
Tabel Jelaskan SQL Runner
Indeks Tampilkan SQL Runner
Pilih 10 SQL Runner
Jumlah SQL Runner
Jelaskan SQL
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Metrik dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom

Apache Druid 0.18+

Apache Druid 0.18+ mendukung fitur berikut per Looker 26.10:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan native persisten
Tampilan stabil
Penghentian kueri
Pivot berbasis SQL
Zona waktu
SSL
Subtotal
Parameter tambahan JDBC
Peka huruf besar/kecil
Jenis lokasi
Jenis daftar
Persentil
Persentil berbeda
Proses Tampilkan SQL Runner
Tabel Jelaskan SQL Runner
Indeks Tampilkan SQL Runner
Pilih 10 SQL Runner
Jumlah SQL Runner
Jelaskan SQL
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Metrik dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom

Langkah berikutnya

Setelah menyelesaikan koneksi database, konfigurasikan opsi autentikasi.