UpdateDataLite

columnsUpdateColumnsLite

deletestring[]

Required

The list of column titles for deletion

newobject[]

Required

data_type"Boolean" | "Int8" | "Int16" | "Int32" | "Int64" | "UInt8" | "UInt16" | "UInt32" | "UInt64" | "Float16" | "Float32" | "Float64" | "Utf8" | "Date32" | "Timestamp"

Capitalized list of supported PyArrow datatypes outlined in https://arrow.apache.org/docs/python/api/datatypes.html.

Timestamp datatype is expected to be used with unit measured in "us" and timezone set to "UTC" inside of parquet column header schema or it won't be accepted; an example for PyArrow binding would look like this: pa.timestamp("us", tz="UTC")

titlestring

The human-readable label used to identify the column

unit_idstring | null

The ID of the column's unit

renameobject[]

Required

new_titlestring

The new human-readable label for the column identified by title

titlestring

The original human-readable label used to identify the column

updatestring[]

Required

The list of column titles for update

update_metadataarray | null

commentstring | null

geometry_changeboolean | null

Whether the update will create or destroy sub-blocks.

• If set to false, no sub-blocks can be created nor destroyed, only sub-blocks that exist in the latest version can be updated.
• If set to true:
  • New sub-blocks can be created and/or existing sub-blocks can be destroyed, but all columns must be provided.
  • Only new, update, and delete column operations are allowed as standalone operations.
  • update_metadata is allowed, but only when the target columns are being updated as part of the update operation, and only when there are no columns being renamed.
  • If update_type is set to merge, then all sub-blocks within a parent block must be provided.

input_optionsInputOptionsParquet | InputOptionsCSV | null

Any of:

One of:

InputOptionsParquetobject

file_format"parquet"

Default: "parquet"

InputOptionsCSVobject

column_name_mappingarray | null

Default: []

decimal_charstring | null

Default: "."

delimiterstring | null

Default: ","

file_format"csv"

Default: "csv"

quote_charstring | null

Default: """

skip_rowsinteger | null

skip_rows_after_headersinteger | null

null

update_type"merge" | "replace"

Default: "merge"

Behaviour of the update, for blocks that are omitted from the update file.

• If set to replace, the values for blocks that are omitted will be set to null, for the selected columns. If geometry_change is true, the geometry of any parent block that has no blocks in the update file will be reset to an un-subdivided state.
• If set to merge, blocks that are omitted will be left unchanged, the values within those blocks will be the same as within the previous version.