Usando sequências de escape SQL

Baixar driver JDBC

O Microsoft JDBC Driver para SQL Server suporta a utilização de sequências de escape SQL, conforme definido pela API JDBC. As sequências de escape são usadas dentro de uma instrução SQL para dizer ao driver que a parte escapada da string SQL deve ser tratada de forma diferente. Quando o driver JDBC processa a parte escapada de uma string SQL, traduz essa parte da string em código SQL que o SQL Server compreende.

Existem cinco tipos de sequências de escape que a API JDBC exige, e todas são suportadas pelo driver JDBC:

• COMO os caracteres coringa
• Gestão de funções
• Data e hora literais
• Chamadas de procedimentos armazenados
• Junções exteriores
• Limitar sintaxe de escape

A sintaxe da sequência de escape usada pelo driver JDBC é a seguinte:

{keyword ...parameters...}

As secções seguintes descrevem os cinco tipos de sequências de escape e como são suportadas pelo driver JDBC.

COMO os caracteres coringa

O driver JDBC suporta a sintaxe {escape 'escape character'} para usar caracteres curinga LIKE de cláusulas como literais. Por exemplo, o código seguinte devolverá valores para col3, onde o valor de col2 começa literalmente com um sublinhado (e não com o seu uso de wildcard).

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

Gestão de funções

O driver JDBC suporta sequências de escape de função em instruções SQL com a seguinte sintaxe:

{fn functionName}  

onde functionName é uma função suportada pelo driver JDBC. Por exemplo:

SELECT {fn UCASE(Name)} FROM Employee  

A tabela seguinte lista as várias funções suportadas pelo driver JDBC ao utilizar uma sequência de escape de funções:

Data e hora literais

A sintaxe de escape para data, hora e datas literais é a seguinte:

{literal-type 'value'}  

onde literal-type é um dos seguintes:

Por exemplo:

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

Chamadas de procedimentos armazenados

O driver JDBC suporta as sintaxes de {? = call proc_name(?,...)} e de {call proc_name(?,...)} para chamadas de procedimentos armazenados, dependendo se precisa de processar um parâmetro de retorno.

Um procedimento é um objeto executável armazenado na base de dados. Geralmente, são uma ou mais instruções SQL que foram pré-compiladas. A sintaxe da sequência de escape para chamar um procedimento armazenado é a seguinte:

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

onde procedure-name especifica o nome de um procedimento armazenado e parameter especifica um parâmetro de procedimento armazenado.

Para mais informações sobre a utilização da call sequência de escape com procedimentos armazenados, consulte Utilização de Instruções com Procedimentos Armazenados.

Junções exteriores

O driver JDBC suporta a sintaxe de junção esquerda, direita e externa completa do SQL92. A sequência de escape para uniões exteriores é a seguinte:

{oj outer-join}  

onde a junção externa é:

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

onde table-reference é o nome de uma tabela e search-condition é a condição de junção que pretende usar para as tabelas.

Por exemplo:

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'  

As seguintes sequências de escape de junção externa são suportadas pelo driver JDBC:

• Junções exteriores à esquerda
• Junções exteriores direitas
• Junções exteriores completas
• Junções externas aninhadas

Limitar sintaxe de escape

A sintaxe de escape para o LIMIT é a seguinte:

LIMIT <rows> [OFFSET <row offset>]  

A sintaxe de escape tem duas partes: <linhas> é obrigatória e especifica o número de linhas a devolver. OFFSET e <deslocamento de linha> são opcionais e especificam o número de linhas a saltar antes de começar a devolver as linhas. O driver JDBC suporta apenas a parte obrigatória ao transformar a consulta para usar TOP em vez de LIMIT. O SQL Server não suporta a cláusula LIMIT. O driver JDBC não suporta o deslocamento de linha< opcional> e lançará uma exceção se for utilizado.

Consulte também

Utilização de instruções com o driver JDBC