Configurando um Provedor JDBC e uma Origem de Dados

Para acesso aos bancos de dados relacionais, os aplicativos utilizam drivers Java™ Database Connectivity (JDBC) e origens de dados que você configura para o servidor de aplicativos.

Antes de Iniciar

Cada banco de dados de fornecedor requer classes de implementação de driver JDBC diferentes para conectividade com JDBC. Um provedor JDBC encapsula esses arquivos de driver específicos do fornecedor. Por meio da origem de dados que você associa ao provedor JDBC, um servidor de aplicativos obtém e gerencia as conexões físicas para transações entre os aplicativos e o banco de dados.
Atenção: Se estiver acessando um banco de dados DB2, o IBM Optim pureQuery Runtime é uma alternativa para JDBC. Para obter mais informações sobre pureQuery, consulte o tópico, Visão Geral da Tarefa: IBM Optim pureQuery Runtime, na seção de links relacionados.
Antes de iniciar essa tarefa, determine a versão da origem de dados que você precisa, de acordo com a especificação API de seus aplicativos.
  • Recurso Reprovado Recurso Reprovado: depfeat
    As origens de dados (WebSphere Application Server Versão 4) (descontinuado) destinam-se ao uso com a especificação do Enterprise JavaBeans (EJB) 1.0 e a especificação do Java Servlet 2.2.
  • As origens de dados da versão mais recente são para utilização com aplicativos que implementam os releases mais avançados dessas especificações.
[z/OS]Importante: Se conectar a um DB2 para z/OS por meio do JDBC Universal JDBC Driver, siga as etapas destacadas no tópico, Usando o Driver Universal JDBC DB2 para acessar DB2 para z/OS. Este artigo fornece instruções detalhadas sobre a instalação do driver JDBC e arquivos relacionados, além de ativar as propriedades JDBC necessárias.

Procedimento

  1. Verifique se todos os arquivos necessários de driver JDBC estão instalados no seu gerenciador de nós. Consulte o artigo, Configurações Necessárias Mínimas da Origem de Dados, pelo fornecedor para essas informações. Se você optar por configurar um provedor JDBC definido pelo usuário, verifique sua documentação de banco de dados para obter informações sobre os arquivos do driver.
  2. Crie um provedor JDBC.

    Ao criar um provedor JDBC a partir do console administrativo, consulte o tópico Configurando um Provedor JDBC Usando o Console Administrativo; ou

    Ao usar o cliente de script wsadmin, consulte o tópico Configurando um Provedor JDBC Usando o Script; ou

    Usando a API Java Management Extensions (JMX), consulte o tópico, Criando um Provedor JDBC e a Origem de Dados Usando a API JavaManagement Extensions.

  3. Crie uma origem de dados.

    No console administrativo, consulte o tópico Criando uma Origem de Dados Usando o Console Administrativo; ou

    Usando o cliente de script wsadmin, consulte o tópico, Configurando Novas Origens de Dados Usando o Script. Para origens de dados V4, consulte o tópico Configurando novas origens de dados WAS40 utilizando script (descontinuado); ou

    utilizando JMX API, consulte o tópico, Criando um provedor JDBC e origem de dados usando a API do JavaManagement Extensions.

    Propriedades Obrigatórias: Diferentes fornecedores do banco de dados requerem diferentes propriedades para implementações de seus drivers JDBC. Configure essas propriedades na origem de dados do WebSphere Application Server. Como o Application Server contém modelos para várias implementações JDBC do fornecedor, o console administrativo estabelece a superfície das propriedades necessárias e as solicita conforme você cria uma origem de dados. No entanto, se você fornecer o script de suas configurações de acesso a dados, deve consultar o artigo Configurações Necessárias Mínimas da Origem de Dados, por fornecedor para as opções de configurações e propriedades necessárias.
  4. Opcional: Configure as propriedades customizadas.

    Como as propriedades necessárias, as propriedades customizadas para drivers JDBC do fornecedor específicos devem ser configuradas na origem de dados do servidor de aplicativos. Consulte a sua documentação do banco de dados para obter informações sobre as propriedades customizadas disponíveis. Para configurar uma classe customizada para facilitar a manipulação de propriedades do banco de dados que não são reconhecidas nativamente pelo Application Server, consulte o tópico, Desenvolvendo uma Classe DataStoreHelper Customizada.

    Também há propriedades de origem de dados opcionais, tal como a propriedade customizada sslConnection do DB2, que talvez você deseje configurar. Consulte Guia de Programação do Aplicativo e Referência para Java para sua versão do DB2 para z/OS se usar o provedor Driver Universal JDBC do DB2 para obter mais informações sobre estas propriedades customizadas.

  5. Ligue as referências do recurso à origem de dados. Consulte o artigo, Consultas da origem de dados para enterprise beans e módulos da Web.
  6. Teste a conexão (para uso de persistência não gerenciada pelo contêiner). Consulte o tópico, Serviço de Conexão de Teste.

Resultados

Se você utilizar o Driver JDBC do DB2 Universal, poderão ocorrer falhas de origem de dados que o log da JVM do servidor de aplicativos não registrará. Verifique o log do banco de dados DB2 ou o log de rastreio de JDBC do WebSphere Application Server (se o rastreio de JDBC estiver ativo). É possível descobrir que uma credencial de autenticação é a causa da falha. Atualmente, o Driver JDBC do DB2 Universal não identifica nem apresenta os erros criados por credenciais de autenticação inválidas de maneira apropriada ou consistente.

Mesmo se você receber informações sobre uma credencial inválida, verifique os logs do banco de dados e de rastreio JDBC. Esses logs fornecem dados de erro mais confiáveis e detalhados sobre as falhas na autenticação.

Boas Práticas Boas Práticas: O log de rastreio JDBC existe apenas se o serviço de rastreio JDBC estiver ativo durante a inicialização do servidor. Ative o serviço no console administrativo. Para obter informações adicionais, consulte o tópico Ativando o Rastreio na Inicialização do Servidor. Especifique WAS.database como o grupo de rastreio e selecione com.ibm.ws.db2.logwriter como a cadeia de rastreio.bprac

Í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_tccrtprovds
Nome do arquivo: tdat_tccrtprovds.html