Configurando a Origem de Dados Utilizando o Console Administrativo

Os componentes de aplicativos utilizam uma origem de dados para acessar as instâncias de conexão com um banco de dados relacional.

Antes de Iniciar

O servidor de aplicativos suporta duas versões diferentes da origem de dados. Determine a origem de dados para seu ambiente de acordo com os níveis de enterprise bean e especificação de servlet que formam a base para seus aplicativos:
  • As origens de dados (WebSphere Application Server Versão 4) devem ser utilizadas com a especificação Enterprise JavaBeans (EJB) 1.0 e com a especificação 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.

Sobre Esta Tarefa

Quando você cria uma origem de dados, você a associa a um provedor Java Database Connectivity (JDBC) que é configurado para acessar um banco de dados de fornecedor específico. O servidor de aplicativos requer ambos os objetos para que seus aplicativos façam chamadas a esse banco de dados específico e recebam dados dele. A origem de dados fornece capacidades de gerenciamento de conexão que possibilitam fisicamente essas trocas entre seus aplicativos e o banco de dados.
Lembre-se: O servidor deve ser reiniciado para que a origem de dados recém criada esteja disponível para um Java Naming and Directory Interface (JNDI) a partir do aplicativo.

Procedimento

  1. Abra o console administrativo.
  2. Acesse o painel do console necessário. Utilize um dos seguintes caminhos:
    • Clique em Recursos > JDBC > Origens de Dados.
    • Clique em Recursos > JDBC > Origens de dados (WebSphere Application Server Versão 4)
    • Clique em Recursos > JDBC > Provedores JDBC > JDBC_provider > Origens de dados
    • Clique em Recursos > JDBC > provedores JDBC > JDBC_provider > Origens de Dados (WebSphere Application Server Versão 4).
  3. Selecione o escopo no qual os aplicativos podem utilizar a origem de dados. É possível escolher uma célula, nó, cluster ou servidor. Para obter mais informações, consulte o tópico sobre as configurações do escopo.
    Apenas Versão 4: A partir desse ponto, as etapas para criar as origens de dados WebSphere Application Server Versão 4 serão diferentes das etapas para criar origens de dados da versão padrão mais recente. Para configurar uma origem de dados da Versão 4:
    • Clique em Novo para continuar no painel do console para definir as propriedades necessárias.
    • Nesse painel de propriedades, especifique valores para os campos que estão agrupados pelo título Configuração. O servidor de aplicativos requer essas propriedades para implementar suas classes do driver JDBC.
    • Salve a sua configuração, clicando em OK. Agora, você concluiu as principais tarefas de configuração de origem de dados.
    • Defina outras propriedades que o fornecedor de banco de dados pode precisar ou ofereça como opções, para usar o driver JDBC. O servidor de aplicativos chama-as de propriedades customizadas e requer que elas sejam configuradas na origem de dados. Comece clicando no link Propriedades Customizadas que agora é exibido no painel do console administrativo. Consulte a documentação de seu banco de dados para conhecer essas propriedades necessárias e opcionais.

      [z/OS]Também é possível aprender sobre propriedades opcionais da origem de dados no Application Programming Guide and Reference for Java para sua versão do DB2 for z/OS, se você usar o Driver Universal JDBC DB2 ou DB2 Usando o IBM® JCC Driver para o provedor JDBC.

  4. Clique em Novo(a). Essa ação faz com que o assistente Criar uma origem de dados ative e exiba o painel Inserir informações básicas da origem de dados. O primeiro campo é o campo do escopo, que é de leitura. Esse campo exibe a seleção de escopo anterior.
  5. Digite um nome de origem de dados no campo Nome da origem de dados. Esse nome identifica a origem de dados apenas para propósitos administrativos.
  6. Digite um nome de JNDI (Java Naming and Directory Interface) no campo Nome de JNDI. O servidor de aplicativos utiliza o nome de JNDI para ligar referências de recursos de um aplicativo a essa origem de dados. Siga estes requisitos ao especificar nomes de JNDI:
    • Não atribua nomes de JNDI duplicados entre tipos de recursos diferentes, como origens de dados versus connection factories J2C ou connection factories JMS.
    • Não designe nomes JNDI duplicados para vários recursos do mesmo tipo no mesmo escopo.
    Para obter informações adicionais sobre JNDI, consulte o tópico sobre nomenclatura.
  7. Clique em Avançar para exibir o painel Selecionar provedor JDBC. O painel Selecionar provedor JDBC será ignorado se você não possuir nenhum provedor JDBC configurado no escopo atual.
  8. Selecione um provedor JDBC existente ou crie um novo provedor.
    • Selecione um provedor JDBC existente.
      1. Clique em Selecionar um provedor JDBC existente.
      2. Selecione um driver JDBC na lista.
      3. Clique em Avançar. Agora o painel com o título Inserir propriedades específicas do banco de dados para a origem de dados será exibido.
    • Crie um novo provedor JDBC.
      1. Clique em Criar Novo Provedor JDBC.
      2. Clique em Avançar para exibir o painel Criar provedor JDBC.
      3. Utilize a primeira lista suspensa para selecionar o tipo de banco de dados do provedor JDBC que você precisa criar.
        A opção Definido pelo Usuário: Selecione Definido pelo Usuário para seu tipo de banco de dados se você encontrar um dos cenários a seguir:
        • 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 aciona 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 classes do driver JDBC, as propriedades da origem de dados e outros requeridos para seu provedor definido pelo usuário. Você deve fornecer essas informações nos próximos dois painéis do assistente:
        • informações do caminho da classe de banco de dados
        • propriedades específicas do banco de dados
      4. Se o tipo de provedor JDBC for exibido na segunda lista, selecione o tipo de provedor JDBC. 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.
      5. Na terceira lista, selecione o tipo de implementação necessário para o 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 Pool de Conexão. 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 essa 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. Você pode digitar valores diferentes para esses campos; eles existem somente para propósitos administrativos.

      6. Clique em Avançar após ter definido seu tipo de banco de dados, tipo de provedor e tipo de implementação. Agora o painel do assistente Inserir informações do caminho de classe do banco de dados é exibido.
      7. No campo do caminho de classe, digite o local do caminho completo dos arquivos de classe do driver JDBC do banco de dados. As informações do caminho de classe tornam-se o valor da variável de ambiente do WebSphere que é exibido nesse painel, no formato ${DATABASE_JDBC_DRIVER_PATH}. O servidor de aplicativos utiliza a variável para definir seu 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 essa definição de variável preenchendo o restante desse painel do assistente e clicando em Avançar.
      8. 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.
      9. Clique em Avançar. Agora o painel Inserir propriedades específicas do banco de dados para a origem de dados será exibido.
  9. Preencha todos os campos no painel Inserir propriedades específicas do banco de dados para a origem de dados.
    • Clique em Utilizar esta Origem de Dados em CMP (Container Managed Persistence) se os enterprise beans CMP (Container Managed Persistence) precisarem acessar essa origem de dados.
    • Quaisquer outros campos de propriedade exibidos nesse painel do assistente são específicos ao seu tipo de banco de dados. Consulte o tópico Configurações Mínimas Necessárias da Origem de Dados, pelo fornecedor, para obter informações sobre estas configurações de propriedade. O artigo aborda os provedores JDBC atuais e descontinuados que são predefinidos no servidor de aplicativos.
      Origens de dados definidas pelo usuário: Esse painel do assistente não exibe campos de propriedades adicionais para origens de dados que correspondem a seus provedores JDBC definidos pelo usuário. Entretanto, a partir dos arquivos de classe de driver JDBC instalados, o servidor de aplicativos pode geralmente extrair os nomes da propriedade da origem de dados necessária. O servidor de aplicativos define-os como propriedades customizadas da origem de dados, exibe-os em um painel customizado do console de propriedades e designa a eles valores padrão. Consulte a documentação do banco de dados sobre as configurações dessas propriedades e quaisquer outros requisitos para sua origem de dados definida pelo usuário. Após criar uma origem de dados, navegue até o painel de coleta de propriedades customizadas correspondente no console administrativo, clicando em Origens de dados > data_source > Propriedades customizadas. Revise os valores padrão da propriedade e modifique-os se necessário.

      O servidor de aplicativos poderá extrair apenas as propriedades específicas do fornecedor a partir dos arquivos de classe do driver, se você instalar os arquivos no nó do gerenciador de implementação e configurar corretamente as variáveis representativas do WebSphere. Caso contrário, o produto exibe uma mensagem informativa (em oposição a uma mensagem de erro) que o direciona para definir manualmente as propriedades necessárias como propriedades customizadas.

  10. Opcional: Configure os aliases de segurança para a origem de dados. É possível selecionar nenhum para qualquer um dos métodos de autenticação ou escolher um dos seguintes tipos:
    • Alias de autenticação gerenciado pelo componente - especifica um alias de autenticação a ser utilizado quando o valor res-auth de referência do recurso do componente for Aplicativo. Para definir um novo alias, navegue até Itens Relacionados > Entradas de dados de autenticação J2C (J2EE Connector Architecture). Um alias gerenciado por componente representa uma combinação de ID e senha que é especificada em um aplicativo para autenticação de origem de dados. Portanto, o alias configurado na origem de dados deve ser idêntico ao alias do código do aplicativo.
      1. Utilize a lista suspensa para selecionar um alias de autenticação gerenciado por componente existente.
      2. Para criar um novo alias, clique nos links fornecidos. Essa ação fecha o assistente da origem de dados e aciona o console administrativo para exibir o painel de dados de autenticação J2C. Clique em Novo para definir um novo alias. Clique em OK para salvar suas configurações e visualizar o novo alias no painel de dados de autenticação J2C. Reinicie o assistente da origem de dados navegando de volta para o painel de coleta da origem de dados, selecionando o escopo apropriado e clicando em Novo.
      Para obter informações adicionais sobre a segurança Java 2 Connector (J2C), consulte o tópico sobre o gerenciamento das entradas de dados de autenticação do Java 2 Connector Architecture.
    • Alias de configuração de mapeamento - é usado apenas na ausência de uma configuração de login na referência de recurso de componente. A especificação de uma configuração de login e das propriedades associadas na referência de recurso do componente é a maneira preferencial para definir a estratégia de autenticação, quando o valor res-auth for configurado para Contêiner. Se você especificar a configuração de login DefaultPrincipalMapping, a propriedade associada será um JAAS - alias de entrada de dados de autenticação J2C.
    • Alias de autenticação gerenciada por contêiner - é usado apenas na ausência de uma configuração de login na referência de recurso de componente. A especificação de uma configuração de login e das propriedades associadas na referência de recurso do componente determina a estratégia de autenticação gerenciada por contêiner quando o valor res-auth for configurado para Contêiner.
    Nota: Se você definiu domínios de segurança no servidor de aplicativos, poderá clicar em Procurar... para selecionar um alias de autenticação para o recurso que está sendo configurado. Os domínios de segurança suportam o isolamento de aliases de autenticação entre os servidores. A visualização em árvore é útil na determinação do domínio de segurança ao qual um alias pertence, além de poder ajudar a determinar os servidores que estão aptos para acessar cada alias de autenticação. A visualização em árvore é adaptada para cada recurso, portanto os domínios e aliases ficam ocultos quando você não pode utilizá-los.
  11. Clique em Avançar para visualizar o painel Resumo e revisar quaisquer informações para a origem de dados. Se alguma informação não estiver correta, é possível clicar em Voltar para voltar e corrigi-la.
  12. Clique em Concluir para salvar a configuração e sair do assistente. Agora o painel Origens de dados será aberto, exibindo sua nova configuração em uma tabela junto com outras origens de dados configuradas para o mesmo escopo.

O que Fazer Depois

  • Você pode substituir os valores padrão para algumas propriedades da origem de dados.
  • É possível configurar propriedades adicionais que seu fornecedor de banco de dados pode requerer ou oferece como opções. Consulte a sua documentação de banco de dados sobre essas configurações.
  • [z/OS]Se você usar o Driver Universal JDBC DB2 ou o DB2 Usando o IBM JCC Driver, aprenda sobre as propriedades opcionais da origem de dados no Application Programming Guide and Reference for Java para sua versão do DB2 for z/OS.
  • É possível incluir a propriedade customizada commitOrRollbackOnCleanup nas configurações de uma origem de dados JDBC se você desejar que uma ação específica seja executada com qualquer trabalho não confirmado se sua origem de dados JDBC fechar inesperadamente. Os valores que podem ser especificados para esta propriedade são commit ou rollback.

    Se sua origem de dados JDBC suportar detecção de Unidade de Trabalho (UOW), esta propriedade se aplicará somente quando você estiver trabalhando dentro de uma unidade de trabalho separada. Se sua origem de dados JDBC não suportar detecção de UOW, esta propriedade sempre se aplicará.

    Se você não incluir esta propriedade em suas configurações de origem de dados JDBC, qualquer transação implícita detectada será recuperada e seu aplicativo deverá lidar com quaisquer transações implícitas não detectadas.

    Para incluir esta propriedade customizada em suas definições de configuração de origem de dados JDBC:
    1. No console administrativo, clique em Provedores JDBC > JDBC_provider > Origens de Dados > data_source > Propriedades Customizadas > Novo.
    2. Insira commitOrRollbackOnCleanup no campo Nome e commit ou rollback no campo Valor.
    3. Salve suas alterações.

Os tópicos a seguir neste centro de informações informam como usar o console administrativo para designar os valores de propriedades:


Í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_ccrtpds
Nome do arquivo: tdat_ccrtpds.html