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

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

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

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

מוודאים שהתקנתם את 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: 15.7.0

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

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

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

  3. יוצרים קונטיינר חדש של 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-15-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-15-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. יוצרים קונטיינר חדש עם AlloyDB Omni בשם my-omni-orafce:

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

  5. מתחברים למסד הנתונים באמצעות התוסף orafce:

    docker exec -it my-omni-orafce psql -h localhost -U postgres
  6. מפעילים את orafce: 
    CREATE EXTENSION IF NOT EXISTS ORAFCE;

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

    SELECT oracle.sysdate();

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

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