Opciones especiales de configuración de SQL

Configure esssql.cfg en el dominio de Essbase cuando desee conectarse a una base de datos mediante controladores ODBC no incluidos por Oracle con Essbase o cuando desee cambiar la configuración predeterminada de cualquiera de los controladores que se distribuyen con Essbase.

Caso de uso

Un caso de uso que requiere un cambio en la configuración predeterminada es cuando necesita activar cargas de datos SQL multithread (que no son las mismas que las cargas de datos paralelas) mediante cualquier controlador (ya sea JDBC, ODBC, incluido con Essbase o no incluido con Essbase). Por ejemplo, al cargar datos SQL en cubos de almacenamiento agregado, puede utilizar hasta ocho archivos de reglas para cargar datos en paralelo. Cada archivo de reglas debe incluir la misma información de autenticación (nombre de usuario y contraseña SQL).

Essbase inicializa varios buffers de carga de datos de almacenamiento agregado temporal (uno para cada archivo de reglas), donde los valores de datos se ordenan y acumulan. Cuando los datos se cargan completamente en los buffers de carga de datos, Essbase confirma el contenido de todos los buffers en el cubo en una operación, que es más rápido que la confirmación de buffers individualmente.

En el siguiente ejemplo de MaxL, los datos SQL se cargan desde dos archivos de reglas (rule1.rul y rule2.rul):

import database AsoSamp.Basic data 
   connect as TBC identified by 'password' 
   using multiple rules_file 'rule1' , 'rule2' 
   to load_buffer_block starting with buffer_id 100 
   on error write to "error.txt";

Cambiar la configuración de SQL

Para activar cargas de datos multithread desde orígenes SQL externos como en el caso de uso anterior, debe cambiar la configuración predeterminada de los controladores que se distribuyen con Essbase modificando esssql.cfg. De lo contrario, los usuarios simultáneos que intenten cargar datos encontrarán un error como: ERROR - 1021025 - SQL driver [driverLibrary] for [DriverName] is in use already and does not allow multiple connections. Please try later.

También debe agregar entradas a esssql.cfg cuando desee conectarse a una base de datos mediante controladores ODBC no incluidos por Oracle con Essbase.

Para cambiar los valores de configuración de SQL,

  1. Busque el archivo de configuración SQL en el dominio de Essbase: 

    <DOMAIN HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg

  2. Guarde una copia del archivo con un nombre diferente. Por ejemplo, realice una copia denominada esssql_cfg.orig.

  3. Abra esssql.cfg para su edición.

    Este archivo se configura mediante varios bloques (uno para cada controlador). Los bloques se delimitan entre corchetes []. Puede copiar y pegar un bloque, y editar la configuración según sea necesario para cada controlador.

  4. Realice los cambios necesarios, según sus necesidades, y guarde el archivo. Consulte esssql.cfg Options a continuación. Para activar operaciones multithread, por ejemplo, cambie el valor de SingleConnection a 0.

  5. Detenga y reinicie el servidor de Essbase, como se describe en Iniciar, Detener y Comprobar servidores.

Ejemplo de archivo esssql.cfg

El siguiente ejemplo esssql.cfg tiene 6 bloques de configuración. La primera está ahí por defecto, y las cinco siguientes se agregan como ejemplos de configuración de diferentes orígenes para activar cargas de datos SQL multithread. 

[
Description "Oracle BI Server"
DriverName libnqsodbc
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 0
ConvertUTF16toUTF8 1
]
[
Description "SQL Server"
DriverName SQLSRV
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 0
]
[
Description "Oracle SQL Server Wire Protocol"
DriverName ARSQLS
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 1
]
[
Description "Oracle DB2 Wire Protocol"
DriverName ARDB2
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 1
]
[
Description "Oracle MySQL Wire Protocol"
DriverName ARMYSQL
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 1
]
[
Description "Teradata"
DriverName TDATAODBC_SB64
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 0
]

Para Teradata DriverName, puede utilizar TDATA o TDATAODBC_SB64.

Opciones de esssql.cfg

El archivo de configuración esssql.cfg debe contener al menos el nombre de archivo del controlador (DriverName). Opcionalmente, puede incluir una descripción (Descripción). El archivo de configuración puede contener palabras clave adicionales, cuyos valores son 0 o 1.

Para buscar DriverName en Linux, busque en odbcinst.ini, ubicado en 
<Essbase Product Home>/modules/<driver class>/<driver version>
El nombre del controlador se encuentra al final de la ruta proporcionada para el controlador.

Por ejemplo, desde la siguiente entrada en odbcinst.ini, sabemos que el nombre del controlador es ARora (no es necesario incluir la información de la versión, 28): 

Driver=/scratch/username/oracle_home/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARora28.so

Para encontrar DriverName en Windows, consulte la utilidad Administrador de fuentes de datos ODBC de Windows de 64 bits en la ficha Controladores.


Herramienta ODBC Data Source Administrator con el separador Drivers seleccionado. Oracle 8.0 Oracle Wire Protocol está resaltado. Su nombre de archivo de controlador es ARORA28.DLL.

Palabra clave Valor Valor = 0 Valor = 1
Descripción (Opcional) Descripción del controlador, entre comillas dobles. El valor por defecto es "" No disponible No disponible
Nombre de controlador (Obligatorio) Nombre del archivo del controlador; por ejemplo ARORA No disponible No disponible
UserId 0 o 1 El ID de usuario no es necesario (por defecto) El ID de usuario es necesario
Contraseña 0 o 1 Contraseña no necesaria (valor por defecto) Contraseña Necesaria
Base de datos 0 o 1 No se necesita el nombre de bases de datos (valor por defecto) Se necesita el nombre de la base de datos
Servidor 0 o 1 No se necesita el nombre del servidor (valor por defecto) Es necesario el nombre del servidor
Aplicación 0 o 1 No es necesario el nombre de aplicación (valor por defecto) Se necesita el nombre de la aplicación
Diccionario 0 o 1 No se necesita el nombre del diccionario (por defecto) Se necesita el nombre del diccionario
Archivos 0 o 1 No es necesario el nombre del archivo (valor por defecto) Se necesita el nombre del archivo
Conexión única 0 o 1 Seguridad de subprocesos del controlador -- Se permiten varias conexiones activas Controlador no seguro para thread -- Se permite una conexión activa
IsQEDriver 0 o 1 El controlador no se incluye con Essbase (predeterminado) El controlador se envía con Essbase
ConvertirUTF16toUTF8 0 o 1 Sin conversión de datos UTF16 a UTF8 (este es el valor por defecto). Convertir datos codificados en UTF16 de un origen de datos de Oracle BI en UTF8. Esto es necesario en UNIX para las cargas de datos SQL en Essbase desde OBI.

Los valores por defecto se aplican a valores que no se han especificado. Los valores predeterminados aplicados en los archivos de configuración difieren de los valores predeterminados de Essbase que se aplican si no existe ningún archivo esssql.cfg.

Las palabras clave y los valores deben estar separados por al menos un espacio, y el juego de palabras clave y valores para cada controlador debe estar entre corchetes ( [ ] ).

Los distintos controladores pueden requerir valores adicionales. Consulte la documentación del controlador para obtener información específica.