Mengonfigurasi ekstensi PostgreSQL

Anda dapat memperluas PostgreSQL dengan memaketkan objek SQL ke dalam satu paket dan menggunakannya sebagai satu unit. Halaman ini berisi informasi tentang cara mengonfigurasi ekstensi PostgreSQL yang didukung Cloud SQL.

Menggunakan ekstensi PostgreSQL

Anda hanya dapat menginstal ekstensi yang didukung oleh Cloud SQL. Untuk informasi selengkapnya, lihat Ekstensi PostgreSQL yang didukung oleh Cloud SQL.

Menginstal ekstensi

Sebelum menggunakan ekstensi, instal ekstensi tersebut:

• Di alat psql, jalankan perintah CREATE EXTENSION.

Persyaratan untuk hak istimewa superuser

Di Cloud SQL, ekstensi hanya dapat dibuat oleh pengguna yang menjadi bagian dari peran cloudsqlsuperuser. Saat membuat instance PostgreSQL baru, pengguna postgres default akan dibuat untuk Anda (meskipun Anda harus menyetel sandi pengguna). Pengguna postgres default adalah bagian dari peran cloudsqlsuperuser. Untuk informasi selengkapnya, lihat Tentang pengguna PostgreSQL.

Koneksi antar-database

Instance target untuk koneksi harus berada dalam jaringan VPC yang sama dengan instance yang terhubung.

Untuk instance cluster, Anda tidak dapat memilih opsi Require trusted client certificate di Google Cloud Console. Selain itu, agar dapat terhubung ke database dalam instance yang sama, Anda tidak dapat menetapkan host menjadi localhost atau 127.0.0.1. Sebagai gantinya, Anda harus menggunakan alamat IP yang ditampilkan untuk instance di Konsol Google Cloud.

Meminta dukungan untuk ekstensi baru

Anda tidak dapat membuat ekstensi sendiri di Cloud SQL.

Guna meminta dukungan untuk ekstensi, klik +1 pada masalah yang terbuka atau buat masalah baru. Untuk daftar masalah Cloud SQL yang terbuka dan informasi tentang pembuatan masalah baru, lihat Menelusuri atau membuat masalah dan permintaan fitur, berdasarkan produk.

Ekstensi PostgreSQL yang didukung oleh Cloud SQL

Untuk mengetahui informasi cara menggunakan ekstensi tertentu, lihat link dokumentasi di salah satu tabel di bawah.

Dukungan Cloud SQL untuk ekstensi PostgreSQL dapat dibagi menjadi kategori berikut:

• Ekstensi PostGIS
• Ekstensi jenis data
• Ekstensi bahasa
• Ekstensi lain-lain

PostGIS

Ekstensi PostGIS 3.2 didukung untuk Cloud SQL untuk PostgreSQL bagi semua versi utama.

Tabel berikut berisi versi ekstensi PostGIS untuk setiap versi Cloud SQL untuk PostgreSQL:

Untuk versi utama PostgreSQL tertentu, pada perintah CREATE EXTENSION, Anda dapat menentukan versi ekstensi PostGIS dengan menggunakan klausa VERSION.

Ekstensi PostGIS mencakup hal berikut:

• postgis
• postgis_raster
• postgis_sfcgal
• postgis_tiger_geocoder
• postgis_topology
• address_standardizer
• address_standardizer_data_us

Untuk informasi selengkapnya, lihat Penginstalan PostGIS.

Selain itu, Cloud SQL untuk PostgreSQL menyertakan versi 3.3.0 dari ekstensi pgRouting, yang memperluas PostGIS. Ekstensi pgRouting meningkatkan pemrosesan geospasial melalui pemilihan rute dan analisis jaringan.

Anda dapat mengupgrade PostGIS dan ekstensi yang terkait secara manual ke versi terbaru. Untuk mempelajari lebih lanjut cara mengupgrade ekstensi PostGIS Anda, lihat Mengupgrade PostGIS.

Ekstensi jenis data

Ekstensi bahasa

Ekstensi lain-lain

Selengkapnya tentang beberapa ekstensi PostgreSQL

Bagian ini menjelaskan informasi selengkapnya tentang beberapa ekstensi PostgreSQL yang didukung dalam tabel di atas.

auto_explain

Untuk mulai menggunakan ekstensi ini pada sebuah instance, tetapkan flag cloudsql.enable_auto_explain ke on. Untuk mengetahui informasi tentang cara menyetel dan meninjau flag yang didukung untuk ekstensi ini, lihat Mengonfigurasi flag database.

Atau, bagi pengguna yang memiliki (hanya) peran cloudsqlsuperuser, Anda dapat menggunakan perintah load untuk memuat ekstensi ini untuk satu sesi.

dblink

Dari dalam sesi database, Anda dapat menggunakan ekstensi ini untuk terhubung ke database PostgreSQL dan menjalankan kueri.

Saat ini, ekstensi ini berfungsi untuk dua instance IP pribadi Cloud SQL dalam jaringan VPC yang sama, atau untuk lintas database dalam instance yang sama.

Untuk informasi tambahan, lihat dblink dalam dokumentasi PostgreSQL.

Gunakan dblink untuk terhubung dengan sandi

Untuk terhubung ke database, atau untuk terhubung ke instance yang sama dengan pengguna lain, Anda harus menentukan sandi. Sebagai tujuan contoh (tetapi bukan untuk tujuan produksi), berikut ini cuplikan kodenya:

  SELECT * FROM dblink (
    'dbname=name port=1234 host=host user=user password=password',
    'select id, name from table' \
  ) AS t(id int, name text);

Atau, untuk menyiapkan koneksi saja, berikut ini cuplikan kode untuk tujuan contoh (bukan untuk tujuan produksi):

  SELECT dblink_connect('dbname=dblinktest user=postgres host=name_or_ip password=xxx');

Gunakan dblink untuk terhubung tanpa sandi

Untuk terhubung ke instance yang sama dengan pengguna yang sama, Anda dapat terhubung tanpa sandi. Contoh:

1. Setel flag database berikut untuk mengaktifkan koneksi lokal tanpa sandi
   cloudsql.allow_passwordless_local_connections

2. Menghubungkan tanpa menentukan host, yang berarti menghubungkan ke instance yang sama. Berikut ini contohnya:

   SELECT *
     FROM dblink('dbname=finance user=alice',
                 'select income from revenue')
       AS revenue(income integer);
   

   Hasilnya bisa mirip dengan yang berikut ini:

         income
         --------
         1000
         (1 row)
   

Agar dapat terhubung ke database dalam instance yang sama, Anda tidak dapat menetapkan host ke localhost atau 127.0.0.1. Sebagai gantinya, Anda harus menggunakan alamat IP yang ditampilkan untuk instance di Konsol Google Cloud.

Lihat juga postgres_fdw dan PL/Proxy dalam dokumen ini.

pageinspect

Ekstensi ini memeriksa konten halaman database pada tingkat rendah. Untuk mengetahui informasi selengkapnya, lihat pageinspect dalam dokumentasi PostgreSQL.

pg_bigm

Ekstensi ini memungkinkan penelusuran teks lengkap, dan memungkinkan indeks dua gram (bigram) untuk penelusuran teks lengkap yang lebih cepat.

Untuk mulai menggunakan ekstensi ini pada sebuah instance, tetapkan flag cloudsql.enable_pg_bigm ke on. Flag berikut juga didukung:

• pg_bigm.enable_recheck
• pg_bigm.gin_key_limit
• pg_bigm.similarity_limit

Untuk mengetahui informasi tentang cara menetapkan dan meninjau flag yang didukung untuk ekstensi ini, lihat Mengonfigurasi flag database.

pg_cron

Untuk mulai menggunakan pg_cron pada instance, tetapkan flag cloudsql.enable_pg_cron ke on. Untuk mengetahui informasi cara menetapkan dan meninjau flag yang didukung untuk ekstensi ini, lihat Mengonfigurasi flag database.

Tugas dikonfigurasi sebagai worker latar belakang, sehingga Anda mungkin perlu menggunakan teknik PostgreSQL standar (seperti flag max_worker_processes) untuk menyesuaikan jumlah worker latar belakang tersebut.

Untuk ekstensi ini, Cloud SQL mendukung mode worker latar belakang, tetapi tidak mendukung antarmuka libpq. Oleh karena itu, autentikasi kepercayaan yang melibatkan ekstensi ini tidak diperlukan.

pgfincore

Ekstensi ini menyertakan fungsi untuk mengelola halaman dalam memori cache disk sistem operasi dari PostgreSQL. Untuk mengetahui informasi selengkapnya, lihat dokumentasi pgfincore.

pg_freespacemap

Ekstensi ini memeriksa peta ruang kosong (FSM). Untuk informasi selengkapnya, lihat pg_freespacemap dalam dokumentasi PostgreSQL.

pg_hint_plan

Untuk mulai menggunakan ekstensi ini pada sebuah instance, tetapkan flag cloudsql.enable_pg_hint_plan ke on. Untuk mengetahui informasi tentang cara menyetel dan meninjau flag yang didukung untuk ekstensi ini, lihat Mengonfigurasi flag database.

Atau, hanya untuk pengguna dengan peran cloudsqlsuperuser, Anda dapat menggunakan perintah load untuk memuat ekstensi ini untuk satu sesi.

pg_partman

Ekstensi ini memungkinkan Anda membuat dan mengelola kumpulan partisi tabel berbasis waktu dan berbasis serial.

Di Cloud SQL, ekstensi ini tidak menyertakan worker latar belakang untuk pemeliharaan partisi otomatis. Sebagai gantinya, Anda dapat menggunakan, misalnya, Cloud Scheduler untuk mengatur pemeliharaan dengan memanggil fungsi pemeliharaan secara teratur pada interval tertentu.

pg_proctab

Berikut adalah langkah-langkah untuk menggunakan ekstensi pg_proctab untuk mengaktifkan aplikasi utilitas pg_top:

1. Di alat psql, jalankan perintah CREATE EXTENSION untuk pg_proctab.
2. Download dan jalankan pg_top.
3. Saat terhubung ke instance Cloud SQL untuk PostgreSQL, tambahkan opsi -r untuk terhubung ke remote database, guna mendapatkan metrik.

Berikut adalah metrik seluruh instance yang termasuk dalam output, termasuk penggunaan oleh agen dukungan dan layanan yang lain dalam instance:

• Rata-rata beban
• Status CPU (% pengguna, bagus, sistem, tidak ada aktivitas, dan menunggu I/O)
• Memori (digunakan, bebas, dan di-cache)

pg_repack

Ekstensi ini memungkinkan Anda menghilangkan pembengkakan dari tabel dan indeks. Secara opsional, Anda dapat menggunakan ekstensi ini untuk melakukan CLUSTER online (mengurutkan tabel berdasarkan indeks cluster). Untuk informasi selengkapnya, lihat dokumentasi pg_repack. Selain itu, untuk penggunaan ekstensi ini di Cloud SQL, prosedur khusus diperlukan untuk menambahkan hak istimewa kepada pengguna.

Jika pengguna di luar peran cloudsqlsuperuser ingin menggunakan ekstensi, Anda harus memberikan hak istimewa cloudsqlsuperuser kepada pengguna. Untuk informasi selengkapnya, dalam dokumen ini, lihat Persyaratan hak istimewa superuser. Contoh berikut menggunakan perintah GRANT untuk menambahkan hak istimewa yang diperlukan.

Contoh menambahkan hak istimewa

Untuk tujuan contoh di bawah ini, csuper1 adalah cloudsqlsuperuser dan testdb adalah database yang dimiliki oleh testuser. Untuk membuat ekstensi pg_repack di testdb, mulai dengan menjalankan perintah berikut:

1. Hubungkan ke testdb sebagai cloudsqlsuperuser:

   psql -U csuper1 -d testdb;
   

2. Berikan pemilik database, yaitu testuser, kepada csuper1:

   GRANT testuser TO csuper1;
   

3. Buat ekstensi:

   CREATE EXTENSION pg_repack;
   

4. Jalankan perintah pg_repack pada tabel, seperti t1 di testdb, sebagai csuper1:

   pg_repack -h <hostname> -d testdb -U csuper1 -k -t t1
   

5. Setelah tugas pg_repack selesai, cabut pemberian izin yang Anda lakukan pada langkah 2:

    REVOKE testuser FROM csuper1;
   

Perintah pg_repack mungkin gagal dengan error berikut:
"ERROR: query failed: SSL SYSCALL error: EOF detected"

Jika terjadi error tersebut, coba setel keepalive TCP ke nilai yang lebih kecil, lalu jalankan perintah pg_repack. Untuk mengetahui informasi selengkapnya, lihat Waktu tunggu koneksi (dari Compute Engine).

pg_squeeze

Ekstensi ini menghapus ruang yang tidak digunakan dari tabel dan secara opsional menggunakan indeks untuk mengurutkan tupel tabel. Untuk mulai menggunakan ekstensi pada instance, tetapkan flag cloudsql.enable_pg_squeeze ke on.

Ekstensi ini juga mendukung decoding logis dengan menulis informasi tambahan ke write-ahead log (WAL). Guna mengaktifkan fungsi ini untuk ekstensi, setel parameter konfigurasi wal_level ke logical atau yang lebih tinggi dengan menetapkan tanda cloudsql.logical_decoding ke on.

Ekstensi memerlukan nilai yang ditetapkan untuk flag max_replication_slots. Jika Anda belum menentukan nilai untuk tanda ini, tetapkan nilai ke 1. Jika tidak, tambahkan 1 ke nilai yang ditetapkan untuk flag tersebut.

Untuk mengetahui informasi tentang cara menyetel tanda dan meninjau tanda yang didukung untuk ekstensi ini, lihat Mengonfigurasi tanda database.

pgtt

Untuk mulai menggunakan ekstensi ini pada sebuah instance, tetapkan flag pgtt.enabled ke on. Untuk mengetahui informasi tentang cara menetapkan dan meninjau flag yang didukung untuk ekstensi ini, lihat Mengonfigurasi flag database.

pg_visibility

Ekstensi ini menyediakan cara untuk memeriksa peta visibilitas (VM) dan informasi visibilitas tingkat halaman dari sebuah tabel. Untuk informasi selengkapnya, lihat pg_visibility dalam dokumentasi PostgreSQL.

PL/Proxy

Ekstensi ini adalah pengendali bahasa prosedural yang memungkinkan panggilan prosedur jarak jauh antar database PostgreSQL, dengan sharding opsional.

Untuk informasi selengkapnya, lihat dokumentasi PL/Proxy.

Instance target untuk koneksi harus berada dalam jaringan VPC yang sama dengan instance yang terhubung. Selain itu, Anda tidak dapat memilih tombol Izinkan hanya koneksi SSL untuk instance cluster di Konsol Google Cloud.

Agar dapat terhubung ke database dalam instance yang sama, Anda tidak dapat menetapkan host ke localhost atau 127.0.0.1. Sebagai gantinya, Anda harus menggunakan alamat IP yang ditampilkan untuk instance di Konsol Google Cloud.

Lihat juga postgres_fdw dan dblink dalam dokumen ini.

postgresql_anonymizer

Untuk mulai menggunakan ekstensi ini pada sebuah instance, tetapkan flag cloudsql.enable_anon ke on. Untuk mengetahui informasi tentang cara menetapkan dan meninjau flag yang didukung untuk ekstensi ini, lihat Mengonfigurasi flag database.

postgres_fdw

Dengan ekstensi ini, tabel dari database PostgreSQL lain ("asing") diekspos sebagai tabel "asing" dalam database saat ini. Tabel tersebut kemudian tersedia untuk digunakan, hampir seolah-olah tabel itu adalah tabel lokal. Untuk informasi selengkapnya, lihat postgres_fdw dalam dokumentasi PostgreSQL.

Ekstensi ini berfungsi untuk dua instance IP pribadi Cloud SQL dalam jaringan VPC yang sama, atau untuk database silang dalam instance yang sama.

Agar dapat terhubung ke database dalam instance yang sama, Anda tidak dapat menetapkan host ke localhost atau 127.0.0.1. Sebagai gantinya, Anda harus menggunakan alamat IP yang ditampilkan untuk instance di Konsol Google Cloud.

Selain itu, untuk kasus tempat data asing disimpan, Anda dapat memilih opsi Allow only SSL connection di Konsol Google Cloud. Anda tidak dapat memilih opsi Wajibkan sertifikat klien tepercaya. Hanya cloudsqlsuperuser yang dapat menjadi pemilik wrapper data asing postgres_fdw.

Lihat juga PL/Proxy dan dblink dalam dokumen ini.

postgresql-hll

Ekstensi ini memperkenalkan jenis data baru, hll, yang merupakan struktur data HyperLogLog. Untuk informasi selengkapnya, lihat dokumentasi postgresql-hll.