When uploading data into Data & Insights via API, the data should be in a specific format best suited for the particular column type being used. These expected formats are not needed when uploading through the Data & Insights Dataset Management Experience which can handle validation errors through Transforms and existing logic.
The table below describes the valid formats for each data type, following these standards will ensure data is uploaded successfully.
Type | Valid Formats | Acceptable Value Examples | Invalid Value Examples |
---|---|---|---|
text |
Text strings up to 4kb in size. This would be about 4,000 characters for strings containing only ASCII characters. (This estimate is per cell value and the limit will be lowered based on non-ASCII characters.) Null values are permitted and are interpreted as the absence of a value (not an empty string or ""). |
|
|
checkbox |
The values true and false with or without quotation encapsulation. Null values are permitted and are interpreted as the absence of a value (not false). |
|
|
number |
Numeric values or strings that can be correctly parsed as numbers. We permit numbers as strings in order to correctly handle values larger than MAX_SAFE_INT. Null values are permitted and are interpreted as the absence of a value (not zero). |
|
|
floating_timestamp (calendar_date) |
ISO-8601 strings that do not include a timezone component. For more information on ISO-8601 see: |
|
|
point |
Well-known Text (WKT) objects of the respective types using decimal degrees in the WGS84 projection as the x and y parameters. Note that the order of parameters is x followed by y (which is equivalent to longitude followed by latitude). For more information on Data & Insights's support for geographic primitives please see: For more information on the Well-known Text format see: |
|
|
location |
Currently, while we work on upgrading the technical storage for datasets on the platform we have a background process for specifying geospatial points in the legacy 'location' format. This format is as follows: { Note: To ensure that your data ingress procedures will automatically benefit from future platform improvements, and to reduce any friction that future changes to your data ingress procedures will be necessary as we will eventually retire these background processes, you should consider proactively updating location columns to point data types at your earliest convenience. |
|
|
Comments
Article is closed for comments.