Orafce für AlloyDB Omni installieren

AlloyDB Omni enthält nicht die Orafce-Erweiterung. Sie können sie jedoch einer vorhandenen AlloyDB Omni-Installation manuell hinzufügen. Folgen Sie dazu der Anleitung auf dieser Seite, um zusätzliche Funktionen und Operatoren aus der Oracle-Datenbank bereitzustellen.

Hinweise

AlloyDB Omni muss auf Ihrem System installiert sein.

Ein Server

Orafce zu Ihrer AlloyDB Omni-Installation hinzufügen

So fügen Sie Ihrer AlloyDB Omni-Installation die Orafce-Erweiterung hinzu:

  1. So finden Sie die Labels der installierten AlloyDB Omni-Versionen:
    docker run --rm -it  google/alloydbomni cat VERSION.txt

    Die Ausgabe sieht in etwa so aus:

    AlloyDB Omni version: 15.5.3
    

    Notieren Sie sich die AlloyDB Omni-Versionsnummer. Sie benötigen sie im nächsten Schritt.

  2. Legen Sie die Umgebungsvariable OMNI_VERSION fest:
    OMNI_VERSION=VERSION

    Ersetzen Sie VERSION durch die vollständige Datenbankserverversion aus dem vorherigen Schritt, z. B. 15.5.3.

  3. Erstellen Sie einen neuen AlloyDB Omni-Container, der Orafce enthält:

    Linux

      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 google/alloydbomni:${OMNI_VERSION}
    
      COPY --from=postgres /usr/lib/postgresql/15/lib/orafce.so /usr/lib/postgresql/15/lib/orafce.so
      COPY --from=postgres /usr/share/postgresql/15/extension/orafce* /usr/lib/postgresql/15/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 google/alloydbomni-with-orafce:$OMNI_VERSION .
      

    macOS

      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 google/alloydbomni:${OMNI_VERSION}
    
      COPY --from=postgres /usr/lib/postgresql/15/lib/orafce.so /usr/lib/postgresql/15/lib/orafce.so
      COPY --from=postgres /usr/share/postgresql/15/extension/orafce* /usr/lib/postgresql/15/share/extension/
    
      COPY --from=postgres /usr/lib/aarch64-linux-gnu/ /usr/lib/aarch64-linux-gnu/
      COPY --from=postgres /lib/aarch64-linux-gnu/ /lib/aarch64-linux-gnu/
      EOF
      cd ~/alloydb-omni-orafce
      sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag google/alloydbomni-with-orafce:$OMNI_VERSION .
      

  4. Erstellen Sie einen neuen Container mit AlloyDB Omni mit dem Namen my-omni-orafce:
    docker run --name my-omni-orafce  -e POSTGRES_PASSWORD=NEW_PASSWORD  -d google/alloydbomni-with-orafce:OMNI_VERSION
  5. Stellen Sie mit der Orafce-Erweiterung eine Verbindung zu Ihrer Datenbank her:
    docker exec -it my-omni-orafce psql -h localhost -U postgres
    
  6. Orafce aktivieren:
    CREATE EXTENSION IF NOT EXISTS ORAFCE;
  7. Prüfen Sie, ob Orafce installiert und aktiviert ist:
    SELECT oracle.sysdate();
    Die Ausgabe sieht dann ungefähr so aus:
    postgres=# SELECT oracle.sysdate();
         sysdate
    ---------------------
    2024-06-10 16:36:30
    (1 row)