Menghubungkan ke PostgreSQL

PostgreSQL adalah sistem manajemen database relasional (RDBMS) open source yang dikembangkan oleh tim relawan dari seluruh dunia.

Konektor PostgreSQL memungkinkan Anda mengakses data dari database berbasis PostgreSQL dalam Looker Studio.

Cara terhubung ke PostgreSQL

Konektor ini menggunakan driver JDBC PostgreSQL untuk menghubungkan sumber data Looker Studio ke tabel database PostgreSQL tunggal.

Versi yang didukung

Kami telah menguji Looker Studio di versi PostgreSQL berikut:

  • 9.6
  • 10
  • 11
  • 12
  • 13
  • 14

Jika Anda mengalami masalah saat menggunakan versi yang didukung, beri tahu kami di Komunitas Looker Studio. Anda juga dapat menambahkan dan memberi suara untuk permintaan fitur di issue tracker.

Untuk menghubungkan

  1. Login ke Looker Studio.
  2. Di halaman beranda Looker Studio, di kiri atas, klik Buat, lalu pilih Sumber Data.
  3. Pilih konektor PostgreSQL.
  4. Konfigurasikan akses ke database Anda menggunakan salah satu opsi koneksi.
  5. Klik AUTHENTICATE. Daftar tabel dalam database tersebut akan muncul.
  6. Pilih tabel.
  7. Klik CONNECT.

Anda kini dapat mengakses semua kolom dalam tabel sebagai kolom dalam laporan Anda.

Opsi koneksi

DASAR

Untuk terhubung dengan nama host atau alamat IP, Anda harus memberikan informasi berikut:

  • Hostname atau alamat IP
  • Port (Opsional)
  • Database
  • Nama pengguna
  • Sandi

URL JDBC

Untuk terhubung menggunakan URL JDBC, berikan informasi koneksi berikut:

  • URL JDBC
    • Contoh jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
  • Sandi

Jika menggunakan opsi nama host JDBC, Anda dapat memastikan opsi tersebut dapat diakses dengan fitur pencarian DNS publik seperti Whois.

Untuk terhubung menggunakan alamat literal IPv6, masukkan alamat di antara tanda kurung siku. Contoh: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

Aktifkan SSL

Looker Studio mendukung koneksi aman (terenkripsi) ke server menggunakan protokol TLS (Transport Layer Security). TLS juga disebut sebagai SSL (Secure Sockets Layer). Untuk mengaktifkan koneksi aman, centang Aktifkan SSL, lalu berikan file konfigurasi SSL Anda.

Setelan ini tidak diperlukan oleh Looker Studio, tetapi mungkin diperlukan untuk konfigurasi database Anda. Hubungi vendor database Anda untuk mengetahui detailnya.

Mengaktifkan autentikasi klien

Jika kotak ini dicentang, Anda dapat mengupload kunci pribadi klien dan sertifikat klien jika diperlukan untuk mengakses database.

Setelan ini tidak diperlukan oleh Looker Studio, tetapi mungkin diperlukan untuk konfigurasi database Anda. Hubungi vendor database Anda untuk mengetahui detailnya.

Catatan : Looker Studio hanya menerima format kunci klien PKCS-8.

Pelajari koneksi aman PostgreSQL lebih lanjut.

Kueri Kustom

Pilih opsi KUERI KUSTOM untuk memberikan kueri SQL dan bukan menghubungkan ke satu tabel. Looker Studio menggunakan SQL kustom ini sebagai pernyataan pemilihan internal untuk setiap kueri yang dibuat pada database.

Misalnya, kode berikut tidak akan berfungsi karena memiliki beberapa pernyataan SQL:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

Kueri di Looker Studio dapat habis waktu tunggunya setelah tiga hingga lima menit. Jika waktu tunggu kueri kustom habis, coba pendekatan berikut untuk menyelesaikan masalah tersebut:

  • Sederhanakan kueri agar berjalan lebih cepat.
  • Jalankan kueri di database Anda dan simpan hasilnya dalam tabel terpisah. Hubungkan tabel baru di sumber data Anda.

Catatan

Jenis data yang didukung

Konektor PostgreSQL mendukung jenis data berikut:

  • Angka
  • Berbasis karakter
  • Boolean
  • Tanggal/Waktu (kecuali Interval)

Saat Looker Studio menemukan kolom dengan jenis yang tidak didukung, kolom tersebut tidak akan dibuat.

Pelajari jenis data PostgreSQL lebih lanjut.

Akses database dan firewall

Agar Looker Studio dapat terhubung dan mengirim kueri ke database yang berada di belakang firewall, Anda perlu membuka akses ke salah satu alamat IP berikut. Anda mungkin juga perlu mengonfigurasi database untuk menerima traffic dari alamat tersebut. Lihat dokumentasi untuk database spesifik Anda guna mengetahui petunjuk tentang cara melakukannya.

Alamat IP

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (Opsional, untuk platform yang mendukung IPv6)

Perhatikan batasan jaringan berikut saat menggunakan konektor PostgreSQL:

  • Looker Studio tidak mendukung koneksi IP pribadi ke PostgreSQL di Cloud SQL.

  • Konektor PostgreSQL tidak menggunakan proxy Cloud SQL saat terhubung ke instance PostgreSQL Cloud SQL. Jika terhubung ke instance PostgreSQL Cloud SQL, Anda harus menambahkan IP yang tercantum ke daftar jaringan yang diizinkan. Lihat dokumentasi Cloud SQL.

Batas konektor PostgreSQL

  • Menghubungkan ke sumber data AlloyDB melalui SSL tidak didukung, karena AlloyDB tidak mendukung pengeksporan sertifikat Certificate Authority (CA).

  • Memilih tabel di luar skema public tidak didukung. Namun, Anda dapat memilih opsi KUERI KUSTOM untuk menulis kueri yang menyertakan tabel dalam skema apa pun.

  • Anda dapat mengajukan kueri maksimum 150 ribu baris per kueri menggunakan konektor ini. Jika Anda melebihi batas ini, data akan terpotong.

  • Header kolom (nama kolom) hanya boleh menggunakan karakter ASCII. Karakter non-ASCII tidak didukung.

Pemecahan masalah

Lihat panduan pemecahan masalah Looker Studio untuk mengetahui daftar pesan error umum dan langkah-langkah untuk mengatasinya.

Membuat sumber data