pools de conexõesPara Criar um Pool de Conexões JDBC

Ao criar um pool de conexões com a Console de Administração, você define os aspectos de uma conexão para um banco de dados específico.

Antes de Começar

Para criar um pool de conexões, primeiro você deve instalar e integrar um driver que suporte a API da JDBC (driver JDBC). Consulte Para Integrar um Driver JDBC.

As seguintes informações são necessárias à criação do pool de conexões JDBC. Colete essas informações antes de continuar:

  1. Na árvore de navegação, selecione o nó Tarefas comuns.

    A página Tarefas comuns é exibida.

  2. Na página Tarefas Comuns, clique no botão Criar Novo Pool de Conexões JDBC.

    A página Novo Pool de Conexões JDBC (Etapa 1 de 2) é exibida.


    Observação:

    Também é possível acessar a página Novo Pool de Conexões JDBC via expansão do nó Recursos e do nó JDBC, selecionando então o nó Pools de Conexões. Na página Pools de Conexões, clique em Novo para criar um novo pool de conexões.
  3. No campo Nome do Pool, digite o nome do novo pool de conexões.

    Esse campo é obrigatório.

  4. Na lista drop-down Tipo de Recurso, selecione um tipo de recurso.

    As opções incluem javax.sql.XADataSource (transações globais), java.sql.ConnectionPoolDataSource (transações locais, possíveis melhorias de desempenho) e javax.sql.DataSource (somente transações locais)java.sql.Driver.

  5. Especifique um fornecedor de banco de dados:

    1. Na lista drop-down Fornecedor do Driver de Banco de Dados, selecione um fornecedor de banco de dados.

    2. Se o fornecedor de banco de dados não aparecer na lista, digite o nome do fornecedor no campo de texto Fornecedor do Driver de Banco de Dados.

  6. Marque a caixa de seleção Instrospecção Ativada para introspectar o driver de banco de dados com base na origem dos dados ou nos nomes de classe de implementação do driver.

  7. Clique em Próximo.

    A página Novo Pool de Conexões JDBC (Etapa 2 de 2) é exibida.

  8. No campo Nome da classe da origem de dados, digite o nome da classe específica do fornecedor que implementa a API DataSource, ConnectionPoolDataSource ou XADataSource.

    Se você selecionou um dos tipos de recursos de origem de dados, esse campo é normalmente preenchido automaticamente com o nome da classe associado ao tipo de recursos e com o fornecedor do banco de dados de sua escolha. Se você selecionou o tipo de recursojava.sql.Driver , esse campo é desativado.

  9. No campo Nome da classe do driver, digite o nome da classe específica do fornecedor que implementa a API java.sql.Driver.

    Se você selecionou o tipo de recurso java.sql.Driver, normalmente esse campo é automaticamente preenchido com o nome da classe associado ao driver do fornecedor de banco de dados de sua escolha. Se você selecionou um dos tipos de recursos de origem de dados, esse campo é desativado.

  10. Marque a caixa de seleção Ping Ativado para efetuar o ping automático no pool durante a criação ou reconfiguração, para identificar e avisar sobre valores de atributos com erros.

    Por default, essa opção está desativada.

  11. No campo Descrição, digite uma descrição breve do pool de conexões.

  12. No campo Tamanho inicial e mínimo do conjunto, digite o número mínimo de conexões para esse conjunto.

    Esse valor também determina o número de conexões colocadas no conjunto quando o conjunto é criado ou quando o GlassFish Server é iniciado. O valor default é 8.

  13. No campo Tamanho inicial e máximo do Pool, digite o número máximo de conexões para esse Pool.

    O valor default é 32.

  14. No campo Quantidade de Redimensionamento do Pool, digite o número de conexões por batch de redimensionamento do pool.

    Quando o pool aumenta e diminui em relação aos tamanhos máximo e mínimo, respectivamente, o pool é redimensionado em batches. Esse valor determina o número de conexões do batch. A definição de um valor muito alto torna demorado o processo de criação e reciclagem de conexões; um valor muito baixo compromete a eficiência. O valor default é 2.

  15. No campo Time-out para inatividade, digite a quantidade máxima de tempo, em segundos, para que uma conexão permaneça ociosa no pool.

    Após esse período, a conexão será removida do conjunto. O valor default é 300.

  16. No campo Tempo Máx. de Espera, digite o tempo máximo, em milissegundos, que a aplicação solicitante da conexão aguardará até obter um timeout.

    O valor default é 60.000.

  17. Marque a caixa de seleção Conexões não transacionais - Ativado para retornar conexões não transacionais.

    Por default, essa opção está desativada.

  18. Na lista drop-down Isolamento de Transação, selecione um nível de isolamento de transação para o pool de conexões.

    Se não especificado, as conexões funcionarão com os níveis de isolamento default, fornecidos pelo driver JDBC. Por default essa opção não é especificada.

  19. Marque a caixa de seleção Nível de Isolamento Garantido, para que todas as conexões obtidas no pool tenham o mesmo nível de isolamento.

    Por exemplo, se o nível de isolamento da conexão for alterado via programação (com con.setTransactionIsolation), durante a última utilização, esse mecanismo alterará o status para o nível de isolamento especificado. Por default, a opção está ativada.

    Essa definição só será aplicável se um nível de isolamento de transação for especificado.

  20. Na seção Propriedades adicionais, especifique essas propriedades.

    Exemplos de propriedades necessárias incluem nome do banco de dados (URL), nome de usuário e senha. A tabela normalmente contém propriedades usadas pelo fornecedor do banco de dados. Para obter informações sobre algumas das propriedades disponíveis, consultePropriedades Específicas para Pools de Conexões JDBC.

    Se você não especificar um valor para uma propriedade, ela será removida da tabela quando você finalizar a criação do pool de conexões. Caso não deseje definir agora um valor para uma propriedade, mas deseja que a propriedade permaneça na tabela, para que o valor possa ser definido em outro momento, digite um conjunto de parênteses vazios no campo Valor:

    ()
    
  21. Clique em Finalizar.

Consulte também
Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices