Oracle

Esta sección explica cómo configurar la conectividad a un destino de Oracle mediante el conector Oracle Target. Oracle únicamente se puede utilizar como destino en una tarea de replicación. Antes de poder conectarse a un destino de Oracle, debe configurar los Permisos requeridos en la base de datos. Si se conecta a Oracle a través de Pasarela de datos de movimiento de datos, también deberá instalar el controlador como se describe en Configuración del controlador.

Para obtener información sobre las limitaciones y consideraciones al utilizar el conector de Oracle , vea Limitaciones y consideraciones.

Configurar las propiedades de la conexión

Esta sección describe las propiedades de conexión disponibles. Todas las propiedades son obligatorias a menos que se indique lo contrario.

Destino de datos

• Pasarela de datos: Seleccione la Pasarela de datos de movimiento de datos que se utilizará para probar la conexión al destino de Oracle. Esta debería ser la misma puerta de enlace que se utilizó para acceder a la fuente de datos.

  Nota informativa

  • Requiere Pasarela de datos de movimiento de datos 2023.5.10 o posterior.

  • También necesita instalar el controlador adecuado en la máquina de Pasarela de datos de movimiento de datos. Para más detalles, vea Configuración del controlador a continuación.

• Cadena de conexión: La Cadena de conexión de Oracle para la base de datos Oracle con la que desea trabajar.

  Nota informativa

  • Al replicar en un almacén de datos autónomo de Oracle, primero debe realizar el procedimiento descrito en Conectar con un almacén de datos autónomo de Oracle .
  • Esta información distingue entre mayúsculas y minúsculas.

Propiedades de la cuenta

User Name y Password: El nombre de usuario y la contraseña de un usuario autorizado para acceder a la base de datos de Oracle Server.

Propiedades internas

Las propiedades internas son para casos de uso especiales y, por lo tanto, no se exponen en el cuadro de diálogo. Solo deberá usarlas si se lo indica el Soporte de Qlik.

Haga uso de los botones y a la derecha de los campos para agregar o eliminar propiedades según sea necesario.

Nombre

El nombre que mostrará la conexión.

Requisitos previos

Permisos requeridos

Al usuario especificado en la cadena de conexión se le deben otorgar los siguientes privilegios otorgados en la base de datos Oracle:

• CREATE ANY TABLE

• CREATE ANY INDEXES

• ALTER ANY TABLE

• DROP ANY TABLE

• INSERT ANY TABLE

• UPDATE ANY TABLE

• DELETE ANY TABLE

• SELECT ANY TABLE

• SELECT all_indexes

• SELECT all_ind_columns

• SELECT all_constraints

• SELECT all_cons_columns

• LOCK ANY TABLE

Configuración del controlador

Puede instalar el driver usando la utilidad de instalación del driver (recomendado) o manualmente. La instalación manual solo debe intentarse en el improbable caso de que encuentre un problema con la utilidad de instalación del driver.

Uso de la utilidad de instalación del driver para instalar el driver/controlador

Esta sección describe cómo instalar el driver necesario. El proceso implica ejecutar un script que descargará, instalará y configurará automáticamente el driver requerido. También puede ejecutar secuencias de script para actualizar y desinstalar el driver según sea necesario.

Preparar la instalación

• Asegúrese de que Python 3.6 o posterior esté instalado en el servidor de la pasarela de Movimiento de datos.

  Python viene preinstalado en la mayoría de las distribuciones de Linux. Puede verificar qué versión de Python está instalada en su sistema ejecutando el siguiente comando:

  python3 --version

Instalar el paquete de visualización driver

Para descargar e instalar el driver:

1. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a:

   opt/qlik/gateway/movement/drivers/bin

2. Ejecute el siguiente comando:

   Sintaxis:

   ./install oracle

   Si no logra descargar el driver (debido a restricciones de acceso o problemas técnicos), aparecerá un mensaje indicándole dónde puede descargar el driver y dónde copiarlo en la máquina de la puerta de enlace de Movimiento de datos. Una vez hecho esto, ejecute nuevamente el comando install oracle.

   De lo contrario, se mostrará el EULA del driver.

3. Puede realizar una de las acciones siguientes:

   • Pulse [Intro] repetidamente para desplazarse por el EULA.
   • Pulse la barra espaciadora repetidamente para desplazarse rápidamente por el EULA.
   • Pulse q para salir del texto de la licencia y ver las opciones de aceptación del EULA.

4. Puede realizar una de las acciones siguientes:

   • Escriba "y" y pulse [Intro] para aceptar el EULA y comenzar la instalación.
   • Escriba "n" y pulse [Intro] para rechazar el EULA y salir de la instalación.

   • Escriba "v" y pulse [Intro] para ver el EULA de nuevo.

Se instalará el driver.

Actualizar el driver

Ejecute el comando de actualización si desea desinstalar versiones anteriores del driver antes de instalar el driver provisto.

Para descargar y actualizar el driver:

1. En la máquina de la puerta de enlace de Movimiento de datos, cambie el directorio de trabajo a:

   opt/qlik/gateway/movement/drivers/bin

2. Ejecute el siguiente comando:

   Sintaxis:

   ./update oracle

   Si no logra descargar el driver (debido a restricciones de acceso o problemas técnicos), aparecerá un mensaje indicándole dónde puede descargar el driver y dónde copiarlo en la máquina de la puerta de enlace de Movimiento de datos. Una vez hecho esto, ejecute nuevamente el comando update oracle.

   De lo contrario, se mostrará el EULA del driver.

3. Puede realizar una de las acciones siguientes:

   • Pulse [Intro] repetidamente para desplazarse por el EULA.
   • Pulse la barra espaciadora repetidamente para desplazarse rápidamente por el EULA.
   • Pulse q para salir del texto de la licencia y ver las opciones de aceptación del EULA.

4. Puede realizar una de las acciones siguientes:

   • Escriba "y" y pulse [Intro] para aceptar el EULA y comenzar la instalación.
   • Escriba "n" y pulse [Intro] para rechazar el EULA y salir de la instalación.
   • Escriba "v" y pulse [Intro] para ver el EULA desde el principio.

El driver anterior se desinstalará y se instalará el nuevo driver.

Desinstalar el driver

Ejecute el comando de desinstalación si desea desinstalar el driver.

Para desinstalar el driver:

1. Detenga todas las tareas configuradas para utilizar este conector.

2. En la máquina de la pasarela de Movimiento de datos, cambie el directorio de trabajo a:

   opt/qlik/gateway/movement/drivers/bin

3. Ejecute el siguiente comando:

   Sintaxis:

   ./uninstall oracle

   Se desinstalará el driver.

Instalar el controlador manualmente

Solo debe intentar instalar el driver manualmente si la instalación automática del driver no se realizó correctamente.

Una vez que se haya instalado Pasarela de datos de movimiento de datos, descargue el controlador oracle-instantclient-basiclite-<version>.x86_64.rpm. Encontrará un enlace de descarga directa a la versión compatible en binary-artifacts, en /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. Una vez completada la descarga, copie el RPM a la máquina de Pasarela de datos de movimiento de datos.

A continuación, en el servidor de Data Movement gateway, abra un indicador en la línea de comandos y haga lo siguiente:

1. Detenga el servicio Data Movement gateway:

   sudo systemctl stop repagent

2. Opcionalmente, confirme que el servicio se ha detenido:

   sudo systemctl status repagent

El estado debería ser el siguiente:

Active: inactive (dead) since <timestamp> ago

3. Instale el controlador (RPM).

4. Además, si aún no está incluido en su sistema, cree un enlace simbólico en el directorio $Oracle_Home\lib. Asigne un nombre al enlace de libclntsh.so y apúntelo a una versión específica de este archivo.

   Ejemplo:

   lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1

5. Cambie el directorio de trabajo a <Data Movement gateway-Install-Dir>/bin y agregue la variable de entorno LD_LIBRARY_PATH al directorio del cliente Oracle instant y al directorio lib de Data Movement gateway copiando la ubicación del controlador en el archivo de site_arep_login.sh:

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh

6. Opcionalmente, confirme que se copió la ubicación del controlador:

   cat site_arep_login.sh

7. Inicie el servicio Data Movement gateway:

   sudo systemctl start repagent

8. Opcionalmente, confirme que el servicio se ha iniciado:

   sudo systemctl status repagent

   El estado debería ser el siguiente:

   Active: active (running) since <timestamp> ago

Conectar con un almacén de datos autónomo de Oracle

Se debe realizar el siguiente procedimiento al replicar en un almacén de datos autónomo de Oracle.

Para configurar la conectividad con Oracle Autonomous Data Warehouse (ADW), necesita el archivo ZIP de credenciales de cliente (Wallet) que descargó cuando configuró su entorno de Oracle Autonomous Data Warehouse.

Para habilitar la conexión de Data Movement gateway a Oracle Autonomous Data Warehouse:

1. Extraiga el contenido del archivo ZIP de credenciales de cliente a una carpeta de su elección.

   Puede ser cualquier carpeta, pero a los efectos de este procedimiento, /home/adw_credentials será la carpeta de Linux que contiene los archivos extraídos.

2. En la carpeta que contiene los archivos extraídos, edite el archivo sqlnet.ora, reemplazando ?/network/admin por la ruta de la carpeta que contiene los archivos extraídos:

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="/home/adw_credentials")))

   SSL_SERVER_DN_MATCH=yes

3. Cree la variable de entorno TNS_ADMIN y configúrela en la ubicación del archivo de credenciales.

   Ejecute los siguientes comandos:

   export TNS_ADMIN=/home/adw_credentials

   export PATH=$TNS_ADMIN:$PATH

4. En el campo Connection string del conector de Oracle Target, escriba uno de los nombres del archivo tnsnames.ora.

Para obtener más información sobre cómo configurar la conectividad con Oracle ADW, consulte:

Connect Autonomous Transaction Processing Using a Client Application

Limitaciones y consideraciones

Se aplican las siguientes limitaciones al utilizar Oracle como destino de replicación:

• No es posible crear nuevos esquemas en la base de datos Oracle. Para replicar en un nuevo esquema, el nuevo nombre del esquema ya debe existir en la base de datos de destino. Luego debe especificar el nuevo nombre del esquema en la pestaña de configuración de la tarea de Metadata.

• Cuando se trabaja en el modo de Aplicación optimizada por lotes, las columnas LOB vacías pueden replicarse como valores NULL.

• Una vez completada la carga completa, si la opción Limit LOB size to (KB) (Limitar tamaño de LOB a KB) a está habilitada y una tabla contiene datos NCLOB, el tamaño NCLOB en el destino se truncará a la mitad del tamaño especificado en el campo Limit LOB size to. CDC aún lo truncará conforme al límite.

Tipos de datos

La información del tipo de datos nativo se conserva y se muestra en la columna Tipo de datos nativo en las vistas de conjuntos de datos. Si la columna no está visible, debe abrir el selector de columnas de la vista del conjunto de datos y seleccionar la columna Tipo de datos nativo.