Indique d'exécuter ou non les instructions SQL
alternatives dans un fichier pureQueryXML, où ni ces instructions alternatives,
ni les instructions originales correspondantes ne sont liées par
l'utilitaire StaticBinder.
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.
Restrictions : - Si une instruction SQL contient des marqueurs de paramètre nommés, l'instruction alternative
doit comporter le même nombre de marqueurs de paramètre, lesquels doivent être classés de la
même manière.
- L'instruction SQL alternative doit remplacer une instruction qui exécute
une action similaire. Par exemple, l'ensemble de résultats d'une instruction SELECT alternative
doit correspondre à l'ensemble de résultats de l'instruction SELECT originale.
- L'instruction SQL alternative ne peut être un type d'instruction différent.
Par exemple, l'instruction alternative d'une instruction SELECT ne peut être
un appel de procédure, même si l'appel de procédure effectue une
action similaire.
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 :
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
- enableDynamicSQLReplacement = TRUE | FALSE