JSON функции и оператори в SQLite (пълен списък)

По-долу е даден пълен списък с JSON функции и JSON оператори, налични в SQLite.

Скаларни функции

Функция	Описание
`json()`	Връща минимизирана версия на своя (низов JSON) аргумент като действителен JSON. По принцип той преобразува необработен текст, който изглежда като JSON, в действителен JSON.
`json_array()`	Връща добре оформен JSON масив въз основа на неговите аргументи.
`json_array_length()`	Връща броя на елементите в даден JSON масив.
`json_extract()`	Извлича и връща една или повече стойности от добре оформен JSON.
`json_insert()`	Вмъква нова стойност в JSON документ.
`json_object()`	Връща добре оформен JSON обект въз основа на неговите аргументи.
`json_patch()`	Добавя, модифицира и/или изтрива елементи от JSON обект (изпълнява алгоритъма RFC-7396 MergePatch, за да приложи дадена корекция към дадения JSON вход).
`json_remove()`	Премахва един или повече елементи от JSON обект или масив.
`json_replace()`	Заменя съществуваща стойност в JSON документ с друга стойност.
`json_set()`	Вмъква или заменя стойност в JSON документ.
`json_type()`	Връща типа на най-външния елемент на дадения JSON.
`json_valid()`	Проверява дали аргументът му е добре оформен JSON.
`json_quote()`	Преобразува число или низ в съответното му JSON представяне.

Агрегирани функции

Функция	Описание
`json_group_array()`	Връща JSON масив, състоящ се от всички стойности в агрегирането.
`json_group_object()`	Връща JSON обект, състоящ се от всички двойки име/стойност в агрегирането.

Функции с таблично значение

Функция Описание

json_each() Разхожда стойността на JSON, предоставена като негов първи аргумент, и връща таблица, състояща се от един ред за всеки елемент на масива или член на обекта. Той обхожда само непосредствените деца на масива или обекта от най-високо ниво или само на самия елемент от най-високо ниво, ако елементът от най-високо ниво е примитивна стойност.

json_tree() Разхожда стойността на JSON, предоставена като негов първи аргумент, и връща таблица, състояща се от един ред за всеки елемент на масива или член на обекта. Той минава рекурсивно през подструктурата JSON, започвайки с елемента от най-високо ниво.

Функция	Описание
`json_each()`	Разхожда стойността на JSON, предоставена като негов първи аргумент, и връща таблица, състояща се от един ред за всеки елемент на масива или член на обекта. Той обхожда само непосредствените деца на масива или обекта от най-високо ниво или само на самия елемент от най-високо ниво, ако елементът от най-високо ниво е примитивна стойност.
`json_tree()`	Разхожда стойността на JSON, предоставена като негов първи аргумент, и връща таблица, състояща се от един ред за всеки елемент на масива или член на обекта. Той минава рекурсивно през подструктурата JSON, започвайки с елемента от най-високо ниво.

JSON оператори

SQLite също така включва следните оператори за работа с JSON:

Оператор	Описание
`->`	Извлича подкомпонент от JSON документ и връща JSON представяне на този подкомпонент.
`->>`	Извлича подкомпонент от JSON документ и връща SQL представяне на този подкомпонент.

Поддръжка на JSON в SQLite

Започвайки от SQLite 3.38.0 (издадена на 22 февруари 2022 г.), JSON функциите и операторите са вградени в SQLite. Преди SQLite 3.38.0 ще трябва да използвате -DSQLITE_ENABLE_JSON1 опция по време на компилиране, за да активирате поддръжката на JSON.