Configurando um Provedor JDBC e uma Origem de Dados

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

Antes de Começar

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 você estiver acessando um banco de dados DB2® , IBM Optim pureQuery Runtime é uma alternativa para o 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 esta tarefa, determine a versão de origem de dados que necessária, de acordo com a especificação da API de seus aplicativos.
  • As fontes de dados (WebSphere® Application Server Versão 4) são para uso com a especificação Enterprise JavaBeans (EJB) 1.0 e a especificação Java Servlet 2.2 .
  • As origens de dados da versão mais recente são paro uso com aplicativos que implementam os releases mais avançados dessas especificações.
[z/OS]Importante: Se você se conectar ao DB2 for z/OS® através do Driver JDBC Universal JDBC , siga os passos que estão delineados no tópico, Usando o Driver DB2 Universal JDBC para acessar DB2 for 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.

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

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

    Usando as Extensões de Gerenciamento Java (JMX) API, consulte o tópico, Criando um provedor JDBC e fonte de dados usando a API de Extensões JavaManagement .

  3. Criar 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 Usando o Script; ou

    Usando a API JMX, consulte o tópico, Criando um provedor JDBC e fonte de dados usando a API de Extensões JavaManagement .

    Propriedades necessárias: Diferentes fornecedores de bancos de dados requerem propriedades diferentes para implementações de seus drivers JDBC . Configure estas propriedades na fonte de dados 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: Configurar propriedades personalizadas.

    Como as propriedades necessárias, as propriedades customizadas para drivers JDBC de fornecedor específico 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á várias propriedades de origem de dados opcionais, como a propriedade customizada sslConnection do DB2, que você pode querer configurar. Consulte o Guia de Programação de Aplicativos e Referência para Java para sua versão do DB2 for z/OS se você usar o provedor de Driver DB2 Universal JDBC para obter mais informações sobre essas 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ê usar o Driver Universal do DB2 JDBC , você pode experimentar falhas de origem de dados que o log da JVM do servidor de aplicativos não documenta. Verifique o log do banco de dados DB2 ou o log de rastreio do WebSphere Application Server JDBC (se o rastreio do JDBC estava ativo). É possível descobrir que uma credencial de autenticação é a causa da falha. Atualmente o Driver Universal do DB2 JDBC não identifica ou supera os erros que são produzidos por credenciais de autenticação não válidas de forma adequada 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.

Melhor prática: O log de rastreio do JDBC existe apenas se o serviço de rastreio JDBC estiver ativo durante o início do servidor. Ative o serviço no console administrativo. Para obter mais informações, 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.