Na árvore de navegação, expanda o nó Recursos.
No nó Recursos, selecione o nó JDBC.
No nó JDBC, selecione o nó Pools de Conexões.
A página Pools de Conexões será aberta.
Na página Pools de Conexões, clique no nome do pool a ser editado.
A página Editar Pool de Conexões será aberta.
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 será aberta.
No campo Time-out da 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 define o Time-out para Consulta
nas instruções criadas. Defina o valor como -1 para desativar essa opção. O valor default é -1.
No campo Tamanho do Cache de Instrução, digite o número de instruções a serem colocadas no cache usando o mecanismo de cache LRU (Menos Usado Recentemente).
Para desativar o armazenamento em cache da instrução, especifique um valor de 0. O valor default é 0.
No campo SQL Inicial, 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.
No campo Listeners de Rastreamento de SQL, digite uma lista separada por vírgulas de nomes de classes de implementação do listener, 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 listeners permite a fácil filtragem de registros de mensagens para as instruções SQL e ajuda os administradores a analisarem as instruções.
Marque a caixa de seleção Ajustar Objetos do JDBC, para que as aplicações ajustem objetos JDBC para Statement
, PreparedStatement
, CallableStatement
, ResultSet
, DatabaseMetaData
.
Por default, a opção está ativada.
Marque a caixa de seleção Agrupamento para ativar o agrupamento de conexões para o pool.
Por default, a opção está ativada.
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.
No campo Time-out para Perda de Conexão, digite o tempo, em segundos, necessário para rastrear perdas de conexão em um pool de conexões.
Use esse campo para detectar potenciais perdas 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 uma perda 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 Reclamação para Perda de Conexão para evitar possíveis perdas da conexão da aplicação.
Marque a caixa de seleção Reclamação para Perda de 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.
No campo Time-out para Perda de Instrução, digite o tempo, em segundos, necessário para rastrear perdas de instrução em um pool de conexões.
Use esse campo para detectar possíveis perdas 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 perdas, e um rastreamento de pilha do chamador é conectado. Defina o valor como 0 para desativar o rastreamento de perda de instrução. O valor default é 0.
Use esse campo junto com Reclamação para Perda de Instrução para evitar possíveis perdas da instrução da aplicação.
Marque a caixa de seleção Reclamação para Perda de 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.
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.
No campo Intervalo para 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.
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.
Marque a caixa de seleção Alocação para 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.
Marque a caixa de seleção Associar a 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 pool. Por default, essa opção está desativada.
Marque a caixa de seleção Correspondência de Conexões Ativada 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 tiverem 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.
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 será fechada. Ao limitar o número de vezes que uma conexão pode ser reutilizada, você poderá evitar perdas 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.
Marque a caixa de seleção Validação de Conexão Obrigatória para ativar a validação de conexão.
A validação de conexão permite que o servidor se reconecte em caso de falha.
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 chamando 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.custom-validation
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.
table
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.
Caso você tenha selecionado table
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.
Caso você tenha selecionado custom-validation
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
.
Marque a caixa de seleção Em Caso de 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.
Marque a caixa de seleção Permitir Chamadores que não Sejam 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. Por default, essa opção está desativada.
Clique no botão Esvaziar na guia Geral para descarregar todas as conexões do pool.
Clicar no botão Esvaziar 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.
Clique em Salvar.
Dica:
Para voltar às definições default, clique no botão Carregar Defaults e depois em Salvar.