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 sudah diaktifkan untuk mengakses AlloyDB.
  • Anda harus memiliki salah satu peran IAM ini di Google Cloud project yang Anda gunakan:
    • roles/alloydb.admin (peran IAM bawaan Admin AlloyDB)
    • roles/owner (peran IAM dasar Pemilik)
    • roles/editor (peran IAM dasar Editor)

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

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: 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. Jika diinginkan, ulangi langkah sebelumnya untuk terhubung ke database lain dan buat 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.

  2. Pada command prompt psql, hubungkan ke database yang 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 mengharuskan 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.