Udostępnij za pośrednictwem

JSON_QUERY (Transact-SQL)

  • Artykuł

Dotyczy: programu SQL Server 2016 (13.x) i nowszych Azure SQL DatabaseAzure SQL Managed Instancepunkt końcowy analizy SQL usługi Azure Synapse Analyticsw usłudze Microsoft FabricWarehouse w usłudze Microsoft Fabric

Wyodrębnia obiekt lub tablicę z ciągu JSON.

Aby wyodrębnić wartość skalarną z ciągu JSON zamiast obiektu lub tablicy, zobacz JSON_VALUE (Transact-SQL). Aby uzyskać informacje o różnicach między JSON_VALUE i JSON_QUERY, zobacz Compare JSON_VALUE and JSON_QUERY.

Transact-SQL konwencje składni

Składnia

JSON_QUERY ( expression [ , path ] )

Argumenty

wyrażenia

Wyrażenie. Zazwyczaj nazwa zmiennej lub kolumny zawierającej tekst JSON.

Jeśli JSON_QUERY znajdzie kod JSON, który nie jest prawidłowy w wyrażeniu , zanim znajdzie wartość zidentyfikowaną przez ścieżkę , funkcja zwróci błąd. Jeśli JSON_QUERY nie znajdzie wartości zidentyfikowanej przez ścieżkę , skanuje cały tekst i zwraca błąd, jeśli znajdzie kod JSON, który nie jest prawidłowy w dowolnym miejscu w wyrażenia.

ścieżka

Ścieżka JSON określająca obiekt lub tablicę do wyodrębnienia.

W programie SQL Server 2017 (14.x) i usłudze Azure SQL Database można podać zmienną jako wartość ścieżki .

Ścieżka JSON może określać tryb lax lub ścisły na potrzeby analizowania. Jeśli nie określisz trybu analizowania, tryb lax jest domyślny. Aby uzyskać więcej informacji, zobacz wyrażenia ścieżki JSON (SQL Server).

Wartość domyślna ścieżki to $. W związku z tym, jeśli nie podasz wartości dla ścieżki , JSON_QUERY zwraca wyrażenie wejściowe .

Jeśli format ścieżki jest nieprawidłowy, JSON_QUERY zwraca błąd.

Wartość zwracana

Zwraca fragment JSON typu nvarchar(max). Sortowanie zwróconej wartości jest takie samo jak sortowanie wyrażenia wejściowego.

Jeśli wartość nie jest obiektem lub tablicą:

  • W trybie lax JSON_QUERY zwraca wartość null.

  • W trybie ścisłym JSON_QUERY zwraca błąd.

Uwagi

Tryb lax i tryb ścisły

Rozważ następujący tekst JSON:

{
   "info": {
      "type": 1,
      "address": {
         "town": "Cheltenham",
         "county": "Gloucestershire",
         "country": "England"
      },
      "tags": ["Sport", "Water polo"]
   },
   "type": "Basic"
}

W poniższej tabeli porównaliśmy zachowanie JSON_QUERY w trybie lax i w trybie ścisłym. Aby uzyskać więcej informacji na temat opcjonalnej specyfikacji trybu ścieżki (lax lub strict), zobacz wyrażenia ścieżki JSON (SQL Server).

Ścieżka Zwracana wartość w trybie lax Zwracana wartość w trybie ścisłym Więcej informacji
$ Zwraca cały tekst JSON. Zwraca cały tekst JSON. N/a
$.info.type NULL Błąd Nie jest obiektem ani tablicą.

Zamiast tego użyj JSON_VALUE.
$.info.address.town NULL Błąd Nie jest obiektem ani tablicą.

Zamiast tego użyj JSON_VALUE.
$.info."address" N'{ "town":"Cheltenham", "county":"Gloucestershire", "country":"England" }' N'{ "town":"Cheltenham", "county":"Gloucestershire", "country":"England" }' N/a
$.info.tags N'[ "Sport", "Water polo"]' N'[ "Sport", "Water polo"]' N/a
$.info.type[0] NULL Błąd Nie tablica.
$.info.none NULL Błąd Właściwość nie istnieje.

Używanie JSON_QUERY z plikiem FOR JSON

JSON_QUERY zwraca prawidłowy fragment JSON. W związku z tym FOR JSON nie uniknie znaków specjalnych w JSON_QUERY zwracanej wartości.

Jeśli zwracasz wyniki w formacie JSON dla formatu JSON i uwzględniasz dane, które są już w formacie JSON (w kolumnie lub w wyniku wyrażenia), zawijaj dane JSON za pomocą JSON_QUERY bez ścieżki parametru.

Przykłady

Przykład 1

W poniższym przykładzie pokazano, jak zwrócić fragment JSON z kolumny CustomFields w wynikach zapytania.

SELECT PersonID,FullName,
  JSON_QUERY(CustomFields,'$.OtherLanguages') AS Languages
FROM Application.People

Przykład 2

W poniższym przykładzie pokazano, jak uwzględnić fragmenty JSON w danych wyjściowych klauzuli JSON FOR.

SELECT StockItemID, StockItemName,
         JSON_QUERY(Tags) as Tags,
         JSON_QUERY(CONCAT('["',ValidFrom,'","',ValidTo,'"]')) ValidityPeriod
FROM Warehouse.StockItems
FOR JSON PATH

Powiązana zawartość