התקנת Orafce ל-AlloyDB Omni

בחירת גרסת תיעוד:

‫AlloyDB Omni לא כולל את התוסף Orafce, אבל אפשר להוסיף אותו באופן ידני להתקנה קיימת של AlloyDB Omni לפי ההוראות שבדף הזה.

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

צריך לוודא שאתם עומדים בדרישות המערכת הבאות:

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

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

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

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

    AlloyDB Omni CLI version: 1.0
AlloyDB Omni database server version: 15.5.2

    חשוב לשים לב למספר הגרסה של שרת מסד הנתונים, כי תצטרכו אותו בשלב הבא.

  2. מגדירים את משתנה הסביבה OMNI_VERSION: 
    OMNI_VERSION=VERSION

    מחליפים את VERSION בגרסה המלאה של שרת מסד הנתונים מהשלב הקודם – לדוגמה, 15.5.2.

  3. יוצרים קונטיינר חדש של AlloyDB Omni שכולל את Orafce: 
    mkdir ~/alloydb-omni-orafce
tee -a ~/alloydb-omni-orafce/Dockerfile << EOF
ARG OMNI_VERSION

FROM postgres:15-bookworm as postgres

RUN apt-get update && \
        apt-get install -y --no-install-recommends \
        postgresql-15-orafce && \
        apt-get purge -y --auto-remove && \
        rm -rf /var/lib/apt/lists/*

FROM gcr.io/alloydb-omni/pg-service:${OMNI_VERSION}

COPY --from=postgres /usr/lib/postgresql/15/lib/orafce.so /lib/orafce.so
COPY --from=postgres /usr/share/postgresql/15/extension/orafce* /share/extension/

COPY --from=postgres /usr/lib/x86_64-linux-gnu/ /usr/lib/x86_64-linux-gnu/
COPY --from=postgres /lib/x86_64-linux-gnu/ /lib/x86_64-linux-gnu/
EOF

cd ~/alloydb-omni-orafce

sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag gcr.io/alloydb-omni/pg-service-with-orafce:$OMNI_VERSION .
  4. עוצרים את שרת מסד הנתונים: 
    sudo alloydb database-server stop
  5. פותחים את /var/alloydb/config/dataplane.conf בכלי לעריכת טקסט.
  6. משנים את השורה שמגדירה את המשתנה PG_IMAGE כך שהוא יתייחס למאגר התגים שיצרתם בשלב הקודם: 
    PG_IMAGE=gcr.io/alloydb-omni/pg-service-with-orafce
  7. מפעילים את AlloyDB Omni: 
    sudo alloydb database-server start
  8. מתחברים למסד הנתונים: 
    sudo docker exec -it pg-service psql -h localhost -U postgres
  9. הפעלת Orafce: 
    CREATE EXTENSION IF NOT EXISTS ORAFCE;
  10. מוודאים ש-Orafce מותקן ומופעל: 
    SELECT oracle.sysdate();