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 paramétrée sur TRUE, les instructions SET SPECIAL REGISTER ou SET_METHOD 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.

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 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 CLI qui est activée avec l'optimisation client pureQuery, les instructions de type SET_METHOD sont limitées par pureQuery Runtime si l'instruction ne se trouve pas dans pureQueryXML.


Commentaires