Propriété executionMode

Indique si les instructions SQL ayant été précédemment capturées et stockées par pureQuery Runtime doivent être exécutées en mode statique. Les instructions SQL capturées sont stockées soit dans un fichier pureQueryXML, soit dans un référentiel créé dans une base de données.

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

STATIC
Lors de la préparation de chaque instruction SQL en vue de son exécution, pureQuery détermine si l'instruction correspond à une instruction SQL ayant été capturée. Si tel est le cas, pureQuery exécute l'instruction en mode statique.
Si pureQuery ne trouve pas d'instruction SQL correspondante, ou s'il trouve une instruction correspondante mais sans définition d'accès, son comportement dépend de la valeur des propriétés allowDynamicSQL et capturedOnly. Voir la description des propriétés.
DYNAMIC
Toutes les instructions SQL émises au titre de l'objet connexion en cours sont exécutées en mode dynamique.
DYNAMIC est la valeur par défaut.

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écution de 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écution de 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écution de 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
executionMode = STATIC | DYNAMIC
Syntaxe de configuration d'IBM Data Server Driver
<parameter name="executionMode" value="STATIC | DYNAMIC" />
Mot clé de chaîne de connexion équivalent d'IBM Data Server Provider for .NET
N/A

Remarques sur l'utilisation

Les applications d'interface de ligne de commande activées avec l'optimisation de client pureQuery prennent en charge les mots clés suivants afin de spécifier l'emplacement du fichier pureQueryXML contenant les instructions SQL capturées :
  • pureQueryXml indique l'emplacement du fichier.
  • pureQueryXmlRepository et propertiesGroupId indiquent l'emplacement du référentiel dans une base de données contenant les données de fichier.

Pour assurer le bon fonctionnement des applications Java avec des marqueurs de paramètre nommés, quel que soit le type ou la version du serveur de données, associez la propriété enableNamedParameterMarkers de Connection ou de DataSource à DB2BaseDataSource.YES avant d'utiliser les marqueurs de paramètre nommés dans les applications.


Commentaires