Condividi tramite


Modalità d'uso in FOR JSON delle sequenze di escape per i caratteri speciali e di controllo

Si applica a: SQL Server 2016 (13.x) e versioni successive Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics (solo pool SQL senza server)Endpoint di analisi SQL in Microsoft FabricMagazzino in Microsoft FabricDatabase SQL in Microsoft Fabric

Questo argomento descrive il modo in cui la clausola FOR JSON di un'istruzione SELECT di SQL Server usa sequenze di escape per i caratteri speciali e rappresenta i caratteri di controllo nell'output JSON.

Questo articolo descrive il supporto predefinito per JSON in Microsoft SQL Server. Per informazioni generali sull'escape e la codifica in JSON, vedere la Sezione 2.5 di JSON RFC.

Escape di caratteri speciali

Se i dati di origine contengono caratteri speciali, la clausola FOR JSON usa sequenze di escape per tali caratteri nell'output JSON con \, come illustrato nella tabella seguente. I caratteri di escape vengono usati sia nei nomi delle proprietà che nei relativi valori.

Carattere speciale Output preceduto da escape
Virgoletta (") \"
Barra rovesciata (\) \\
Barra (/) \/
Backspace \b
Alimentazione modulo \f
Nuova riga \n
Ritorno a capo \r
Tabulazione orizzontale \t

Caratteri di controllo

Se i dati di origine contengono caratteri di controllo, la clausola FOR JSON codifica tali caratteri nell'output JSON nel formato \u<code>, come illustrato nella tabella seguente.

Carattere di controllo Output codificato
CHAR(0) \u0000
CHAR(1) \u0001
... ...
CHAR(31) \u001f

Example

Di seguito è riportato un esempio dell'output di FOR JSON per dati di origine che includono sia caratteri speciali che caratteri di controllo.

Query:

SELECT 'VALUE\    /
  "' AS [KEY\/"],
    CHAR(0) AS '0',
    CHAR(1) AS '1',
    CHAR(31) AS '31'
FOR JSON PATH;

Result:

[
    {
        "KEY\\\/\"": "VALUE\\    \/\r\n  \"",
        "0": "\u0000",
        "1": "\u0001",
        "31": "\u001f"
    }
]