FirebirdSQL logo

Pool de connexion externe

Chaque connexion externe (créée par l’opérateur EXECUTE STATEMENT …​ ON EXTERNAL) est associée à un pool de connexion à sa création (voir External Connection Pooling pour plus de détails).

Ce groupe d’opérateurs permet de gérer le pool de connexion externe. Dans sa préparation, ils sont décrits comme des opérateurs DDL, mais ont un effet immédiat : c’est-à-dire qu’ils sont exécutés immédiatement et complètement, sans attendre un commit de la transaction.

Les changements sont appliqués à l’instance de pool en mémoire dans le processus Firebird actuel. Par conséquent, un changement dans un processus classique n’affecte pas les autres processus classiques. Les changements ne sont pas permanents, et après le redémarrage de Firebird, les paramètres de pool de firebird.conf seront utilisés.

Le privilège système MODIFY_EXT_CONN_POOL est requis pour exécuter ce groupe d’opérateurs. [fblangref-security-roles-create].

ALTER EXTERNAL CONNECTIONS POOL SET SIZE

Destination

Définit le nombre maximum de connexions inactives.

Syntaxe
ALTER EXTERNAL CONNECTIONS POOL SET SIZE size
Table 1. Paramètres de l’opérateur ALTER EXTERNAL CONNECTIONS POOL SET SIZE
Paramètre Description

size

Taille du pool de connexion externe. Valeurs valides de 0 à 1000.

L’instruction ALTER EXTERNAL CONNECTIONS POOL SET SIZE définit le nombre maximum de connexions inactives dans le pool de connexions externes. Les valeurs valides vont de 0 à 1000.

Une valeur nulle indique que le pool est désactivé. La valeur par défaut est définie dans firebird.conf (paramètre ExtConnPoolSize).

ALTER EXTERNAL CONNECTIONS POOL SET LIFETIME

Destination

Définit la durée de vie des connexions inactives.

Syntaxe
ALTER EXTERNAL CONNECTIONS POOL SET LIFETIME value <time_part>

<time_part> ::= SECOND | MINUTE | HOUR
Table 1. Paramètres de l’opérateur ALTER EXTERNAL CONNECTIONS POOL SET LIFETIME
Paramètre Description

value

Durée de vie des connexions inactives.

L’instruction ALTER EXTERNAL CONNECTIONS POOL SET LIFETIME définit la durée de vie des connexions inactives dans le pool de connexions externes.

Les valeurs valides vont de 1 seconde à 24 heures. La valeur par défaut est définie dans firebird.conf (paramètre ExtConnPoolLifeTime en secondes).

ALTER EXTERNAL CONNECTIONS POOL CLEAR ALL

Destination

Ferme toutes les connexions inactives.

Syntaxe
ALTER EXTERNAL CONNECTIONS POOL CLEAR ALL

L’opérateur ALTER EXTERNAL CONNECTIONS POOL CLEAR ALL ferme toutes les connexions inactives dans le pool de connexions externes. Toutes les connexions actives seront déconnectées du pool (ces connexions seront fermées immédiatement si elles ne sont pas utilisées).