Indique le chemin relatif ou absolu et le nom d'un fichier qui doit être créé ou qui a été créé lors de la capture d'instructions SQL.
Ce fichier doit prendre l'extension .pdqxml ou .xml. Il n'existe pas de valeur par défaut. Le nom du fichier doit respecter
les conventions de dénomination de votre système d'exploitation.
Utilisation
de cette propriété avec un référentiel : Si la propriété finalRepositoryProperties définit
un référentiel, une exception est émise si la propriété pureQueryXml est
également définie.
Utilisation de cette propriété lors de la capture d'instructions SQL :
- Lors de la première capture d'instructions SQL à partir d'une application non mise en cluster, vous pouvez utiliser la propriété pureQueryXml ou outputPureQueryXml. Vous devez utiliser l'une des deux.
Le répertoire que vous indiquez doit exister. Par ailleurs, vous
devez être autorisé à créer des fichiers dans ce répertoire. Si vous spécifiez les deux propriétés, la propriété outputPureQueryXml a la priorité.
- Lors de la première capture d'instructions SQL à partir d'une application en cluster, vous ne pouvez pas utiliser la propriété pureQueryXml.
Vous devez utiliser la propriété outputPureQueryXml.
- Lors de la capture d'instructions SQL supplémentaires à partir d'une application non mise en cluster pour laquelle vous avez déjà créé un fichier pureQueryXML, utilisez cette propriété pour indiquer ce fichier si vous ne souhaitez pas le garder en son état actuel. Lors de la capture d'instructions SQL supplémentaires, pureQuery écrit ces instructions dans le fichier.
- Lors de la capture d'instructions SQL supplémentaires à partir d'une application non mise en cluster pour laquelle vous avez déjà créé un fichier pureQueryXML, vous pouvez utiliser la propriété pureQueryXml pour indiquer le fichier en tant que fichier d'entrée et utiliser la propriété outputPureQueryXml pour la capture
d'instructions SQL supplémentaires qui n'apparaissent pas dans le fichier d'entrée.
- Lors de la capture d'instructions SQL supplémentaires à partir d'une application en cluster,
utilisez la propriété pureQueryXml pour définir comme fichier d'entrée le fichier
pureQueryXML résultant de la fusion des fichiers créés lors de la dernière capture des instructions SQL à partir de l'application. Utilisez la propriété outputPureQueryXml pour indiquer les fichiers dans lesquels vous souhaitez capturer les instructions SQL supplémentaires.
Utilisation de cette propriété pour exécuter de façon dynamique des instructions SQL capturées : Utilisez la propriété pureQueryXml pour indiquer le fichier dans lequel ces instructions ont été capturées.
Le répertoire et le fichier indiqués doivent exister. L'application doit être autorisée à lire les fichiers se trouvant dans le répertoire indiqué.
Si vous définissez cette propriété dans un fichier pdq.properties du plan de travail : Vérifiez que la propriété pureQueryXml est définie sur dataAccessFolder/nom-fichier.
Si vous ne définissez aucune valeur, le plan de travail utilise dataAccessFolder/capture.pdqxml.
Pour que le plan de travail reconnaisse le fichier pureQueryXML, ce dernier doit être
dans le dossier dataAccessFolder de votre projet Java.
Important : Si
les données SQL capturées sont en cours d'enregistrement dans pureQueryXML et que le fichier se trouve sur le système de fichiers, vous
devez vous assurer que l'application est mise au repos et que le fichier n'est pas
écrit lorsque vous le récupérez. Si l'application n'est pas mise au repos, le
contenu de pureQueryXML risque de ne pas être valide ou l'application risque de ne
pas pouvoir mettre à jour le fichier pureQueryXML, car cela générerait une erreur
E-S. Vous pouvez utiliser l'option -validateXml à l'aide de
l'utilitaire Merge, Configure ou StaticBinder pour vérifier la validité du
fichier.
Notes d'utilisation de l'interface CLI IBM et d'IBM Data Server
Driver
Lorsque vous utilisez DB2 Call Level Interface (DB2 CLI) ou IBM Data Server Driver
avec pureQuery Runtime, vous pouvez utiliser la propriété pureQuery Runtime en
tant que mot clé de configuration.
- Syntaxe de mot clé CLI IBM
- pureQueryXml = nom de fichier qualifié complet |
nom de fichier relatif
- Syntaxe de configuration d'IBM Data Server Driver
- <parameter name="pureQueryXml" value="nom de fichier
qualifié complet | nom de fichier relatif
- Environnement équivalent ou attribut de connexion :
- Aucun
- Mot clé de chaîne de connexion équivalent d'IBM®
Data Server Provider for .NET
- N/A