Nedenfor er en komplet liste over JSON-funktioner og JSON-operatorer tilgængelige i SQLite.
Skalære funktioner
Funktion | Beskrivelse |
json() | Returnerer en minificeret version af dens (JSON-streng)-argument som faktisk JSON. Grundlæggende konverterer den rå tekst, der ligner JSON, til faktisk JSON. |
json_array() | Returnerer et velformet JSON-array baseret på dets argumenter. |
json_array_length() | Returnerer antallet af elementer i et givet JSON-array. |
json_extract() | Udtrækker og returnerer en eller flere værdier fra veludformet JSON. |
json_insert() | Indsætter en ny værdi i et JSON-dokument. |
json_object() | Returnerer et velformet JSON-objekt baseret på dets argumenter. |
json_patch() | Tilføjer, ændrer og/eller sletter elementer i et JSON-objekt (det kører RFC-7396 MergePatch-algoritmen for at anvende en given patch mod det givne JSON-input). |
json_remove() | Fjerner et eller flere elementer fra et JSON-objekt eller et array. |
json_replace() | Erstatter en eksisterende værdi i et JSON-dokument med en anden værdi. |
json_set() | Indsætter i eller erstatter en værdi i et JSON-dokument. |
json_type() | Returnerer typen af det yderste element af den givne JSON. |
json_valid() | Tjekker om dets argument er veludformet JSON. |
json_quote() | Konverterer et tal eller en streng til dens tilsvarende JSON-repræsentation. |
Aggregerede funktioner
Funktion | Beskrivelse |
json_group_array() | Returnerer et JSON-array bestående af alle værdier i aggregeringen. |
json_group_object() | Returnerer et JSON-objekt, der består af alle navn/værdi-par i aggregeringen. |
Tabelværdierede funktioner
Funktion | Beskrivelse |
json_each() | Vender JSON-værdien angivet som dets første argument og returnerer en tabel bestående af en række for hvert array-element eller objektmedlem. Det går kun de umiddelbare børn af arrayet eller objektet på øverste niveau, eller bare selve elementet på øverste niveau, hvis elementet på øverste niveau er en primitiv værdi. |
json_tree() | Vender JSON-værdien angivet som dets første argument og returnerer en tabel bestående af en række for hvert array-element eller objektmedlem. Den går rekursivt gennem JSON-understrukturen begyndende med elementet på øverste niveau. |
JSON-operatører
SQLite inkluderer også følgende operatorer til at arbejde med JSON:
Operator | Beskrivelse |
-> | Udtrækker en underkomponent fra et JSON-dokument og returnerer en JSON-repræsentation af den underkomponent. |
->> | Udtrækker en underkomponent fra et JSON-dokument og returnerer en SQL-repræsentation af den underkomponent. |
JSON-understøttelse i SQLite
Fra SQLite 3.38.0 (frigivet den 22. februar 2022) er JSON-funktioner og -operatorer indbygget i SQLite. Før SQLite 3.38.0 skal du bruge -DSQLITE_ENABLE_JSON1
mulighed for kompileringstid for at aktivere JSON-understøttelse.