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.

Oraface 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-Version:

    Docker

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

    Podman

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

    Die Ausgabe sieht in etwa so aus:

    AlloyDB Omni version: 15.7.0

    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 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 -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-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. 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. Aktivieren Sie orafce: 
    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)