Propriété capturedOnly

Indique si seules les instructions SQL contenues dans le fichier pureQueryXML doivent être exécutées.

Vous pouvez définir cette propriété sur TRUE après avoir créé un fichier pureQueryXML à utiliser avec une application. Vous ne pouvez pas la définir sur TRUE lorsque vous capturez des instructions SQL.

Cette propriété peut posséder les valeurs suivantes :

TRUE
L'application exécute uniquement les instructions SQL qui se trouvent dans le fichier pureQueryXML.
FALSE
L'application exécute toutes les instructions SQL, y compris celles qui ne se trouvent pas dans le fichier pureQueryXML.
Il s'agit de la valeur par défaut.
Remarque : Lorsque la propriété capturedOnly est définie sur TRUE, les instructions SET définissant des registres spéciaux ou des méthodes de connexion JDBC définissant des registres spéciaux ne sont pas limitées par pureQuery Runtime. Les instructions sont toujours autorisées que l'instruction se trouve ou non dans le fichier pureQueryXML.
Si une instruction SQL est exécutée avec le verrouillage optimiste, elle ne peut pas être exécutée de façon statique. Par conséquent, pureQuery Runtime ne capture pas des instructions qui sont exécutées avec le verrouillage optimiste. Les instructions ne sont pas concernées par les options allowDynamicSQL ou capturedOnly de pureQuery Runtime. Le verrouillage optimiste est activé par les méthodes suivantes :

DB2Connection.prepareDB2OptimisticLockingQuery
DB2Statement.executeDB2OptimisticLockingQuery

Le tableau suivant présente les combinaisons de capturedOnly, executionMode et allowDynamicSQL ainsi que les opérations résultantes :

Tableau 1. Combinaisons capturedOnly, executionMode et allowDynamicSQL et opérations résultantes :
capturedOnly executionMode allowDynamicSQL Instruction SQL correspondante Résultat
TRUE STATIC TRUE OUI isBindable = True : exécution de l'instruction SQL en mode statique

isBindable = False : exécution de l'instruction SQL en mode dynamique

TRUE STATIC/DYNAMIC TRUE/FALSE NO Renvoie une erreur
TRUE STATIC FALSE OUI isBindable = True : exécution de l'instruction SQL en mode statique

isBindable = False : renvoi d'une erreur

TRUE DYNAMIC TRUE/FALSE OUI Exécuter l'instruction SQL
FALSE STATIC TRUE OUI isBindable = True : exécution de l'instruction SQL en mode statique.

isBindable = False : exécution de l'instruction SQL en mode dynamique

FALSE STATIC TRUE NO Exécuter l'instruction SQL en mode dynamique
FALSE STATIC FALSE OUI isBindable = True : exécution de l'instruction SQL en mode statique.

isBindable = False : renvoi d'une erreur

FALSE STATIC FALSE NO Renvoie une erreur
FALSE DYNAMIC TRUE/FALSE YES/NO Exécuter l'instruction SQL

Notes d'utilisation de l'interface CLI DB2 et d'IBM Data Server Driver

Lors de l'utilisation de l'interface CLI DB2 ou d'IBM® Data Server Driver avec pureQuery Runtime, vous pouvez utiliser la propriété pureQuery Runtime comme mot clé de configuration.

Syntaxe de mot clé CLI IBM
capturedOnly = TRUE | FALSE
Syntaxe de configuration d'IBM Data Server Driver
< parameter name="capturedOnly" value="TRUE | FALSE" />
Mot clé de chaîne de connexion équivalent d'IBM Data Server Provider for .NET
N/A

Remarques sur l'utilisation

Lorsque le mot clé capturedOnly=TRUE est défini pour une application d'interface de ligne de commande activée avec l'optimisation de client pureQuery, les instructions dont le type est SET_METHOD sont limitées par pureQuery Runtime si elles ne se trouvent pas dans le fichier pureQueryXML.


Commentaires