Terhubung ke PostgreSQL

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

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

Dalam artikel ini:

• Cara terhubung ke PostgreSQL
• Catatan
• Batas
• Referensi terkait

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 Bantuan Looker Studio. Anda dapat menambahkan dan memberi suara untuk permintaan fitur di sini.

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 menggunakan salah satu opsi koneksi (lihat di bawah).
5. Klik AUTENTIKASI.
   • Daftar tabel dalam database tersebut akan muncul.
6. Pilih tabel.
7. Klik HUBUNGKAN.

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

Opsi koneksi

DASAR

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

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

URL JDBC

Untuk terhubung melalui URL JDBC, berikan informasi koneksi berikut:

• URL JDBC
  Contoh

  
  jdbc:postgresql://<nama host atau alamat IP>[:<port>]/<database>
  • Nama pengguna
  • 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. Misalnya: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

Untuk informasi selengkapnya, lihat https://datatracker.ietf.org/doc/html/rfc2732

Mengaktifkan SSL (opsional)

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.

Mengaktifkan autentikasi klien (opsional)

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

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.

Kueri SQL kustom hanya boleh memiliki satu pernyataan.

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;

Catatan: Kueri di Looker Studio dapat habis waktu tunggunya setelah 3 hingga 5 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. Lalu hubungkan ke tabel tersebut di sumber data Anda.

Catatan

Jenis data yang didukung

Konektor PostgreSQL saat ini mendukung jenis data berikut:

• Numerik
• 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 alamat IP yang spesifik. Anda mungkin juga perlu mengonfigurasi database untuk menerima traffic dari alamat tersebut. Lihat dokumentasi untuk database spesifik Anda guna mengetahui petunjuk tentang cara melakukannya.

Peringatan: Alamat IP yang saat ini digunakan oleh Looker Studio untuk terhubung ke database Anda akan berubah pada awal tahun 2023. Untuk memastikan laporan Anda terus berfungsi dengan benar setelah perubahan, Anda harus membuka alamat IP yang tercantum di bawah.

Menampilkan daftar alamat IP

142.251.74.0/23 
2001:4860:4807::/48 (Opsional, untuk platform yang mendukung IPv6)
74.125.0.0/16

Catatan untuk instance PostgreSQL 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

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

Referensi terkait

Membuat sumber data