AlloyDB untuk PostgreSQL

Looker mendukung koneksi ke AlloyDB untuk PostgreSQL, layanan database cloud-native yang terkelola sepenuhnya dari Google Cloud yang kompatibel dengan PostgreSQL.

Halaman ini memberikan petunjuk untuk terhubung ke AlloyDB untuk PostgreSQL dari Looker.

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.

Jika Anda tertarik untuk menggunakan enkripsi SSL, lihat dokumentasi PostgreSQL.

Pengguna dan keamanan

Untuk melakukan tindakan pada database Anda, Looker harus memiliki akun pengguna di database Anda.

Untuk mengonfigurasi pengguna database yang akan digunakan Looker, lakukan langkah-langkah berikut di database Anda:

  1. Buat pengguna dan sandi database.

    CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';

  2. Berikan izin kepada pengguna database agar Looker dapat melakukan tindakan pada database Anda:

    GRANT CONNECT ON DATABASE DATABASE_NAME to USERNAME;
\c DATABASE_NAME
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO USERNAME;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO USERNAME;

  3. Jika Anda menggunakan skema selain public, jalankan perintah ini untuk memberikan izin penggunaan kepada Looker:

    GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;

  4. Untuk memastikan bahwa tabel mendatang yang Anda tambahkan ke skema publik juga tersedia untuk pengguna Looker, jalankan perintah berikut:

    ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON sequences TO USERNAME;

Bergantung pada penyiapan Anda, perintah sebelumnya mungkin perlu diubah. Jika pengguna atau peran lain membuat tabel yang memerlukan izin mendatang untuk pengguna Looker, Anda harus menentukan peran atau pengguna target untuk menerapkan pemberian izin pengguna Looker ke:

ALTER DEFAULT PRIVILEGES FOR USER ANOTHER_USERNAME IN SCHEMA SCHEMA_NAME GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES FOR ROLE TARGET_ROLE IN SCHEMA SCHEMA_NAME GRANT SELECT ON sequences TO USERNAME;

Misalnya, jika pengguna web_app membuat tabel dan Anda ingin pengguna looker dapat menggunakan tabel tersebut, Anda harus menjalankan pernyataan GRANT untuk memberikan izin pengguna looker pada tabel yang dibuat oleh pengguna web_app. Dalam hal ini, peran atau pengguna target adalah pengguna web_app, yang berarti Anda ingin mengubah hak istimewa pada tabel yang dibuat oleh web_app sehingga pengguna looker dapat memiliki izin untuk membaca tabel. Berikut ini contohnya:

ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;

Lihat ALTER DEFAULT PRIVILEGES di situs PostgreSQL untuk mengetahui informasi selengkapnya.

Penyiapan skema sementara

Buat skema yang dimiliki oleh pengguna Looker:

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

Menetapkan search_path

Sebelum menghubungkan Looker ke database Anda, Anda harus menetapkan search_path yang sesuai, yang dapat digunakan Looker SQL Runner untuk mengambil metadata tertentu dari database Anda:

ALTER USER USERNAME SET search_path TO '$user',SCHEMA_NAME,SCHEMA_NAME_2,SCHEMA_NAME_3
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas that you'll use with Looker

Membuat koneksi Looker ke database Anda

Ikuti langkah-langkah berikut untuk membuat koneksi dari Looker ke database Anda:

  1. Buka halaman Connect your database to Looker dengan melakukan salah satu tindakan berikut:

    • Klik ikon Main menu dan pilih Admin, lalu pilih Connections dari bagian Database di panel Admin. Di halaman Connections, klik tombol Add Connection.
    • Klik tombol Create di menu navigasi utama, lalu pilih item menu Connection.

  2. Dari menu drop-down Dialect, pilih Google Cloud AlloyDB for PostgreSQL.

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

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

  5. Untuk menyimpan setelan ini, klik Connect.

Parameter JDBC yang didukung

Untuk AlloyDB untuk PostgreSQL, Looker mendukung parameter JDBC berikut di kolom Additional JDBC parameters untuk koneksi. Lihat dokumentasi untuk database Anda guna mengetahui informasi tentang parameter ini.

  • allowEncodingChanges
  • ApplicationName
  • assumeMinServerVersion
  • binaryTransfer
  • binaryTransferDisable
  • binaryTransferEnable
  • cancelSignalTimeout
  • connectTimeout
  • currentSchema
  • databaseMetadataCacheFields
  • defaultRowFetchSize
  • escapeSyntaxCallMode
  • gssEncMode
  • hostRecheckSeconds
  • jaasApplicationName
  • jaasLogin
  • kerberosServerName
  • loadBalanceHosts
  • loginTimeout
  • logServerErrorDetail
  • options
  • password
  • preferQueryMode
  • preparedStatementCacheQueries
  • prepareThreshold
  • queryTimeout
  • readOnly
  • reWriteBatchedInserts
  • socketTimeout
  • ssl
  • sslfactory
  • sslhostnameverifier
  • sslmode
  • sslNegotiation
  • sslpassword
  • sslpasswordcallback
  • stringtype
  • targetServerType
  • tcpKeepAlive
  • unknownLength
  • user

Dukungan fitur

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

Google Cloud AlloyDB untuk PostgreSQL mendukung fitur berikut mulai Looker 26.8:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan berbasis 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
Proses Tampilkan SQL Runner
Tabel Jelaskan SQL Runner
Indeks Tampilkan SQL Runner
Pilih 10 SQL Runner
Jumlah SQL Runner
Jelaskan SQL
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Metrik dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom