Bulk Import

Bulk Import is a file-based inbound mechanism for loading large volumes of data into Minyu.

Data is provided as CSV files packaged in a ZIP archive. Each file maps to a table using the table's API name. Many-to-many relations are handled through dedicated linking files. Relations are fully supported.

The import executes as a scheduled batch operation.

Execution Model

• Write rules are bypassed
• Only structural schema constraints apply
• Errors are isolated per row and per file
• The operation is irreversible once executed

Identifiers

Both identifiers are supported:

• id → Internal Minyu primary key
• _id → External reference key

Mandatory

Both are mandatory even if the values are blank

Processing Phases

1. Upload and structural validation
2. Dry run on temporary tables
3. Review of row-level errors
4. Scheduled execution on live data