Para Editar Atributos Avançados do Pool de Conexões JDBC

  1. Na árvore de navegação, expanda o nó Recursos.

  2. No nó Recursos, selecione o nó JDBC.

  3. No nó JDBC, selecione o nó Pools de Conexões.

    A página Pools de Conexões é exibida.

  4. Na página Pools de Conexões, clique no nome do pool a ser editado.

    A página Editar Pool de Conexões é exibida.

  5. Na página Editar Pool de Conexões, clique na guia Avançado.

    A página Editar Atributos Avançados do Pool de Conexões é exibida.

  6. No campo Time-out para instrução, digite o período, em segundos, após o qual as consultas de execução anormalmente longas serão finalizadas.

    O GlassFish Server configura o Time-out para consulta nas instruções criadas. Defina o valor como -1 para desativar essa opção. O valor default é -1.

  7. No campo Tamanho do cache para instruções, digite o número de instruções a serem colocadas no cache usando o mecanismo de cache LRU (Least Recently Used).

    Para desativar a colocação da instrução no cache, especifique um valor de 0. O valor default é 0.

  8. No campo SQL de Inicialização, digite uma string SQL a ser executada sempre que uma conexão for criada (não reutilizada) no pool.

    A execução dessa string inicializa o estado da conexão.

  9. No campo Interpretador de rastreamento SQL, digite uma lista separada por vírgulas de nomes de classes de implementação do interpretador, que especifica que as instruções SQL executadas por aplicações serão rastreadas.

    As classes do listener devem implementar a interface org.glassfish.api.jdbc.SQLTraceListener. O uso de interpretadores permite a fácil filtragem de registros de mensagens para as instruções SQL e ajuda os administradores a analisarem as instruções.

  10. Marque a caixa de seleção Encapsular Objetos JDBC, para que as aplicações encapsulem objetos JDBC para Statement, PreparedStatement , CallableStatement, ResultSet, DatabaseMetaData.

    Por default, a opção está ativada.

  11. Marque a caixa de seleção Amostragem para ativar a amostragem de conexões para o pool.

    Por default, a opção está ativada.

  12. No campo Validar no máximo uma vez, digite o período, em segundos, após o qual uma conexão será validada no máximo uma vez.

    A definição desse atributo para um valor apropriado minimiza o número de solicitações de validação feitos por uma conexão. O valor default é 0, o que significa que o atributo não está ativado.

  13. No campo Time-out de Vazamento da Conexão, digite o tempo, em segundos, necessário para rastrear vazamentos de conexão em um pool de conexões.

    Use esse campo para detectar potenciais vazamentos de conexão pela aplicação. Uma conexão que não é retornada para o pool pela aplicação dentro do período especificado é assumida como tendo um vazamento potencial, e um rastreamento de pilha do chamador é registrado. Defina o valor como 0 para desativar o rastreamento de perda de conexão. O valor default é 0.

    Use esse campo junto com Recuperação de Vazamento da Conexão para evitar possíveis vazamentos da conexão da aplicação.

  14. Marque a caixa de seleção Recuperação de Vazamento da Conexão para restaurar conexões vazadas no pool após a conclusão do rastreamento da conexão.

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

  15. No campo Time-out de Vazamento da Instrução, digite o tempo, em segundos, necessário para rastrear vazamentos de instrução em um pool de conexões.

    Use esse campo para detectar possíveis vazamentos de instruções na aplicação. Considera-se que uma instrução que não é retornada para o pool pela aplicação no período especificado tenha vazamentos, e um rastreamento de pilha do chamador é conectado. Defina o valor como 0 para desativar o rastreamento de vazamentos de instrução. O valor default é 0.

    Use esse campo junto com Recuperação de Vazamento da Instrução para evitar possíveis vazamentos da instrução da aplicação.

  16. Marque a caixa de seleção Recuperação de Vazamento da Instrução para restaurar instruções vazadas no pool após a conclusão do rastreamento da instrução.

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

  17. No campo Novas tentativas de criação, digite o número de tentativas a serem feitas se houver uma falha ao criar uma nova conexão.

    Defina o valor como 0 para que nenhuma tentativa seja feita para criar novamente a conexão. O valor default é 0.

  18. No campo Intervalo de nova tentativa, digite o intervalo, em segundos, entre duas tentativas de criar uma conexão.

    O valor default é 10. Esse atributo só será usado se o valor Novas tentativas de criação for maior que 0.

  19. Marque a caixa de seleção Associação Lenta Ativada para associar uma conexão física com um conjunto lógico somente quando uma conexão for usada.

    As conexões serão desassociadas quando a transação for concluída e um método de componente for finalizado, o que ajuda a reutilizar as conexões físicas. Se essa opção está desativada, uma conexão física é associada à coleção lógica mesmo antes de ser usada. Por default, essa opção está desativada.

  20. Marque a caixa de seleção Inscrição de Conexão Lenta Ativada para inscrever um recurso para a transação somente quando ele for efetivamente utilizado em um método.

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

  21. Marque a caixa de seleção Associar com Thread Ativado para criar associações entre conexões e threads.

    Quando o mesmo thread for necessário a uma conexão, a conexão já associada ao thread poderá ser reutilizada, não incorrendo, portanto, a sobrecarga para obtenção de outra conexão no conjunto. Por default, essa opção está desativada.

  22. Marque a caixa de seleção Corresponder Conexões Ativado para ativar a correspondência de conexão para o pool.

    Se essa opção está ativada, uma conexão que é selecionada do pool deveria ser correspondida com as conexões que têm determinadas credenciais. Essa opção precisará ser ativada se o pool de conexões for usado por aplicações que têm várias credenciais de usuário. Essa opção poderá ser desativada se o administrador souber que as conexões no pool serão sempre homogêneas e, portanto, uma conexão selecionada no pool não precisará coincidir com o adaptador de recurso. Por default, essa opção está desativada.

  23. No campo Uso Máx. de Conexão, digite o número de vezes que uma conexão deve ser reutilizada pelo pool.

    Depois que uma conexão é reutilizada por um número especificado de vezes, ela é fechada. Ao limitar o número de vezes que uma conexão pode ser reutilizada, você poderá evitar vazamentos de instruções caso uma aplicação não feche as instruções. Defina o valor como 0 para desativar esse atributo. O valor default é 0.

  24. Marque a caixa de seleção Validação de conexão exigida para ativar a validação de conexão.

    A validação de conexão permite que o servidor se reconecte em caso de falha.

  25. Na lista drop-down Método de Validação, selecione um método de validação.

    O GlassFish Server pode validar as conexões ao banco de dados nas seguintes formas.

    confirmação automática e metadados

    O GlassFish Server valida uma conexão ao chamar os métodos con.getAutoCommit e con.getMetaData.


    Observação:

    Muitos drivers JDBC armazenam no cache os resultados dessas chamadas. Como resultado, o uso dessas chamadas nem sempre fornece validações confiáveis. Verifique com o fornecedor do driver para determinar se essas chamadas são ou não armazenadas no cache.
    validação personalizada

    O GlassFish Server usa um mecanismo de validação definido pelo usuário especificado pela classe de implementação personalizada no campo Nome da classe de validação.

    tabela

    A aplicação consulta a tabela de banco de dados especificada. A tabela deve existir e estar acessível, mas não precisa conter linhas. Não use uma tabela existente que tenha um número grande de linhas, nem uma tabela que seja acessada com frequência.

  26. Caso você tenha selecionado tabela na lista drop-down Método de Validação, digite o nome da tabela de banco de dados ou selecione-o na lista drop-down Nome da Tabela.

  27. Caso você tenha selecionado validação personalizada na lista drop-down Método de Validação, digite o nome da classe de implementação da validação personalizada ou selecione-o na lista drop-down Nome da Classe de Validação.

    O nome da classe fornecido precisa estar acessível ao GlassFish Server. A classe especificada deve implementar a interface org.glassfish.api.jdbc.ConnectionValidation.

  28. Marque a caixa de seleção Em Qualquer Falha, Fechar Todas as Conexões, para fazer com que o servidor feche e restabeleça todas as conexões do pool em caso de falha de conexão.

    Se a opção for desativada, cada conexão individual somente será restabelecida quando for usada. Por default, essa opção está desativada.

  29. Marque a caixa de seleção Permitir Chamadores Não de Componentes Ativado para permitir que o pool seja usado por chamadores não de componentes; por exemplo, filtros de servlet e gerenciadores de persistência de terceiros.

    As conexões obtidas por chamadores não de componente não são automaticamente fechadas no final de uma transação pelo contêiner. Elas precisam ser explicitamente fechadas pelo chamador. Essa opção está desativada por default.

  30. Clique no botão Descarregar na guia Geral para descarregar todas as conexões do pool.

    Clicar no botão Descarregar destrói quaisquer conexões existentes, recria as conexões estabelecidas para o pool e restaura o pool para seu tamanho inicial e mínimo.

  31. Clique em Salvar.


    Dica:

    Para voltar às definições default, clique no botão Carregar Defaults e depois em Salvar.
Consulte também
Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices