Mengonfigurasi ekstensi database

Halaman ini menjelaskan cara mengaktifkan dan menonaktifkan ekstensi PostgreSQL di AlloyDB.

Lihat Ekstensi database yang didukung untuk mengetahui daftar ekstensi yang didukung AlloyDB.

Mengaktifkan ekstensi

Secara umum, Anda mengaktifkan ekstensi dengan terhubung ke database di instance utama cluster AlloyDB dan memasukkan perintah LOAD atau CREATE EXTENSION.

Namun, beberapa ekstensi mengharuskan Anda menetapkan satu atau beberapa flag database sebelum dapat menggunakan perintah LOAD atau CREATE EXTENSION untuk mengaktifkan ekstensi. Anda menetapkan flag ini pada instance AlloyDB tempat Anda ingin menggunakan ekstensi, baik instance tersebut adalah instance utama atau instance kumpulan baca.

Prosedur

  1. Jika diperlukan, tetapkan flag database yang sesuai pada instance tempat Anda ingin menggunakan ekstensi, baik instance utama maupun instance kumpulan baca.

    Daftar ekstensi yang didukung menunjukkan ekstensi mana yang memerlukan langkah ini dan menyatakan flag database mana yang harus Anda tetapkan.

  2. Hubungkan klien psql ke instance utama cluster, seperti yang dijelaskan dalam Menghubungkan klien psql ke instance.

  3. Pada command prompt psql, hubungkan ke database dan buat ekstensi: 
    \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
  4. Jika mau, ulangi langkah sebelumnya untuk terhubung ke database lain dan buat ekstensi di setiap database tersebut.

Mengupdate ekstensi

Meskipun update pemeliharaan AlloyDB otomatis menginstal biner ekstensi terbaru pada software yang mendasari instance Anda, update tersebut tidak otomatis mengupdate katalog database ekstensi. Anda bertanggung jawab untuk mengupdate ekstensi secara manual guna memastikan ekstensi tersebut menggunakan versi terbaru yang didukung.

Untuk menentukan ekstensi mana yang memerlukan update, bandingkan versi yang diinstal dengan versi terbaru yang didukung yang tercantum dalam Tabel referensi ekstensi yang didukung.

Hubungkan ke database Anda dan jalankan perintah berikut untuk melihat versi yang diinstal:

SELECT * FROM pg_extension;

Untuk mengupdate ekstensi ke versi terbaru yang tersedia di instance Anda, gunakan perintah ALTER EXTENSION.

Hubungkan ke instance utama cluster menggunakan klien pilihan Anda, seperti AlloyDB Studio atau klien psql, lalu jalankan perintah berikut untuk setiap ekstensi yang ingin Anda update:

ALTER EXTENSION EXTENSION_NAME UPDATE;

Jika Anda perlu mengupdate ke versi tertentu, gunakan sintaksis berikut:

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

Menonaktifkan ekstensi

Anda menonaktifkan ekstensi dengan membalikkan prosedur yang digunakan untuk mengaktifkannya.

  1. Hubungkan klien psql ke instance utama cluster, seperti yang dijelaskan dalam Menghubungkan klien psql ke instance.

  2. Pada command prompt psql, hubungkan ke database yang telah mengaktifkan ekstensi dan hapus ekstensi: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Ulangi langkah sebelumnya untuk terhubung ke database lain yang mengaktifkan ekstensi dan hapus ekstensi di setiap database tersebut.

  4. Jika ekstensi mewajibkan agar tanda database ditetapkan pada instance tempat ekstensi digunakan, hapus tanda dari setiap instance tempat ekstensi digunakan dengan mengikuti petunjuk di Mengonfigurasi tanda database instance.

    Daftar ekstensi yang didukung menunjukkan ekstensi mana yang memerlukan penetapan flag database dan mengidentifikasi flag mana.