Array Upgrade

TileDB arrays have a format version that is set by the version of TileDB used in creating the array. The format version controls items such as the directory layout and the binary format. Writes to TileDB arrays are done in the same format version as the dataset in order to maintain client compatibility. When a new format version is available, you can upgrade your arrays to take advantage of the newer format's improvements.

Updating the array version is a logical change. This allows for future writes or consolidation to be written in the newer version. Calling the upgrade API will not rewrite the dataset. After calling the upgrade API, you can use consolidation to perform a rewrite of existing fragments.

C

// ... create context ctx
// ... create config config

int rc = tiledb_array_upgrade_version(ctx, array_name, config);

C++

// ... create context ctx
// ... create config config

tiledb::Array::upgrade_version(ctx, "<array_uri>", config);

Python

# ... create context ctx
# ... create config config

Array.upgrade_version()

# optionally pass a config
Array.upgrade_version(config=config)

Java

// Create array and context

array.upgradeVersion(context, array.getConfig());