FirebirdSQL logo
 Instructions de procédure SQL (PSQL)Fonctions agrégées 

Espace de nommage SYSTEM

Variables de l’espace de nommage SYSTEM
CLIENT_ADDRESS

Adresse du client. Pour TCPv4 - adresse IP, pour XNET - ID du processus local. Pour les autres cas NULL.

CLIENT_HOST

Le nom d’hôte du protocole réseau du client distant. La valeur est renvoyée pour tous les protocoles pris en charge.

CLIENT_OS_USER

Le nom d’utilisateur du système d’exploitation de l’ordinateur client.

CLIENT_PID

Le PID du processus sur l’ordinateur client.

CLIENT_PROCESS

Chemin complet de l’application client se connectant à la base de données.

CLIENT_VERSION

La version de la bibliothèque client (fbclient) utilisée par l’application client.

CURRENT_ROLE

La variable globale CURRENT_ROLE.

CURRENT_USER

La variable globale CURRENT_USER.

DB_NAME

Le nom canonique de la base de données actuelle. C’est soit un nom d’alias (si la connexion au nom de fichier est interdite DatabaseAccess = NONE) ou, sinon, un nom de fichier de base de données entièrement étendu.

DB_FILE_ID

Identifiant unique de la base de données actuelle au niveau du système de fichiers.

DB_GUID

GUID de la base de données.

EFFECTIVE_USER

L’utilisateur effectif à l’heure actuelle. Indique l’utilisateur avec des privilèges dont la procédure, la fonction ou le déclencheur est en cours d’exécution.

ENGINE_VERSION

Version du serveur Firebird.

EXT_CONN_POOL_SIZE

Taille du pool de connexions externes.

EXT_CONN_POOL_LIFETIME

La durée de vie des connexions inactives dans le pool de connexion externe.

EXT_CONN_POOL_IDLE_COUNT

Le nombre actuel de connexions inactives dans le pool de connexions externes.connexions.

EXT_CONN_POOL_ACTIVE_COUNT

Le nombre actuel de connexions actives dans le pool de connexions externes.

GLOBAL_CN

Dernière valeur du compteur global actuel de Commit Number

ISOLATION_LEVEL

Le niveau d’isolement de la transaction actuelle — CURRENT_TRANSACTION. Valeurs : 'READ_COMMITED', 'SNAPSHOT' ou 'CONSISTENCY'.

LOCK_TIMEOUT

Le temps qu’une transaction attend pour que la ressource soit libérée lorsqu’elle est bloquée, en secondes.

NETWORK_PROTOCOL

Le protocole utilisé pour se connecter à la base de données. Valeurs possibles : 'TCPv4', 'TCPv6', 'WNET', 'XNET', NULL.

PARALLEL_WORKERS

Nombre maximal de flux de travail parallèles dans la connexion actuelle.

READ_ONLY

Indique si la transaction est une transaction en lecture seule. 'FALSE' pour les transactions en lecture-écriture 'TRUE' pour la lecture seule.

REPLICA_MODE

Mode de réplication : chaîne vide ou NULL--base de données primaire, READ-ONLY--réplique en lecture seule, READ-WRITE--réplique en lecture-écriture.

REPLICATION_SEQUENCE

La valeur actuelle de la séquence de réplication (le numéro du dernier segment écrit dans le journal de réplication).

SESSION_ID

Variable globale CURRENT_CONNECTION.

SESSION_IDLE_TIMEOUT

Contient la valeur actuelle du délai d’inactivité de la connexion en secondes, qui a été définie au niveau de la connexion, ou zéro si aucun délai n’a été défini.

SESSION_TIMEZONE

Le fuseau horaire actuel défini dans la session en cours.

SNAPSHOT_NUMBER

Nombre d’instantanés de la base de données : niveau transaction (pour la transaction SNAPSHOT ou CONSISTENCY) ou niveau requête (pour la transaction READ COMMITTED READ CONSISTENCY). NULL si le snapshot n’existe pas.

STATEMENT_TIMEOUT

Contient la valeur actuelle du délai d’exécution de l’opérateur en millisecondes, qui a été défini au niveau de la connexion, ou zéro si aucun délai n’a été défini.

TRANSACTION_ID

Variable globale CURRENT_TRANSACTION.

WIRE_COMPRESSED

Si la compression du trafic réseau est utilisée ou non. Si la compression du trafic réseau est utilisée, elle renvoie 'TRUE', sinon 'FALSE'. Pour les connexions embarquées — renvoie NULL.

WIRE_ENCRYPTED

Si le cryptage du trafic réseau est utilisé. Si le cryptage du trafic réseau est utilisé, renvoie "VRAI", sinon "FAUX". Pour les connexions embarquées — renvoie NULL.

WIRE_CRYPT_PLUGIN

Si le cryptage du trafic réseau est utilisé, renvoie le nom du plugin de cryptage actuel, sinon NULL.

Espace de nommage`DDL_TRIGGER`

L’utilisation de l’espace de nom DDL_TRIGGER n’est autorisée que pendant l’exécution du déclencheur DDL. Son utilisation est également autorisée dans les procédures stockées et les fonctions appelées par les déclencheurs DDL.

Le contexte DDL_TRIGGER fonctionne comme une pile. Avant que le trigger DDL ne soit déclenché, les valeurs liées à la commande en cours d’exécution sont placées sur cette pile. Lorsque le trigger est terminé, les valeurs sont éjectées.Ainsi, dans le cas d’instructions DDL en cascade, lorsque chaque commande DDL utilisateur déclenche un trigger DDL et que ce trigger déclenche d’autres commandes DDL, avec EXECUTE STATEMENT, les valeurs des variables dans l’espace de noms DDL_TRIGGER correspondront à la commande qui a déclenché le dernier trigger DDL dans la pile d’appels.

Variables de l’espace de nommage DDL_TRIGGER
EVENT_TYPE

type d’événement (CREATE, ALTER, DROP).

OBJECT_TYPE

type d’objet (TABLE, VIEW et al.).

DDL_EVENT

(<ddl event item>), où <ddl_event_item> c’est EVENT_TYPE || ' ' || OBJECT_TYPE

OBJECT_NAME

le nom de l’objet de métadonnées.

OLD_OBJECT_NAME

le nom de l’objet de métadonnées avant son renommage.

NEW_OBJECT_NAME

le nom de l’objet de métadonnées après renommage.

SQL_TEXT

le texte de la requête SQL.

Note

Une fois de plus, notez que les noms d’espaces de noms et de variables sont sensibles à la casse, doivent être des chaînes de caractères non vides, et sont entourés de guillemets !