Menginstal orafce untuk AlloyDB Omni

AlloyDB Omni tidak menyertakan ekstensi orafce, tetapi Anda dapat menambahkannya secara manual ke penginstalan AlloyDB Omni yang ada dengan mengikuti petunjuk di halaman ini. Ekstensi orafce menyediakan fungsi dan operator yang mengemulasikan subset fungsi dan paket dari database Oracle. Hal ini menyederhanakan migrasi aplikasi dari Oracle ke database yang kompatibel dengan PostgreSQL seperti AlloyDB Omni.

Sebelum memulai

Pastikan Anda telah menginstal AlloyDB Omni di sistem Anda.

Menambahkan orafce ke penginstalan AlloyDB Omni

Untuk menambahkan ekstensi orafce ke penginstalan AlloyDB Omni, ikuti langkah-langkah berikut:

1. Temukan label versi AlloyDB Omni yang diinstal:

   Docker

   docker run --rm -it  google/alloydbomni cat VERSION.txt

   Podman

   podman run --rm -it  google/alloydbomni cat VERSION.txt

   Outputnya mirip dengan hal berikut ini:

   AlloyDB Omni version: Omniween
   

   Catat nomor versi AlloyDB Omni; Anda memerlukannya di langkah berikutnya.

2. Tetapkan variabel lingkungan OMNI_VERSION:

   OMNI_VERSION=VERSION

   Ganti VERSION dengan versi server database lengkap dari langkah sebelumnya—misalnya, 16.3.0.

3. Buat penampung AlloyDB Omni baru yang menyertakan orafce:

   Linux

         mkdir ~/alloydb-omni-orafce
         tee -a ~/alloydb-omni-orafce/Dockerfile << EOF
         ARG OMNI_VERSION
         FROM google/alloydbomni:${OMNI_VERSION}
         RUN apt-get update && \
               apt-get install -y --no-install-recommends postgresql-16-orafce && \
               apt-get purge -y --auto-remove && \
               rm -rf /var/lib/apt/lists/*
         EOF
         cd ~/alloydb-omni-orafce
         sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag google/alloydbomni-with-orafce:$OMNI_VERSION .
         

   macOS

         mkdir ~/alloydb-omni-orafce
         tee -a ~/alloydb-omni-orafce/Dockerfile << EOF
         ARG OMNI_VERSION
         FROM google/alloydbomni:${OMNI_VERSION}
         RUN apt-get update && \
               apt-get install -y --no-install-recommends postgresql-16-orafce && \
               apt-get purge -y --auto-remove && \
               rm -rf /var/lib/apt/lists/*
         EOF
         cd ~/alloydb-omni-orafce
         sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag google/alloydbomni-with-orafce:$OMNI_VERSION .
         

4. Buat penampung baru dengan AlloyDB Omni bernama my-omni-orafce:

   docker run --name my-omni-orafce  -e POSTGRES_PASSWORD=NEW_PASSWORD  -d google/alloydbomni-with-orafce:OMNI_VERSION

5. Hubungkan ke database Anda dengan ekstensi orafce:

   docker exec -it my-omni-orafce psql -h localhost -U postgres

6. Aktifkan orafce:

   CREATE EXTENSION IF NOT EXISTS ORAFCE;

7. Pastikan orafce telah diinstal dan diaktifkan:

   SELECT oracle.sysdate();

   Outputnya terlihat mirip dengan yang berikut ini:

      postgres=# SELECT oracle.sysdate();
      sysdate
      ---------------------
      2024-06-10 16:36:30
      (1 row)