Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update json-functions.md #46411

Merged
merged 5 commits into from
Feb 14, 2023
Merged

Update json-functions.md #46411

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
4645355
Update json-functions.md
den-crane Feb 14, 2023
6273176
Update json-functions.md
den-crane Feb 14, 2023
7805845
Update json-functions.md
den-crane Feb 14, 2023
3b708de
Update json-functions.md
den-crane Feb 14, 2023
010056f
Update json-functions.md
den-crane Feb 14, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
12 changes: 9 additions & 3 deletions docs/en/sql-reference/functions/json-functions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,13 @@ sidebar_position: 56
sidebar_label: JSON
---

# Functions for Working with JSON
There are two sets of functions to parse JSON.
- `visitParam*` (`simpleJSON*`) is made to parse a special very limited subset of a JSON, but these functions are extremely fast.
- `JSONExtract*` is made to parse normal JSON.

ClickHouse has special functions for working with this JSON. All the JSON functions are based on strong assumptions about what the JSON can be, but they try to do as little as possible to get the job done.
# visitParam functions

ClickHouse has special functions for working with simplified JSON. All these JSON functions are based on strong assumptions about what the JSON can be, but they try to do as little as possible to get the job done.

The following assumptions are made:

Expand Down Expand Up @@ -75,7 +79,9 @@ visitParamExtractString('{"abc":"hello}', 'abc') = '';

There is currently no support for code points in the format `\uXXXX\uYYYY` that are not from the basic multilingual plane (they are converted to CESU-8 instead of UTF-8).

The following functions are based on [simdjson](https://github.com/lemire/simdjson) designed for more complex JSON parsing requirements. The assumption 2 mentioned above still applies.
# JSONExtract functions

The following functions are based on [simdjson](https://github.com/lemire/simdjson) designed for more complex JSON parsing requirements.

## isValidJSON(json)

Expand Down