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 programmation pureQuery 4 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 et le type d'information à capturer. 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  
com.ibm.pdq (propriétés de journal du composant pureQuery) Indique le paramètre de niveau du journal de plusieurs composants pureQuery. X X  
dumpLogsOnSqlCodes Si les enregistrements du journal sont stockés en mémoire, cette propriété spécifie les codes d'erreur SQL déclenchant l'écriture des enregistrements dans le fichier journal. X X  
dumpLogsExcludingSqlCodes Si les enregistrements du journal sont stockés en mémoire, cette propriété spécifie les codes d'erreur SQL qui ne déclenchent pas l'écriture des enregistrements dans le journal. Cette propriété est utilisée avec la propriété dumpLogsOnSqlCodes. 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 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 X
propertiesRefreshInterval Indique la durée, en minutes, d'attente avant qu'une optimisation 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 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
pureQueryXmlRepository Indique le référentiel contenant les données du fichier pureQueryXML qui sont utilisées avec une application CLI activée avec l'optimisation du client pureQuery.     X
queryTimeoutInSeconds Nombre de secondes à attendre avant l'exécution d'une instruction SQL. X    
repositoryRequired Définit le comportement d'optimisation 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 X
sqlLiteralSubstitution Indique si une substitution de littéral doit être exécutée ou pas. pureQuery Runtime essaie de remplacer les valeurs de littéral dans les instructions SQL par des marqueurs de paramètre et d'exécuter 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  
traceBufferRowCount Indique le nombre d'enregistrements du journal des informations de trace placées en mémoire tampon. X X  
traceFile3 Indique le fichier dans lequel le journal est écrit. 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
traceLevel3 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 traceFile et traceLevel de pureQuery Runtime peuvent uniquement être spécifiées dans un fichier pdq.properties global. Pour obtenir des informations sur les fichiers de propriétés globaux, voir Portée des propriétés d'exécution pureQuery dans un environnement WebSphere Application Server.
  4. 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