Apache Druid

Mengenkripsi traffic jaringan

Praktik terbaiknya adalah mengenkripsi 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 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 di Looker, pilih Connections, lalu klik Add Connection.

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

  • Nama: Nama koneksi.

  • Dialek: Apache Druid, Apache Druid 0.13+ (Apache Druide 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 defaultnya adalah 8182.

  • Database: Nama database Anda. Defaultnya adalah druid.

  • Username: 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.

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

  • Parameter JDBC tambahan: Parameter JDBC Avatica yang dipisahkan 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

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

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

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

  • Koneksi maksimum per node: Defaultnya adalah 25. Setelan ini dapat dibiarkan pada nilai default pada awalnya. Lihat halaman dokumentasi Menghubungkan Looker ke database untuk mengetahui informasi selengkapnya.

  • Connection Pool Timeout: Defaultnya adalah 120 detik.

  • SQL Runner Precache: Untuk membuat SQL Runner tidak melakukan pramuat informasi tabel dan hanya memuat informasi tabel saat tabel dipilih, hapus centang opsi ini. Baca selengkapnya tentang setelan ini di dokumentasi Pra-cache SQL Runner.

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

Untuk memverifikasi bahwa koneksi berhasil, klik tombol Test Connection di bagian Status details di bagian bawah halaman Connections Settings.

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

Jika Looker menampilkan Can Connect, tekan Connect untuk membuat koneksi.

Koneksi database Anda kemudian akan ditambahkan ke daftar di halaman Admin Connections Looker.

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

Parameter JDBC yang didukung

Untuk Apache Druid, Looker mendukung parameter JDBC berikut di kolom Additional JDBC parameters untuk koneksi. Lihat dokumentasi database Anda untuk 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 mulai Looker 26.22:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan berbasis 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
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Pengukuran 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 mulai Looker 26.22:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan berbasis 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
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Pengukuran dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom

Apache Druid 0.18+

Apache Druid 0.18+ mendukung fitur berikut mulai Looker 26.22:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan berbasis 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
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Pengukuran dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom

Langkah berikutnya

Setelah menyelesaikan koneksi database, konfigurasikan opsi autentikasi.