Utilisation de séquences d'échappement SQL

Télécharger le pilote JDBC

Le Pilote Microsoft JDBC pour SQL Server prend en charge l’utilisation des séquences d’échappement SQL, tel que le définit l’API JDBC. Les séquences d'échappement sont utilisées dans une instruction SQL pour indiquer au pilote que la partie d'échappement de la chaîne SQL doit être gérée différemment. Lorsque le pilote JDBC traite la partie d'échappement d'une chaîne SQL, il traduit cette partie de la chaîne en code SQL compris par SQL Server.

Il existe cinq types de séquences d'échappement requis par l'API JDBC, et tous sont pris en charge par le pilote JDBC :

• Littéraux génériques LIKE
• Gestion de fonction
• Littéraux de date et heure
• Appels de procédure stockée
• Jointures externes
• Syntaxe d'échappement LIMIT

La syntaxe de séquence d'échappement utilisée par le pilote JDBC est la suivante :

{keyword ...parameters...}

Les sections suivantes décrivent les cinq types de séquences d'échappement et comment ils sont pris en charge par le pilote JDBC.

Littéraux génériques LIKE

Le pilote JDBC prend en charge la syntaxe {escape 'escape character'} pour l’utilisation de caractères génériques de clause LIKE comme littéraux. Par exemple, le code suivant retournera des valeurs pour col3, où la valeur de col2 commence littéralement par un trait de soulignement (et pas son utilisation générique).

ResultSet rst = stmt.executeQuery("SELECT col3 FROM test1 WHERE col2   
LIKE '\\_%' {escape '\\'}");  

Gestion de fonction

Le pilote JDBC prend en charge les séquences d'échappement de fonction dans les instructions SQL avec la syntaxe suivante :

{fn functionName}  

où functionName est une fonction prise en charge par le pilote JDBC. Par exemple :

SELECT {fn UCASE(Name)} FROM Employee  

Le tableau suivant répertorie les différentes fonctions prises en charge par le pilote JDBC lors de l'utilisation d'une séquence d'échappement de fonction :

Littéraux de date et heure

La syntaxe d'échappement pour les littéraux de date, heure et horodatage est la suivante :

{literal-type 'value'}  

où literal-type est l’un des éléments suivants :

Par exemple :

UPDATE Orders SET OpenDate={d '2005-01-31'}
WHERE OrderID=1025  

Appels de procédure stockée

Le pilote JDBC prend en charge la syntaxe d’échappement {? = call proc_name(?,...)} et {call proc_name(?,...)} pour les appels de procédure stockée, selon que vous devez ou non traiter un paramètre de retour.

Une procédure est un objet exécutable stocké dans la base de données. Généralement, il s'agit d'une ou plusieurs instructions SQL qui ont été précompilées. La syntaxe de séquence d'échappement pour appeler une procédure stockée est la suivante :

{[?=]call procedure-name[([parameter][,[parameter]]...)]}  

où procedure-name spécifie le nom d’une procédure stockée et parameter un paramètre de procédure stockée.

Pour plus d'informations sur l'utilisation de la séquence d'échappement call avec des procédures stockées, consultez Utilisation d’instructions avec des procédures stockées.

Jointures externes

Le pilote JDBC prend en charge la syntaxe de jointure externe SQL92 gauche, droite et entière. La séquence d'échappement pour les jointures externes est la suivante :

{oj outer-join}  

où outer-join est :

table-reference {LEFT | RIGHT | FULL} OUTER JOIN
{table-reference | outer-join} ON search-condition  

où table-reference est un nom de table et search-condition est la condition de jointure que vous souhaitez utiliser pour les tables.

Par exemple :

SELECT Customers.CustID, Customers.Name, Orders.OrderID, Orders.Status
   FROM {oj Customers LEFT OUTER JOIN
      Orders ON Customers.CustID=Orders.CustID}
   WHERE Orders.Status='OPEN'  

Les séquences d'échappement de jointure externe suivantes sont prises en charge par le pilote JDBC :

• Jointures externes gauches
• Jointures externes droites
• Jointures externes entières
• Jointures externes imbriquées

Syntaxe d'échappement LIMIT

La syntaxe d'échappement pour LIMIT est la suivante :

LIMIT <rows> [OFFSET <row offset>]  

La syntaxe d’échappement comporte deux parties : <lignes> obligatoire et spécifie le nombre de lignes à retourner. OFFSET et <décalage de lignes> spécifient le nombre de lignes à ignorer avant de commencer à retourner des lignes. Le pilote JDBC prend en charge uniquement la partie obligatoire en transformant la requête pour qu'elle utilise la clause TOP au lieu de LIMIT. SQL Server ne prend pas en charge la clause LIMIT. Le pilote JDBC ne prend pas en charge la partie <décalage de lignes> facultative et lève une exception si elle est utilisée.

Voir aussi

Utilisation d'instructions avec le pilote JDBC