MySQL, MariaDB, dan SingleStore

Dialek yang menggunakan instruksi 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 dialek dan versi basis data Anda:

MySQL 8.0.X:

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

  1. Konfigurasikan basis data MySQL untuk menggunakan plugin mysql_native_password. Hal ini dapat dilakukan dengan berbagai cara, dan akan bergantung pada cara deployment database MySQL 8 Anda 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, ganti some_password_here dengan kata 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, ganti some_password_here dengan kata 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 mengkonfigurasi skema sementara. Perintah berikut menunjukkan contoh pembuatan database sementara dan pemberian hak istimewa yang diperlukan kepada pengguna looker.

Anda dapat menentukan nama basis data sementara di kolom Basis Data Sementara saat membuat koneksi basis data Anda. Jika Anda tidak menentukan nama database sementara, Looker akan membuat database sementara bernama looker_tmp. Perintah berikut menggunakan looker_tmp, tetapi jika Anda menentukan nama basis data sementara yang berbeda, gunakan nama basis data sementara Anda sebagai pengganti 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 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, atur variabel MySQL max_allowed_packet ke nilai maksimumnya, 1073741824, untuk mencegah kesalahan "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 Looker, pilih Connections, lalu klik Add Connection.

  2. Dari menu tarik-turun Dialect, pilih nama dialek basis data Anda: MySQL, MySQL 8.0.12+, MariaDB, SingleStore, atau SingleStore 7+.

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

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

  5. 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 MySQL, MariaDB, dan SingleStore, Looker mendukung parameter JDBC berikut di kolom Parameter JDBC tambahan untuk koneksi. Lihat dokumentasi untuk database Anda guna mengetahui informasi tentang parameter ini.

  • allowMultiQueries
  • autocommit
  • characterSetResults
  • clientCertificateKeyStorePassword
  • clientCertificateKeyStoreUrl
  • connectionAttributes
  • connectionCollation
  • connectionTimeZone
  • connectTimeout
  • defaultAuthenticationPlugin
  • disableSslHostnameVerification
  • disconnectOnExpiredPasswords
  • enabledSslCipherSuites
  • failOverReadOnly
  • fallbackToSystemTrustStore
  • forceConnectionTimeZoneToSession
  • interactiveClient
  • lookerFailover
  • maxIdleTime
  • maxQuerySizeToLog
  • oldModeNoPrecisionTimestamp
  • password
  • passwordCharacterEncoding
  • permitMysqlScheme
  • pinGlobalTxToPhysicalConnection
  • preserveInstants
  • queryInterceptors
  • restrictedAuth
  • rewriteBatchedStatements
  • socketTimeout
  • sslMode
  • tcpKeepAlive
  • trustCertificateKeyStorePassword
  • trustCertificateKeyStoreUrl
  • useCompression
  • usePipelineAuth
  • user
  • useServerPrepStmts
  • verifyServerCertificate
  • yearIsDateType

Dukungan fitur

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

MySQL mendukung fitur berikut mulai Looker 26.16:

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

MySQL 8.0.12+ mendukung fitur berikut mulai Looker 26.16:

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

MariaDB mendukung fitur-fitur berikut per Looker 26.16:

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

SingleStore mendukung fitur-fitur berikut sejak Looker 26.16:

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

SingleStore 7+ mendukung fitur berikut mulai Looker 26.16:

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