Dưới đây là danh sách đầy đủ các hàm JSON và toán tử JSON có sẵn trong SQLite.
Hàm vô hướng
Hàm | Mô tả |
json() | Trả về phiên bản rút gọn của đối số (chuỗi JSON) của nó dưới dạng JSON thực. Về cơ bản, nó chuyển đổi văn bản thô trông giống như JSON thành JSON thực tế. |
json_array() | Trả về một mảng JSON được định dạng tốt dựa trên các đối số của nó. |
json_array_length() | Trả về số phần tử trong một mảng JSON nhất định. |
json_extract() | Trích xuất và trả về một hoặc nhiều giá trị từ JSON được định dạng tốt. |
json_insert() | Chèn một giá trị mới vào tài liệu JSON. |
json_object() | Trả về một đối tượng JSON được định dạng tốt dựa trên các đối số của nó. |
json_patch() | Thêm, sửa đổi và / hoặc xóa các phần tử của Đối tượng JSON (nó chạy thuật toán MergePatch RFC-7396 để áp dụng một bản vá cụ thể so với đầu vào JSON đã cho). |
json_remove() | Xóa một hoặc nhiều phần tử khỏi đối tượng hoặc mảng JSON. |
json_replace() | Thay thế một giá trị hiện có trong tài liệu JSON bằng một giá trị khác. |
json_set() | Chèn vào hoặc thay thế một giá trị trong tài liệu JSON. |
json_type() | Trả về kiểu của phần tử ngoài cùng của JSON đã cho. |
json_valid() | Kiểm tra xem đối số của nó có phải là JSON được định dạng tốt hay không. |
json_quote() | Chuyển đổi một số hoặc chuỗi thành biểu diễn JSON tương ứng của nó. |
Hàm tổng hợp
Hàm | Mô tả |
json_group_array() | Trả về một mảng JSON bao gồm tất cả các giá trị trong tập hợp. |
json_group_object() | Trả về một đối tượng JSON bao gồm tất cả các cặp tên / giá trị trong tập hợp. |
Các hàm được định giá trong bảng
Hàm | Mô tả |
json_each() | Đi bộ giá trị JSON được cung cấp làm đối số đầu tiên của nó và trả về một bảng bao gồm một hàng cho mỗi phần tử mảng hoặc thành viên đối tượng. Nó chỉ đi các phần tử con trực tiếp của mảng hoặc đối tượng cấp cao nhất hoặc chỉ của chính phần tử cấp cao nhất nếu phần tử cấp cao nhất là một giá trị nguyên thủy. |
json_tree() | Đi bộ giá trị JSON được cung cấp làm đối số đầu tiên của nó và trả về một bảng bao gồm một hàng cho mỗi phần tử mảng hoặc thành viên đối tượng. Nó duyệt đệ quy qua cấu trúc con JSON bắt đầu với phần tử cấp cao nhất. |
Toán tử JSON
SQLite cũng bao gồm các toán tử sau để làm việc với JSON:
Nhà điều hành | Mô tả |
-> | Trích xuất một thành phần con từ tài liệu JSON và trả về bản trình bày JSON của thành phần con đó. |
->> | Trích xuất thành phần con từ tài liệu JSON và trả về biểu diễn SQL của thành phần con đó. |
Hỗ trợ JSON trong SQLite
Bắt đầu từ SQLite 3.38.0 (phát hành vào ngày 22 tháng 2 năm 2022), các hàm và toán tử JSON được tích hợp sẵn trong SQLite. Trước SQLite 3.38.0, bạn cần sử dụng -DSQLITE_ENABLE_JSON1
tùy chọn thời gian biên dịch để bật hỗ trợ JSON.