Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL Server 2016 (13.x) e versões posteriores Base de Dados SQL do Azure AzureSQL Managed InstanceSQL analytics endpoint em Microsoft FabricWarehouse em Microsoft FabricSQL database em Microsoft Fabric
Escapa de caracteres especiais em textos e retorna texto com caracteres escapados.
STRING_ESCAPE é uma função determinística introduzida pela primeira vez no SQL Server 2016.
Transact-SQL convenções de sintaxe
Sintaxe
STRING_ESCAPE( text , type )
Arguments
texto
Uma expressãonvarchar que representa o objeto que deve ser escapado.
type
Fugindo das regras que serão aplicadas. Atualmente, o valor suportado é 'json'.
Tipos de devolução
Texto nvarchar(max) com caracteres especiais e de controle escapados.
Atualmente, só é possível escapar a STRING_ESCAPE caracteres especiais JSON apresentados nas tabelas seguintes.
| Caráter especial | Sequência codificada |
|---|---|
Quotation mark (") |
\" |
Reverse solidus (\\) |
\\ |
Solidus (/) |
\/ |
Backspace |
\b |
Form feed |
\f |
New line |
\n |
Carriage return |
\r |
Horizontal tab |
\t |
| Caráter de controle | Sequência codificada |
|---|---|
CHAR(0) |
\u0000 |
CHAR(1) |
\u0001 |
... |
... |
CHAR(31) |
\u001f |
Observações
Examples
A. Escape de texto de acordo com as regras de formatação JSON
A consulta a seguir escapa de caracteres especiais usando regras JSON e retorna texto com escape.
SELECT STRING_ESCAPE('\ /
\\ " ', 'json') AS escapedText;
Aqui está o conjunto de resultados.
escapedText
-------------------------------------------------------------
\\\t\/\n\\\\\t\"\t
B. Formatar objeto JSON
A consulta a seguir cria texto JSON a partir de variáveis de número e cadeia de caracteres e escapa de qualquer caractere JSON especial em variáveis.
SET @json = FORMATMESSAGE('{ "id": %d,"name": "%s", "surname": "%s" }',
17, STRING_ESCAPE(@name,'json'), STRING_ESCAPE(@surname,'json') );