Poniżej znajduje się pełna lista funkcji JSON i operatorów JSON dostępnych w SQLite.
Funkcje skalarne
Funkcja | Opis |
json() | Zwraca zminimalizowaną wersję swojego argumentu (ciąg JSON) jako rzeczywisty JSON. Zasadniczo konwertuje surowy tekst, który wygląda jak JSON, na rzeczywisty JSON. |
json_array() | Zwraca dobrze sformatowaną tablicę JSON na podstawie jej argumentów. |
json_array_length() | Zwraca liczbę elementów w danej tablicy JSON. |
json_extract() | Wyodrębnia i zwraca jedną lub więcej wartości z dobrze sformatowanego JSON. |
json_insert() | Wstawia nową wartość do dokumentu JSON. |
json_object() | Zwraca prawidłowo sformatowany obiekt JSON na podstawie jego argumentów. |
json_patch() | Dodaje, modyfikuje i/lub usuwa elementy obiektu JSON (uruchamia algorytm RFC-7396 MergePatch, aby zastosować daną poprawkę do danych wejściowych JSON). |
json_remove() | Usuwa jeden lub więcej elementów z obiektu lub tablicy JSON. |
json_replace() | Zastępuje istniejącą wartość w dokumencie JSON inną wartością. |
json_set() | Wstawia lub zastępuje wartość w dokumencie JSON. |
json_type() | Zwraca typ najbardziej zewnętrznego elementu danego JSON. |
json_valid() | Sprawdza, czy jego argument jest poprawnie sformułowany w formacie JSON. |
json_quote() | Konwertuje liczbę lub ciąg na odpowiednią reprezentację JSON. |
Funkcje agregujące
Funkcja | Opis |
json_group_array() | Zwraca tablicę JSON składającą się ze wszystkich wartości w agregacji. |
json_group_object() | Zwraca obiekt JSON złożony ze wszystkich par nazwa/wartość w agregacji. |
Funkcje o wartościach tabelarycznych
Funkcja | Opis |
json_each() | Przechodzi wartość JSON podaną jako pierwszy argument i zwraca tabelę składającą się z jednego wiersza dla każdego elementu tablicy lub elementu członkowskiego. Przechodzi tylko bezpośrednie dzieci tablicy lub obiektu najwyższego poziomu lub tylko sam element najwyższego poziomu, jeśli element najwyższego poziomu jest wartością pierwotną. |
json_tree() | Przechodzi wartość JSON podaną jako pierwszy argument i zwraca tabelę składającą się z jednego wiersza dla każdego elementu tablicy lub elementu członkowskiego. Rekurencyjnie przechodzi przez podstrukturę JSON, zaczynając od elementu najwyższego poziomu. |
Operatory JSON
SQLite zawiera również następujące operatory do pracy z JSON:
Operator | Opis |
-> | Wyodrębnia podkomponent z dokumentu JSON i zwraca reprezentację JSON tego podkomponentu. |
->> | Wyodrębnia podkomponent z dokumentu JSON i zwraca reprezentację SQL tego podkomponentu. |
Obsługa JSON w SQLite
Począwszy od wersji SQLite 3.38.0 (wydanej 22 lutego 2022 r.), funkcje i operatory JSON są wbudowane w SQLite. Przed wersją SQLite 3.38.0 należało użyć -DSQLITE_ENABLE_JSON1
opcja czasu kompilacji, aby włączyć obsługę JSON.