Modificare gli attributi avanzati del pool di connessione JDBC

  1. Nella struttura ad albero, espandere il nodo Resources.
  2. Nel nodo Resources, selezionare il nodo JDBC.
  3. Nel nodo JDBC, selezionare il nodo Connection Pools.

    Viene visualizzata la pagina Connection Pools.

  4. Nella pagina Connection Pools, fare clic sul nome del pool da modificare.

    Viene visualizzata la pagina Edit Connection Pool.

  5. Nella pagina Edit Connection Pool, fare clic sulla scheda Advanced.

    Viene visualizzata la pagina Edit Connection Pool Advanced Attributes.

  6. Nel campo Statement Timeout, digitare il periodo di tempo in secondi trascorso il quale le query di lunghezza eccessiva verranno terminate.

    GlassFish Server imposterà QueryTimeout per le istruzioni create. Impostare il valore su -1 per disabilitare l'opzione. Il valore predefinito è -1.

  7. Nel campo Statement Cache Size, digitare il numero di istruzioni da memorizzare nella cache mediante il meccanismo LRU (Least Recently Used).

    Per disabilitare la memorizzazione nella cache delle istruzioni, specificare il valore 0. Il valore predefinito è 0.

  8. Nel campo Init SQL, digitare la stringa SQL da eseguire ogni volta che si crea (e non ogni volta che si riutilizza) una connessione nel pool.

    L'esecuzione della stringa inizializza lo stato della connessione.

  9. Nel campo SQL Trace Listeners, digitare un elenco separato da virgole di nomi di classi di implementazione del listener per specificare il rilevamento delle istruzioni SQL eseguite dalle applicazioni.

    Le classi listener devono implementare l'interfaccia org.glassfish.api.jdbc.SQLTraceListener . L'utilizzo di listener semplifica il filtraggio dei messaggi del log per il rilevamento delle istruzioni SQL e consente agli amministratori di analizzare le istruzioni.

  10. Selezionare la casella di controllo Wrap JDBC Objects Enabled per far sì che le applicazioni ricevano oggetti JDBC avanzati per Statement, PreparedStatement , CallableStatement, ResultSet e DatabaseMetaData.

    Questa opzione è abilitata per impostazione predefinita.

  11. Selezionare la casella di controllo Pooling per abilitare la creazione del raggruppamento delle connessioni per il pool.

    Questa opzione è abilitata per impostazione predefinita.

  12. Nel campo Validate At Most Once, digitare il numero di secondi al termine dei quali una connessione viene convalidata al massimo una volta.

    Impostando un valore appropriato per questo attributo si riduce al minimo il numero di richieste di convalida di una connessione. Il valore predefinito è 0 e implica che l'attributo non sia abilitato.

  13. Nel campo Leak Timeout, digitare il numero di secondi necessari per rilevare le perdite di connessione in un pool di connessione.

    Utilizzare il campo per rilevare potenziali perdite di connessione dell'applicazione. Si presume che una connessione non restituita al pool dall'applicazione entro il tempo previsto rappresenti una perdita, pertanto viene registrata una traccia dello stack del chiamante. Impostare il valore su 0 per disabilitare il rilevamento delle perdite di connessione. Il valore predefinito è 0.

    Utilizzare il campo insieme a Leak Reclaim per rilevare potenziali perdite di connessione in un pool di connessione.

  14. Selezionare la casella di controllo Leak Reclaim per ripristinare le connessioni perse nel pool una volta completato il rilevamento.

    Questa opzione è disabilitata per impostazione predefinita.

  15. Nel campo Creation Retry Attempts, digitare il numero di tentativi da effettuare in caso di errore durante la creazione di una nuova connessione.

    Impostare il valore su 0 per non impostare alcun tentativo di creazione della connessione. Il valore predefinito è 0.

  16. Nel campo Retry Interval, digitare l'intervallo in secondi che intercorre tra un tentativo di creare una connessione e quello successivo.

    Il valore predefinito è 10. Questo attributo viene utilizzato solo se il valore di Creation Retry Attempts è maggiore di 0.

  17. Selezionare la casella di controllo Lazy Association Enabled per associare una connessione fisica a una connessione logica soltanto quando viene utilizzata.

    Le connessioni vengono disassociate quando la transazione è completa e termina un metodo del componente. In tal modo il riutilizzo delle connessioni fisiche risulta più agevole. Se l'opzione è disabilitata, una connessione fisica viene associata a una connessione logica anche prima di essere utilizzata. Questa opzione è disabilitata per impostazione predefinita.

  18. Selezionare la casella di controllo Lazy Connection Enlistment Enabled per integrare una risorsa nella transazione solo quando viene effettivamente utilizzata in un metodo.

    Questa opzione è disabilitata per impostazione predefinita.

  19. Selezionare la casella di controllo Associate with Thread Enabled per creare associazioni tra connessioni e thread.

    Quando un thread richiede un'altra connessione, può riutilizzare la connessione già associata allo stesso, senza provocare l'overhead per ottenere una connessione aggiuntiva dal pool. Questa opzione è disabilitata per impostazione predefinita.

  20. Selezionare la casella di controllo Match Connections Enabled per abilitare la corrispondenza tra connessioni per il pool.

    Se l'opzione è abilitata, la connessione selezionata dal pool dovrà corrispondere a connessioni provviste di determinate credenziali. L'opzione deve essere abilitata se il pool di connessione viene utilizzato da applicazioni provviste di più credenziali utente. L'opzione può essere disabilitata se l'amministratore è certo che le connessioni del pool saranno sempre omogenee e che una connessione ottenuta dal pool non dovrà corrispondere all'adattatore di risorsa. Questa opzione è disabilitata per impostazione predefinita.

  21. Nel campo Max Connection Usage, digitare il numero di volte in cui 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. Impostare il valore su 0 per disabilitare l'attributo. Il valore predefinito è 0.

  22. Selezionare la casella di controllo Connection Validation Required per abilitare la convalida della connessione.

    La convalida della connessione consente la riconnessione del server in caso di interruzione.

  23. Dall'elenco a discesa Validation Method, selezionare un metodo di convalida.

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

    auto-commit e metadata

    GlassFish Server convalida una connessione chiamando i metodi con.getAutoCommit e con.getMetaData.


    Nota - Molti driver JDBC memorizzano i risultati di tali chiamate nella cache. Di conseguenza, è possibile che l'utilizzo delle chiamate non fornisca convalide affidabili. Verificare con il produttore del driver se le chiamate vengono salvate o meno nella memoria cache.


    custom-validation

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

    table

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

  24. Se dall'elenco a discesa Validation Method è stata selezionata l'opzione table, selezionare il nome della tabella del database nell'elenco a discesa Table Name.
  25. Se dall'elenco a discesa Validation Method è stata selezionata l'opzione custom-validation, digitare il nome della classe di implementazione della convalida personalizzata.

    Il nome classe fornito deve risultare accessibile per GlassFish Server. La classe specificata deve implementare l'interfaccia org.glassfish.api.jdbc.ConnectionValidation .

  26. Selezionare la casella di controllo On Any Failure Close All Connections per far sì che il server chiuda e ripristini tutte le connessioni del pool nel caso di un errore relativo a una singola connessione.

    Se l'opzione è disabilitata, le singole connessioni vengono ristabilite soltanto quando vengono utilizzate. Questa opzione è disabilitata per impostazione predefinita.

  27. Selezionare l'opzione Allow Non Component Callers Enabled per far sì che il pool possa essere utilizzato da chiamanti diversi dai componenti, quali filtri servlet e persistence manager di altri produttori.

    Le connessioni ottenute da chiamanti diversi dai componenti non vengono chiuse automaticamente dal contenitore al termine di una transazione. Devono essere chiuse esplicitamente dal chiamante. Questa opzione è disabilitata per impostazione predefinita.

  28. (Opzionale) Fare clic sul pulsante Flush della scheda General per scaricare tutte le connessioni dal pool.

    Se si fa clic sul pulsante Flush vengono eliminate le connessioni esistenti, ricreate le connessioni stabilite per il pool e ripristinate le dimensioni minime e iniziali del pool.

  29. Fare clic su Save.

    Suggerimento - Per tornare alle impostazioni predefinite, fare clic sul pulsante Load Defaults, quindi su Save.


Vedere anche

Copyright © 2005, 2011, Oracle e/o relative consociate. Tutti i diritti riservati. Nota legale