MySQL, MariaDB, dan SingleStore

Dialek yang menggunakan petunjuk ini

MySQL, MariaDB, dan SingleStore (sebelumnya MemSQL) memiliki persyaratan penyiapan database yang sama seperti yang dijelaskan di halaman ini.

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.

Jika Anda tertarik untuk menggunakan enkripsi SSL, lihat halaman dokumentasi MySQL ini.

Pengguna dan keamanan

Untuk membuat dan memberikan akses yang diperlukan kepada pengguna Looker, ikuti petunjuk di bagian yang sesuai dengan versi dan dialek database Anda:

MySQL 8.0.X:

Catatan: Opsi dialek MySQL 8.0.X Looker diterapkan dengan patch versi 8.0.12+ karena penghentian MySQL dalam pengurutan implisit dalam klausa GROUP BY. Hal ini memengaruhi subtotal Looker untuk MySQL versi 8.0.0 hingga 8.0.11, yang menyebabkan error pembuatan SQL. Looker menyarankan untuk mengupgrade database MySQL 8.0.X apa pun setidaknya ke 8.0.12 untuk berintegrasi sepenuhnya. Namun, versi MySQL sebelumnya akan tetap berfungsi, selain subtotal.

Di MySQL 8.0.X, plugin autentikasi default adalah caching_sha2_password. Looker menggunakan plugin mysql_native_password untuk mencoba mengautentikasi ke database MySQL melalui driver JDBC. Agar versi MySQL ini berfungsi dengan benar, Anda harus melakukan langkah-langkah tambahan berikut:

1. Konfigurasikan database MySQL untuk menggunakan plugin mysql_native_password. Hal ini dapat dilakukan dengan beberapa cara, dan akan bergantung pada cara database MySQL 8 Anda di-deploy dan jenis akses yang Anda miliki ke konfigurasi:

   • Mulai proses dengan flag --default-auth=mysql_native_password

   • Tetapkan properti di file konfigurasi my.cnf:

   [mysqld]
   default-authentication-plugin=mysql_native_password
   

   • Jika instance database Anda dihosting melalui AWS RDS, tetapkan parameter default_authentication_plugin melalui Grup Parameter RDS yang diterapkan ke instance database ini.

2. Jalankan perintah berikut, dengan mengganti some_password_here dengan sandi unik dan aman:

   CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'some_password_here';
   GRANT SELECT ON database_name.* TO 'looker'@'%';
   

MySQL 5.7.X dan yang lebih lama, MariaDB, dan SingleStore:

Jalankan perintah berikut, dengan mengganti some_password_here dengan sandi unik dan aman:

CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('some_password_here');
GRANT SELECT ON database_name.* TO 'looker'@'%';

Penyiapan skema sementara untuk tabel turunan persisten

Dialek database ini mendukung pembuatan tabel turunan persisten (PDT). Fitur ini dapat sangat berguna, dan sebaiknya aktifkan jika memungkinkan.

Untuk mengaktifkan PDT, Anda perlu mengonfigurasi skema sementara. Perintah berikut menunjukkan contoh pembuatan database sementara dan pemberian hak istimewa yang diperlukan kepada pengguna looker.

Anda dapat menentukan nama database sementara di kolom Database Sementara saat membuat koneksi database. Jika Anda tidak menentukan nama database sementara, Looker akan membuat database awal bernama looker_tmp. Perintah berikut menggunakan looker_tmp, tetapi jika Anda menentukan nama database sementara yang berbeda, gunakan nama database sementara, bukan looker_tmp.

CREATE SCHEMA looker_tmp;
GRANT
  SELECT,
  INDEX,
  INSERT,
  UPDATE,
  DELETE,
  CREATE,
  DROP,
  ALTER,
  CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';

Untuk SingleStore, atau jika database Anda menggunakan replikasi berbasis GTID, Anda harus menggunakan parameter LookML create_process untuk menggunakan PDT, karena GTID tidak mendukung pernyataan CREATE TABLE AS SELECT.

Penyiapan alternatif untuk tabel turunan reguler

Jika tidak ingin mengizinkan pembuatan tabel turunan persisten, Anda tetap dapat menggunakan tabel turunan reguler. Untuk menggunakan tabel turunan reguler, Anda masih perlu menambahkan izin tertentu ke skema yang disebut looker_tmp. Namun, skema looker_tmp sebenarnya tidak perlu ada di database Anda.

GRANT
  SELECT,
  INDEX,
  INSERT,
  DROP,
  CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
-- Note that the looker_tmp schema does not need to actually exist,
-- even though these permission grants are still needed

Menetapkan variabel max_allowed_packet

Untuk MySQL, tetapkan variabel max_allowed_packet MySQL ke nilai maksimumnya, 1073741824, untuk mencegah error "SQLException: Packet for query is too large".

Membuat koneksi Looker ke database Anda

Setelah menyelesaikan konfigurasi database, Anda dapat terhubung ke database dari Looker. Ikuti langkah-langkah berikut untuk membuat koneksi dari Looker ke database Anda:

1. Di bagian Admin di Looker, pilih Koneksi, lalu klik Tambahkan Koneksi.

2. Dari menu drop-down Dialek, pilih nama dialek database Anda: MySQL, MySQL 8.0.12+, MariaDB, SingleStore, atau SingleStore 7+.

   Catatan: Jika Anda menggunakan instance Looker (Google Cloud core) dan tidak melihat dialek Anda tercantum di menu drop-down Dialek, lihat dokumentasi Looker (Google Cloud core) untuk memverifikasi bahwa dialek didukung untuk instance Looker (Google Cloud core).

3. Isi detail koneksi. Sebagian besar setelan umum untuk sebagian besar dialek database. Lihat halaman dokumentasi Menghubungkan Looker ke database Anda untuk mengetahui informasinya.

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

5. Untuk menyimpan setelan ini, klik Hubungkan.

Dukungan fitur

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

MySQL mendukung fitur berikut mulai Looker 24.20:

Fitur	Didukung?
Level Dukungan	Didukung
Looker (Google Cloud core)	Tidak
Agregat Simetris	Ya
Tabel Turunan	Ya
Tabel Turunan SQL Persisten	Ya
Tabel Turunan Berbasis Persisten	Ya
Tampilan Stabil	Ya
Penghentian Kueri	Ya
Pivot berbasis SQL	Ya
Zona waktu	Ya
SSL	Ya
Subtotal	Ya
Parameter Tambahan JDBC	Ya
Peka Huruf Besar/Kecil	Tidak
Jenis Lokasi	Ya
Jenis Daftar	Ya
Persentil	Ya
Persentil Berbeda	Ya
Proses Tampilkan SQL Runner	Ya
SQL Runner Describe Table	Ya
SQL Runner Show Indexes	Ya
SQL Runner Select 10	Ya
Jumlah SQL Runner	Ya
SQL Explain	Ya
Kredensial Oauth	Tidak
Komentar Konteks	Ya
Penggabungan Koneksi	Tidak
Sketsa HLL	Tidak
Kesadaran Agregat	Ya
PDT inkremental	Ya
Milidetik	Ya
Mikrodetik	Ya
Tampilan Terwujud	Tidak
Perkiraan Jumlah Berbeda	Tidak

MySQL 8.0.12+ mendukung fitur berikut mulai Looker 24.20:

Fitur	Didukung?
Level Dukungan	Didukung
Looker (Google Cloud core)	Ya
Agregat Simetris	Ya
Tabel Turunan	Ya
Tabel Turunan SQL Persisten	Ya
Tabel Turunan Berbasis Persisten	Ya
Tampilan Stabil	Ya
Penghentian Kueri	Ya
Pivot berbasis SQL	Ya
Zona waktu	Ya
SSL	Ya
Subtotal	Ya
Parameter Tambahan JDBC	Ya
Peka Huruf Besar/Kecil	Tidak
Jenis Lokasi	Ya
Jenis Daftar	Ya
Persentil	Ya
Persentil Berbeda	Ya
Proses Tampilkan SQL Runner	Ya
SQL Runner Describe Table	Ya
SQL Runner Show Indexes	Ya
SQL Runner Select 10	Ya
Jumlah SQL Runner	Ya
SQL Explain	Ya
Kredensial Oauth	Tidak
Komentar Konteks	Ya
Penggabungan Koneksi	Tidak
Sketsa HLL	Tidak
Kesadaran Agregat	Ya
PDT inkremental	Ya
Milidetik	Ya
Mikrodetik	Ya
Tampilan Terwujud	Tidak
Perkiraan Jumlah Berbeda	Tidak

MariaDB mendukung fitur berikut mulai Looker 24.20:

Fitur	Didukung?
Level Dukungan	Didukung
Looker (Google Cloud core)	Ya
Agregat Simetris	Ya
Tabel Turunan	Ya
Tabel Turunan SQL Persisten	Ya
Tabel Turunan Berbasis Persisten	Ya
Tampilan Stabil	Ya
Penghentian Kueri	Ya
Pivot berbasis SQL	Tidak
Zona waktu	Ya
SSL	Ya
Subtotal	Ya
Parameter Tambahan JDBC	Ya
Peka Huruf Besar/Kecil	Tidak
Jenis Lokasi	Ya
Jenis Daftar	Ya
Persentil	Ya
Persentil Berbeda	Ya
Proses Tampilkan SQL Runner	Ya
SQL Runner Describe Table	Ya
SQL Runner Show Indexes	Ya
SQL Runner Select 10	Ya
Jumlah SQL Runner	Ya
SQL Explain	Ya
Kredensial Oauth	Tidak
Komentar Konteks	Ya
Penggabungan Koneksi	Tidak
Sketsa HLL	Tidak
Kesadaran Agregat	Ya
PDT inkremental	Tidak
Milidetik	Ya
Mikrodetik	Ya
Tampilan Terwujud	Tidak
Perkiraan Jumlah Berbeda	Tidak

SingleStore mendukung fitur berikut mulai Looker 24.20:

Fitur	Didukung?
Level Dukungan	Didukung
Looker (Google Cloud core)	Tidak
Agregat Simetris	Ya
Tabel Turunan	Ya
Tabel Turunan SQL Persisten	Ya
Tabel Turunan Berbasis Persisten	Ya
Tampilan Stabil	Ya
Penghentian Kueri	Ya
Pivot berbasis SQL	Ya
Zona waktu	Ya
SSL	Ya
Subtotal	Ya
Parameter Tambahan JDBC	Ya
Peka Huruf Besar/Kecil	Tidak
Jenis Lokasi	Ya
Jenis Daftar	Ya
Persentil	Tidak
Persentil Berbeda	Tidak
Proses Tampilkan SQL Runner	Ya
SQL Runner Describe Table	Ya
SQL Runner Show Indexes	Ya
SQL Runner Select 10	Ya
Jumlah SQL Runner	Ya
SQL Explain	Ya
Kredensial Oauth	Tidak
Komentar Konteks	Ya
Penggabungan Koneksi	Tidak
Sketsa HLL	Tidak
Kesadaran Agregat	Ya
PDT inkremental	Tidak
Milidetik	Ya
Mikrodetik	Ya
Tampilan Terwujud	Tidak
Perkiraan Jumlah Berbeda	Tidak

SingleStore 7+ mendukung fitur berikut mulai Looker 24.20:

Fitur	Didukung?
Level Dukungan	Didukung
Looker (Google Cloud core)	Ya
Agregat Simetris	Ya
Tabel Turunan	Ya
Tabel Turunan SQL Persisten	Ya
Tabel Turunan Berbasis Persisten	Ya
Tampilan Stabil	Ya
Penghentian Kueri	Ya
Pivot berbasis SQL	Ya
Zona waktu	Ya
SSL	Ya
Subtotal	Ya
Parameter Tambahan JDBC	Ya
Peka Huruf Besar/Kecil	Tidak
Jenis Lokasi	Ya
Jenis Daftar	Ya
Persentil	Ya
Persentil Berbeda	Tidak
Proses Tampilkan SQL Runner	Ya
SQL Runner Describe Table	Ya
SQL Runner Show Indexes	Ya
SQL Runner Select 10	Ya
Jumlah SQL Runner	Ya
SQL Explain	Ya
Kredensial Oauth	Tidak
Komentar Konteks	Ya
Penggabungan Koneksi	Tidak
Sketsa HLL	Tidak
Kesadaran Agregat	Ya
PDT inkremental	Tidak
Milidetik	Ya
Mikrodetik	Ya
Tampilan Terwujud	Tidak
Perkiraan Jumlah Berbeda	Tidak