Prise en charge des propriétés pureQuery Runtime dans les environnements d'application

Récapitulatif des propriétés prises en charge lors de l'utilisation de pureQuery Runtime par les applications qui comprennent l'API pureQuery, l'optimisation client pureQuery et l'interface CLI ou .NET.
Le tableau suivant répertorie les propriétés pureQuery Runtime et les environnements d'application pris en charge.
Tableau 1. Propriétés pureQuery et environnements d'application pris en charge
Propriété Description Les applications Java™ qui n'utilisent que l'API pureQuery Les applications Java qui n'utilisent que l'optimisation client pureQuery Les applications CLI, ODBC/CLI ou .NET qui utilisent l'optimisation client pureQuery
allowDynamicSQL1 Indique si l'application doit être autorisée à exécuter en mode dynamique les types d'instruction SQL suivants : les instructions SQL non capturées dans un fichier pureQueryXML et les instructions SQL capturées dans un fichier pureQueryXML mais non liées par l'utilitaire StaticBinder.   X X
capturedOnly2 Indique si seules les instructions SQL contenues dans le fichier pureQueryXML doivent être exécutées.   X X
captureMode Indique si des informations sur les instructions SQL doivent être capturées et le type d'information à capturer.   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  
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 dans un fichier pureQueryXML, où ni ces instructions alternatives, ni les instructions originales correspondantes ne sont liées par l'utilitaire StaticBinder.   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
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  
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  
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  
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 quand pureQuery Runtime vérifie l'emplacement des données pureQuery stockées pour les changements apportés aux propriétés d'exécution pureQuery ou aux données pureQueryXML après le démarrage de l'application. Lorsque pureQuery Runtime détecte des mises à jour, pureQuery Runtime récupère les propriétés d'exécution 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
pureQueryXmlRepository Indique le référentiel qui contient les données du fichier pureQueryXML utilisé avec une application CLI ou .NET activée avec l'optimisation 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
repositorySchema Indique le schéma d'un référentiel créé dans une base de données. X X  
runtimeGroupActivationCheckInterval4 Indique la durée, en minutes, d'attente avant que pureQuery Runtime vérifie l'activation d'un groupe d'exécution pureQuery.   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
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  
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 pureQuery Runtime traceFile et traceLevel peuvent être spécifiées uniquement 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 pureQuery Runtime dans un environnement WebSphere Application Server.
  4. La propriété pureQuery Runtime runtimeGroupActivationCheckInterval peut être spécifiée uniquement en tant que propriété globale. Pour plus d'informations sur la spécification de cette propriété, voir les remarques sur l'utilisation de runtimeGroupActivationCheckInterval.

Commentaires