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.

Sebelum memulai

• Project Google Cloud yang Anda gunakan harus telah diaktifkan untuk mengakses AlloyDB.
• Anda harus memiliki salah satu peran IAM berikut di project Google Cloud yang Anda gunakan:
  • roles/alloydb.admin (peran IAM bawaan AlloyDB Admin)
  • roles/owner (peran IAM dasar Pemilik)
  • roles/editor (peran IAM dasar Editor)

  Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi untuk meminta akses.

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 Anda dapat menggunakan perintah LOAD atau CREATE EXTENSION untuk mengaktifkan ekstensi. Anda menetapkan flag ini di 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 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 di 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 diinginkan, ulangi langkah sebelumnya untuk terhubung ke database lain dan membuat ekstensi di setiap database tersebut.

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.

   Catatan: Anda harus terhubung ke instance utama meskipun Anda menonaktifkan ekstensi yang hanya digunakan di instance kumpulan baca.
2. Di 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.

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

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