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.
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
- 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.
- 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 .
- 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.
- 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.
- 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.
- 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.