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 = ? ;