Instalar Orafce para AlloyDB Omni

Selecciona una versión de la documentación:

AlloyDB Omni no incluye la extensión Orafce, pero puedes añadirla manualmente a una instalación de AlloyDB Omni siguiendo las instrucciones de esta página.

Antes de empezar

Asegúrate de que cumples los siguientes requisitos del sistema:

Añadir Orafce a tu instalación de AlloyDB Omni

Para añadir la extensión Orafce a tu instalación de AlloyDB Omni, sigue estos pasos:

  1. Busca las etiquetas de la versión de AlloyDB Omni que tienes instalada: 
    sudo alloydb version

    El resultado debería ser similar al siguiente:

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

    Anota el número de versión del servidor de la base de datos, ya que lo necesitarás en el siguiente paso.

  2. Define la variable de entorno OMNI_VERSION: 
    OMNI_VERSION=VERSION

    Sustituye VERSION por la versión completa del servidor de la base de datos del paso anterior. Por ejemplo, 15.5.2.

  3. Crea un contenedor de AlloyDB Omni que incluya 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. Detén el servidor de la base de datos: 
    sudo alloydb database-server stop
  5. Abre /var/alloydb/config/dataplane.conf en un editor de texto.
  6. Modifica la línea que define la variable PG_IMAGE para que haga referencia al contenedor que has creado en un paso anterior: 
    PG_IMAGE=gcr.io/alloydb-omni/pg-service-with-orafce
  7. Inicia AlloyDB Omni: 
    sudo alloydb database-server start
  8. Conéctate a tu base de datos: 
    sudo docker exec -it pg-service psql -h localhost -U postgres
  9. Habilita Orafce: 
    CREATE EXTENSION IF NOT EXISTS ORAFCE;
  10. Confirma que Orafce está instalado y habilitado: 
    SELECT oracle.sysdate();