Criar Ligações e Origens de Dados para Drivers JDBC Genéricos

Utilize este fluxo de trabalho para permitir ao Essbase ligar a qualquer origem de dados de JDBC, utilizando os drivers que carregar para o Essbase Server.

Se for o administrador da implementação do Essbase, pode configurar o Essbase para utilizar os drivers preferidos que carregar para o Essbase Server. A Oracle testou a conectividade de JDBC do Essbase utilizando drivers Oracle. Para utilizar drivers JDBC de outros fornecedores, consulte a documentação do driver para saber quais os requisitos para especificar o URL e as credenciais da sua origem de dados de JDBC. Para quaisquer passos relacionados com o desempenho, consulte a documentação sobre JDBC do fornecedor.

Nota:

Certifique-se de que o driver JDBC que utiliza com o Essbase respeita o método setFetchSize para controlar a memória utilizada ao processar o conjunto de resultados. Para um desempenho ótimo dos processos de carregamento de dados e de criação de dimensões, o Essbase extrai 1000 registos por chamada de rede.

Para configurar o Essbase para utilizar drivers JDBC genéricos,

Ligue ao Essbase Server utilizando SSH.
Crie manualmente um diretório drivers na <Página Principal do Produto Essbase> na instância do servidor.

Certifique-se de que drivers está totalmente em minúsculas, uma vez que o percurso é sensível a maiúsculas/minúsculas.
A partir do site do fornecedor, descarregue os JARs do driver JDBC que pretende utilizar.

O driver JDBC do Oracle Database suportado pelo Essbase é ojdbc8.jar.

Se utilizar o Autonomous Data Warehouse, necessita de descarregar o arquivo completo (ojdbc8-full.tar.gz) que contém o driver Oracle JDBC Thin e os JARs associados.
Carregue os jars do driver JDBC para o diretório drivers na instância do Essbase.

Carregue apenas uma versão de cada driver da base de dados para o diretório drivers. Por exemplo, não carregue simultaneamente sqljdbc41.jar e sqljdbc42.jar. Se o fizer, o Essbase irá utilizar o mais antigo (uma vez que aparece primeiro no CLASSPATH).

Se utiliza o Autonomous Data Warehouse, extraia o arquivo (ojdbc8-full.tar.gz) e desloque todo o conteúdo diretamente para o diretório drivers (não para uma subpasta).
Crie ligações aos drivers JDBC.
1. Na interface web do Essbase, clique em Origens, em seguida, em Ligações.
  
  Ou, para definir a ligação e a Origem de Dados ao nível da aplicação e não globalmente, comece na página Aplicações em vez de na página Origens, clique num nome de aplicação e, em seguida, clique em Origens.
2. Clique em Criar Ligação e selecione JDBC.
  
  Para encontrar o driver JDBC, o Essbase procura na pasta drivers. Se não for encontrado nenhum ficheiro jar, o Essbase devolve um erro Classe Não Encontrada (ou falha ao carregar o driver) quando testar a ligação.
3. No ecrã Criar Ligação,
  1. Forneça um nome para a ligação de JDBC. Por exemplo, Oracle JDBC.
  2. No campo URL, forneça a cadeia de caracteres de ligação de JDBC. Por exemplo, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Obtenha a cadeia de caracteres de ligação de JDBC a partir do fornecedor de JDBC.
    
    O formato de sintaxe acima aplica-se apenas ao Oracle Database. Consulte Mais Exemplos de Ligação para Drivers JDBC Genéricos se estiver a trabalhar com outros fornecedores.
  3. Para os campos Utilizador e Senha, introduza as credenciais de um utilizador autorizado a aceder à base de dados.
  4. No campo Driver, forneça o nome da classe totalmente qualificado do driver JDBC. Por exemplo, oracle.jdbc.driver.OracleDriver.
  Para drivers Oracle, especifique o URL utilizando as seguintes diretrizes de sintaxe:
  - Se o Oracle Database estiver registado num listener, pode utilizar o Nome do Serviço no URL em vez da SID, utilizando a sintaxe abreviada jdbc:oracle:thin:@<host>:<port>/<servicename>. Exemplo:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - O exemplo seguinte utiliza o Nome do Serviço com a sintaxe longa.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Para utilizar a ID do Sistema (SID) Oracle que identifica a base de dados de modo exclusivo, utilize a sintaxe jdbc:oracle:thin:@<host>:<port>:<SID>. Por exemplo,
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Se estiver a utilizar o Autonomous Data Warehouse, na sintaxe do URL, deve incluir a variável de ambiente TNS_ADMIN especificando o percurso para o wallet. O wallet pode estar em qualquer local no Essbase Server, mas deve fornecer o percurso completo, utilizando uma sintaxe semelhante a jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Exemplo do Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Exemplo do Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Exemplo numa Implementação do OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Os exemplos acima funcionam apenas para o Oracle Database. Consulte Mais Exemplos de Ligação para Drivers JDBC Genéricos se estiver a trabalhar com outros fornecedores.
4. Clique em Testar para validar a ligação e, em caso de êxito, clique em Criar.
5. Certifique-se de que a ligação foi criada com êxito e que aparece na lista de ligações.
Crie Origens de Dados através de ligações do driver JDBC genérico.
1. Clique em Origens de Dados e clique em Criar Origem de Dados.
2. Na caixa de lista pendente Ligação, selecione o nome da ligação que acabou de criar; por exemplo, Oracle JDBC. As ligações ao nível da aplicação têm como prefixo o nome da aplicação, no formato appName.connectionName.
3. Forneça um nome para a Origem de Dados; por exemplo, OracleDB_Datasource.
4. Opcionalmente, introduza uma descrição da Origem de Dados; por exemplo, SAMPLE_BASIC_TABLE on Oracle Database.
5. No campo Consulta, forneça a consulta de SQL adequada que seleciona os dados que pretende disponibilizar nesta Origem de Dados.
6. Clique em Seguinte. Se a instrução de SQL estiver correta para consultar uma tabela, as colunas consultadas são preenchidas.
7. Altere quaisquer colunas numéricas para Double e clique em Seguinte.
8. Altere quaisquer parâmetros adicionais específicos da origem, se aplicável, e clique em Seguinte. Para informações sobre a utilização de parâmetros, consulte Implementar Parâmetros para Origens de Dados.
9. Reveja a secção de pré-visualização. Deverá ver os resultados da consulta que extrai colunas de dados da origem externa.
10. Se a pré-visualização parecer correta, clique em Criar para terminar de criar a Origem de Dados.