Support des propriétés d'exécution pureQuery dans les environnements d'application

Récapitulatif des propriétés prises en charge lorsque l'exécution pureQuery est utilisée par des applications qui comprennent l'interface de programme d'application pureQuery, l'optimisation client pureQuery ou l'interface CLI.
Le tableau suivant répertorie les propriétés d'exécution pureQuery ainsi que les environnements d'application pris en charge.
Tableau 1. Propriétés pureQuery et environnements d'application pris en charge
Propriété Description Applications Java avec l'interface de programme d'application pureQuery 3 Applications Java avec l'optimisation client pureQuery Applications CLI avec l'optimisation client pureQuery
allowDynamicSQL1 Indique si l'application doit être autorisée à exécuter en mode dynamique toute instruction SQL non capturée dans un fichier pureQueryXML ou capturée mais sans définition d'accès.   X X
capturedOnly2 Indique si seules les instructions SQL contenues dans le fichier pureQueryXML doivent être exécutées. X X X
captureMode Indique si des informations sur les instructions SQL doivent être capturées. X X X
captureStatementBatchSQL Indique si les instructions SQL DML que l'application transmet à une méthode Statement.addBatch() doivent être capturées, ceci dans la limite du nombre d'instructions SQL (instructions SELECT exclues) qui a été défini par la propriété maxNonParmSQL. X X  
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. X X X
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. X X X
finalRepositoryProperties Indique l'emplacement des propriétés pureQuery utilisées avec une application pureQuery.   X  
maxNonParmSQL Indique le nombre maximal d'instructions SQL non paramétrées à capturer. Cette option s'applique uniquement lorsque la valeur de captureMode est ON. Lorsque captureMode prend la valeur OFF, pureQuery ignore ce paramètre. X X X
maxResultRow Indique le nombre maximal de lignes qu'une instruction retourne dans les résultats de l'interrogation. X    
maxStackTracesCaptured Indique le nombre maximum de traces de pile enregistrées pour le point de définition et le point d'exécution de chaque instruction SQL capturée. X X  
outputPureQueryXml Indique un chemin qualifié complet ou un chemin relatif et le nom du ou des fichiers créés par la capture des instructions SQL. X X  
outputXmlRepository Indique une base de données qui contient un référentiel. Le référentiel stocke les données SQL capturées provenant d'une application activée pour l'optimisation de client pureQuery.   X  
packagePrefixExclusions Indique la liste de domaines et de sous-domaines séparés par une barre verticale des packages Java que vous ne souhaitez pas inclure aux traces de pile. X X  
propertiesGroupId Définit un ID de groupe d'exécution d'un référentiel créé dans une base de données. pureQuery Runtime utilise l'ID de groupe d'exécution et les informations de connexion définissant le référentiel, soit pour stocker des données SQL capturées à partir d'une application, soit pour récupérer la configuration d'exécution pureQuery et les informations relatives au fichier pureQueryXML.   X  
propertiesRefreshInterval Indique la durée, en minutes, d'attente avant qu'une optimisation de client pureQuery n'ait fini de contrôler dans l'emplacement des données pureQuery stockées les changements apportés aux propriétés pureQuery ou aux données pureQueryXML. Lorsque des mises à jour ont été détectées, l'optimisation de client pureQuery récupère les propriétés d'exécution pureQuery mises à jour ainsi que les données pureQueryXML et utilise les informations mises à jour.   X  
pureQueryXml 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. X X X
queryTimeoutInSeconds Nombre de secondes à attendre avant l'exécution d'une instruction SQL. X    
repositoryRequired Définit le comportement d'optimisation de client pureQuery si des erreurs se produisent lors de la récupération ou de l'écriture des données pureQuery. Si les propriétés d'exécution pureQuery et les données pureQueryXML ne peuvent pas être récupérées de l'emplacement défini par la propriété finalRepositoryProperties ou si le référentiel qui stocke les données SQL capturées n'est pas accessible.   X  
sqlLiteralSubstitution Indique de procéder ou non à une substitution de littéral. pureQuery Runtime tente de remplacer les valeurs de littéral dans les instructions SQL par des marqueurs de paramètre et de capturer les versions paramétrées des instructions. X X X
stackTraceDepth Indique le nombre maximal d'entrées de trace de pile enregistrées pour chaque instruction SQL. Ces entrées sont enregistrées dans le fichier pureQueryXML. X X  
traceFile Spécifie le fichier physique dans lequel écrire le journal. Vous pouvez utiliser un chemin absolu ou un chemin relatif au répertoire dans lequel l'utilitaire pureQuery Log est exécuté. X X X
traceLevel Spécifie le niveau de détail à écrire dans le fichier journal. X X X
Remarque :
  1. La propriété s'applique uniquement lorsque la valeur de la propriété executionMode est STATIC.
  2. La valeur de la propriété capturedOnly ne peut pas être définie par TRUE lorsque vous capturez les instructions SQL.
  3. Les propriétés de pureQuery peuvent être utilisées avec l'interface pureQuery EnhancedDataSource ou la classe DataFactory.
    Interface EnhancedDataSource com.ibm.pdq.runtime.datasource
    capturedOnly
    captureMode
    captureStatementBatchSQL
    enableDynamicSQLReplacement
    maxNonParmSQL
    maxStackTracesCaptured
    outputPureQueryXml
    packagePrefixExclusions
    pureQueryXml
    stackTraceDepth
    sqlLiteralSubstitution
    com.ibm.pdq.runtime.factory.DataFactory
    executionMode
    queryTimeoutInSeconds
    maxResultRows

Commentaires