ClickHouse

Hubungkan Looker ke database ClickHouse Anda untuk menganalisis data dan membuat dasbor interaktif. Koneksi ini membantu membuat data ClickHouse Anda tersedia untuk pelaporan dan analisis dalam Looker, yang mendukung pengambilan keputusan berbasis data secara langsung.

Halaman ini memandu Anda mengonfigurasi setelan koneksi Looker dan instance ClickHouse, termasuk cara mengenkripsi traffic jaringan, menentukan izin pengguna, dan meninjau fitur yang didukung. Looker mendukung ClickHouse versi 0.2 atau yang lebih baru, dan ClickHouse 26+ menggunakan driver JDBC yang dimodernisasi dan dukungan agregasi simetris.

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.

Untuk mengaktifkan enkripsi SSL di sisi server, lihat dokumentasi Setelan Server Global ClickHouse.

Pengguna dan keamanan

Pertama, konfigurasi pengguna Looker Anda di server ClickHouse. Pengguna database ClickHouse dapat dikonfigurasi menggunakan SQL (CREATE USER) atau melalui bagian users dalam file users.xml. Ikuti dokumentasi hak akses ClickHouse untuk mengonfigurasi akses pengguna. Contoh dasar berikut menggunakan users.xml:

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

Selain itu, dalam file ini, konfigurasi akses database yang sesuai:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

Membuat koneksi Looker ke database Anda

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

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

• Dialek: Pilih ClickHouse 26+ atau ClickHouse.
• Host: Nama host atau alamat IP server ClickHouse yang dapat dijangkau.
• Port: Port tempat layanan ClickHouse dapat dijangkau melalui HTTP(S).
  • Secara default, koneksi HTTP menggunakan 8123, dan koneksi HTTPS menggunakan 8443.
  • Port 9000 dan 9440 secara default digunakan oleh klien command line TCP native ClickHouse, tetapi port HTTP(S) harus digunakan oleh Looker untuk terhubung ke ClickHouse.
  • Administrator ClickHouse Anda mungkin telah memilih port alternatif dengan setelan http_port atau https_port dalam konfigurasi ClickHouse. Minta admin ClickHouse Anda untuk mendapatkan setelan yang sesuai dengan konfigurasi Anda.
• Database: Nama database (harus salah satu database yang diizinkan dalam izin ClickHouse Anda).
• Nama pengguna: Nama pengguna database.
• Sandi: Sandi database.
• SSL: Centang untuk terhubung ke ClickHouse melalui SSL/TLS.
• Verifikasi SSL: (Opsional) Centang untuk menerapkan verifikasi nama host dan sertifikat SSL yang ketat di server ClickHouse. Pilih Verifikasi SSL hanya jika Anda menggunakan sertifikat SSL yang ditandatangani oleh Certificate Authority yang umumnya tepercaya. Jika Anda menggunakan sertifikat SSL yang ditandatangani sendiri, biarkan setelan ini tidak dicentang.
• Parameter JDBC tambahan: (Opsional) Parameter string JDBC tambahan. Lihat bagian Parameter JDBC yang didukung di halaman ini untuk mengetahui daftar parameter yang didukung Looker.

Untuk memverifikasi bahwa koneksi berhasil, klik tombol Uji Koneksi di bagian Detail status di bagian bawah halaman Setelan Koneksi.

Jika Looker menampilkan Dapat Terhubung, tekan Hubungkan untuk membuat koneksi.

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

Parameter JDBC yang didukung

Untuk ClickHouse, Looker mendukung parameter JDBC berikut di kolom Parameter JDBC tambahan untuk koneksi. Lihat dokumentasi untuk database Anda guna mengetahui informasi tentang parameter ini.

Parameter ClickHouse 26+

• async_insert
• autoCommit
• compress
• compress_algorithm
• compress_level
• connect_timeout
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_settings
• database
• databaseTerm
• externalDatabase
• fetchSize
• format
• jdbcCompliant
• keep_alive_timeout
• max_buffer_size
• max_execution_time
• max_result_bytes
• max_result_rows
• max_threads
• namedParameter
• query_timeout
• receive_timeout
• result_overflow_mode
• retry
• session_check
• session_id
• session_timeout
• session_timezone
• socket_timeout
• ssl
• sslmode
• transactionSupport
• use_server_time_zone
• use_time_zone
• wait_for_async_insert
• wrapperObject

Parameter ClickHouse (Lama)

• beta.row_binary_for_simple_insert
• compress
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_http_headers
• custom_http_params
• default_query_settings
• disable_frameworks_detection
• jdbc_ignore_unsupported_values
• jdbc_resultset_auto_close
• jdbc_sql_parser
• jdbc_use_max_result_rows
• jdbcCompliance
• max_execution_time
• password
• session_timezone
• socket_timeout
• typeMappings
• use_server_time_zone
• use_time_zone
• user
• wrapperObject

Dukungan fitur

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

Dukungan fitur ClickHouse 26+

ClickHouse 26+ mendukung fitur berikut mulai Looker 26.18:

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
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
Jumlah SQL Runner
Penjelasan SQL
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 analitik dalam database
Kalender kustom

Dukungan fitur ClickHouse

ClickHouse mendukung fitur berikut mulai Looker 26.18:

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
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
Jumlah SQL Runner
Penjelasan SQL
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 analitik dalam database
Kalender kustom

Langkah berikutnya

Setelah menyelesaikan koneksi database, konfigurasi opsi autentikasi.