[AIX Solaris HP-UX Linux Windows]

Criando uma Origem de Dados que Utiliza o Driver JDBC do Oracle para OCI

É possível usar o driver Oracle JDBC for OCI com a Versão 7.0 e mais recente do Application Server.

Sobre Esta Tarefa

Para criar uma origem de dados no Application Server que tire vantagem da Oracle Call Interface (OCI), ou recursos Oracle que requerem que a OCI seja usada, deve-se usar as bibliotecas nativas do Oracle JDBC OCI. Qualquer tipo de provedor Oracle JDBC pode ser configurado com o Application Server para usar a OCI.

Procedimento

  1. No console administrativo, crie o provedor JDBC.
    1. Clique em Recursos, expandaJDBC e clique em Provedores JDBC.
    2. Selecione o escopo para o Provedor JDBC. O escopo pode ser configurado para uma nível de célula, nó ou servidor.
    3. Clique em Novo para criar o Provedor JDBC.
  2. Configure as definições para o provedor JDBC. Esse provedor pode ser usado para criar origens de dados que usam OCI ou URLs thin. O tipo usado depende do que é especificado na URL. Esse provedor não pode ser usado com o carregador de classes isolado quando usado com a OCI.
    1. Selecione Oracle para o tipo de banco de dados no painel Etapa 1: Criar Novo Provedor JDBC.
    2. Selecione um driver Oracle JDBC para o tipo de provedor no painel Etapa 1: Criar novo provedor JDBC.
    3. Selecione Origem de dados do conjunto de conexões ou Origem de dados XA para o tipo de implementação no painel Etapa 1: Criar novo provedor JDBC.
    4. Especifique um nome e, opcionalmente, uma descrição, para o provedor JDBC.
    5. Clique em Avançar.
    6. Especifique um local de diretório para o arquivo Java archive (JAR) ojdbc6.jar ou ojdbc7.jar (se você estiver executando o Java 7 ou mais recente) no painel Etapa 2: Inserir propriedades específicas do banco de dados para a origem de dados.
      Boas Práticas Boas Práticas: Uma variável do Application Server pode ser usada no caminho da classe.

      Por exemplo, é possível usar a variável ${ORACLE_JDBC_DRIVER_PATH} no campo para o caminho da classe, mas deve-se definir a variável ORACLE_JDBC_DRIVER_PATH para o Application Server. É possível configurar o valor dessa variável nesta etapa para o diretório no qual o JAR ojdbc está instalado. Como alternativa, depois de criar o provedor, é possível no nível do escopo apropriado, definir ou mudar essa variável no console administrativo clicando em Ambiente > Gerenciar variáveis do WebSphere. Configure seu valor para o diretório no qual o arquivo JAR ojdbc está instalado.

      Por exemplo, o campo de caminho da classe poderia conter ${ORACLE_JDBC_DRIVER_PATH}/ojdbc6.jar e o campo de local do diretório poderia conter /root/InstantClient/12.1.0.1.0.

      bprac
    7. Clique em Avançar.
    8. Revise a configuração no painel Resumo e clique em Concluir. Se precisar fazer mudanças na configuração, selecione a nova configuração no próximo painel, faça suas mudanças e clique em Aplicar.
  3. Crie a origem de dados no Servidor de Aplicativos.
    1. Clique em Recursos, expanda JDBC e clique em Provedores JDBC > provider_name.
    2. Em Propriedades Adicionais, clique em Origens de Dados > Novo.
    3. Especifique o nome para a origem de dados no painel Etapa 1: Inserir informações básicas da origem de dados.
    4. Especifique o nome JNDI para a origem de dados no painel Etapa 1: Inserir informações básicas da origem de dados.
    5. Clique em Avançar.
    6. Especifique a URL do banco de dados do qual a origem de dados obtém conexões. Especifique essas informações no painel Etapa 2: Inserir propriedades específicas do banco de dados para a origem de dados.
      Para um driver OCI, um destes exemplos poderia ser usado:
      jdbc:oracle:oci:@//mySystem:1521/sample
      jdbc:oracle:oci:@sample
    7. Selecione o nome da classe auxiliar do armazém de dados que corresponde ao tipo de provedor JDBC configurado. Selecione essas informações no painel Etapa 2: Inserir propriedades específicas do banco de dados para a origem de dados.
    8. Clique em Avançar.
    9. Opcional: Especifique os valores para os aliases de segurança associados.
    10. Clique em Avançar.
    11. Revise a configuração no painel Resumo e clique em Concluir. Se precisar fazer mudanças na configuração, selecione a nova configuração no próximo painel, faça suas mudanças e clique em Aplicar.
    12. Salve a configuração.
    13. Execute uma conexão de teste. Se o teste funcionar, a configuração está pronta. Se o teste falhar com erros de ligação, continue com a próxima etapa.
  4. Opcional: Configure o caminho da biblioteca nativa no Provedor JDBC, configure as variáveis de ambiente do S.O ou configure as variáveis de ambiente no servidor.
    1. Primeiro, tente configurar o caminho da biblioteca nativa no provedor JDBC e, em seguida, execute uma conexão de teste. Para configurar o caminho da biblioteca nativa:
      1. Edite o Provedor JDBC
      2. Preencha o Caminho da biblioteca nativa com o caminho para as bibliotecas nativas do driver Oracle JDBC. Esse pode ser o mesmo caminho que você usou para o caminho da classe.
      Boas Práticas Boas Práticas: Uma variável do Application Server pode ser usada no caminho da biblioteca nativa.

      Por exemplo, se o caminho da classe e o caminho da biblioteca nativa forem iguais, é possível usar a variável que foi usada para o caminho da classe ou uma variável como ${ORACLE_HOME} no campo para o caminho da biblioteca nativa. Deve-se definir, então, a variável ORACLE_HOME para o Application Server. No nível do escopo apropriado, defina ou mude essa variável no console administrativo clicando em Ambiente > Gerenciar variáveis do WebSphere e configure seu valor para o diretório no qual as bibliotecas do cliente nativo Oracle estão instaladas.

      Por exemplo, o campo poderia conter ${ORACLE_HOME}/lib se lib estivesse onde as bibliotecas nativas estão instaladas.

      bprac
    2. Se ainda houver falhas de ligação, o caminho para as bibliotecas nativas do cliente Oracle deve ser configurado no ambiente do S.O no qual o WebSphere Application Server está em execução ou ser configurado nas entradas de ambiente para o servidor. A variável de ambiente a ser configurada é específica para o tipo de plataforma. Esses itens podem já estar configurados como parte do processo de instalação do Oracle.
      • AIX: LIBPATH
      • HP-UX: SHLIBPATH
      • Linux/Solaris: LD_LIBRARY_PATH
      • WINDOWS: PATH
    3. A variável TNS_ADMIN pode precisar ser configurada para o caminho que contém arquivos, como tnsnames.ora ou sglnet.ora. Por exemplo, se o tnsnames.ora contiver serviços TNS que são usados em uma URL, como jdbc:oracle:thin:@mydb.
    4. Para configurar variáveis no ambiente do S.O., siga as instruções para a plataforma. Por exemplo, para AIX, o seguinte pode ser usado:
      export LIBPATH=/InstantClient:$LIBPATH
      export TNS_ADMIN=/InstantClient
    5. Para configurar variáveis no servidor, use as entradas de ambiente. Por exemplo, utilizando o Administrative Console:
      1. Servidores de aplicativos > myServer.
      2. Selecione a guia Configuração.
      3. Em Infraestrutura do servidor, expanda Gerenciamento de Java e processo.
      4. Selecione Definição de processo e, em seguida, em Propriedades adicionais, selecione Entradas de ambiente.
      5. Inclua um par de nome e valor para cada variável de ambiente a ser configurada.
    6. Depois de configurar as variáveis de ambiente apropriadas, tente testar a conexão novamente.
  5. Será necessário reiniciar o servidor antes de usar a origem de dados em um aplicativo.

O que Fazer Depois

Observe os itens a seguir:
  1. O nível de bit do Instant Client instalado deve corresponder ao nível de bit do sistema operacional.
  2. O Instant Client selecionado deve ser a versão correta para a plataforma em que ele é instalado. O Instant Client for AIX5L pode ser usado com o AIX 5L ou mais recente.
  3. O arquivo JAR ojdbc deve ser a versão correta para a versão java sendo usada pelo WebSphere Application Server. O ojdbc6.jar pode ser usado com o Java 6 ou Java 7. O ojdbc7.jar pode ser usado somente com o Java 7.
  4. O arquivo JAR ojdbc sendo usado deve ser aquele que foi fornecido com o cliente que está sendo usado.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_oracleoci
Nome do arquivo: tdat_oracleoci.html