Paramètres obligatoires pour la capture des instructions SQL lors de l'exécution de la capture incrémentielle pour l'optimisation client

Ces paramètres permettent de capturer des instructions SQL supplémentaires d'une application après y avoir déjà capturé d'autres instructions.
Si vous avez modifié votre application après avoir créé un fichier pureQueryXML et que vous souhaitez disposer de traces de pile précises dans ce fichier, vous ne pouvez pas effectuer la capture incrémentielle si ces deux conditions sont vraies :
  • Vos modifications contiennent plus que des modifications apportées aux propriétés dans l'URL d'une connexion ou dans un objet DataSource.
  • Vos modifications ont changé le nombre de lignes contenues dans votre application.

L'édition de votre application peut invalider les traces de pile enregistrées dans le fichier pureQueryXML.

Tableau 1. Paramètres obligatoires pour la capture des instructions SQL lors de l'exécution de la capture incrémentielle
Propriété Paramètre Effet
captureMode ON pureQuery capture les instructions lorsque vous exécutez ces instructions dans une application.
executionMode DYNAMIC pureQuery exécute les instructions en mode dynamique.
Pour une application non mise en cluster, si vous ne souhaitez pas empêcher l'écriture dans le fichier pureQueryXML :
pureQueryXml
Nom et chemin du fichier pureQueryXML d'origine.
Lorsque vous exécutez votre application avec les paramètres de la table, pureQuery vérifie si une instruction SQL donnée se trouve déjà dans le fichier pureQueryXML de la connexion dans laquelle l'instruction est exécutée. pureQuery exécute ensuite l'une de ces actions :
  • Si l'instruction se trouve dans le fichier pureQueryXML et que l'accès à l'instruction est défini dans un package DB2, pureQuery exécute l'instruction en mode statique.
  • Si l'instruction se trouve dans le fichier pureQueryXML et que son accès n'est pas défini, pureQuery exécute l'instruction en mode dynamique.
  • Si l'instruction ne se trouve pas dans le fichier pureQueryXML, pureQuery capture l'instruction et l'exécute en mode dynamique.
Pour une application non mise en cluster, si vous utilisez le fichier pureQueryXML comme fichier d'entrée et que vous souhaitez uniquement capturer les instructions qui ne sont pas encore capturées :
pureQueryXml
outputPureQueryXml
Configuration pour pureQueryXml :
Nom et chemin du fichier pureQueryXML d'origine.

Configuration pour outputPureQueryXml :
nom_fichier.pdqxml ou nom_fichier.xml
Lorsque vous exécutez votre application avec les paramètres de la table, pureQuery vérifie si une instruction SQL donnée se trouve déjà dans le fichier pureQueryXML (celui spécifié avec la propriété pureQueryXml) de la connexion dans laquelle l'instruction est exécutée. pureQuery exécute ensuite l'une de ces actions :
  • Si l'instruction se trouve dans le fichier pureQueryXML et que l'accès à l'instruction est défini dans un package DB2, pureQuery exécute l'instruction en mode statique.
  • Si l'instruction se trouve dans le fichier pureQueryXML et que son accès n'est pas défini, pureQuery exécute l'instruction en mode dynamique.
  • Si l'instruction ne se trouve pas dans le fichier pureQueryXML, pureQuery capture l'instruction dans le fichier spécifié avec outputPureQueryXml, puis exécute l'instruction en mode dynamique.

Une fois le fichier pureQueryXML de sortie généré, vous pouvez le fusionner avec le fichier d'origine.

Pour une application en cluster, à l'aide d'un fichier pureQueryXML constituant le résultat de la fusion des fichiers pureQueryXML créés lors de la dernière capture des instructions à partir de l'application en cluster :
pureQueryXml
outputPureQueryXml
Configuration pour pureQueryXml :
Nom et chemin du fichier pureQueryXML résultant de la fusion.

Configuration pour :
nom_fichier.pdqxml ou nom_fichier.xml

Lorsque vous exécutez les instances d'application avec les paramètres de la table, pureQuery vérifie si une instruction SQL donnée se trouve déjà dans le fichier pureQueryXML spécifié avec la propriété pureQueryXml. pureQuery exécute ensuite l'une de ces actions :

  • Si l'instruction se trouve dans le fichier pureQueryXML et que l'accès à l'instruction est défini dans un package DB2, pureQuery exécute l'instruction en mode statique.
  • Si l'instruction se trouve dans le fichier pureQueryXML et que son accès n'est pas défini, pureQuery exécute l'instruction en mode dynamique.
  • Si l'instruction ne se trouve pas dans le fichier pureQueryXML, pureQuery capture l'instruction dans le fichier de l'instance générée à partir de la valeur de outputPureQueryXml, puis exécute l'instruction en mode dynamique.

Cette table n'affiche pas les propriétés dont vous pouvez conserver les valeurs par défaut ou d'autres propriétés que vous pouvez utiliser. Voici la liste complète des propriétés que vous pouvez utiliser lors de la capture des instructions SQL :

Vous pouvez également définir les propriétés de consignation. Voir Descriptions des propriétés de consignation et de traçage.

Pour plus d'informations sur le mode et l'emplacement de définition de ces propriétés, voir Définition des propriétés de l'optimisation client.


Commentaires