Propriété 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.

Pour l'application Java avec l'optimisation de client pureQuery, cette propriété est reconnue uniquement si la propriété finalRepositoryProperties est également spécifiée. Sinon, elle est ignorée. La propriété finalRepositoryProperties n'est pas prise en charge pour les applications d'interface de ligne de commande activées avec l'optimisation de client pureQuery.

Cette propriété peut posséder les valeurs suivantes :

atStartup
Indique que l'emplacement défini par la propriété finalRepositoryProperties est demandé au démarrage de l'application. Si les propriétés pureQuery ne sont pas disponibles ou que des erreurs de lecture sont détectées, une exception est émise.
forOutput
Indique que l'écriture des premières données SQL capturées dans le référentiel doit être effectuée avec succès. Si le référentiel n'est pas disponible ou que des erreurs d'écriture sont détectées, une exception est émise. Si le référentiel n'est pas disponible après le démarrage de l'application, une erreur est consignée si la consignation est activée. L'application se poursuit et l'écriture des données SQL capturées est tentée à l'heure suivante programmée.

La valeur n'est pas prise en charge pour les applications d'interface de ligne de commande activées avec l'optimisation de client pureQuery.

atStartupAndForOutput
Indique que les valeurs atStartup et forOutput sont activées.

La valeur n'est pas prise en charge pour les applications d'interface de ligne de commande activées avec l'optimisation de client pureQuery.

no
Indique le comportement par défaut si l'emplacement défini par la propriété finalRepositoryProperties n'est pas disponible au démarrage de l'application. La liste suivante décrit le comportement par défaut :
  • L'application est exécutée avec l'optimisation client pureQuery par défaut et la configuration d'exécution pureQuery. L'application exécute des données SQL dynamiques.
  • Si la consignation est activée, un message est consigné et indique le problème qui se pose avec le référentiel.
  • Si une unité d'exécution de minuteur peut être créée, une tentative de récupération des propriétés d'exécution pureQuery et des données pureQueryXML est effectuée toutes les 10 minutes. Si les informations sont récupérées, l'optimisation client pureQuery utilise les propriétés d'exécution pureQuery récupérées ainsi que les données pureQueryXML.
  • Si l'optimisation client pureQuery est configurée pour stocker les données SQL capturées dans un référentiel et que le référentiel n'est pas disponible ou qu'une erreur d'écriture est détectée, un message est consigné et indique le problème qui se pose avec le référentiel. L'écriture des données SQL capturées dans le référentiel est tentée à l'heure suivante programmée.

Remarques sur l'utilisation

La liste suivante contient des informations relatives à l'utilisation de la propriété repositoryRequired :

Notes d'utilisation de l'interface CLI DB2 et d'IBM Data Server Driver

Lors de l'utilisation de l'interface CLI DB2 ou d'IBM® Data Server Driver avec pureQuery Runtime, vous pouvez utiliser la propriété pureQuery Runtime comme mot clé de configuration.

Syntaxe de mot clé CLI IBM
repositoryRequired = atStartup | no
Syntaxe de configuration d'IBM Data Server Driver
<parameter name="repositoryRequired" value="atStartup | no" />
Mot clé de chaîne de connexion équivalent d'IBM Data Server Provider for .NET
N/A

Notes d'utilisation de l'interface de ligne de commande DB2

Les informations d'utilisation suivantes s'appliquent lorsque le mot clé pureQueryXmlRepository est spécifié et que les applications d'interface de ligne de commande (CLI) sont activées avec l'optimisation de client pureQuery :
  • Pour les applications CLI, seules les données du fichier pureQueryXML sont récupérées sur le référentiel. Les paramètres pureQuery Runtime ne sont pas récupérés sur le référentiel. Les paramètres pureQuery Runtime utilisés sont spécifiés dans le fichier de configuration.
  • repositoryRequired prend en charge uniquement les valeurs atStartup et no.
  • Lorsque vous indiquez le mot clé repositoryRequired, les mots clés pureQueryXmlRepository et propertiesGroupId doivent également être spécifiés.
  • Lorsque la valeur repositoryRequired est définie sur no et que l'emplacement du référentiel indiqué par le mot clé pureQueryXmlRepository n'est pas disponible au démarrage, les instructions SQL sont exécutées dynamiquement avec les paramètres pureQuery Runtime par défaut. Toutes les valeurs de mots clés pureQuery Runtime sont définies sur leurs valeurs par défaut, à l'exception du mot clé sqlLiteralSubstitution. La valeur sqlLiteralSubstitution définie dans le fichier de configuration est retenue.
  • Si la récupération du fichier de capture pureQueryXml à partir du référentiel échoue, l'erreur SQL CLI00202E est renvoyée.

Commentaires