Format du fichier script SQL utilisé par l'utilitaire GeneratePureQueryXml

Un fichier script SQL contient des instructions SQL et des informations facultatives relatives aux attributs de curseur qui sont utilisées lors de l'exécution d'une instruction SQL. Vous pouvez créer un fichier pureQueryXML à partir d'un fichier script SQL à l'aide de l'utilitaire GeneratePureQueryXml ou du plan de travail.
Dans le fichier script SQL , les éléments suivants correspondent aux paramètres par défaut des lignes commentaire et des terminaisons d'instruction SQL qui peuvent être modifiés à l'aide de l'utilitaire GeneratePureQueryXml :
  • Une ligne commentaire commence par deux tirets (--).
  • Un point-virgule termine chaque instruction SQL.
Un commentaire peut contenir des paires clé-valeur spécifiant les attributs de curseur pour la première instruction SQL venant après les commentaires.

Les commentaires peuvent également être placés entre /* et */. Les attributs de curseur spécifiés dans les commentaires placés entre /* et */ sont ignorés.

Paramètres d'attribut de curseur

Les paramètres et valeurs d'attribut de curseur suivants sont pris en charge et peuvent être utilisés dans un fichier script SQL :

resultSetHoldability
Facultatif. Indique la valeur de mise en suspens de l'ensemble de résultats. Vous pouvez spécifier l'une des valeurs suivantes pour resultSetHoldability :
  • CLOSE_CURSORS_AT_COMMIT : mise en suspens de l'ensemble de résultats définie de sorte que les curseurs se ferment sur validation.
  • HOLD_CURSORS_OVER_COMMIT : mise en suspens de l'ensemble de résultats définie de sorte que les curseurs se maintiennent sur validation.

La valeur par défaut est HOLD_CURSORS_OVER_COMMIT.

resultSetConcurrency
Facultatif. Indique la valeur d'accès concurrent de l'ensemble de résultats. Vous pouvez spécifier l'une des valeurs suivantes pour resultSetConcurrency :
  • CONCUR_READ_ONLY : définit le mode d'accès concurrent des curseurs sur lecture uniquement.
  • CONCUR_UPDATABLE définit le mode d'accès concurrent des curseurs sur actualisable.

La valeur par défaut est CONCUR_READ_ONLY.

resultSetType
Facultatif. Indique les types d'ensembles de résultats. Vous pouvez spécifier l'une des valeurs suivantes pour resultSetType :
  • TYPE_FORWARD_ONLY : définit le type d'ensemble de résultats sur déplacement avant uniquement.
  • TYPE_SCROLL_SENSITIVE : définit le type d'ensemble de résultats sur sensible au défilement.
  • TYPE_SCROLL_INSENSITIVE : définit le type d'ensemble de résultats sur non sensible au défilement.

La valeur par défaut est TYPE_FORWARD_ONLY.

Exemples

Dans l'exemple suivant, les attributs resultSetHoldability, resultSetConcurrency et resultSetType sont définis pour l'instruction SQL SELECT :
-- resultSetHoldability= CLOSE_CURSORS_AT_COMMIT, resultSetConcurrency=CONCUR_UPDATABLE, resultSetType=TYPE_SCROLL_SENSITIVE
SELECT ID, NAME FROM EMP WHERE REGION=?;
ans l'exemple suivant, les attributs de l'instruction SQL SELECT sont définis à l'aide de trois lignes commentaire :
-- resultSetHoldability= CLOSE_CURSORS_AT_COMMIT
-- resultSetConcurrency=CONCUR_UPDATABLE
-- resultSetType=TYPE_SCROLL_SENSITIVE
SELECT * FROM PRODUCTS WHERE  PRICE > ? ;
Dans l'exemple suivant, les attributs placés entre les marqueurs de commentaire /* et */ sont ignorés :
/*
   resultSetHoldability= CLOSE_CURSORS_AT_COMMIT
   resultSetConcurrency=CONCUR_UPDATABLE
   resultSetType=TYPE_SCROLL_SENSITIVE
*/
SELECT * FROM PRODUCTS WHERE  PRICE > ? ;
Dans l'exemple suivant, les attributs s'appliquent à la première instruction SELECT. La deuxième instruction SELECT utilise les valeurs par défaut :
-- resultSetHoldability= CLOSE_CURSORS_AT_COMMIT
-- resultSetConcurrency=CONCUR_UPDATABLE
-- resultSetType=TYPE_SCROLL_SENSITIVE

SELECT * FROM PRODUCTS WHERE PRICE > ? 
  AND COLOR = ? ;

SELECT PRICE FROM PRODUCTS WHERE  PRODID = ? ;

Commentaires