Menginstal orafce untuk AlloyDB Omni

Pilih versi dokumentasi:

Halaman ini menjelaskan cara menambahkan ekstensi orafce secara manual ke penginstalan AlloyDB Omni yang ada. Ekstensi orafce menyediakan fungsi dan operator yang mengemulasikan subset fungsi dan paket dari database Oracle. Ekstensi ini menyederhanakan migrasi aplikasi dari Oracle ke database yang kompatibel dengan PostgreSQL seperti AlloyDB Omni.

Sebelum memulai

Instal AlloyDB Omni di sistem Anda.

Menambahkan orafce ke penginstalan AlloyDB Omni Anda

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

  1. Temukan label versi AlloyDB Omni yang terinstal:

    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: 16.8.0
    

    Catat nomor versi AlloyDB Omni karena Anda akan membutuhkannya pada langkah berikutnya.

  2. 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 .
    

  3. Buat container baru dengan AlloyDB Omni bernama my-omni-orafce:

    docker build -t google/alloydbomni-with-orafce:latest
    docker run --name my-omni-orafce  -e POSTGRES_PASSWORD=NEW_PASSWORD  -d google/alloydbomni-with-orafce:OMNI_VERSION
    
  4. Hubungkan ke database Anda dengan ekstensi orafce:

    docker exec -it my-omni-orafce psql -h localhost -U postgres
    
  5. Aktifkan orafce:

    CREATE EXTENSION IF NOT EXISTS ORAFCE;
    
  6. Konfirmasi bahwa orafce telah diinstal dan diaktifkan:

    SELECT oracle.sysdate();
    

    Outputnya mirip dengan hal berikut ini:

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