Mengonfigurasi ekstensi database

Untuk menambahkan fungsi tambahan ke database AlloyDB untuk PostgreSQL—seperti penelusuran vektor, pengindeksan geospasial, atau audit kueri—Anda dapat mengaktifkan, memperbarui, dan menonaktifkan ekstensi PostgreSQL yang didukung.

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

Mengaktifkan ekstensi

Secara umum, Anda mengaktifkan ekstensi dengan menghubungkan 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 maupun 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 yang harus Anda tetapkan.

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

   Catatan: Anda harus terhubung ke instance utama meskipun Anda mengaktifkan ekstensi pada instance kumpulan baca.
3. Di command prompt psql, hubungkan ke database dan buat ekstensi:

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   Catatan: Untuk membuat ekstensi auto_explain, gunakan perintah LOAD.
4. Jika Anda 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 di software dasar 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, dan 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 dapat 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.

   Catatan: Anda harus terhubung ke instance utama meskipun Anda menonaktifkan ekstensi yang hanya digunakan pada instance kumpulan baca.
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 telah mengaktifkan ekstensi dan hapus ekstensi di setiap database tersebut.

4. Jika ekstensi mengharuskan flag database ditetapkan pada instance tempat ekstensi digunakan, hapus flag dari setiap instance tempat ekstensi digunakan dengan mengikuti petunjuk di bagian Mengonfigurasi flag database instance.

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