Quando si crea un connection pool con Console di amministrazione, si definiscono gli aspetti di una connessione a un database specifico.
Per creare un connection pool, è necessario in primo luogo installare e integrare un driver che supporti l'interfaccia API JDBC (driver JDBC). Vedere Per integrare un driver JDBC.
Per la creazione del connection pool JDBC sono necessarie le informazioni riportate di seguito. Raccogliere queste informazioni prima di continuare:
Nome del fornitore del driver del database
Tipo di risorsa, ad esempio javax.sql.DataSource
(solo transazioni locali), java.sql.ConnectionPoolDataSource
(transazioni locali, possibili miglioramenti delle prestazioni), javax.sql.XADataSource
(transazioni globali) e java.sql.Driver
Nome classe dell'origine dati
Proprietà obbligatorie, quali il nome (URL) del database, il nome utente e la password
Selezionare il nodo Task comuni nell'albero di navigazione.
Viene visualizzata la pagina Task comuni.
Nella pagina Task comuni fare clic sul pulsante Crea nuovo connection pool JDBC.
Viene visualizzata la pagina Nuovo connection pool JDBC (passo 1 di 2).
Nota:
È possibile accedere alla pagina Nuovo connection pool JDBC anche espandendo il nodo Risorse e il nodo JDBC, quindi selezionando il nodo Connection pool. Nella pagina Connection pool fare quindi clic su Nuovo per creare un nuovo connection pool.Nel campo Nome pool digitare un nome per il nuovo connection pool.
Questo campo è obbligatorio.
Nell'elenco a discesa Tipo di risorsa selezionare un tipo di risorsa.
Le opzioni disponibili includono javax.sql.XADataSource
(transazioni globali), java.sql.ConnectionPoolDataSource
(transazioni locali, possibili miglioramenti delle prestazioni), javax.sql.DataSource
(solo transazioni locali) e java.sql.Driver
.
Specificare un fornitore di database:
selezionare un fornitore di database nell'elenco a discesa Fornitore driver database.
Se il fornitore desiderato non viene visualizzato nella lista, digitarne il nome nel campo di testo Fornitore driver database.
Selezionare la casella di controllo Abilitato dell'opzione Analisi per eseguire l'introspezione del driver del database in base al tipo di risorsa e al fornitore del driver del database.
Affinché l'introspezione riesca, il driver JDBC deve essere disponibile per GlassFish Server. Vedere Per integrare un driver JDBC.
Fare clic su Successivo.
Viene visualizzata la pagina Nuovo connection pool JDBC (passo 2 di 2).
Nel campo Nome classe origine dati digitare il nome della classe specifica del fornitore che implementa l'interfaccia API DataSource
, ConnectionPoolDataSource
o XADataSource
.
Se sono stati selezionati la casella di controllo Abilitato dell'opzione Analisi e uno dei tipi di risorsa di origine dati, nel campo viene inserito automaticamente il nome classe associato al tipo di risorsa e al fornitore di database scelti. Se è stato selezionato il tipo di risorsa java.sql.Driver
, il campo è disabilitato.
Nel campo Nome classe driver digitare il nome della classe specifica del fornitore che implementa l'interfaccia API java.sql.Driver
.
Se è stato selezionata la casella di controllo Abilitato dell'opzione Analisi o è stato selezionato il tipo di risorsa java.sql.Driver
, in questo campo viene inserito automaticamente il nome di classe associato al driver e al fornitore di database scelti. Se è stato selezionato uno dei tipi di risorsa origine dati, il campo è disabilitato.
Selezionare la casella di controllo Abilitato dell'opzione Ping per eseguire automaticamente il ping durante il processo di creazione o riconfigurazione del pool al fine di identificare e segnalare valori errati degli attributi.
Questa opzione è disabilitata per impostazione predefinita.
Nel campo Descrizione digitare una breve descrizione per il connection pool.
Nel campo Dimensione pool iniziale e minima digitare il numero minimo di connessioni per il pool.
Questo valore determina inoltre il numero di connessioni inserite nel pool al momento della creazione del pool o all'avvio di GlassFish Server. Il valore predefinito è 8.
Nel campo Dimensione massima pool digitare il numero massimo di connessioni per il pool.
Il valore predefinito è 32.
Nel campo Quantità di ridimensionamento pool digitare il numero di connessioni da includere in ogni batch di ridimensionamento del pool.
Quando si verificano lo scale up e lo scale down del pool, verso la dimensione massima e minima rispettivamente, il ridimensionamento viene eseguito per batch. Questo valore determina il numero di connessioni presenti nel batch. Se il valore è troppo grande può generare ritardi nella creazione e nella riattivazione delle connessioni, mentre se è troppo piccolo può ridurre le prestazioni complessive. Il valore predefinito è 2.
Nel campo Timeout inattività digitare il periodo di tempo massimo, in secondi, durante il quale una connessione può rimanere inattiva nel pool.
Una volta trascorso il periodo di tempo impostato, la connessione viene rimossa dal pool. Il valore predefinito è 300.
Nel campo Tempo massimo di attesa digitare il tempo massimo di attesa, in millisecondi, per la richiesta di connessione da parte di un'applicazione prima che si verifichi il timeout della connessione.
Il valore predefinito è 60.000.
Selezionare la casella di controllo Abilitato dell'opzione Connessioni non transazionali per restituire connessioni non transazionali.
Questa opzione è disabilitata per impostazione predefinita.
Nell'elenco a discesa Livello di isolamento dell'opzione Isolamento transazione selezionare un livello di isolamento transazione per il connection pool corrente.
Se il livello non è specificato, le connessioni funzionano con i livelli di isolamento predefiniti forniti dal driver JDBC. Per impostazione predefinita, questa opzione non viene specificata.
Selezionare la casella di controllo Garantito dell'opzione Livello di isolamento per garantire che tutte le connessioni del pool dispongano dello stesso livello di isolamento.
Ad esempio, se il livello di isolamento della connessione viene modificato a livello di programmazione (mediante con.setTransactionIsolation
) al momento dell'ultimo utilizzo, questo meccanismo ripristina il livello di isolamento specificato per lo stato. Questa opzione è abilitata per impostazione predefinita.
Questa impostazione è applicabile solo se è stato specificato un livello isolamento transazione.
Nella sezione Proprietà aggiuntive, specificare le proprietà aggiuntive.
Alcuni esempi di proprietà obbligatorie sono il nome del database (URL), il nome utente e la password. In genere la tabella contiene le proprietà utilizzate dal fornitore del database. Per informazioni su alcune delle proprietà disponibili, vedere Proprietà specifiche dei connection pool JDBC.
Se non si specifica un valore per una proprietà, la proprietà interessata verrà rimossa dalla tabella al termine della creazione del connection pool. Se non si desidera impostare il valore di una proprietà in questa fase, conservando tuttavia la proprietà nella tabella in modo da impostarne il valore in un secondo momento, digitare un set di parentesi vuote nel campo Valore:
()
Per aggiungere una proprietà, fare clic sul pulsante Aggiungi proprietà. Nella riga vuota visualizzata, digitare il nome della proprietà nel campo Nome e il valore della proprietà nel campo Valore.
Per modificare una proprietà, è necessario modificare il valore del campo Valore della proprietà.
Per eliminare una proprietà, selezionare la casella di controllo a sinistra del campo Nome corrispondente alla proprietà da eliminare, quindi fare clic sul pulsante Elimina proprietà.
Fare clic su Fine.