Opções de Configuração de SQL Especial

Configure o esssql.cfg no domínio do Essbase quando quiser se conectar a um banco de dados usando drivers ODBC não incluídos pela Oracle com o Essbase ou quando quiser alterar as configurações padrão para qualquer um dos drivers distribuídos com o Essbase.

Caso de Uso

Um caso de uso que requer uma alteração nas configurações padrão é quando você precisa ativar carregamentos de dados SQL multithread (que não são iguais aos carregamentos de dados paralelos) usando qualquer driver (seja JDBC, ODBC, incluído no Essbase ou não incluído no Essbase). Por exemplo, ao carregar dados SQL em cubos de armazenamento agregado, você pode usar até oito arquivos de regra para carregar dados em paralelo. Cada arquivo de regra deve incluir as mesmas informações de autenticação (nome de usuário e senha SQL).

O Essbase inicializa vários buffers de carregamento de dados de armazenamento agregado temporário (um para cada arquivo de regras), em que os valores de dados são classificados e acumulados. Quando os dados são totalmente carregados nos buffers de carregamento de dados, o Essbase faz commit do conteúdo de todos os buffers no cubo em uma operação, o que é mais rápido do que fazer commit dos buffers individualmente.

No exemplo MaxL a seguir, os dados SQL são carregados de dois arquivos de regras (regra1.rul e regra2.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";

Alterar a Configuração SQL

Para ativar carregamentos de dados multithread de origens SQL externas, como no caso de uso acima, você deve alterar as configurações padrão para os drivers distribuídos com o Essbase, modificando esssql.cfg. Caso contrário, os usuários simultâneos que tentam carregar dados encontrarão um erro como: ERROR - 1021025 - SQL driver [driverLibrary] for [DriverName] is in use already and does not allow multiple connections. Please try later.

Você também precisa adicionar entradas ao esssql.cfg quando quiser se conectar a um banco de dados usando drivers ODBC não incluídos pela Oracle com o Essbase.

Para alterar as definições de configuração SQL,

  1. Localize o arquivo de configuração SQL no domínio do Essbase: 

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

  2. Salve uma cópia do arquivo com outro nome. Por exemplo, faça uma cópia chamada esssql_cfg.orig.

  3. Abra o esssql.cfg para edição.

    Você configura esse arquivo usando vários blocos (um para cada driver). Os blocos são delineados por colchetes []. Você pode copiar e colar um bloco e editar as configurações conforme necessário para cada driver.

  4. Faça as alterações necessárias, dependendo das suas necessidades, e salve o arquivo. Consulte as Opções de nesssql.cfg abaixo. Para ativar operações com vários threads, por exemplo, altere o valor de SingleConnection para 0.

  5. Interrompa e reinicie o servidor do Essbase, conforme descrito em Iniciar, Interromper e Verificar Servidores.

Arquivo esssql.cfg de Amostra

O exemplo a seguir esssql.cfg tem 6 blocos de configuração. O primeiro está lá por padrão, e os próximos cinco são adicionados como exemplos de configuração de diferentes origens para permitir cargas de dados 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 o DriverName do Teradata, você pode usar TDATA ou TDATAODBC_SB64.

Opções esssql.cfg

O arquivo de configuração esssql.cfg deve conter pelo menos o nome do arquivo de driver (DriverName). Opcionalmente, pode incluir uma descrição (Descrição). O arquivo de configuração pode conter palavras-chave adicionais, cujos valores são 0 ou 1.

Para localizar o DriverName no Linux, procure em odbcinst.ini, localizado em 
<Essbase Product Home>/modules/<driver class>/<driver version>
O nome do driver está no final do caminho fornecido para o driver.

Por exemplo, na seguinte entrada em odbcinst.ini, sabemos que o nome do driver é ARora (não é necessário incluir as informações de versão, 28): 

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

Para localizar o DriverName no Windows, procure no utilitário Administrador de fonte de dados ODBC de 64 bits do Windows, na guia Drivers.


Ferramenta Administrador de fonte de dados ODBC com guia Drivers selecionada. O Oracle 8.0 Oracle Wire Protocol está destacado. Seu nome de arquivo de driver é ARORA28.DLL.

Palavra-chave Valor Valor = 0 Valor = 1
Descrição (Opcional) Uma descrição do driver, entre aspas duplas. O valor padrão é "" N/D N/D
Nome do Driver (Obrigatório) O nome do arquivo do driver; por exemplo, ARORA N/D N/D
UserId 0 ou 1 ID do Usuário não obrigatório (padrão) ID do Usuário obrigatório
Senha 0 ou 1 Senha não obrigatória (padrão) Senha necessária
Banco de dados 0 ou 1 Nome do banco de dados não obrigatório (padrão) É obrigatório o nome do banco de dados
Servidor 0 ou 1 Nome do servidor não obrigatório (padrão) Nome do servidor obrigatório
Aplicativos 0 ou 1 Nome do aplicativo não obrigatório (padrão) Nome do aplicativo obrigatório
Dicionário 0 ou 1 Nome do dicionário não obrigatório (padrão) Nome do dicionário obrigatório
Arquivos 0 ou 1 Nome do arquivo não obrigatório (padrão) Nome de arquivo obrigatório
Conexão Única 0 ou 1 Thread-safe do driver -- Várias conexões ativas permitidas Driver não thread-safe -- Uma conexão ativa permitida
IsQEDriver 0 ou 1 O driver não foi enviado com o Essbase (padrão) O driver é enviado com o Essbase
ConverterUTF16toUTF8 0 ou 1 Nenhuma conversão de dados UTF16 para UTF8 (este é o padrão). Converta dados codificados em UTF16 de uma origem de dados do Oracle BI em UTF8. Isso é necessário no UNIX para carregamentos de dados SQL no Essbase do OBI.

Os padrões se aplicam a valores não especificados. Os padrões aplicados nos arquivos de configuração diferem dos valores padrão do Essbase que se aplicam se nenhum arquivo esssql.cfg existir.

Palavras-chave e valores devem ser separados por pelo menos um espaço, e o conjunto de palavras-chave e valores para cada driver deve estar entre colchetes ( [ ] ).

Drivers diferentes podem exigir valores adicionais. Consulte a documentação do driver para obter informações específicas.