Editar Atributos Avançados do Pool de Conexões

Use a página Editar Atributos Avançados do pool de conexões, para especificar atributos que ajudam a diagnosticar vazamentos de conexão e aprimorar a facilidade de uso.

A página Editar Atributos Avançados do pool de conexões contém as seguintes opções.

Descarregar Padrões

Botão para restaurar os valores padrão de todas as configurações.

Nome do Pool

O nome do pool de conexões. O nome é um campo somente leitura. Você só poderá especificar nome do pool de conexões quando criar um novo pool de conexões do JDBC.

Tempo-limite da Instrução

Período em segundos, após o qual as consultas de execução anormalmente longa serão encerradas. O Servidor GlassFish configura o Tempo-limite de Consulta nas instruções criadas. Um valor de -1 significa que a opção está desativada. O valor padrão é -1.

Tamanho do cache de declaração

O número de declarações a serem colocadas no cache usando o mecanismo de cache LRU (Least Recently Used). Um valor de 0 desativa a colocação de declarações no cache. O valor padrão é 0.

Init SQL

Uma sequência SQL a ser executada sempre que uma conexão é criada (não reutilizada) no pool. A execução desta sequência inicializa o estado da conexão.

Listeners de rastreamento SQL

Uma lista separada por vírgulas de nomes de classes de implementação do listener, que especifica que as declarações SQL executadas por aplicativos serão rastreadas. As classes do listener precisam implementar o org.glassfish.api.jdbc.SQLTraceListener da interface. O uso de listeners permite a fácil filtragem de registros de mensagens para as declarações SQL e ajuda os administradores a analisarem as declarações.

Ajustar Objetos JDBC

Quando esta opção é ativada, o aplicativos irão obter objetos JDBC incorporados para Statement, PreparedStatement, CallableStatement, ResultSet, DatabaseMetaData. Por padrão, a opção está ativada.

Colocar no pool

Permite colocar no pool as conexões para o pool. Por padrão, a opção está ativada.

Validar no Máximo Uma Vez

Período em segundos, após o qual a conexão será validada no máximo uma vez. Isso ajuda a reduzir o número de solicitações de validação. O valor padrão é 0.

Tempo-limite da Perda

Período em segundos para rastrear as perdas de conexão em um pool de conexões. Use este campo para detectar potenciais vazamentos de conexão pelo aplicativo. Uma conexão que não é retornada para o pool pelo aplicativo dentro do período especificado é assumida como sendo de potencial vazamento, e um rastreamento de pilha do chamador é registrado. Um valor de 0 que o rastreamento de vazamento da conexão está desativado. O valor padrão é 0.

Use este campo junto com Reclamar vazamento, para evitar potenciais vazamentos de conexão pelo aplicativo.

Reclamação de Perda

Se esta opção está ativada, as conexões com vazamento serão restauradas no pool após a conclusão do rastreamento de vazamento da conexão. Por padrão, a opção está desativada.

Novas Tentativas de Criação

O número de tentativas a serem feitas se houver uma falha na criação de uma nova conexão. O valor de 0 significa que nenhuma tentativa será feita para criar a conexão novamente. O valor padrão é 0.

Intervalo de Nova Tentativa

O intervalo de tempo, em segundos, entre duas tentativas de criar uma conexão. O valor padrão é 10. Esse atributo só será usado se o valor Novas Tentativas de Criação for maior que 0.

Associação Lenta

Se esta opção está ativada, uma conexão física é associada à coleção lógica somente quando a conexão é 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. Por padrão, a opção está desativada.

Inscrição de Conexão Lenta

Se esta opção está ativada, um recurso para a transação será inscrito somente quando a transação for realmente usada em um método. Por padrão, a opção está desativada.

Associar com Segmento

Se esta opção está ativada, uma associação será estabelecida entre uma conexão com o thread, para quando o mesmo thread for necessário à uma conexão, a conexão já associada ao thread poderá ser reutilizada, não incorrendo, portanto, na sobrecarga para obtenção de uma conexão no pool. Por padrão, a opção está desativada.

Conexões Correspondentes

Se esta opção está ativada, uma conexão que é selecionada do pool deveria ser correspondida com as conexões que têm determinadas credenciais. Esta opção precisa ser ativada se o pool de conexões é usado por aplicativos que têm múltiplas credenciais de usuário. Essa opção poderá ser desativada com segurança 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 padrão, a opção está desativada.

Uso Máx. de Conexão

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ê pode evitar vazamentos de declarações se um aplicativo não fecha declarações. Um valor de 0 significa que a opção está desativada. O valor padrão é 0.

Validação da Conexão

Se esta opção for ativada, a validação de conexão será necessária, permitindo que o servidor se reconecte em caso de falha.

Método de Validação

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

confirmação automática e metadados

O Servidor GlassFish valida a conexão ao chamar o método con.getAutoCommit ou con.getMetaData.


Observação - Muitos drivers JDBC armazenam em 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 em cache.


validação personalizada

O Servidor GlassFish 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

O aplicativo 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.

Nome da Tabela

Nome da tabela de banco de dados para validação. Esse campo só será aplicável se o método de validação tiver sido definido como tabela.

Nome da classe de validação

O nome da classe de implementação personalizada. Esse campo só será aplicável se o método de validação tiver sido definido como validação personalizada. O nome da classe fornecido precisa estar acessível ao Servidor GlassFish. A classe especificada deve implementar o org.glassfish.api.jdbc.ConnectionValidation da interface.

Em Qualquer Falha

Se esta opção for ativada, o Servidor GlassFish fechará todas as conexões do pool e as restabelecerá quando alguma conexão falhar. Se a opção for desativada, cada conexão individual somente será restabelecida quando for usada. Por padrão, a opção está desativada.

Permitir Chamadores Não Componentes

Se esta opção for ativada, o pool poderá ser usado pelos chamadores não de componentes; por exemplo; filtros de servlet 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 container. Elas precisam ser explicitamente fechadas pelo chamador. Por padrão, a opção está desativada.

Tarefas relacionadas
Comandos asadmin relacionados
Copyright © 2010 Oracle and/or its affiliates. All rights reserved. Advertência legal