Modifica attributi avanza connection pool

Nella pagina Modifica attributi avanzati connection pool è possibile specificare attributi che consentono di diagnosticare le perdite di connessione e semplificare l'utilizzo.

La pagina Modifica attributi avanzati connection pool contiene le opzioni riportate di seguito.

Carica impostazioni predefinite

Pulsante che consente di ripristinare i valori predefiniti delle impostazioni che dispongono di tali valori. Le impostazioni prive di valori predefiniti restano invariate.

Nome pool

Nome del connection pool. Il campo relativo al nome è di sola lettura. È possibile specificare il nome del connection pool solo quando si crea un nuovo connection pool JDBC.

Timeout istruzione

Periodo di tempo, in secondi, trascorso il quale le query con esecuzione prolungata in modo anomalo vengono interrotte. GlassFish Server imposterà QueryTimeout per le istruzioni create. Il valore -1 indica che l'opzione è disabilitata. Il valore predefinito è -1.

Dimensione cache istruzioni

Numero di istruzioni da inserire nella cache mediante il meccanismo di inserimento nella cache LRU (Least Recently Used; Utilizzato meno di recente). Il valore 0 disabilita l'inserimento delle istruzioni nella cache. Il valore predefinito è 0.

SQL iniz.

Stringa SQL da eseguire ogni volta che si crea (e non ogni volta che si riutilizza) una connessione nel pool. L'esecuzione di questa stringa inizializza lo stato della connessione.

Listener SQL Trace

Lista di valori separati da virgole di nomi di classi di implementazione dei listener. Specifica che verrà eseguito il trace delle istruzioni SQL eseguite dalle applicazioni. Le classi dei listener devono implementare l'interfaccia org.glassfish.api.jdbc.SQLTraceListener. L'utilizzo di listener semplifica l'applicazione di filtri ai messaggi di log per individuare le istruzioni SQL e consente agli amministratori di analizzare le istruzioni.

Wrapping oggetti JDBC

Se questa opzione è abilitata, le applicazioni otterranno oggetti JDBC di cui è stato eseguito il wrapping per Statement, PreparedStatement, CallableStatement, ResultSet e DatabaseMetaData. Questa opzione è abilitata per impostazione predefinita.

Pooling

Abilita il connection pooling per il pool. Questa opzione è abilitata per impostazione predefinita.

Convalida al massimo una volta

Specifica l'intervallo di tempo, in secondi, tra richieste successive di convalida di una connessione (al massimo una volta). L'impostazione questo attributo su un valore appropriato riduce al minimo il numero di richieste di convalida di una connessione. Il valore predefinito è 0 e implica che l'attributo non sia abilitato.

Timeout perdite connessione

Quantità di tempo, in secondi, necessaria per eseguire il trace delle perdite di connessione in un connection pool. Utilizzare questo campo per rilevare potenziali perdite di connessione da parte dell'applicazione. Quando una connessione non viene restituita al pool dall'applicazione entro il periodo specificato, si presume che sia una potenziale perdita e viene registrato uno stack trace del chiamante. Un valore pari a 0 indica che il trace delle perdite di connessione è disabilitato. Il valore predefinito è 0.

Utilizzare questo campo insieme a Recupero perdite per evitare potenziali perdite di connessione dall'applicazione.

Recupero perdite connessione

Se questa opzione è abilitata, le connessioni perse vengono ripristinate nel pool al termine del trace delle perdite di connessione. Questa opzione è disabilitata per impostazione predefinita.

Timeout perdite istruzioni

Quantità di tempo, in secondi, necessaria per eseguire il trace delle perdite di istruzioni in un connection pool. Utilizzare questo campo per rilevare potenziali perdite di istruzioni da parte dell'applicazione. Quando una istruzione non viene restituita al pool dall'applicazione entro il periodo specificato, si presume che sia una potenziale perdita e viene registrato uno stack trace del chiamante. Un valore pari a 0 indica che il trace di perdite di connessione è disabilitato. Il valore predefinito è 0.

Utilizzare questo campo insieme a Recupero perdite istruzioni per evitare potenziali perdite di connessione dall'applicazione.

Recupero perdite istruzioni

Se questa opzione è abilitata, le istruzioni perse vengono ripristinate nel pool al termine del trace delle perdite di istruzioni. Questa opzione è disabilitata per impostazione predefinita.

Numero di nuovi tentativi di creazione

Numero di tentativi che verranno eseguiti in caso di errore durante la creazione di una nuova connessione. Un valore pari a 0 indica che non verrà effettuato alcun tentativo di ricreare la connessione. Il valore predefinito è 0.

Intervallo tentativi

Intervallo di tempo, in secondi, tra due tentativi di creazione di una connessione. Il valore predefinito è 10. Questo attributo viene utilizzato solo se il valore di Numero di nuovi tentativi di creazione è maggiore di 0.

Associazione ritardata

Se questa opzione è abilitata, una connessione fisica viene associata a una connessione logica solo quando viene utilizzata. Viene annullata l'associazione delle connessioni quando la transazione è completa e un metodo di un componente termina, in modo da facilitare il riutilizzo delle connessioni fisiche. Questa opzione è disabilitata per impostazione predefinita.

Partecipazione alla transazione connessioni ritardate

Se questa opzione è abilitata, una risorsa viene integrata nella transazione solo se è effettivamente utilizzata in un metodo. Questa opzione è disabilitata per impostazione predefinita.

Associa a thread

Se questa opzione è abilitata, la connessione viene associata a un thread in modo tale che, quando occorre una connessione, lo stesso thread possa riutilizzare la connessione già associata senza provocare un sovraccarico dalla necessità di ottenere una connessione dal pool. Questa opzione è disabilitata per impostazione predefinita.

Corrispondenza connessioni

Se questa opzione è abilitata, una connessione selezionata dal pool deve corrispondere alle connessioni provviste di determinate credenziali. Questa opzione deve essere abilitata se il connection pool viene utilizzato da applicazioni provviste di più credenziali utente. È possibile disabilitare questa opzione in modo sicuro se l'amministratore sa che le connessioni del pool saranno sempre omogenee e che quindi non è necessario che una connessione selezionata dal pool debba essere abbinata dal Resource Adapter. Questa opzione è disabilitata per impostazione predefinita.

Utilizzo max connessioni

Numero di volte che una connessione deve essere riutilizzata dal pool. Una volta che una connessione viene riutilizzata per il numero di volte specificato, viene chiusa. Limitando il numero di riutilizzi di una connessione, è possibile evitare perdite di istruzioni nel caso in cui un'applicazione non chiuda le istruzioni. Un valore pari a 0 indica che questo attributo è disabilitato. Il valore predefinito è 0.

Convalida connessione

Se questa opzione è abilitata, è necessario eseguire la convalida della connessione, che consente al server di riconnettersi in caso di errore.

Metodo di convalida

GlassFish Server può convalidare le connessioni al database nei seguenti modi.

auto-commit e metadata

GlassFish Server convalida una connessione chiamando il metodo con.getAutoCommit o con.getMetaData.


Nota:

Molti driver JDBC inseriscono i risultati di queste chiamate nella cache. Di conseguenza, è possibile che l'utilizzo di queste chiamate non fornisca convalide affidabili. Verificare con il fornitore del driver se queste chiamate vengono inserite o meno nella cache.
custom-validation

GlassFish Server utilizza un meccanismo di convalida definito dall'utente, specificato dalla classe di implementazione personalizzata nel campo Nome classe di convalida.

table

L'applicazione esegue query sulla tabella di database specificata. La tabella deve esistere ed essere accessibile, ma non richiede righe. Non utilizzare una tabella esistente con un numero elevato di righe o una tabella a cui si accede di frequente.

Nome tabella

Nome della tabella di database per la convalida. Questo campo è applicabile solo se il campo Metodo di convalida è impostato su table. È possibile selezionare il nome dall'elenco a discesa o digitarlo.

Nome classe di convalida

Nome della classe di implementazione della convalida personalizzata. Il campo è applicabile solo se il campo Metodo di convalida è impostato su custom-validation. Il nome di classe fornito deve risultare accessibile a GlassFish Server. La classe specificata deve implementare l'interfaccia org.glassfish.api.jdbc.ConnectionValidation. È possibile selezionare il nome dall'elenco a discesa o digitarlo.

In caso di qualsiasi errore

Se questa opzione è abilitata, GlassFish Server chiude tutte le connessioni nel pool e le ristabilisce se una connessione non riesce. Se l'opzione è disabilitata, le singole connessioni vengono ristabilite solo quando vengono utilizzate. Questa opzione è disabilitata per impostazione predefinita.

Consenti chiamanti non componenti

Se questa opzione è abilitata, il pool può essere utilizzato da chiamanti non componenti, quali filtri servlet e Persistence Manager di terze parti. Le connessioni ottenute da chiamanti non componenti non vengono chiuse automaticamente dal contenitore al termine di una transazione. Devono essere chiuse esplicitamente dal chiamante. Questa opzione è disabilitata per impostazione predefinita.

Task correlati
Comandi asadmin correlati
Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices