arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

JSONPATHARRAYDEFAULTEMPTY

This section contains reference documentation for the JSONPATHARRAYDEFAULTEMPTY function.

Extracts an array from jsonField based on 'jsonPath', the result type is inferred based on JSON value. Returns empty array for null or parsing error. This function can only be used in an ingestion transformation function.

hashtag
Signature

JSONPATHARRAYDEFAULTEMPTY(jsonField, 'jsonPath')

Arguments
Description
circle-exclamation

'jsonPath'` is a literal. Pinot uses single quotes to distinguish them from identifiers. You can use the to test JSON expressions before you import any data.

hashtag
Usage Examples

The usage examples are based on extracting fields from the following JSON document:

Expression
Value

This function can be used in the to extract the name, score, and second value of homework_grades into their respective columns , as described below:

jsonField

An Identifier/Expression contains JSON documents.

'jsonPath'

Follows JsonPath Syntaxarrow-up-right to read values from JSON documents.

JSONPATHARRAYDEFAULTEMPTY(myJsonRecord, '$.subjects[*].name')

["maths", "english"]

JSONPATHARRAYDEFAULTEMPTY(myJsonRecord, '$.subjects[*].score')

[90, 70]

JSONPATHARRAYDEFAULTEMPTY(myJsonRecord, '$.subjects[*].homework_grades[1]')

[85, 65]

JSONPATHARRAYDEFAULTEMPTY(myJsonRecord, '$.subjects[*].homework_grades[7]')

[]

Jayway JsonPath Evaluator Toolarrow-up-right
table config
{
  "data": {
    "name": "Pete",
    "age": 24,
    "subjects": [
      {
        "name": "maths",
        "homework_grades": [80, 85, 90, 95, 100],
        "grade": "A",
        "score": 90
      },
      {
        "name": "english",
        "homework_grades": [60, 65, 70, 85, 90],
        "grade": "B",
        "score": 70
      }
    ]
  }
}
{
   "tableConfig":{
      "ingestionConfig":{
         "transformConfigs":[
            {
               "columnName":"names",
               "transformFunction":"JSONPATHARRAYDEFAULTEMPTY(data, '$.subjects[*].name')"
            },
            {
               "columnName":"ages",
               "transformFunction":"JSONPATHARRAYDEFAULTEMPTY(data, '$.subjects[*].score')"
            },
            {
               "columnName":"homeworkGrades",
               "transformFunction":"JSONPATHARRAYDEFAULTEMPTY(data, '$.subjects[*].homework_grades[1]')"
            }
         ]
      }
   }
}