Criar Dimensões e Carregar Dados por Streaming com Base em um Banco de Dados Remoto

Se os dados ou dimensões que você deseja carregar para um cubo estiverem em um banco de dados remoto, você poderá usar a opção stream na CLI (Interface de Linha de Comando) do Essbase para enviar os dados ou os membros para seu cubo,

Ao usar a opção stream para os comandos dataload ou dimbuild da CLI, você também deverá fazer referência a uma conexão JDBC salva que reflita o driver e as strings de conexão.

Antes de Começar

  1. O arquivo de regra de carregamento deve existir no diretório do cubo.

  2. A consulta do banco de dados usada para carregar dados ou criar dimensões deve ter a mesma dimensionalidade que as colunas na regra de carregamento (em outras palavras, a ordem das dimensões na regra deve corresponder à ordem das dimensões na consulta SQL).

Limites

  • Não há suporte para variáveis de substituição nas instruções SQL usadas em regras de carregamento.

  • Só use funções SQL que sejam suportadas pelo JDBC. Não há suporte para funções escalares ODBC na CLI.

Workflow para Criações de Dimensão de Streaming e Dados

  1. Crie uma string salva da conexão JDBC que reflita as strings do driver e da conexão da sua origem de dados, usando o comando createlocalconnection da CLI.

  2. (Não é necessário para banco de dados Oracle) Defina uma variável de ambiente EXTERNAL_CLASSPATH para indicar o arquivo .jar para o seu driver de banco de dados. Consulte a seção Exemplos de Variáveis de Ambiente EXTERNAL_CLASSPATH neste tópico.

  3. Execute o comando dataload ou dimbuild da CLI com a opção de streaming, fornecendo o nome de conexão salvo.

    Opcionalmente, você pode especificar a consulta de banco de dados no comando dataload ou dimbuild. Caso contrário, você poderá especificá-lo na regra de carregamento (em Propriedades SQL).

Exemplos de Definição da Variável de Ambiente EXTERNAL_CLASSPATH

Defina a variável do ambiente EXTERNAL_CLASSPATH para que você possa fazer stream de qualquer fonte de dados diferente do Oracle Database. Defina a variável para apontar para o local do arquivo .jar do driver do banco.

DB2

Defina a variável EXTERNAL_CLASSPATH para apontar para o local do arquivo jar do driver DB2.

Exemplo de C Shell

setenv EXTERNAL_CLASSPATH /scratch/db/jars/db2jcc.jar

Exemplo de Shell Korn ou Bash

export EXTERNAL_CLASSPATH=/scratch/db/jars/db2jcc.jar

Exemplo do Windows

set EXTERNAL_CLASSPATH=C:\db\jars\db2jcc.jar

MySQL

Defina a variável EXTERNAL_CLASSPATH para apontar para a localização do arquivo jar do driver MySQL.

Exemplo de C Shell

setenv EXTERNAL_CLASSPATH /scratch/db/jars/mysql-connector-java-5.1.43-bin.jar

Exemplo de Shell Korn ou Bash

export EXTERNAL_CLASSPATH=/scratch/db/jars/mysql-connector-java-5.1.43-bin.jar

Exemplo do Windows

set EXTERNAL_CLASSPATH=C:\db\jars\mysql-connector-java-5.1.43-bin.jar

Microsoft SQL Server

Defina a variável EXTERNAL_CLASSPATH para apontar para o local do arquivo jar do driver do SQL Server.

Exemplo de C Shell

setenv EXTERNAL_CLASSPATH /scratch/db/jars/sqljdbc4-3.0.jar

Exemplo de Shell Korn ou Bash

export EXTERNAL_CLASSPATH=/scratch/db/jars/sqljdbc4-3.0.jar

Exemplo do Windows

set EXTERNAL_CLASSPATH=C:\db\jars\sqljdbc4-3.0.jar

Teradata

Defina a variável EXTERNAL_CLASSPATH para apontar para a localização de ambos os arquivos jar de driver do Teradata.

Exemplo de C Shell

setenv EXTERNAL_CLASSPATH /scratch/db/jars/tdgssconfig.jar:/scratch/db/jars/terajdbc4.jar

Exemplo de Shell Korn ou Bash

export EXTERNAL_CLASSPATH=/scratch/db/jars/tdgssconfig.jar:/scratch/db/jars/terajdbc4.jar

Exemplo do Windows

set EXTERNAL_CLASSPATH=C:\db\jars\tdgssconfig.jar;C:\db\jars\terajdbc4.jar