Nachfolgend finden Sie eine vollständige Liste der in SQLite verfügbaren JSON-Funktionen und JSON-Operatoren.
Skalarfunktionen
Funktion | Beschreibung |
json() | Gibt eine verkleinerte Version seines Arguments (JSON-String) als tatsächliches JSON zurück. Im Grunde konvertiert es Rohtext, der wie JSON aussieht, in tatsächliches JSON. |
json_array() | Gibt basierend auf seinen Argumenten ein wohlgeformtes JSON-Array zurück. |
json_array_length() | Gibt die Anzahl der Elemente in einem gegebenen JSON-Array zurück. |
json_extract() | Extrahiert und gibt einen oder mehrere Werte aus wohlgeformtem JSON zurück. |
json_insert() | Fügt einen neuen Wert in ein JSON-Dokument ein. |
json_object() | Gibt basierend auf seinen Argumenten ein wohlgeformtes JSON-Objekt zurück. |
json_patch() | Fügt Elemente eines JSON-Objekts hinzu, ändert und/oder löscht sie (es führt den RFC-7396-MergePatch-Algorithmus aus, um einen gegebenen Patch auf die gegebene JSON-Eingabe anzuwenden). |
json_remove() | Entfernt ein oder mehrere Elemente aus einem JSON-Objekt oder -Array. |
json_replace() | Ersetzt einen vorhandenen Wert in einem JSON-Dokument durch einen anderen Wert. |
json_set() | Fügt einen Wert in ein JSON-Dokument ein oder ersetzt ihn. |
json_type() | Gibt den Typ des äußersten Elements des gegebenen JSON zurück. |
json_valid() | Überprüft, ob sein Argument wohlgeformtes JSON ist. |
json_quote() | Konvertiert eine Zahl oder einen String in die entsprechende JSON-Darstellung. |
Aggregatfunktionen
Funktion | Beschreibung |
json_group_array() | Gibt ein JSON-Array zurück, das aus allen Werten in der Aggregation besteht. |
json_group_object() | Gibt ein JSON-Objekt zurück, das aus allen Name/Wert-Paaren in der Aggregation besteht. |
Tabellenwertfunktionen
Funktion | Beschreibung |
json_each() | Verwendet den als erstes Argument bereitgestellten JSON-Wert und gibt eine Tabelle zurück, die aus einer Zeile für jedes Array-Element oder Objektmitglied besteht. Es durchläuft nur die unmittelbaren Kinder des Arrays oder Objekts der obersten Ebene oder nur das Element der obersten Ebene selbst, wenn das Element der obersten Ebene ein primitiver Wert ist. |
json_tree() | Verwendet den als erstes Argument bereitgestellten JSON-Wert und gibt eine Tabelle zurück, die aus einer Zeile für jedes Array-Element oder Objektmitglied besteht. Es geht rekursiv durch die JSON-Unterstruktur, beginnend mit dem Element der obersten Ebene. |
JSON-Operatoren
SQLite enthält außerdem die folgenden Operatoren für die Arbeit mit JSON:
Operator | Beschreibung |
-> | Extrahiert eine Unterkomponente aus einem JSON-Dokument und gibt eine JSON-Darstellung dieser Unterkomponente zurück. |
->> | Extrahiert eine Unterkomponente aus einem JSON-Dokument und gibt eine SQL-Darstellung dieser Unterkomponente zurück. |
JSON-Unterstützung in SQLite
Ab SQLite 3.38.0 (veröffentlicht am 22. Februar 2022) sind JSON-Funktionen und -Operatoren in SQLite integriert. Vor SQLite 3.38.0 müssten Sie -DSQLITE_ENABLE_JSON1
verwenden Option zur Kompilierzeit, um die JSON-Unterstützung zu aktivieren.