Creación de conexiones y orígenes de datos para controladores de JDBC genéricos

Use este flujo de trabajo para permitir que Essbase se conecte a cualquier origen de datos de JDBC utilizando controladores que se cargan en el servidor de Essbase.

Si es el administrador de despliegues de Essbase, puede configurar Essbase para usar los controladores que prefiera y cargarlos en la máquina servidor de Essbase. Oracle ha probado la conectividad JDBC de Essbase mediante controladores de Oracle. Para usar controladores de JDBC de otros proveedores, compruebe la documentación del controlador para ver los requisitos al especificar la URL y las credenciales del origen de datos de JDBC. Para cualquier paso relacionado con el rendimiento, consulte la documentación del proveedor JDBC.

Nota:

Asegúrese de que el controlador de JDBC que utiliza con Essbase utiliza correctamente el método setFetchSize para controlar la memoria utilizada durante el procesamiento del resultado establecido. Para que el rendimiento de la carga de datos y los procesos de creación de dimensiones sean óptimos, Essbase recupera 1000 registros por cada llamada de red.

Para configurar Essbase para que use controladores de JDBC genéricos:

Conéctese a la máquina servidor de Essbase mediante SSH.
Cree manualmente un directorio drivers en <Directorio raíz del producto de Essbase> en la instancia del servidor.

Asegúrese de que drivers esté escrito en minúsculas, ya que la ruta es sensible a mayúsculas/minúsculas.
Descargue los archivos JAR del controlador de JDBC que desee usar del sitio del proveedor.

El controlador de JDBC de Oracle Database que soporta Essbase es ojdbc8.jar.

Si usa Autonomous Data Warehouse, tendrá que descargar el archivo completo (ojdbc8-full.tar.gz) que contiene el controlador Thin de JDBC de Oracle y los archivos JAR complementarios.
Cargue los archivos JAR de JDBC en el directorio drivers de la instancia de Essbase.

Cargue solo una versión de cada controlador de la base de datos en el directorio drivers. Por ejemplo, no cargue sqljdbc41.jar y sqljdbc42.jar. De lo contrario, Essbase usará el más antiguo (dado que aparece primero en CLASSPATH).

Si usa Autonomous Data Warehouse, extraiga el archivo (ojdbc8-full.tar.gz) y mueva todo el contenido directamente al directorio drivers (no a una subcarpeta).
Cree conexiones a los controladores de JDBC.
1. En la interfaz web de Essbase, haga clic en Orígenes y, después, en Conexiones.
  
  Para definir la conexión y el origen de datos en el nivel de aplicación en vez de hacerlo de forma global, comience desde la página Aplicaciones en lugar de la página Orígenes, haga clic en un nombre de aplicación y, a continuación, haga clic en Orígenes.
2. Haga clic en Crear conexión y seleccione JDBC.
  
  Para encontrar el controlador de JDBC, Essbase busca en la carpeta drivers. Si no se encuentran archivos jar, Essbase devuelve un error de "No se ha encontrado la clase" (o no carga el controlador) al probar la conexión.
3. En la pantalla Crear conexión,
  1. Introduzca un nombre para la conexión de JDBC. Por ejemplo, Oracle JDBC.
  2. En el campo URL, proporcione la cadena de conexión de JDBC. Por ejemplo, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Obtenga la cadena de conexión de JDBC a partir del proveedor de JDBC.
    
    El formato de sintaxis anterior solo se aplica para Oracle Database. Consulte Más ejemplos de conexión para los controladores JDBC genéricos si trabaja con otros proveedores.
  3. En los campos Usuario y Contraseña, introduzca las credenciales de un usuario que esté autorizado a acceder a la base de datos.
  4. En el campo Controlador, introduzca el nombre de clase completo del controlador de JDBC. Por ejemplo, oracle.jdbc.driver.OracleDriver.
  Para los controladores de Oracle, especifique la URL mediante las siguientes directrices de sintaxis:
  - Si Oracle Database se registra con un listener, puede utilizar el Nombre del servicio en la URL en lugar del SID mediante la sintaxis corta jdbc:oracle:thin:@<host>:<port>/<servicename>. Ejemplo:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - En el siguiente ejemplo se usa el Nombre del servicio con la sintaxis larga.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Para usar el ID del sistema de Oracle (SID) que identifica la base de datos de forma exclusiva, utilice la sintaxis jdbc:oracle:thin:@<host>:<port>:<SID>. Por ejemplo,
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Si usa Autonomous Data Warehouse, en la sintaxis de la URL debe incluir la variable de entorno TNS_ADMIN especificando la ruta a la cartera. La cartera puede estar en cualquier lugar del equipo del servidor de Essbase, pero debe proporcionar la ruta completa con una sintaxis como jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Ejemplo en Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Ejemplo en Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Ejemplo en un despliegue de OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Los ejemplos anteriores solo funcionan para Oracle Database. Consulte Más ejemplos de conexión para los controladores JDBC genéricos si trabaja con otros proveedores.
4. Haga clic en Probar para validar la conexión y, si es correcta, haga clic en Crear.
5. Compruebe que la conexión se ha creado correctamente y que aparece en la lista de conexiones.
Cree orígenes de datos en las conexiones de controladores de JDBC genéricas.
1. Haga clic en Orígenes de datos y, a continuación, en Crear origen de datos.
2. En el cuadro desplegable Conexión, seleccione el nombre de la conexión que acaba de crear; por ejemplo, Oracle JDBC. Las conexiones de nivel de aplicación están prefijadas con el nombre de la aplicación, con el formato appName.connectionName.
3. Proporcione un nombre para el origen de datos, por ejemplo, OracleDB_Datasource.
4. Opcionalmente, introduzca una descripción del origen de datos; por ejemplo, SAMPLE_BASIC_TABLE on Oracle Database.
5. En el campo Consulta, proporcione la consulta SQL apropiada y seleccione los datos que desea que estén disponibles en este origen de datos.
6. Haga clic en Siguiente. Si la sentencia SQL para consultar una tabla es correcta, las columnas consultadas se rellenan.
7. Cambie cualquier columna a Doble y haga clic en Siguiente.
8. Si es necesario, cambie cualquier parámetro adicional específico del origen y haga clic en Siguiente. Para obtener información sobre el uso de los parámetros, consulte Implantación de parámetros para orígenes de datos.
9. Revise el panel de vista previa. Debería ver los resultados de la consulta recuperando columnas de datos desde el origen externo.
10. Si la vista previa es correcta, haga clic en Crear para terminar de crear el origen de datos.