התקנה של orafce ל-AlloyDB Omni

בחירת גרסה של מאמר העזרה:

בדף הזה נסביר איך להוסיף באופן ידני את התוסף orafce להתקנה קיימת של AlloyDB Omni. התוסף orafce מספק פונקציות ואופרטורים שמדמים קבוצת משנה של פונקציות וחבילות ממסד הנתונים של Oracle. התוסף הזה מפשט את ההעברה של אפליקציות מ-Oracle למסדי נתונים שתואמים ל-PostgreSQL, כמו AlloyDB Omni.

לפני שמתחילים

מתקינים את AlloyDB Omni במערכת.

הוספת orafce להתקנת AlloyDB Omni

כדי להוסיף את התוסף orafce להתקנת AlloyDB Omni: פועלים לפי השלבים הבאים:

  1. כדי למצוא את תוויות הגרסה של AlloyDB Omni שהותקנה:

    Docker

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

    Podman

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

    הפלט אמור להיראות כך:

    AlloyDB Omni version: 17.5.0

    חשוב לשים לב למספר הגרסה של AlloyDB Omni כי תצטרכו אותו בשלב הבא.

  2. יוצרים קונטיינר חדש של AlloyDB Omni שכולל את orafce:

    Linux 

    $ mkdir ~/alloydb-omni-orafce

$ tee ~/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-17-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 ~/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-17-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. יוצרים קונטיינר חדש עם AlloyDB Omni בשם 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. מתחברים למסד הנתונים באמצעות התוסף orafce:

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

  5. מפעילים את orafce:

    CREATE EXTENSION IF NOT EXISTS ORAFCE;

  6. מוודאים ש-orafce מותקן ומופעל:

    SELECT oracle.sysdate();

    הפלט אמור להיראות כך:

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