A mapping file is generated for each entity type. There may be more than one mapping file per type, as files may be provided incrementally or split across multiple files when they exceed the chunking limit.

Metadata Header (First Row)

The first line of every export file contains metadata about the export. The meta contains the entity type as the table name (e.g. jira:comment), and standard mapping columns definitions.

The column definitions are:

Property	Type	Description
`entityType`	varchar	The entity type for this item (e.g. `jira:issue`). Entity Types
`sourceId`	number	Source system identifier.
`targetId`	number	Destination system identifier.
`migrationScopeId`	varchar	A UUID identifying the migration scope (the combination of source and destination) for this item.
`createdAtTimestamp`	timestamp	Time the mapping was created.
`DELETED`	boolean	Indicates if this mapping has been deleted.
`TXN_SEQUENCE`	integer	Identifier indicating the sequence number of the mapping updates.

Example metadata line (formatted for readability)

1
2
{"columns":[{"name":"sourceId","type":"number","size":19,"nullable":false},{"name":"targetId","type":"number","size":19,"nullable":false},
  {"name":"entityType","type":"varchar","size":100,"nullable":false},{"name":"migrationScopeId","type":"varchar","size":255,"nullable":true},
  {"name":"createdAtTimestamp","type":"timestamp","size":-1,"nullable":false},
  {"name":"DELETED","type":"boolean","size":1,"nullable":false},
  {"name":"TXN_SEQUENCE","type":"integer","size":19,"nullable":false}],
  "primaryKeys":["sourceId","entityType"],
  "table":"jira:comment","rowCount":1000,"TYPE":"METADATA"}

Example mapping file data row (formatted for readability)

1
2
{"sourceId":36778,"targetId":136830,"entityType":"jira:comment","migrationScopeId":"migration_scope_001",
  "createdAtTimestamp":"2026-04-17T05:30:07.477354Z","DELETED":false,"TXN_SEQUENCE":29606730}