Conector de Base de Datos Oracle

Categoría: Conectores de Base de Datos

Introducción

Este documento ha sido creado para ayudar a configurar un conector mindzieDataDesigner a la base de datos Oracle. El mindzieDataDesigner es la herramienta ETL utilizada por mindzieStudio para convertir tablas de base de datos en registros de eventos para minería de procesos. El propósito de este documento es ayudar a crear la cadena de conexión y abrir puertos en el firewall si es necesario.

Resumen

El conector Oracle proporciona conectividad nativa a instancias de base de datos Oracle usando Oracle Managed Data Access (ODP.NET). Este conector ofrece alto rendimiento, soporte completo de funciones Oracle y manejo optimizado de zonas horarias para empresas globales.

Requisitos del Sistema

  • Sistema de Base de Datos: Oracle Database 11g Release 2 o superior (se recomienda 19c)
  • Ediciones Compatibles: Express Edition (XE), Standard Edition, Enterprise Edition
  • Soporte de Plataforma: Windows, Linux, Unix
  • Soporte en la Nube: Oracle Cloud Infrastructure (OCI), Amazon RDS para Oracle, Oracle Autonomous Database
  • Dependencias: Oracle Managed Data Access (ODP.NET) - incluido con el conector

Formato de la Cadena de Conexión

Formato Básico (Easy Connect)

Data Source=hostname:port/service_name;User Id=username;Password=password;

Formato TNS Names

Data Source=tns_alias;User Id=username;Password=password;

Parámetros de Conexión

Parámetro Descripción Obligatorio Ejemplo
Data Source Detalles de conexión al servidor Sí oracle-server:1521/ORCL
User Id Nombre de usuario de Oracle Sí PROCESS_MINING
Password Contraseña de Oracle Sí SecurePassword123
Connection Timeout Tiempo de espera de conexión (segundos) No 60
Command Timeout Tiempo de espera de comando (segundos) No 600
Pooling Habilitar agrupación de conexiones No true
Min Pool Size Número mínimo de conexiones en el pool No 1
Max Pool Size Número máximo de conexiones en el pool No 100
DBA Privilege Privilegios administrativos No SYSDBA
Persist Security Info Persistir credenciales No false

Ejemplos de Conexión

Oracle Express Edition (XE) local

Data Source=localhost:1521/XE;User Id=MINDZIE_USER;Password=password;

Base de Datos Oracle Enterprise

Data Source=oracle-prod.company.com:1521/PRODDB;User Id=PROCESS_MINING;Password=SecurePassword123;Connection Timeout=60;

Usando TNS Names

Data Source=PROD_ORACLE;User Id=MINDZIE_USER;Password=SecurePassword123;

Oracle Autonomous Database (Nube)

Data Source=mydb_high;User Id=ADMIN;Password=CloudPassword123;

Conexión con Configuraciones Avanzadas

Data Source=oracle-server:1521/ORCL;User Id=MINDZIE_USER;Password=password;
Pooling=true;Min Pool Size=5;Max Pool Size=50;Connection Timeout=30;

Conexión a Base de Datos Pluggable (PDB)

Data Source=oracle-server:1521/PDB1;User Id=PROCESS_USER;Password=password;

Métodos de Autenticación

Autenticación de Base de Datos

  • Autenticación estándar con usuario/contraseña de Oracle
  • Usuarios creados con sentencias CREATE USER
  • Método de autenticación más común

Autenticación del SO

Data Source=oracle-server:1521/ORCL;Integrated Security=yes;

Autenticación Proxy

Data Source=oracle-server:1521/ORCL;User Id=app_user;Password=password;Proxy User Id=end_user;

Solución de Problemas

Problemas Comunes de Conexión

Error "ORA-12154: TNS:could not resolve the connect identifier"

  • Verificar configuración de TNS names en tnsnames.ora
  • Comprobar variables de entorno ORACLE_HOME y TNS_ADMIN
  • Usar sintaxis Easy Connect como alternativa
  • Validar nombre del servicio y nombre del host

Error "ORA-01017: invalid username/password"

  • Verificar que las credenciales sean correctas y el usuario exista
  • Revisar si la cuenta está bloqueada: ALTER USER username ACCOUNT UNLOCK;
  • Asegurarse que el usuario tenga privilegio CREATE SESSION
  • Validar que la contraseña no haya expirado

Error "ORA-12505: TNS:listener does not currently know of SID given"

  • Verificar uso de nombre de servicio vs SID
  • Comprobar estado del listener Oracle: lsnrctl status
  • Usar el nombre del servicio en lugar del SID en versiones modernas de Oracle
  • Validar registro del servicio de base de datos

Error "ORA-00257: archiver error"

  • Revisar espacio en logs de archivo de Oracle
  • Contactar al DBA de Oracle para mantenimiento
  • Considerar usar conexión de solo lectura si está disponible

Acceso a Servidores mindzie: Para mayor seguridad, puede configurar su firewall para permitir conexiones únicamente desde los servidores mindzie agregando a la lista blanca direcciones IP específicas. Contacte al soporte de mindzie para obtener las direcciones IP actuales de los servidores mindzie que está usando.

Problemas en Oracle Cloud

Error "ORA-28040: No matching authentication protocol"

  • Actualizar cliente Oracle a una versión compatible
  • Verificar requisitos de autenticación en Oracle Cloud
  • Comprobar configuración SSL/TLS

Configuración de Oracle Autonomous Database

Requisitos Previos

  1. Descargar Wallet: Obtener el wallet de conexión desde el Consola de Oracle Cloud
  2. Extraer Wallet: Colocar los archivos en un directorio accesible
  3. Configurar TNS_ADMIN: Apuntar al directorio del wallet
  4. Cadena de Conexión: Usar nombres de servicio desde tnsnames.ora

Conexión a Autonomous Database

Data Source=mydb_high;User Id=ADMIN;Password=WalletPassword123;

Configuración del Wallet

  • Extraer wallet.zip en un directorio seguro
  • Establecer variable de entorno TNS_ADMIN
  • Usar nombres de servicio predefinidos (HIGH, MEDIUM, LOW)

Información Relacionada

💡 Consejo: Para despliegues empresariales de Oracle, considere usar cadenas de conexión Oracle Real Application Clusters (RAC) con múltiples hosts para alta disponibilidad y distribución de carga.