MySQL, MariaDB, dan SingleStore

Dialek yang menggunakan petunjuk ini

MySQL, MariaDB, dan SingleStore (sebelumnya MemSQL) memiliki persyaratan penyiapan database yang sama, yang dijelaskan di halaman ini untuk menghubungkan Looker ke database analisis Anda. Untuk mengonfigurasi MySQL sebagai database backend internal untuk instance Looker yang dihosting pelanggan, lihat Memigrasikan database backend Looker ke MySQL.

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 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 untuk dialek dan versi database Anda.

MySQL 8.4.X

Di MySQL 8.4.X, plugin autentikasi default adalah caching_sha2_password, dan plugin mysql_native_password dinonaktifkan secara default. Pilih salah satu metode autentikasi berikut, bergantung pada apakah SSL diaktifkan untuk koneksi Looker Anda:

  • Saat terhubung dengan SSL yang diaktifkan (direkomendasikan): Driver JDBC Looker mendukung caching_sha2_password melalui koneksi SSL tanpa mengaktifkan mysql_native_password. Pilih SSL saat Anda membuat koneksi Looker, dan jalankan perintah berikut untuk membuat pengguna dan memberikan hak istimewa SELECT:

    CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD';
    GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
    
  • Saat terhubung tanpa mengaktifkan SSL: Karena Looker tidak mengaktifkan pengambilan kunci publik RSA otomatis (allowPublicKeyRetrieval) pada koneksi database pelanggan yang tidak dienkripsi, Anda harus melakukan autentikasi dengan mysql_native_password:

    1. Konfigurasikan server MySQL 8.4.X untuk mengaktifkan plugin mysql_native_password menggunakan salah satu metode berikut, bergantung pada deployment Anda:

      • Mulai server MySQL dengan flag --mysql-native-password=ON.
      • Tetapkan properti di file konfigurasi my.cnf:

        [mysqld]
        mysql_native_password=ON
        
      • Untuk instance MySQL 8.4.X yang dihosting di cloud di Google Cloud, AWS, atau Azure, aktifkan flag database atau parameter mysql_native_password di konfigurasi instance atau grup parameter jika belum diaktifkan secara default, dan mulai ulang instance database jika diperlukan. Lihat dokumentasi penyedia cloud Anda untuk mengetahui detail konfigurasi.

    2. Buat pengguna database dengan mysql_native_password dan berikan hak istimewa SELECT:

      CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD';
      GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
      

Ganti placeholder berikut dalam perintah sebelumnya:

  • DB_USERNAME: nama pengguna untuk pengguna database Looker, seperti looker
  • PASSWORD: sandi yang unik dan aman
  • DATABASE_NAME: nama database Anda

MySQL 8.0.X

Di MySQL 8.0.X, plugin autentikasi default adalah caching_sha2_password. Looker menggunakan plugin mysql_native_password untuk melakukan autentikasi ke database MySQL 8.0.X melalui driver JDBC. Agar MySQL 8.0.X berfungsi dengan baik, selesaikan langkah-langkah 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 PASSWORD dengan sandi yang unik dan aman:

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

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

Jalankan perintah berikut, dengan mengganti PASSWORD dengan sandi yang unik dan aman:

CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
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 Temp Database saat membuat koneksi database. 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 database sementara yang berbeda, gunakan nama database sementara Anda, 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 masih 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 Looker, pilih Connections, lalu klik Add Connection.
  2. Dari menu drop-down Dialect, pilih nama dialek database Anda: MySQL, MySQL 8.0.12+ (untuk MySQL 8.0.12 dan versi 8.X yang lebih baru, termasuk MySQL 8.4.X), MariaDB, SingleStore, atau SingleStore 7+.

  3. 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.

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

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

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

Parameter JDBC yang didukung

Untuk MySQL, MariaDB, dan SingleStore, Looker mendukung parameter JDBC berikut di kolom Additional JDBC parameters untuk koneksi. Lihat dokumentasi database Anda untuk 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 dapat mendukung beberapa fitur, dialek database Anda juga harus mendukungnya.

MySQL 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

MySQL 8.0.12+ 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

MariaDB 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

SingleStore 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

SingleStore 7+ 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