Resumen
Conectarse a una base de datos como Oracle puede ser la parte más frustrante de la instalación y configuración de la aplicación. Las muchas opciones disponibles con los controladores JDBC y ODBC pueden resultar abrumadoras. Las siglas por sí solas son suficientes para causar un dolor de cabeza.
La pila de software IRI utiliza controladores JDBC y ODBC para diferentes propósitos. IRI Workbench requiere conexiones JDBC para acceder a los datos y metadatos en las bases de datos. El uso de IRI Workbench es totalmente opcional. Sin embargo, la integración de metadatos de la base de datos, además de varios asistentes y editores, hacen que sea mucho más fácil crear y mantener los scripts de trabajo y los archivos de configuración utilizados por el motor de procesamiento de datos de IRI, SortCL.
IRI Workbench, con sus conexiones JDBC, también es necesario para ejecutar IRI DarkShield®, para el descubrimiento y enmascaramiento de documentos y almacenes de datos semiestructurados y no estructurados. Las conexiones y los controladores ODBC son necesarios para la ejecución en tiempo de ejecución de los trabajos ETL de IRI Voracity® y las herramientas de componentes como CoSort®, RowGen®, FieldShield® y NextForm® que también generan y apuntan datos en las bases de datos.
Las instrucciones y los ejemplos de este artículo se basan en el método Oracle Easy Connect (EZCONNECT). Si por alguna razón sus bases de datos de Oracle no pueden usar EZCONNECT, deberá confiar en la documentación proporcionada por Oracle y otros recursos para configurar sus conexiones.
Recopilar información
Hay varios detalles que necesitará saber sobre su base de datos antes de configurar cualquier conexión. Esta información debe estar disponible a través de un administrador de base de datos. Si administra la base de datos usted mismo, esta información se puede encontrar en listener.ora archivo de configuración.
Recopile los detalles que se muestran en la Tabla 1 para la base de datos que requiere una conexión. Esta información es necesaria para las conexiones JDBC y ODBC.
Tabla 1:detalles necesarios para crear una conexión de base de datos.
Más sobre la información necesaria:
- Host puede ser un nombre de host o una dirección IP. Los nombres de host pueden ser una palabra, con un dominio implícito, un nombre completamente calificado que incluye el dominio.
- El puerto es un número entero único. El valor predeterminado es 1521, pero el administrador de la base de datos puede cambiarlo.
- Cada instancia de base de datos tiene un SID. El SID debe ser único si hay más de una instancia que comparte el mismo host y puerto. A veces, se hace referencia a la instancia mediante un nombre de servicio, en lugar del SID. Si la base de datos a la que se está conectando tiene un nombre de servicio, debe usarlo.
- El nombre de usuario debe ser el nombre de usuario de Oracle asociado con el esquema o esquemas con los que trabajará. Es mejor elegir un usuario con un alcance limitado de privilegios de esquema. El uso de una cuenta de usuario SYSTEM puede resultar en una cantidad inmanejable de esquemas y tablas visibles.
- La contraseña debe coincidir con el nombre de usuario especificado.
Una vez que se haya recopilado la información correcta, estará listo para crear las conexiones ODBC y JDBC.
ODBC
El administrador ODBC y los controladores vienen en arquitecturas de dos bits, 32 bits y 64 bits. La arquitectura de bits del administrador y del controlador debe hacer coincidir la arquitectura de bits de la aplicación que utiliza la conexión. En Windows®, los motores de tiempo de ejecución IRI suelen ser de 32 bits, incluso cuando se ejecutan en un sistema operativo de 64 bits. En Linux y Unix, prevalecen las aplicaciones de 64 bits.
Antes de elegir la arquitectura de bits de sus controladores ODBC, es importante conocer la arquitectura de bits del producto de tiempo de ejecución IRI que utiliza SortCL, como CoSort o FieldShield. Si no está seguro de la arquitectura de bits de su motor IRI, puede verificarlo usando el comando de versión. Forme la línea de comando, ejecute:
sortcl /v
En IRI Workbench, la Ayuda> Información de la versión elemento del menú mostrará los mismos resultados. La arquitectura de bits se puede encontrar en la cadena de versión, como se muestra en la Tabla 2.
Tabla 2:Determinación de la arquitectura de bits CoSort.
Determine la arquitectura de bits correcta. Lo necesitará para identificar el administrador ODBC correcto que se utilizará y para descargar e instalar los controladores ODBC adecuados. El uso de administradores y controladores ODBC en Linux, Unix y Mac es más complicado y está más allá del alcance de este artículo.
Los ejemplos aquí utilizarán el Administrador ODBC proporcionado por Microsoft con Windows. Si usa otro sistema operativo y necesita ayuda, comuníquese con su representante de IRI.
Las conexiones ODBC se identifican con un identificador único conocido como Nombre de fuente de datos (DSN). Microsoft proporciona el Administrador de fuente de datos ODBC programa con Windows, para definir y configurar DSNs.
Es importante elegir el programa Administrador de ODBC con la arquitectura de bits correcta para que coincida con la aplicación que necesita acceso a la base de datos y los controladores. Elija el programa de la Tabla 3. Es confuso que el programa de 32 bits esté en la carpeta SysWOW64, mientras que el programa de 64 bits esté en la carpeta System32.
Tabla 3:programas de administrador de fuente de datos ODBC.
Si tiene un servidor de base de datos de Oracle instalado en su estación de trabajo, probablemente ya tenga instalado un controlador ODBC de Oracle. Puede comprobar la presencia de un controlador ODBC de Oracle ejecutando el programa Administrador de fuente de datos ODBC.
Busque en los Controladores pestaña para una entrada similar a la que se muestra en la Figura 4, El nombre debe comience con la palabra Oracle . Usted no puede use el controlador llamado Microsoft ODBC para Oracle , este no trabajo.
Figura 4:controlador de Oracle en el programa Administrador de fuente de datos ODBC.
Los controladores se enumeran en orden alfabético. Si no ve un controlador de Oracle presente, deberá instalar un cliente de Oracle. Oracle tiene una versión diferente del cliente para cada versión de la base de datos. Por lo general, puede usar un cliente más nuevo con una base de datos más antigua, pero no necesariamente al revés.
Suponga que desea instalar el cliente de 32 bits para Oracle 18c. En el momento de escribir este documento, el instalador estaba disponible para su descarga desde Oracle. Vaya a la página de descarga y busque el texto Oracle Database 18c Client (18.3) para Microsoft Windows x86 (32 bits) , como se muestra en la Figura 5.
Descargue el archivo vinculado NT_180000_client.zip . Necesitará una cuenta de Oracle en línea para descargar el instalador del cliente; puede registrarse de forma gratuita si no tiene un inicio de sesión.
Figura 5:descarga del cliente de Oracle que incluye controladores ODBC y JDBC.
Descomprima el archivo zip descargado en una carpeta temporal para instalar el cliente. Vaya a la carpeta temporal y busque en el client32 carpeta para setup.exe , ejecutará este programa para instalar el cliente. Necesitará privilegios de administrador para instalar el cliente.
Elija un tipo de instalación como se muestra en la Figura 6. Solo para el controlador ODBC, el controlador JDBC y la utilidad de línea de comandos SQL*Plus, elija Instant Client tipo. Si desea instalar todas las herramientas de administración, elija el Administrador tipo.
Siga las instrucciones del asistente de instalación. Probablemente pueda aceptar los valores predeterminados para cualquier opción adicional. Hay un botón de ayuda en la parte inferior del asistente de instalación. Para obtener más ayuda sobre este instalador en particular, Oracle tiene documentación adicional disponible en línea.
Figura 6:tipo de instalación de Oracle Client.
Una vez que haya instalado los controladores ODBC, puede configurar un DSN para una conexión de base de datos de Oracle. Ejecute el programa Administrador de fuente de datos ODBC especificado en la Tabla 3. Seleccione la pestaña para crear un DSN de usuario o un DSN del sistema . un DSN de usuario solo será visible para el usuario que lo creó.
Un DSN del sistema es visible para todos los usuarios de esa estación de trabajo. Lo más común es crear un DSN de usuario, así que seleccione esa pestaña. Seleccione Agregar botón para crear una nueva conexión DSN. Seleccione el controlador Oracle correcto como se muestra en la Figura 7, luego seleccione Finalizar botón.
Figura 7:selección del controlador ODBC de Oracle.
Se le presentará la Configuración del controlador ODBC de Oracle cuadro de diálogo, como el que se muestra en la Figura 9. Asigne un nombre a su conexión. Este es el DSN. Es mejor evitar los espacios en blanco y la puntuación en el DSN, excepto posiblemente guiones bajos, guiones y puntos.
Haga que el nombre sea descriptivo de la base de datos a la que se está conectando. El nombre del servicio TNS puede variar según el método de conexión de Oracle que se utilice.
El ejemplo de la Figura 8 utiliza EZCONNECT y los detalles del ejemplo que se recopilaron en la Tabla 8.
Tabla 8:detalles de una conexión de base de datos de ejemplo.
El formato de una cadena de conexión EZCONNECT es:host :puerto /Nombre del servicio
Tenga en cuenta que no hay un lugar separado en el cuadro de diálogo para guardar la contraseña. Pero Oracle le permite guardar la contraseña agregándola al Nombre de usuario, separándola con una barra inclinada, como se muestra en los detalles del ejemplo en la Figura 9.
Aunque la contraseña se almacena en texto sin formato, el DSN solo es visible para el usuario que está conectado a la estación de trabajo en ese momento y no representa un riesgo de seguridad significativo en la mayoría de los casos. Si tiene un departamento de TI con políticas de seguridad, es posible que no se le permita almacenar su contraseña de esta manera. La contraseña se puede escribir siempre que se establezca una conexión.
También es posible almacenar la contraseña en IRI Workbench, donde se aplicará a los trabajos que acceden a los datos a través de este DSN. Sin embargo, si está permitido, guardar su contraseña en el DSN como se muestra a continuación es el método más conveniente.
Figura 9:cuadro de diálogo de configuración del controlador con detalles de ejemplo.
Después de configurar estos detalles, seleccione Probar conexión botón. Con suerte, verá la Conexión exitosa resultado, como se muestra en la Figura 10.
Si hay un problema con sus datos o conexión, o ha omitido almacenar la contraseña, aparecerá el cuadro de diálogo Oracle ODBC Driver Connect, como se muestra en la Figura 11. Esto le dará la oportunidad de proporcionar los detalles que faltan o cambiar los detalles ya ingresados.
Si las ediciones permiten que la conexión tenga éxito, deberán aplicarse en el cuadro de diálogo de configuración que se muestra en la Figura 9 antes de seleccionar Aceptar . Hay cuatro pestañas de opciones en la parte inferior del cuadro de diálogo de configuración. Cambie estas opciones solo si está seguro de que son necesarias.
Figura 10:una prueba de conexión exitosa.
Figura 11:oportunidad de probar otros detalles o ingresar una contraseña.
Ahora que, con suerte, tiene un DSN ODBC en funcionamiento, puede configurar una conexión JDBC en IRI Workbench. Debe crear una conexión JDBC en IRI Workbench con los mismos detalles exactos que se usaron en el DSN de ODBC. La conexión ODBC DSN y JDBC se vinculará en las preferencias de IRI Workbench más adelante.
JDBC
Seleccionar controladores JDBC es un poco más fácil que ODBC, ya que los controladores JDBC no tienen arquitectura de bits. Dependiendo de cómo haya instalado el cliente ODBC de Oracle, probablemente ya tenga instalados los controladores JDBC. Busque una carpeta llamada jdbc , en la carpeta de instalación del cliente de Oracle. Dentro del jdbc la carpeta debe ser una carpeta llamada lib , con los archivos JDBC java archive (JAR) dentro. El nombre del archivo JAR a usar variará según la versión de Oracle y Java, en general, usará el archivo del controlador con un nombre como odbc8 .jar, donde el número se relacionará con la versión de Java que se está utilizando y puede ser diferente.
Si los archivos JAR aún no están instalados, ya sea por el servidor de la base de datos o por la instalación del cliente, puede buscar una descarga adecuada en el sitio web de Oracle.
Mesa de trabajo IRI
IRI Workbench es el entorno de desarrollo integrado (IDE) basado en Eclipse™ para crear, mantener y ejecutar secuencias de comandos de trabajo para todos los productos IRI. Además de trabajar con trabajos para productos IRI como CoSort, RowGen, FieldShield y NextForm, también es la principal interfaz de usuario de la plataforma Voracity que los incluye.
Una conexión JDBC dentro de IRI Workbench se usa para muchos propósitos, que incluyen:
- Examen de valores de datos para el diseño de trabajos, clasificación de datos y descubrimiento de datos.
- Tabla de navegación y estructura de esquema.
- Extracción, conversión e intercambio automático y manual de metadatos.
- Ejecutar comandos y consultas SQL y examinar los resultados.
- Extracción y carga masiva de valores de datos hacia y desde archivos planos.
- Generación de diagramas entidad relación (ER).
Hay varias formas de crear conexiones de base de datos en IRI Workbench. La forma más común es con la vista Data Source Explorer (DSE). La vista DSE es un navegador, normalmente acoplado a lo largo del borde izquierdo de la ventana IRI Workbench. Si se ha cerrado, hay dos formas sencillas de volver a abrirlo:
- En el menú principal, seleccione Ventana> Perspectiva> Restablecer perspectiva .
- En el menú principal, seleccione Ventana> Mostrar vista> Explorador de fuentes de datos .
Una conexión de base de datos en IRI Workbench se denomina Perfil de conexión , a veces reducido a solo Perfil . Para crear un nuevo perfil desde la vista DSE, seleccione Nuevo perfil de conexión de la minibarra de herramientas en la vista, como se muestra en la Figura 12.
Figura 12:botón de la barra de herramientas Nuevo perfil de conexión en DSE.
En la primera página del Nuevo perfil de conexión asistente, seleccione Oracle de la lista de Tipos de perfil de conexión . Asigne un nombre al perfil, similar al DSN. Hágalo descriptivo y evite los espacios en blanco o la puntuación innecesarios. La Figura 13 muestra esta página con el mismo nombre utilizado para el DSN de ODBC.
Figura 13:página del asistente del perfil de conexión de Oracle.
Seleccione Siguiente> para ir a la página siguiente del asistente. Deberá crear una nueva definición de controlador utilizando el botón de icono como se muestra en la Figura 14.
Figura 14:botón Nueva definición de controlador.
La Nueva definición de controlador El asistente tiene tres pestañas. En la primera pestaña, Nombre/Tipo, seleccione el controlador delgado de Oracle versión de la plantilla para que coincida con la versión de su base de datos. La figura 15 muestra la selección de la plantilla para la base de datos Oracle 18c.
Figura 15:Pestaña Nombre/Tipo de la página del asistente Nueva definición de controlador.
La segunda pestaña, Lista JAR , es para especificar el archivo de biblioteca del controlador JDBC. Seleccione el archivo JAR existente en los archivos JAR lista. Luego seleccione el botón Editar JAR/Zip a la derecha para buscar la ubicación del archivo JAR.
Encuentre la ubicación de la biblioteca de controladores JDBC de Oracle, que se analiza en la sección JDBC de este documento. La Figura 16 muestra la lista JAR pestaña después de localizar el archivo del controlador JDBC.
Figura 16:la lista JAR después de ubicar el archivo del controlador JDBC.
La tercera y última pestaña es el controlador Propiedades pestaña, que se muestra en la Figura 17. El único cambio que puede necesitar hacer en esta pestaña es agregar una barra diagonal final a la propiedad URL de conexión si aún no está presente.
Figura 17:la pestaña de propiedades del controlador con la barra diagonal final en la URL de conexión.
Seleccione el botón Aceptar para completar la definición del controlador. Ahora puede completar las propiedades de los detalles de la conexión con los mismos valores que se usaron en la Tabla 8 en la sección de creación de DSN de ODBC y seleccionar Guardar contraseña. caja.
La Figura 18 muestra la página Detalles de la conexión, todo listo para probar la Probar conexión botón. Si no ve un Éxito cuadro de mensaje, verifique los detalles en el cuadro de mensaje de error para obtener información adicional. Esto puede indicar un problema con el servidor de la base de datos, la conexión de red o los detalles de la conexión.
Figura 18:la página de detalles de la conexión completa, lista para probar la conexión a la base de datos.
Si la prueba es exitosa, puede seleccionar Finalizar y estar conectado a la base de datos. Incluso si la prueba falla, es posible que desee seleccionar Finalizar botón, esto preservará el trabajo que ha hecho hasta ahora, mientras investiga el error. Podrá editar las propiedades del perfil de conexión más tarde, solucionar cualquier problema e intentarlo de nuevo.
La Figura 19 muestra la vista DSE después de conectarse correctamente. Oracle utiliza una gran cantidad de esquemas internos y, según los privilegios otorgados a su usuario, es posible que vea bastantes esquemas además de los que tienen los valores de datos que le interesan.
El perfil de conexión se puede filtrar a nivel de esquema e incluso de tabla. Esto facilitará la localización y el trabajo con los valores de datos que le interesen.
Figura 19:vista DSE sin filtrado de esquema.
El tipo más simple de filtrado de esquema ocultará todos los esquemas excepto el que pertenece al usuario configurado. Haga clic con el botón derecho en la carpeta Esquemas para mostrar el menú contextual. Seleccione las Propiedades desde el menú contextual, como se muestra en la Figura 20.
Figura 20:selección de propiedades de esquema desde el menú contextual.
Esto mostrará las Propiedades del filtro cuadro de diálogo, que se muestra en la Figura 21. Comience por anular la selección de Deshabilitar filtro casilla de verificación cerca de la parte inferior. Luego, complete el nombre del esquema de USUARIO en el grupo Expresión en la parte superior. Seleccione el botón Aplicar y cerrar cuando haya terminado.
Esto permitirá filtrar, mostrar y procesar solo los esquemas que coincidan con la expresión. Se puede realizar un filtrado mucho más complejo. Consulte el artículo del blog de IRI Filtrado de tablas en IRI Workbench para obtener más información.
Figura 21:Filtrado de esquema simple.
Actualice la lista de esquemas desde el mismo menú contextual utilizado anteriormente. El único esquema ahora visible es el que pertenece al usuario, como se muestra en la Figura 22.
Figura 22:vista DSE después del filtrado de esquema.
Registro de conexiones de datos IRI
Todo lo que queda por hacer es reconciliar el DSN de ODBC y el perfil de conexión de JDBC. Al crear trabajos en IRI Workbench utilizando el perfil de conexión JDBC, es necesario saber qué DSN de ODBC corresponde a la misma base de datos y usuario.
Abra el Registro de conexión de datos en Preferencias seleccionando Ventana> Preferencias desde el menú principal. Vaya a IRI> Registro de conexión de datos en el árbol del lado izquierdo. La página de registro se muestra en la Figura 23.
Figura 23:página de preferencias del registro de conexión de datos.
Debe haber una fila en la tabla para cada DSN que se haya configurado en el Administrador de fuente de datos ODBC. Si no ve el DSN que coincide con su perfil de conexión de datos, intente seleccionar Actualizar botón en el lado derecho de la página.
Resalte la fila del DSN que debe asignarse a su perfil de conexión de datos, luego seleccione Editar botón en el lado derecho de la página. Esto mostrará el Registro de conexión de datos cuadro de diálogo, que se muestra en la Figura 24.
Figura 24:cuadro de diálogo Registro de conexión de datos.
Opcionalmente, puede aplicar el mismo filtro de esquema que se utilizó en el perfil de conexión de datos. Si no guarde el nombre de usuario o la contraseña en el DSN, puede guardarlo opcionalmente en este cuadro de diálogo. El único obligatorio la información de este cuadro de diálogo es el Perfil de conexión en el fondo.
Seleccione el botón Aceptar cuando haya terminado. Asegúrese de que la casilla de verificación en Activo seleccione la columna, como se muestra en la Figura 25, y luego seleccione Aplicar y cerrar botón.
Figura 25:entrada DSN correctamente configurada en el Registro de conexión de datos.
Felicitaciones, ahora está listo para comenzar a trabajar con los datos en su base de datos Oracle conectada. Consulte esta página de índice de artículos de blog de instrucciones sobre cómo trabajar con datos de Oracle (y otros) de IRI Workbench.
Glosario