Skip to main content

ImportArchiveData

Imports archive row data from an export ZIP into a target archive. The target archive must be Disabled during the import (see DisableArchive). The bot validates that the export schema matches the target archive before any rows are written.

Examples

Import in InsertOnly mode (default):

octo-cli -c ImportArchiveData `
-tid "mytenant" `
-aid "69fda707d47638c68edc7fea" `
-i "./archive-export.zip" `
-w

Import with upsert (required for windowed archives):

octo-cli -c ImportArchiveData `
-tid "mytenant" `
-aid "69fda707d47638c68edc7fea" `
-i "./archive-export.zip" `
-m "Upsert" `
-w

Options

ShortLongRequiredDescription
-tid--tenantIdyesId of tenant
-aid--archiveRtIdyesRuntime id of the target CkArchive entity
-i--inputyesExport file to import (*.zip)
-m--modenoImport mode: InsertOnly (default) or Upsert. Upsert is required for windowed (time-range / rollup) archives.
-w--waitnoWait for a import job to complete

Notes

The target archive must be Disabled during the import (use DisableArchive first, EnableArchive afterwards).

On failure the bot's error message (schema mismatch / archive-not-Disabled) is surfaced verbatim.