Propriété enableDynamicSQLReplacement

Indique d'exécuter ou non les instructions SQL alternatives ayant été ajoutées à un fichier pureQueryXML, lorsque les instructions initiales et les instructions alternatives ne disposaient pas de définition d'accès.

Après capture d'instructions SQL dans un fichier pureQueryXML, il peut arriver qu'une ou plusieurs de ces instructions ne présentent pas l'efficacité escomptée par votre application. Or, dans la mesure où vous faites ce constat à un stade avancé de votre cycle de développement, vous risquez de ne plus pouvoir modifier l'application. Il vous est toutefois possible d'éditer le fichier pureQueryXML en ajoutant une instruction SQL de remplacement pour chacune des instructions insuffisamment performantes. Lorsque vous exécuterez votre application, pureQuery utilisera les nouvelles instructions SQL en lieu et place des instructions initialement capturées.

Après les avoir ajoutées, vous pouvez choisir de définir ou non des accès pour les instructions SQL de remplacement. Si vous y renoncez mais voulez tout de même utiliser ces instructions, vous devez paramétrer la propriété enableDynamicSQLReplacement à TRUE lorsque vous exécutez votre application.

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

TRUE
Indique que les instructions SQL de remplacement doivent être exécutées. pureQuery exécute ces instructions en mode dynamique car leurs accès ne sont pas définis.
FALSE
Indique que les instructions SQL de remplacement ne doivent pas être exécutées. En lieu et place, pureQuery exécute les instructions SQL initialement capturées dans les fichiers pureQueryXML utilisés par votre application.
Il s'agit de la valeur par défaut.
La liste suivante décrit si pureQuery Runtime exécute une autre instruction SQL :
  • Si la valeur d'executionMode est DYNAMIC, l'instruction SQL qui est exécutée dépend de la valeur de la propriété enableDynamicSQLReplacement.
  • Si la valeur d'executionMode est STATIC :
    • Si l'autre instruction n'est pas liée, elle est exécutée uniquement lorsque la valeur de l'option enableDynamicSQLReplacement est TRUE et la valeur de l'attribut isBindable est FALSE pour l'instruction d'origine.
    • Si l'autre instruction SQL est liée, elle est exécutée de façon statique. La propriété enableDynamicSQLReplacement est ignorée.

      Pour lier l'autre instruction, ajoutez-la puis effectuez l'opération de liaison. Si l'instruction d'origine est marquée comme pouvant être liée, l'autre instruction est liée.

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

Commentaires