Menghubungkan ke PostgreSQL

Anda dapat menghubungkan database PostgreSQL ke Data Studio untuk memvisualisasikan dan menganalisis data. Gunakan konektor PostgreSQL untuk mengubah data menjadi dasbor dan laporan interaktif. Kemudian, Anda dapat membagikan analisis kepada tim atau pemangku kepentingan yang tidak memiliki akses langsung ke database.

Versi yang didukung

Kami telah menguji Data 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 Data Studio. Anda juga dapat menambahkan dan memberikan suara untuk permintaan fitur di issue tracker.

Cara terhubung ke PostgreSQL

Konektor PostgreSQL menggunakan driver JDBC PostgreSQL untuk menghubungkan sumber data Data Studio ke satu tabel database PostgreSQL, atau ke kueri kustom yang Anda berikan.

Untuk terhubung ke database PostgreSQL, ikuti langkah-langkah berikut:

  1. Login ke Data Studio.
  2. Di halaman beranda Data Studio, 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 dari daftar atau masukkan kueri kustom.
  7. Klik CONNECT.

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

Opsi koneksi

Menghubungkan menggunakan nama host atau alamat IP

Di panel koneksi, pilih BASIC. Masukkan detail koneksi:

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

Menghubungkan menggunakan URL JDBC

Di panel koneksi, pilih URL JDBC. Masukkan detail koneksi:

  • URL JDBC

    • Contoh jdbc:postgresql://HOSTNAME[:PORT]/DATABASE

  • Nama pengguna
  • Sandi

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

Menghubungkan menggunakan SSL

Data Studio mendukung koneksi aman (terenkripsi) ke server menggunakan protokol TLS (Transport Layer Security) (TLS 1.2). TLS juga disebut sebagai SSL (Secure Sockets Layer).

Untuk mengaktifkan koneksi aman, pilih Aktifkan SSL , lalu berikan file konfigurasi SSL Anda.

Menghubungkan menggunakan autentikasi klien

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

Pelajari koneksi aman PostgreSQL lebih lanjut .

Kueri kustom

Pilih opsi KUERI KUSTOM untuk memberikan kueri SQL dan bukan menghubungkan ke satu tabel. Data Studio menggunakan SQL kustom ini sebagai pernyataan pemilihan dalam 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;

Kueri di Data Studio mungkin akan habis waktunya 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.

Jenis data yang didukung

Konektor PostgreSQL mendukung jenis data berikut:

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

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

Pelajari lebih lanjut tentang jenis data PostgreSQL.

Akses database dan firewall

Agar Data Studio dapat terhubung ke dan melakukan kueri 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

Alamat berikut dicadangkan untuk infrastruktur global Data Studio:

  • 142.251.74.0/23

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

Jika Anda telah mengaktifkan residensi data untuk langganan Data Studio Pro, gunakan alamat berikut:

  • 142.251.56.0/24

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

Perhatikan batasan jaringan berikut saat menggunakan konektor PostgreSQL:

  • Data 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 ekspor 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 Data Studio untuk mengetahui daftar pesan error umum dan langkah-langkah untuk mengatasinya.

Membuat sumber data