Configurando um Provedor JDBC Utilizando o Console Administrativo

Para criar conexões entre um aplicativo e um banco de dados relacional, o servidor de aplicativos utiliza as classes de implementação do driver que são encapsuladas pelo provedor Java™ Database Connectivity (JDBC).

Antes de Começar

Cada provedor JDBC é essencialmente um objeto que representa as classes do driver JDBC específicas do fornecedor para o servidor de aplicativos, para estabelecer acesso a esse banco de dados. Os provedores JDBC são pré-requisitos para origens de dados, que fornecem aplicativos com conexões físicas com um banco de dados. Consulte a tabela do provedor JDBC para identificar o provedor JDBC apropriado para o seu banco de dados e requisitos de aplicativos.
[z/OS]Recurso reprovado: O servidor de aplicativos não suporta mais o DB2® para o driver de 390 e z/OS® Legacy JDBC e o provedor JDBC correspondente, o DB2 para zOS provedor local JDBC (RRS). Use o driver DB2 usando o driver IBM® JCC ou o driver DB2 Universal JDBC para conectar-se ao DB2 for z/OS.

Sobre esta Tarefa

Configure pelo menos um provedor JDBC para cada servidor de banco de dados que você planeja utilizar em um escopo específico no ambiente do servidor de aplicativos.

Procedimento

  1. Abra o console administrativo.
  2. Clique em Recursos > JDBC > JDBC Provedores.
  3. Selecione o escopo no qual os aplicativos podem utilizar o provedor JDBC.
    O escopo selecionado torna-se o escopo de qualquer origem de dados associada a esse provedor. É possível escolher uma célula, nó, cluster ou servidor. Para obter mais informações sobre o escopo e como ele pode afetar os recursos, consulte o tópico nas configurações do escopo administrativo.
  4. Clique em Novo.
    Essa ação faz com que o assistente Criar um Novo Provedor JDBC seja ativado.
  5. Use a primeira lista suspensa para selecionar o tipo de banco de dados do provedor JDBC que deve ser criado.
    A opção Definida pelo Usuário: Selecione Definido pelo Usuário para o seu tipo de banco de dados se encontrar qualquer um dos seguintes cenários:
    • Você não vê seu tipo de banco de dados.
    • Não é possível selecionar o tipo de provedor JDBC necessário na próxima etapa.
    A seleção definida pelo usuário abre o painel do assistente para exibir o tipo de provedor como um provedor JDBC definido pelo usuário e o tipo de implementação como definida pelo usuário. Consulte a documentação do banco de dados para obter os arquivos de classe do driver JDBC, as propriedades da origem de dados e outras informações necessárias para o provedor definido pelo usuário. Você deve fornecer essas informações sobre os dois painéis a seguir:
    • caminho da classe de banco de dados
    • propriedades específicas do banco de dados
  6. Selecione seu tipo de provedor JDBC se ele for fornecido na segunda lista drop-down.
    Selecione Mostrar Obsoleto para acionar a exibição dos provedores atuais e obsoletos. Se não for possível localizar seu provedor nessa lista expandida, então, selecione Definido pelo Usuário na lista anterior de tipos de banco de dados.
    [z/OS]Evite problemas: O produto emite uma mensagem de erro DSRA360 se você selecionar o provedor DB2 for z/OS Local JDBC Provider (RRS). Na Versão 6.1 e mais tarde, o servidor de aplicativos remove completamente o suporte para o provedor DB2 for z/OS Local JDBC Provider (RRS).
  7. A partir da terceira lista drop-down, selecione o tipo de implementação necessário para seu aplicativo.
    Se seu aplicativo não precisar que as conexões suportem transações de consolidação em duas fases, escolha Origem de Dados do Conjunto de Conexões. Escolha Origem de Dados XA, no entanto, se seu aplicativo precisar de conexões que suportem transações de consolidação em duas fases. Os aplicativos que utilizam esta configuração de origem de dados têm o benefício de recuperação de transação gerenciada por contêiner.

    Após selecionar um tipo de implementação, o assistente preenche o nome e os campos de descrição para seu provedor JDBC. É possível digitar valores diferentes para esses campos; eles existem somente para propósitos administrativos.

  8. Clique em Avançar para ver o painel do assistente Enter database class path information .
  9. No campo do caminho de classe, digite o local do caminho completo dos arquivos de classe do driver JDBC do banco de dados.
    Suas informações de caminho de classe tornam-se o valor da variável de ambiente do WebSphere® exibida neste painel, na forma de ${DATABASE_JDBC_DRIVER_PATH}. O servidor de aplicativos usa a variável para definir o provedor JDBC; essa prática elimina a necessidade de especificar caminhos de classe JDBC estáticos para aplicativos individuais. Lembre-se de que se você não fornecer o caminho de classe do driver JDBC correto e completo para a variável, sua origem de dados fatalmente falhará. Se o campo já exibir um caminho completo da classe, poderá aceitar esta definição de variável preenchendo o restante desse painel do assistente e clicando em Avançar.
    Configurações suportadas: O servidor de aplicativos suporta várias versões do driver JDBC selecionado para o driver DataDirect ConnectJDBC tipo 4 para o MS SQL Server. Cada versão do driver JDBC possui um caminho de classe exclusivo. Selecione a versão apropriada do driver JDBC para que o caminho de classe seja preenchido corretamente.
  10. Utilize o campo Caminho da Biblioteca Nativa para especificar arquivos de classe adicionais que seu driver JDBC poderá requerer para funcionar corretamente em sua plataforma do servidor de aplicativos. Digite o nome completo do caminho de diretório desses arquivos de classe.
    Evitar problemas: Se você estiver usando um driver de OCI Oracle como seu provedor JDBC , você deve especificar o caminho para onde as bibliotecas nativas estão armazenadas. Se nenhum caminho de biblioteca nativa for especificado, a primeira vez que você tentar se conectar usando esse provedor, ocorrerão erros do carregador de classes.
  11. Clique em Avançar para ver um resumo de suas configurações do provedor JDBC .
  12. Clique em Concluir se você estiver satisfeito com a configuração do provedor JDBC .
    Agora você visualizará o painel Coleta do provedor JDBC, que exibe seu novo provedor JDBC em uma tabela junto com outros provedores que estão configurados para o mesmo escopo.

O Que Fazer Depois

A próxima etapa é criar uma origem de dados para associar ao seu provedor JDBC. Para obter informações detalhadas, consulte o tópico do centro de informações sobre como configurar uma origem de dados utilizando o console administrativo.
Lembre-se: Se você modificar a configuração de um provedor JDBC , como o caminho de classe, caminho da biblioteca nativa ou propriedades customizadas, clique em OK e, em seguida, reinicie cada servidor de aplicação dentro do escopo desse provedor JDBC . Caso contrário, a nova configuração não funciona e você recebe mensagens de erro da origem de dados.