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.
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:
Nome do fornecedor do driver de banco de dados
Tipo de recurso, por exemplo, javax.sql.DataSource
(somente transações locais), java.sql.ConnectionPoolDataSource
(transações locais; possíveis melhorias de desempenho) e javax.sql.XADataSource
(transações globais) java.sql.Driver
.
Nome de classe da fonte de dados
Propriedades necessárias; por exemplo, nome do banco de dados (URL), nome de usuário e senha
Na árvore de navegação, selecione o nó Tarefas Comuns.
A página Tarefas Comuns será aberta.
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) será aberta.
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.No campo Nome do Pool, digite o nome do novo pool de conexões.
Esse campo é obrigatório.
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
.
Especifique um fornecedor de banco de dados:
Na lista drop-down Fornecedor do Driver de Banco de Dados, selecione um fornecedor de banco de dados.
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.
Marque a caixa de seleção Omissão Ativada para efetuar a omissão do driver do banco de dados com base no Tipo de Recurso e no Fornecedor do Driver do Banco de Dados.
Para que a omissão funcione, o driver JDBC deve estar disponível para GlassFish Server. Consulte Para Integrar um Driver JDBC.
Clique em Próximo.
A página Novo Pool de Conexões JDBC (Etapa 2 de 2) será aberta.
No campo Nome da classe da fonte de dados, digite o nome da classe específica do fornecedor que implementa a API DataSource
, ConnectionPoolDataSource
ou XADataSource
.
Se você tiver selecionado Omissão Ativada e um dos tipos de recursos da fonte de dados, esse campo será preenchido automaticamente com o nome da classe associado ao tipo de recurso e com o fornecedor do banco de dados de sua escolha. Se você selecionou o tipo de recursojava.sql.Driver
, esse campo será desativado.
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ê tiver selecionado Omissão Ativada ou o tipo de recurso java.sql.Driver
, esse campo será automaticamente preenchido com o nome da classe associado ao driver e ao fornecedor de banco de dados de sua escolha. Se você selecionou um dos tipos de recursos de fonte de dados, esse campo é desativado.
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.
No campo Descrição, digite uma descrição breve do pool de conexões.
No campo Tamanho Inicial e Mínimo do Pool, digite o número mínimo de conexões para esse pool.
Esse valor também determina o número de conexões colocadas no pool quando o pool é criado pela primeira vez ou quando o GlassFish Server é iniciado. O valor default é 8.
No campo Tamanho Máximo do Pool, digite o número máximo de conexões para esse Pool.
O valor default é 32.
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.
No campo Time-out para Ociosidade, 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 pool. O valor default é 300.
No campo Tempo Máximo de Espera, digite o tempo máximo, em milissegundos, que a aplicação solicitante da conexão aguardará até obter um time-out.
O valor default é 60.000.
Marque a caixa de seleção Conexões Não Transacionais Ativadas para retornar conexões não transacionais.
Por default, essa opção está desativada.
Na lista drop-down Nível de 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.
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.
Na seção Propriedades Adicionais, especifique as propriedades adicionais.
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 os 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:
()
Para adicionar uma propriedade, clique no botão Adicionar Propriedade. Na linha em branco que for exibida, digite o nome da propriedade no campo Nome e digite o valor da propriedade no campo Valor.
Para modificar uma propriedade, edite o campo Valor da propriedade.
Para deletar uma propriedade, marque a caixa de seleção à esquerda do campo Nome da Propriedade a ser deletada. Clique no botão Deletar Propriedades.
Clique em Finalizar.