Describing JSON Lines data

The following table shows the properties you must provide in a data source description for each data field in a location, event or properties block with JSON Lines format data.

Setting Description
id The name for the column in the database table
Example: vehicle_id
The ID specified should contain only numbers, lowercase letters and underscores and should start with a lowercase letter.
sourceFieldName The name of the JSON property in the source data
Example: "id"
purpose (Optional)
This setting enables you to identify the following fields for specialized indexing:
- latitude
- longitude
- source_id
See Special fields for more information.
sqlType The SQL data type for this field. For more information about the data types supported, see Types of data.
Example: VARCHAR

For example:

    "id": "vehicle_id",
    "sourceFieldName": "id",
    "purpose": "SOURCE_ID",
    "sqlType": "VARCHAR"

Data validation

For JSON Lines format data, each row of source input data must comply to the JSON specification or it will be rejected.

For a given row, if a source field:

  • is referenced that does not exist, the value associated with that field will be interpreted as NULL
  • is an empty string, it will be interpreted as an empty string (the validity of this is based on its field specification)
  • has a value null, it will be interpreted as NULL (the validity of this is based on its field specification)