Error Codes Reference¶
DATAMIMIC uses standardized Issue Codes for clear, actionable error messages.
Error Format¶
Each error includes:
- Issue Code: Unique identifier (e.g.,
I322) - Message: Description of the problem
- Location: File and line number where the error occurred
- Guidance: How to resolve the issue
Issue Code Ranges¶
| Range | Category |
|---|---|
| I1xx | Source issues |
| I2xx | Include issues |
| I3xx | Exporter configuration issues |
| I4xx | Generator and datetime issues |
| I5xx | Condition issues |
| I6xx | Parser issues |
| I7xx | Client/runtime configuration issues |
| I8xx | Task configuration issues |
| I9xx | Operation issues |
Source Issues¶
I101: Source File Not Found¶
Message: Source file '{name}' not found in task workspace.
Cause: The source file path resolved under the task workspace but the file does not exist.
Resolution: Place the file under the descriptor directory or update the source path.
Guidance: Check your project environment configuration or uploaded assets.
I102: Source Invalid CSV¶
Message: Invalid CSV in '{name}'.
Cause: The CSV file content is malformed or cannot be parsed.
Resolution: Fix CSV syntax, delimiter, and quoting, then retry.
Guidance: Check your project environment configuration or uploaded assets.
I103: Source Invalid CSV Header¶
Message: Invalid CSV in '{name}'. CSV sources must include a header row.
Cause: The CSV source is missing a header row required for column mapping.
Resolution: Add a header row to the CSV source and retry.
Guidance: Check your project environment configuration or uploaded assets.
I104: Source Invalid JSON¶
Message: Invalid JSON in '{name}'.
Cause: The JSON file content is malformed or cannot be parsed.
Resolution: Fix JSON syntax and ensure the file is valid JSON.
Guidance: Check your project environment configuration or uploaded assets.
I105: Source Invalid XML¶
Message: Invalid XML in '{name}'.
Cause: The XML file content is malformed or cannot be parsed.
Resolution: Fix XML syntax and ensure the file is well-formed.
Guidance: Check your project environment configuration or uploaded assets.
I106: Source Invalid NDJSON¶
Message: Invalid NDJSON in '{name}'.
Cause: The NDJSON content contains invalid JSON lines.
Resolution: Ensure each line is a valid JSON object and retry.
Guidance: Check your project environment configuration or uploaded assets.
I107: Source JSON Root Invalid¶
Message: JSON file '{name}' must contain a list of objects or a dictionary.
Cause: The JSON root value is not a list of objects or a dictionary.
Resolution: Use a JSON array of objects or a dictionary at the root.
I108: Source XML Root Invalid¶
Message: XML file '{name}' must contain a dictionary.
Cause: The XML root does not map to a dictionary structure.
Resolution: Ensure the XML root maps to key/value structure expected by the loader.
I109: Source Unsupported File Type¶
Message: Data source '{name}' is not supported by DataSourceRegistry.
Cause: The source configuration specifies an unsupported configuration.
Resolution: Use a supported file or adjust the configuration.
Guidance: Check your project environment configuration or uploaded assets.
I110: Source JSON Array Not Acceptable¶
Message: JSON array not acceptable for object mode: '{name}'.
Cause: Object mode expects a JSON object but an array was provided.
Resolution: Use object mode with an object root or switch to array mode.
I111: Source JSON Object Mode Unsupported¶
Message: Unsupported JSON root for object mode in '{name}'.
Cause: Object mode is not supported for the provided JSON root type.
Resolution: Use array mode or adjust the JSON root to a supported type.
I112: Source JSON Wrappable Required¶
Message: JSON file '{name}' must be an array or an object (wrappable).
Cause: The JSON root is not an array or object and cannot be wrapped.
Resolution: Provide a JSON array or object at the root.
I113: Source Template Empty¶
Message: Template source '{name}' is empty.
Cause: The template file exists but contains no usable content.
Resolution: Provide non-empty template content before running the task.
I114: Source Template Not Found¶
Message: Template file '{name}' not found in task workspace.
Cause: The template file referenced by the source could not be located in the task workspace.
Resolution: Upload the template file or correct the template path.
Guidance: Check your project environment configuration or uploaded assets.
I115: Source Template Invalid XML¶
Message: Invalid XML in template '{name}'.
Cause: The configuration provides an invalid XML in template '{name}'.
Resolution: Correct the template file to a valid value or configuration.
Guidance: Check your project environment configuration or uploaded assets.
I116: Source Expr Not String¶
Message: Source expression must evaluate to a string.
Cause: The configuration violates the requirement that Source expression must evaluate to a string.
Resolution: Set the source to a string value.
I117: Source Expr Item Not String¶
Message: Item source expression for
Cause: The configuration violates the requirement that Item source expression for
Resolution: Set the source to a string value.
I118: Source Expr Nested Not String¶
Message: NestedKey source expression must evaluate to a string.
Cause: The configuration violates the requirement that NestedKey source expression must evaluate to a string.
Resolution: Set the source to a string value.
I119: Source Expr Eval Failed¶
Message: Failed to evaluate source expression '{expr}': {error}.
Cause: The system failed to evaluate source expression '{expr}': {error}.
Resolution: Fix the expression or script and retry.
I120: Source Client Unsupported¶
Message: Cannot load data from client: {client_type}.
Cause: The system could not load data from client: {client_type}.
Resolution: Use a supported client or adjust the configuration.
I121: Source Unknown Client¶
Message: Unknown database client '{client_id}' for
Cause: The configuration references an unknown database client '{client_id}' for
Resolution: Correct the client to a valid value or configuration.
I122: Source Unknown¶
Message: Unknown source for
Cause: The source identifier did not match any configured client or supported source type.
Resolution: Use a configured client id or ML source syntax (ml://
I123: Source Object Storage Bucket Missing¶
Message: Object storage requires a non-empty 'bucket' (MinIO/S3) or 'container' (Azure).
Cause: A required object storage is missing in the source configuration.
Resolution: Provide the required object storage configuration and retry.
I124: Source Object Storage Bucket Attr Missing¶
Message: Object-storage source of
Cause: A required object storage is missing in the source configuration.
Resolution: Provide the required object storage configuration and retry.
I125: Source Object Storage URI Missing¶
Message: Object-storage source of
Cause: A required object storage is missing in the source configuration.
Resolution: Provide the required object storage configuration and retry.
I126: Source Object Storage Object Not Found¶
Message: Object '{object_name}' not found in bucket '{bucket}'.
Cause: The referenced object storage could not be found for the source configuration.
Resolution: Ensure the referenced object storage configuration exists and the identifier/path is correct.
Guidance: Check your project environment configuration or uploaded assets.
I127: Source Object Storage Invalid Payload¶
Message: Invalid {kind} in object '{object_name}' in bucket '{bucket}'.
Cause: The configuration provides an invalid {kind} in object '{object_name}' in bucket '{bucket}'.
Resolution: Correct the object storage configuration to a valid value or configuration.
Guidance: Check your project environment configuration or uploaded assets.
I128: Source Object Storage Unsupported Type¶
Message: Unsupported object type for '{object_name}' in bucket '{bucket}'. Supported extensions: .csv, .json, .xml.
Cause: The configuration uses an unsupported object type for '{object_name}' in bucket '{bucket}'.Supportedextensions: .csv, .json, .xml.
Resolution: Use a supported object storage configuration or adjust the configuration.
I129: Source DB Query Client Missing¶
Message: Database query requested but client was None.
Cause: A required database query is missing in the source configuration.
Resolution: Provide the required database query and retry.
I130: Source DB Table Client Missing¶
Message: Database table requested but client was None.
Cause: A required database table is missing in the source configuration.
Resolution: Provide the required database table and retry.
I131: Source Memstore Task ID Missing¶
Message: task_id is required for Redis memstore.
Cause: A required configuration is missing in the source configuration.
Resolution: Provide the required source and retry.
I132: Source Unsupported Type¶
Message: Unsupported source type: {source_type}.
Cause: The configuration uses an unsupported source type: {source_type}.
Resolution: Use a supported source or adjust the configuration.
I133: Source Item Unsupported¶
Message: Cannot load data from source '{source}' of '{list_name}'.
Cause: The system could not load data from source '{source}' of '{list_name}'.
Resolution: Use a supported source or adjust the configuration.
I134: Source File Path Not String¶
Message: File source requires a string path (got {value_type}).
Cause: A value expected to be a string was not a string in the source configuration.
Resolution: Set the file to a string value.
I135: Source Index Required¶
Message: Order key '{key_col}' for table '{table}' is not indexed while ds_require_index is enabled.
Cause: The configured order key is not indexed while ds_require_index is enabled.
Resolution: Add an index for the order key or disable ds_require_index in platform_json.
Guidance: Add an index on the order key or disable ds_require_index in platform_json.
I136: Source ML Unknown¶
Message: Unknown source for
Cause: The configuration references an unknown source for
Resolution: Correct the source to a valid value or configuration.
I137: Source Project Ctx Missing¶
Message: Project file sources require a descriptor_dir context.
Cause: Project file sources require a descriptor_dir context, but none was available.
Resolution: Run the task with a valid descriptor_dir or avoid project-file sources.
Guidance: Ensure the task descriptor context (descriptor_dir) is available for project files.
I138: Source Project Path Outside Descriptor¶
Message: Project file '{source}' is outside descriptor directory '{descriptor_dir}'.
Cause: The project file path resolves outside the descriptor directory.
Resolution: Move the file under descriptor_dir or use object storage instead.
Guidance: Project files must live under the task descriptor directory. Move the file into the task directory or use object storage.
I139: Source Project Descriptor Dir Symlink¶
Message: descriptor_dir '{descriptor_dir}' is a symlink (not allowed for project files).
Cause: The descriptor_dir is a symlink, which is not allowed for project file access.
Resolution: Use a real directory path for descriptor_dir.
Guidance: Use a real directory for descriptor_dir; symlinked descriptor_dir is not allowed for security.
I140: Source Project Symlink Escape¶
Message: Project file '{source}' resolves outside descriptor directory '{descriptor_dir}'.
Cause: The project file path resolves outside descriptor_dir due to a symlink.
Resolution: Move the file under descriptor_dir or remove the symlink.
Guidance: Project files must live under the task descriptor directory. Move the file into the task directory or use object storage.
I141: Source Project Path Non Local¶
Message: Project file source '{source}' must be a local filesystem path.
Cause: The project file path is not a local filesystem path.
Resolution: Use a local path under descriptor_dir or switch to object storage.
Guidance: Project files must live under the task descriptor directory. Move the file into the task directory or use object storage.
I142: Source DB Table Not Found¶
Message: Database table '{table}' not found{code_hint}.
Cause: The referenced database table could not be found for the source configuration.
Resolution: Ensure the referenced database table exists and the identifier/path is correct.
I143: Source DB Column Not Found¶
Message: Database column '{column}' not found{code_hint}.
Cause: The referenced database column could not be found for the source configuration.
Resolution: Ensure the referenced database column exists and the identifier/path is correct.
I144: Source DB Query Syntax¶
Message: Database query syntax error: {reason}{code_hint}.
Cause: The database query syntax is invalid for the source configuration.
Resolution: Review the configuration and retry.
I145: Source DB Permission Denied¶
Message: Database permission denied: {reason}{code_hint}.
Cause: Access to the database was denied for the source configuration.
Resolution: Grant the required permissions and retry.
I146: Source DB Type Mismatch¶
Message: Database query type mismatch: {reason}{code_hint}.
Cause: The database type does not match the expected schema for the source configuration.
Resolution: Review the configuration and retry.
I147: Source DB Column Ambiguous¶
Message: Database column reference is ambiguous: '{column}'{code_hint}.
Cause: An error occurred during source configuration.
Resolution: Review the configuration and retry.
I148: Source DB Schema Not Found¶
Message: Database schema '{schema}' not found{code_hint}.
Cause: The referenced database schema could not be found for the source configuration.
Resolution: Ensure the referenced database schema exists and the identifier/path is correct.
I149: Source DB Function Not Found¶
Message: Database function '{function}' not found{code_hint}.
Cause: The referenced database function could not be found for the source configuration.
Resolution: Ensure the referenced database function exists and the identifier/path is correct.
I150: Source Mongo Selector Invalid¶
Message: Invalid Mongo selector: {error}.
Cause: The configuration provides an invalid Mongo selector: {error}.
Resolution: Correct the Mongo selector to a valid value or configuration.
I151: Source Mongo Selector Unsupported¶
Message: Unsupported Mongo selector '{selector}'.Use find:/aggregate: syntax.
Cause: The configuration uses an unsupported Mongo selector '{selector}'.Use find:/aggregate: syntax.
Resolution: Use a supported Mongo selector or adjust the configuration.
I152: Source Mongo Permission Denied¶
Message: Mongo permission denied: {reason}.
Cause: Access to the Mongo was denied for the source configuration.
Resolution: Grant the required permissions and retry.
I153: Source Mongo Namespace Not Found¶
Message: Mongo namespace '{namespace}' not found.
Cause: The referenced Mongo could not be found for the source configuration.
Resolution: Ensure the referenced Mongo namespace exists and the identifier/path is correct.
I154: Source Mongo Query Invalid¶
Message: Mongo query error: {reason}.
Cause: The Mongo value is invalid for the source configuration.
Resolution: Correct the Mongo query to a valid value or configuration.
I155: Source DB Connection Failed¶
Message: Database connection failed: {reason}{code_hint}.
Cause: The connection failed while accessing the database for the source configuration.
Resolution: Review the configuration and retry.
I156: Source DB Timeout¶
Message: Database query timed out: {reason}{code_hint}.
Cause: The source configuration timed out while accessing the database.
Resolution: Retry the operation or increase the timeout if appropriate.
I157: Source DB Deadlock¶
Message: Database deadlock detected: {reason}{code_hint}.
Cause: A database deadlock was detected during the source configuration.
Resolution: Retry the operation or reduce concurrency.
I158: Source Object Storage Client Missing¶
Message: Object storage requested but client was None.
Cause: Object-storage source loading requires a configured object-storage client instance.
Resolution: Provide a valid object-storage client (or storage id) and retry.
I159: Source Kafka Client Missing¶
Message: Kafka source requested but client was None.
Cause: Kafka source loading requires a configured Kafka client instance.
Resolution: Provide a valid Kafka client and retry.
I160: Source Return Type Unsupported¶
Message: Return type '{return_type}' is not supported for source type '{source_type}'.
Cause: The requested return type is incompatible with the selected source type.
Resolution: Use a compatible return type for the source type and retry.
I161: Source Massive Mode Fallback Blocked¶
Message: Massive mode blocked fallback '{fallback}' for backend '{backend}' in '{operation}'.
Cause: The selected source path would use an unsafe fallback for large-scale reads.
Resolution: Use keyset/range-based paging paths or disable massive mode for compatibility reads.
I162: Source DB Route Unsupported Client¶
Message: Unsupported database client type for source routing: {client_type}.
Cause: Database source routing could not classify the configured client implementation.
Resolution: Use a supported database client adapter for RDBMS or MongoDB sources.
I163: Source DB Query Or Table Required¶
Message: Database source requires either 'query' or 'table_name'.
Cause: Database source loading was requested without a query or table name.
Resolution: Set a valid query or table_name in the source configuration and retry.
I164: Source Kafka Client Unsupported API¶
Message: Kafka client '{client_type}' must implement consume_list_message(count) or consume_iter_message(count).
Cause: The configured Kafka client does not implement the required consume API contract.
Resolution: Use a Kafka client adapter that implements consume_list_message or consume_iter_message.
I167: Source Kafka TLS Failed¶
Message: Kafka TLS/SSL handshake failed for topic '{topic}': {reason}.
Cause: The Kafka source client failed the TLS/SSL handshake while reading messages.
Resolution: Verify Kafka TLS certificate paths, trust chain, hostname validation, and protocol settings.
I168: Source Kafka Authentication Failed¶
Message: Kafka authentication failed for topic '{topic}': {reason}.
Cause: The Kafka source client could not authenticate with the configured credentials.
Resolution: Verify SASL/TLS identity settings and credentials for the Kafka source client.
I169: Source Kafka Authorization Failed¶
Message: Kafka authorization failed for topic '{topic}': {reason}.
Cause: The Kafka source client was authenticated but lacks permissions for the topic/resource.
Resolution: Grant required read permissions for the topic and related Kafka resources.
I170: Source Kafka Network Failed¶
Message: Kafka network connectivity failed for topic '{topic}': {reason}.
Cause: The Kafka source client could not reach the configured broker endpoint.
Resolution: Verify bootstrap server host/port, DNS, routing, and firewall connectivity.
I171: Source Kafka Timeout¶
Message: Kafka read timed out for topic '{topic}': {reason}.
Cause: The Kafka source operation exceeded the configured timeout while reading messages.
Resolution: Retry or tune Kafka consumer timeout settings for this workload.
I172: Source Kafka Topic Not Found¶
Message: Kafka topic/resource not found for topic '{topic}': {reason}.
Cause: The configured Kafka topic/resource was not found or is not accessible.
Resolution: Verify the topic exists, is spelled correctly, and is visible to the client.
I173: Source Kafka Read Failed¶
Message: Kafka source read failed for topic '{topic}': {reason}.
Cause: The Kafka source client failed while reading messages due to an unexpected runtime error.
Resolution: Review Kafka client configuration and runtime logs, then retry the operation.
I165: Source Return Payload Type Mismatch¶
Message: Return type '{return_type}' for source type '{source_type}' expected payload type '{expected_type}', got '{actual_type}'.
Cause: The source loader returned a payload that violates the return-type contract.
Resolution: Use a compatible source/return_type combination or fix the source loader contract.
I166: Source Load Kwarg Unsupported¶
Message: Unsupported load parameter(s) '{params}' for source type '{source_type}'. Allowed parameters: {allowed_params}.
Cause: DataSourceRegistry.load received unsupported parameters for the selected source type.
Resolution: Remove unsupported parameters or switch to a source type that supports them.
Include Issues¶
I201: Include File Not Found¶
Message: Include file '{uri}' not found in task workspace.
Cause: The referenced configuration could not be found for the include configuration.
Resolution: Ensure the referenced file exists and the identifier/path is correct.
Guidance: Check your project environment configuration or uploaded assets.
I202: Include Properties Parse Failed¶
Message: Failed to parse include properties file '{uri}': {error}.
Cause: The system failed to parse include properties file '{uri}': {error}.
Resolution: Fix the input format and retry.
I203: Include Unsupported File Type¶
Message: Unsupported include file type '{uri}'. Only .properties and .xml are supported.
Cause: The configuration uses an unsupported include file type '{uri}'. Only .properties and .xml are supported.
Resolution: Use a supported file or adjust the configuration.
I204: Include Unsupported File Type Generate¶
Message: Unsupported include file type '{uri}' inside
Cause: The configuration uses an unsupported include file type '{uri}' inside
Resolution: Use a supported file or adjust the configuration.
I205: Include Condition Not Boolean¶
Message: Condition '{condition}' for include '{uri}' evaluated to a non-boolean value (not a valid boolean value): {value}.
Cause: A condition evaluated to a non-boolean value in the include configuration.
Resolution: Ensure the expression evaluates to true or false.
I206: Include Condition Eval Failed¶
Message: Failed to evaluate condition '{condition}' for include '{uri}': {error}.
Cause: The system failed to evaluate condition '{condition}' for include '{uri}': {error}.
Resolution: Fix the expression or script and retry.
I207: Include Path Outside Descriptor¶
Message: Include path '{uri}' is outside descriptor directory '{descriptor_dir}' or violates relative-path policy: {reason}.
Cause: The include path is outside the descriptor directory or does not follow relative-path requirements.
Resolution: Use a relative include path under descriptor_dir.
Guidance: Project files must live under the task descriptor directory. Move the file into the task directory or use object storage.
Exporter Config Issues¶
I301: Export SQL Unsupported Dialect¶
Message: Unsupported SQL dialect '{dialect}'.
Cause: The configuration uses an unsupported SQL dialect '{dialect}'.
Resolution: Use a supported configuration or adjust the configuration.
I302: Export SQL Unsupported Mode¶
Message: Unsupported SQL output mode '{mode}'. Choose one of {modes}.
Cause: The configuration uses an unsupported SQL output mode '{mode}'. Choose one of {modes}.
Resolution: Use a supported configuration or adjust the configuration.
I303: Export SQL Invalid Batch Size¶
Message: Invalid batch_size '{value}'.
Cause: The configuration provides an invalid batch_size '{value}'.
Resolution: Correct the configuration to a valid value or configuration.
I304: Export SQL Batch Size Nonpositive¶
Message: batch_size must be > 0 (got {size}).
Cause: The configuration violates the requirement that batch_size must be > 0 (got {size}).
Resolution: Provide a positive integer value.
I305: Export SQL Columns Not List¶
Message: columns must be a list of column names.
Cause: The configuration violates the requirement that columns must be a list of column names.
Resolution: Provide a list value for the configuration.
I306: Export SQL Columns Empty¶
Message: columns must be non-empty strings.
Cause: The configuration violates the requirement that columns must be non-empty strings.
Resolution: Provide a non-empty configuration and retry.
I307: Export SQL Column Map Not Dict¶
Message: column_map must be a dict mapping source to target names.
Cause: The configuration violates the requirement that column_map must be a dict mapping source to target names.
Resolution: Provide a dictionary value for the configuration.
I308: Export SQL Column Map Strings¶
Message: column_map keys and values must be strings.
Cause: The configuration violates the requirement that column_map keys and values must be strings.
Resolution: Review the configuration and retry.
I309: Export SQL Column Map Nonempty¶
Message: column_map keys and values must be non-empty.
Cause: The configuration violates the requirement that column_map keys and values must be non-empty.
Resolution: Provide a non-empty configuration and retry.
I310: Export SQL Table Name Empty¶
Message: table_name must be a non-empty string.
Cause: The configuration violates the requirement that table_name must be a non-empty string.
Resolution: Provide a non-empty configuration and retry.
I311: Export SQL Duplicate Columns¶
Message: Duplicate output columns after mapping: {columns}.
Cause: The configuration contains duplicate output columns after mapping: {columns}.
Resolution: Remove duplicates or adjust the configuration to avoid conflicts.
I312: Export Target Not Found¶
Message: Target not found: {target}. Available exporters: {exporters}. Available clients: {clients}.
Cause: The referenced target could not be found for the exporter configuration.
Resolution: Ensure the referenced target exists and the identifier/path is correct.
I313: Export Storage Client Not Found¶
Message: Cannot find storage client with id '{storage_id}'.
Cause: The system could not find storage client with id '{storage_id}'.
Resolution: Ensure the referenced client exists and the identifier/path is correct.
I314: Export Storage Client Unsupported Api¶
Message: Storage client '{client_label}' does not expose a supported storage API. Expected one of: _get_minio_client or write/write_txt/write_csv/write_json/write_xml. Configure a compatible
Cause: The exporter configuration specifies an unsupported client.
Resolution: Use a supported client or adjust the configuration.
I315: Export Storage Bucket Missing¶
Message: Missing default bucket for storage client '{storage_id}'. Configure 'bucket' (MinIO/AWS) or 'container' (Azure) in the
Cause: A required default bucket for storage client '{storage_id}'. Configure 'bucket' (MinIO/AWS) or'container'(Azure) in the
Resolution: Provide the required bucket/container and retry.
I316: Export XML Single Multi Root¶
Message: XMLSingle expects exactly one root element; got {count} keys: {keys}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I317: Export XML Single Root Type¶
Message: First nested key '{root_key}' must contain a dictionary or list, got {value_type}.
Cause: The configuration violates the requirement that First nested key '{root_key}' must contain a dictionaryorlist, got {value_type}.
Resolution: Review the configuration and retry.
I318: Export Target Parse Failed¶
Message: Failed to parse exporter target(s) '{targets}': {error}.
Cause: The system failed to parse exporter target(s) '{targets}': {error}.
Resolution: Fix the input format and retry.
I319: Export Param Non Literal¶
Message: Exporter parameter '{param}' must be a literal value; got {value}.
Cause: The configuration violates the requirement that Exporter parameter '{param}' must be a literal value;got{value}.
Resolution: Review the configuration and retry.
I320: Export Operation Unsupported¶
Message: Unsupported operation '{operation}' for client '{client_name}'. Allowed operations: {allowed}.
Cause: The configuration uses an unsupported operation '{operation}' for client '{client_name}'. Allowedoperations:{allowed}.
Resolution: Use a supported configuration or adjust the configuration.
I321: Export Operation Unsupported Client¶
Message: Unsupported client type '{client_type}' for operation '{operation}'.
Cause: The configuration uses an unsupported client type '{client_type}' for operation '{operation}'.
Resolution: Use a supported client or adjust the configuration.
I322: Export Dynamic Target Entity Unsupported¶
Message: Dynamic targetEntity is only supported for single-file exporters (TemplateSingle, JSONSingle, XMLSingle). Unsupported targets: {targets}.
Cause: Dynamic targetEntity was set for exporters that do not support it.
Resolution: Use TemplateSingle/JSONSingle/XMLSingle or remove dynamic targetEntity values.
Guidance: Dynamic targetEntity is supported only for single-file exporters (TemplateSingle, JSONSingle, XMLSingle).
I323: Export Storage Connect Failed¶
Message: Failed to connect to storage client '{storage_id}': {reason}.
Cause: The system failed to connect to storage client '{storage_id}': {reason}.
Resolution: Review the configuration and retry.
Guidance: Verify storage credentials and network connectivity. For MinIO/S3, ensure the system clock is in sync with the storage server.
I324: Export URI Requires Custom Storage¶
Message: exportUri is only supported with a custom object storage client; got storageId='{storage_id}'.
Cause: exportUri was provided without a custom object storage client.
Resolution: Set storageId to a custom
Guidance: Set storageId to a custom
I325: Export URI Invalid¶
Message: Invalid exportUri '{export_uri}': {reason}.
Cause: exportUri does not match the required path format.
Resolution: Provide a relative path prefix using letters, numbers, '/', '-', '_', '.', or '='.
Guidance: exportUri must be a relative path prefix using letters, numbers, '/', '-', '_', '.', or '='.
I326: Export Dynamic Target Entity Mixed¶
Message: Mixed dynamic targetEntity usage for exporter '{exporter_name}': some records include target_entity and others do not.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I327: Export Template Path Mixed¶
Message: TemplateSingle expects a single template path; got '{current_path}' after '{expected_path}'.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I328: Export DB Table Not Found¶
Message: Target table '{table}' not found in the database{code_hint}.
Cause: The referenced database table could not be found for the exporter configuration.
Resolution: Ensure the referenced database table exists and the identifier/path is correct.
I329: Export Mongo Duplicate Key¶
Message: Duplicate key error while writing to Mongo collection '{collection}': {reason}.
Cause: The configuration contains duplicate key error while writing to Mongo collection '{collection}': {reason}.
Resolution: Ensure values are unique or adjust constraints, then retry.
I330: Export Mongo Write Not Allowed¶
Message: Mongo write not allowed for collection '{collection}': {reason}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I331: Export Mongo Validation Failed¶
Message: Mongo validation failed for collection '{collection}': {reason}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I332: Export Mongo Namespace Not Found¶
Message: Mongo namespace '{namespace}' not found.
Cause: The referenced Mongo could not be found for the exporter configuration.
Resolution: Ensure the referenced Mongo namespace exists and the identifier/path is correct.
I333: Export DB Column Not Found¶
Message: Target column '{column}' not found on table '{table}'{code_hint}.
Cause: The referenced database column could not be found for the exporter configuration.
Resolution: Ensure the referenced database column exists and the identifier/path is correct.
I334: Export DB Schema Not Found¶
Message: Database schema '{schema}' not found{code_hint}.
Cause: The referenced database schema could not be found for the exporter configuration.
Resolution: Ensure the referenced database schema exists and the identifier/path is correct.
I335: Export DB Permission Denied¶
Message: Database permission denied for table '{table}': {reason}{code_hint}.
Cause: Access to the database was denied for the exporter configuration.
Resolution: Grant the required permissions and retry.
I336: Export DB Type Mismatch¶
Message: Database type mismatch while writing to '{table}': {reason}{code_hint}.
Cause: The database type does not match the expected schema for the exporter configuration.
Resolution: Review the configuration and retry.
I337: Export DB Duplicate Key¶
Message: Duplicate key error while writing to '{table}': {reason}{code_hint}.
Cause: The configuration contains duplicate key error while writing to '{table}': {reason}.
Resolution: Ensure values are unique or adjust constraints, then retry.
I338: Export DB Not Null Violation¶
Message: Null value violates NOT NULL constraint on '{table}': {reason}{code_hint}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I339: Export DB Foreign Key Violation¶
Message: Foreign key constraint violation on '{table}': {reason}{code_hint}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I340: Export DB Check Violation¶
Message: Check constraint violation on '{table}': {reason}{code_hint}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I341: Export DB Connection Failed¶
Message: Database connection failed while writing to '{table}': {reason}{code_hint}.
Cause: The connection failed while accessing the database for the exporter configuration.
Resolution: Review the configuration and retry.
I342: Export DB Timeout¶
Message: Database write timed out for '{table}': {reason}{code_hint}.
Cause: The exporter configuration timed out while accessing the database.
Resolution: Retry the operation or increase the timeout if appropriate.
I343: Export DB Deadlock¶
Message: Database deadlock detected while writing to '{table}': {reason}{code_hint}.
Cause: A database deadlock was detected during the exporter configuration.
Resolution: Retry the operation or reduce concurrency.
I344: Export Storage Access Denied¶
Message: Storage access denied for bucket '{bucket}': {reason}.
Cause: Access to the configuration was denied for the exporter configuration.
Resolution: Grant the required permissions and retry.
I345: Export Storage Bucket Not Found¶
Message: Storage bucket '{bucket}' not found.
Cause: The referenced configuration could not be found for the exporter configuration.
Resolution: Ensure the referenced bucket/container exists and the identifier/path is correct.
I346: Export Storage Write Failed¶
Message: Storage write failed for bucket '{bucket}' object '{object_name}': {reason}.
Cause: An error occurred during exporter configuration.
Resolution: Review the configuration and retry.
I347: Export Storage Connect Access Denied¶
Message: Storage access denied for client '{storage_id}': {reason}.
Cause: Access to the configuration was denied for the exporter configuration.
Resolution: Grant the required permissions and retry.
I348: Export Flush Failed¶
Message: Exporter flush failed: {detail}.
Cause: An exporter failed while flushing buffered records.
Resolution: Inspect the reported exporter details and resolve the underlying target write error.
I349: Export Kafka TLS Failed¶
Message: Kafka TLS/SSL handshake failed for topic '{topic}': {reason}.
Cause: Kafka producer failed during TLS/SSL negotiation while exporting records.
Resolution: Verify Kafka TLS certificate paths, key material, and security protocol settings.
I350: Export Kafka Authentication Failed¶
Message: Kafka authentication failed for topic '{topic}': {reason}.
Cause: Kafka producer credentials were rejected while exporting records.
Resolution: Verify SASL credentials/mechanism and retry with valid authentication settings.
I351: Export Kafka Authorization Failed¶
Message: Kafka authorization failed for topic '{topic}': {reason}.
Cause: Kafka producer lacks permissions for the configured topic.
Resolution: Grant write permissions for the topic or update ACLs and retry.
I352: Export Kafka Network Failed¶
Message: Kafka network connectivity failed for topic '{topic}': {reason}.
Cause: Kafka producer could not establish broker connectivity while exporting records.
Resolution: Verify broker hosts/ports, DNS, routing, and firewall configuration.
I353: Export Kafka Timeout¶
Message: Kafka operation timed out for topic '{topic}': {reason}.
Cause: Kafka producer operation exceeded configured timeout while exporting records.
Resolution: Retry the operation or tune Kafka timeout settings for the environment.
I354: Export Kafka Topic Not Found¶
Message: Kafka topic '{topic}' not found or inaccessible: {reason}.
Cause: Configured Kafka topic does not exist or cannot be accessed by the producer.
Resolution: Ensure the topic exists and the producer has access to it.
I355: Export Kafka Write Failed¶
Message: Kafka write failed for topic '{topic}': {reason}.
Cause: Kafka producer encountered an unclassified write failure while exporting records.
Resolution: Inspect broker/client logs and producer configuration, then retry.
Generator and Datetime Issues¶
I401: Generator Init Failed¶
Message: Failed to initialise generator '{generator_decl}' for <{element_tag}> '{stmt_path}'. Cannot create generator '{class_name}' for element '{element_name}'{descriptor}{context_msg}: {error}.
Cause: The system failed to initialise generator '{generator_decl}' for <{element_tag}> '{stmt_path}'. Cannotcreategenerator '{class_name}' for element '{element_name}'{descriptor}{context_msg}: {error}.
Resolution: Review the configuration and retry.
I402: Generator Faker Method Unsupported¶
Message: Faker method '{method}' is not supported.
Cause: The generator configuration specifies an unsupported generator.
Resolution: Use a supported generator or adjust the configuration.
I403: Generator Faker Method Missing¶
Message: Faker method '{method}' does not exist.
Cause: A required generator is missing in the generator configuration.
Resolution: Provide the required generator and retry.
I404: Generator Invalid Gender¶
Message: Invalid gender: {gender}.
Cause: The configuration provides an invalid gender: {gender}.
Resolution: Correct the generator to a valid value or configuration.
I405: Datetime Eval Expression Failed¶
Message: Failed to evaluate {name} expression: {value}.
Cause: The system failed to evaluate {name} expression: {value}.
Resolution: Review the configuration and retry.
I406: Datetime Invalid Range¶
Message: Invalid range '{range}' in spec '{spec}'.
Cause: The configuration provides an invalid range '{range}' in spec '{spec}'.
Resolution: Correct the configuration to a valid value or configuration.
I407: Datetime Value Out Of Bounds¶
Message: Value {value} out of bounds [{low},{high}] in spec '{spec}'.
Cause: A value is outside the allowed bounds for the generator configuration.
Resolution: Provide values within the allowed bounds or range.
I408: Datetime Invalid Value¶
Message: Invalid value '{value}' in spec '{spec}'.
Cause: The configuration provides an invalid value '{value}' in spec '{spec}'.
Resolution: Correct the configuration to a valid value or configuration.
I409: Datetime Months Entries Range¶
Message: months entries must be 1..12.
Cause: The configuration violates the requirement that months entries must be 1..12.
Resolution: Provide values within the allowed bounds or range.
I410: Datetime Months Invalid¶
Message: months must be a string like '1,3-5,Q1' or a list of integers in 1..12.
Cause: The configuration violates the requirement that months must be a string like '1,3-5,Q1' or a list ofintegersin 1..12.
Resolution: Correct the configuration to a valid value or configuration.
I411: Datetime Weekday Range Invalid¶
Message: Invalid weekday range '{token}'.
Cause: The configuration provides an invalid weekday range '{token}'.
Resolution: Correct the configuration to a valid value or configuration.
I412: Datetime Weekday Token Invalid¶
Message: Invalid weekday token '{token}'.
Cause: The configuration provides an invalid weekday token '{token}'.
Resolution: Correct the configuration to a valid value or configuration.
I413: Datetime Weekday Index Bounds¶
Message: Weekday index {value} out of bounds [0,6].
Cause: An error occurred during generator configuration.
Resolution: Review the configuration and retry.
I414: Datetime Weekday List Range¶
Message: weekday list values must be 0..6.
Cause: The configuration violates the requirement that weekday list values must be 0..6.
Resolution: Provide values within the allowed bounds or range.
I415: Datetime Weekday List Invalid¶
Message: weekday list values must be ints or weekday names.
Cause: The configuration violates the requirement that weekday list values must be ints or weekday names.
Resolution: Correct the configuration to a valid value or configuration.
I416: Datetime Weekdays Invalid¶
Message: weekdays must be a string like 'Mon-Fri,weekend' or a list of ints (0..6) or names.
Cause: The configuration violates the requirement that weekdays must be a string like 'Mon-Fri,weekend' or a listofints (0..6) or names.
Resolution: Correct the configuration to a valid value or configuration.
I417: Datetime Dom Value Range¶
Message: dom values must be 1..31 or 'last'.
Cause: The configuration violates the requirement that dom values must be 1..31 or 'last'.
Resolution: Provide values within the allowed bounds or range.
I418: Datetime Dom List Invalid¶
Message: dom list values must be ints or 'last'.
Cause: The configuration violates the requirement that dom list values must be ints or 'last'.
Resolution: Correct the configuration to a valid value or configuration.
I419: Datetime Dom Range Invalid¶
Message: Invalid dom range '{token}'.
Cause: The configuration provides an invalid dom range '{token}'.
Resolution: Correct the configuration to a valid value or configuration.
I420: Datetime Dom Token Invalid¶
Message: Invalid dom token '{token}'.
Cause: The configuration provides an invalid dom token '{token}'.
Resolution: Correct the configuration to a valid value or configuration.
I421: Datetime Dom Invalid¶
Message: dom must be a string like '1-5,15,last' or a list of ints and/or 'last'.
Cause: The configuration violates the requirement that dom must be a string like '1-5,15,last' or a list ofintsand/or 'last'.
Resolution: Correct the configuration to a valid value or configuration.
I422: Datetime Hours Preset Unknown¶
Message: Unknown hours_preset '{preset}' (supported: office, night, flat).
Cause: The configuration references an unknown hours_preset '{preset}' (supported: office, night, flat).
Resolution: Correct the configuration to a valid value or configuration.
I423: Datetime Granularity Range¶
Message: granularity must be in 1..{limit}.
Cause: The configuration violates the requirement that granularity must be in 1..{limit}.
Resolution: Provide values within the allowed bounds or range.
I424: Datetime Weights Length¶
Message: {name} must have length {expected_len}.
Cause: The configuration violates the requirement that {name} must have length {expected_len}.
Resolution: Review the configuration and retry.
I425: Datetime Weights Negative¶
Message: {name} must be non-negative.
Cause: The configuration violates the requirement that {name} must be non-negative.
Resolution: Review the configuration and retry.
I426: Datetime Weights Sum Zero¶
Message: {name} must not sum to zero.
Cause: The configuration violates the requirement that {name} must not sum to zero.
Resolution: Review the configuration and retry.
I427: Datetime Value Format Mismatch¶
Message: value '{value}' does not match input_format '{input_format}'.
Cause: An error occurred during generator configuration.
Resolution: Review the configuration and retry.
I428: Datetime Min Format Mismatch¶
Message: min '{value}' does not match input_format '{input_format}'.
Cause: An error occurred during generator configuration.
Resolution: Review the configuration and retry.
I429: Datetime Max Format Mismatch¶
Message: max '{value}' does not match input_format '{input_format}'.
Cause: An error occurred during generator configuration.
Resolution: Review the configuration and retry.
I430: Datetime Max Before Min¶
Message: max_datetime must be greater than min_datetime.
Cause: The configuration violates the requirement that max_datetime must be greater than min_datetime.
Resolution: Review the configuration and retry.
I431: Datetime Epoch Unit Invalid¶
Message: epoch_unit must be 'seconds' or 'milliseconds'.
Cause: The configuration violates the requirement that epoch_unit must be 'seconds' or 'milliseconds'.
Resolution: Correct the configuration to a valid value or configuration.
I432: Datetime Non Datetime To Epoch¶
Message: Cannot convert non-datetime to epoch: {value}.
Cause: The system could not convert non-datetime to epoch: {value}.
Resolution: Review the configuration and retry.
I433: Datetime Value Not Datetime¶
Message: Generated datetime value is not a datetime: {value}.
Cause: An error occurred during generator configuration.
Resolution: Review the configuration and retry.
I434: Datetime No Eligible Dates¶
Message: No eligible dates within the range after applying month/weekday/dom weights.
Cause: An error occurred during generator configuration.
Resolution: Review the configuration and retry.
I435: Generator Unknown¶
Message: Unknown generator '{class_name}' for element '{element_name}'{descriptor}.
Cause: The configuration references an unknown generator '{class_name}' for element '{element_name}'{descriptor}.
Resolution: Correct the generator to a valid value or configuration.
I436: Generator Create Failed¶
Message: Cannot create generator '{class_name}' for element '{element_name}'{descriptor}: {error}.
Cause: The system could not create generator '{class_name}' for element '{element_name}'{descriptor}: {error}.
Resolution: Review the configuration and retry.
Condition Issues¶
I501: Condition Duplicate If¶
Message: Fail while parsing
Cause: Duplicate values or entries were found in the condition configuration.
Resolution: Remove duplicates or adjust the configuration to avoid conflicts.
I502: Condition If Missing¶
Message: Fail while parsing
Cause: A required condition is missing in the condition configuration.
Resolution: Provide the required condition and retry.
I503: Condition Else After¶
Message: Fail while parsing
Cause: The configuration violates the requirement that Fail while parsing
Resolution: Review the configuration and retry.
I504: Condition Else Duplicate¶
Message: Fail while parsing
Cause: Duplicate values or entries were found in the condition configuration.
Resolution: Remove duplicates or adjust the configuration to avoid conflicts.
I505: Condition Invalid Tag¶
Message: Invalid tag {tag} in
Cause: The configuration provides an invalid tag {tag} in
Resolution: Correct the condition to a valid value or configuration.
I506: Condition Eval Failed¶
Message: Failed to evaluate condition '{condition}' for {element_label}: {error}.
Cause: The system failed to evaluate condition '{condition}' for {element_label}: {error}.
Resolution: Fix the expression or script and retry.
I507: Condition Not Boolean¶
Message: Condition '{condition}' for {element_label} evaluated to a non-boolean value (not a valid boolean value): {value}.
Cause: A condition evaluated to a non-boolean value in the condition configuration.
Resolution: Ensure the expression evaluates to true or false.
Parser Issues¶
I601: Parser Reserved Name¶
Message: Element <{element_tag}> name '{name}' is a reserved name (conflicts with registered generator/converter), please use another name.
Cause: An error occurred during descriptor parsing.
Resolution: Review the configuration and retry.
I602: Parser Invalid Tag¶
Message: Expect element tag name '{expected}', but got '{actual}'.
Cause: The configuration value is invalid for the descriptor parsing.
Resolution: Correct the configuration to a valid value or configuration.
I603: Parser No Subelements Allowed¶
Message: Element <{element_tag}>{parent_clause} does not accept any sub-elements.
Cause: An error occurred during descriptor parsing.
Resolution: Review the configuration and retry.
I604: Parser Invalid Child¶
Message: Element <{element_tag}> got invalid child <{child_tag}>, expects: {expected}.
Cause: The configuration value is invalid for the descriptor parsing.
Resolution: Correct the configuration to a valid value or configuration.
I605: Parser Validation Failed¶
Message: {details}.
Cause: An error occurred during descriptor parsing.
Resolution: Review the configuration and retry.
I606: Parser Unknown Statement¶
Message: Cannot get element tag for statement {statement}.
Cause: The system could not get element tag for statement {statement}.
Resolution: Correct the statement to a valid value or configuration.
I607: Parser Unknown Element¶
Message: Unknown element <{element_tag}> in descriptor.
Cause: The configuration references an unknown element <{element_tag}> in descriptor.
Resolution: Correct the configuration to a valid value or configuration.
I608: Parser Cannot Parse Element¶
Message: Cannot parse element <{element_tag}>.
Cause: The system could not parse element <{element_tag}>.
Resolution: Review the configuration and retry.
I609: Parser Descriptor Not Found¶
Message: Descriptor file '{name}' not found in task workspace.
Cause: The referenced script could not be found for the descriptor parsing.
Resolution: Ensure the referenced script exists and the identifier/path is correct.
Guidance: Check the descriptor file in your project environment configuration or uploaded assets.
I610: Parser Descriptor Invalid XML¶
Message: Descriptor XML '{name}' is not well-formed at {location}.
Cause: The XML value is invalid for the descriptor parsing.
Resolution: Correct the XML content to a valid value or configuration.
Guidance: Check the descriptor file in your project environment configuration or uploaded assets.
I611: Parser Array Subelements Not Allowed¶
Message: Element
Cause: An error occurred during descriptor parsing.
Resolution: Review the configuration and retry.
I612: Parser Array Literal Empty¶
Message: Literal array '{name}' must define at least one
Cause: The configuration violates the requirement that Literal array '{name}' must define at least one
Resolution: Provide a non-empty configuration and retry.
I613: Parser Array Value Invalid¶
Message: Failed while parsing attributes of element <{child_tag}> inside
Cause: The system failed while parsing attributes of element <{child_tag}> inside
Resolution: Correct the configuration to a valid value or configuration.
I614: Parser Execute Text Not Allowed¶
Message: Element
Cause: An error occurred during descriptor parsing.
Resolution: Review the configuration and retry.
I615: Parser IfElse Tag Invalid¶
Message: Invalid element tag for IfElseBaseParser: {element_tag}.
Cause: The configuration provides an invalid element tag for IfElseBaseParser: {element_tag}.
Resolution: Correct the configuration to a valid value or configuration.
Client/Runtime Config Issues¶
I701: Client System Type Unsupported¶
Message: System type '{system_type}' is not supported.
Cause: The client/runtime configuration specifies an unsupported client.
Resolution: Use a supported client or adjust the configuration.
I702: Client Preflight Failed¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: An error occurred during client/runtime configuration.
Resolution: Review the configuration and retry.
I707: Client Preflight Missing Field¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: A required connection field is missing in project environment configuration.
Resolution: Provide the missing field in the client configuration and retry.
I708: Client Preflight Invalid Configuration¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: The connection configuration failed validation before connectivity checks.
Resolution: Fix the configuration values and retry.
I709: Client Preflight Authentication Failed¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: Credentials or identity settings were rejected by the target system.
Resolution: Verify credentials, auth mechanism settings, and retry.
I715: Client Preflight Authorization Failed¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: The credentials are valid but missing permissions for the configured resource.
Resolution: Grant required permissions and retry.
I710: Client Preflight TLS Failed¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: TLS/SSL handshake validation failed for the connection.
Resolution: Check certificate files, trust chain, hostnames, and TLS protocol settings.
I711: Client Preflight Network Failed¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: The runtime could not establish a network path to the configured endpoint.
Resolution: Verify host, DNS, network routing, and firewall rules.
I712: Client Preflight Timeout¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: The target endpoint did not respond within the configured timeout.
Resolution: Increase timeout if appropriate, then verify endpoint health and latency.
I713: Client Preflight Resource Not Found¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: The configured resource does not exist or cannot be resolved.
Resolution: Create/verify the resource (for example topic/table/bucket) and retry.
I714: Client Preflight Unsupported Client¶
Message: Client preflight failed for '{client_id}' ({kind}): {reason}.
Cause: The client type is not part of the supported healthcheck contract.
Resolution: Use a supported client type or update the platform/runtime together.
I703: Client Missing Fields¶
Message: Missing required field(s) {fields} in project environment configuration for
Cause: The object-storage client configuration is missing required fields.
Resolution: Provide all required fields for the object-storage client.
I704: Client Env Properties Parse Failed¶
Message: Failed to parse environment properties file '{path}': {error}.
Cause: The system failed to parse environment properties file '{path}': {error}.
Resolution: Fix the input format and retry.
Guidance: Check your project environment configuration or uploaded assets.
I705: Client Object Storage Missing¶
Message: Object storage client required for
Cause: A required object storage is missing in the client/runtime configuration.
Resolution: Provide the required object storage configuration and retry.
Guidance: Configure an
I706: Runtime Config Invalid JSON¶
Message: Invalid platform_json: {error}.
Cause: platform_json is not valid JSON or not a JSON object string.
Resolution: Provide platform_json as a JSON object string using double quotes.
Guidance: platform_json must be a JSON object string (use double quotes), e.g. '{"memory_limit_mb": 1024}'.
Task Config Issues¶
I801: Task Key Missing Attrs¶
Message: Must specify at least one attribute for element <{element_tag}> '{name}', such as '{attr_script}', '{attr_constant}', '{attr_values}', '{attr_generator}', '{attr_source}' or '{attr_type}'.
Cause: A required configuration is missing in the task configuration.
Resolution: Provide the required configuration and retry.
I802: Task Subtask Invalid¶
Message: Generate sub-task expected for {element_label}, but got {found_type}.
Cause: The configuration value is invalid for the task configuration.
Resolution: Correct the configuration to a valid value or configuration.
I803: Task Statement Name Missing¶
Message: Missing name for statement. Ensure the 'name' attribute is set before execution.
Cause: A required name for statement. Ensure the 'name' attribute is set before execution.
Resolution: Provide the required statement and retry.
I804: Task Array Script Element Type¶
Message: Failed while evaluate script '{script}' of
Cause: The system failed while evaluate script '{script}' of
Resolution: Review the configuration and retry.
I805: Task Array Script Mixed Types¶
Message: Failed while evaluate script '{script}' of
Cause: The system failed while evaluate script '{script}' of
Resolution: Review the configuration and retry.
I806: Task Array Script Not List¶
Message: expect datatype list of evaluated script '{script}' of
Cause: A value expected to be a list was not a list in the task configuration.
Resolution: Provide a list value for the script.
I807: Task Count Iteration Selector Requires DB¶
Message: iterationSelector requires a database 'source' on nested
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I808: Task Count Selector Unsupported Client¶
Message: Using selector without count only supports DatabaseClient (MongoDB, Relational Database).
Cause: The task configuration specifies an unsupported client.
Resolution: Use a supported client or adjust the configuration.
I809: Task Count Missing¶
Message: Cannot determine count for
Cause: The system could not determine count for
Resolution: Provide the required configuration and retry.
I810: Task Count Not Int¶
Message: Count of
Cause: A value expected to be an integer was not an integer in the task configuration.
Resolution: Provide a positive integer value.
I811: Task Unknown Converter¶
Message: Unknown converter '{class_name}' for {element_label}. If this is a custom converter, ensure it is registered or use a fully qualified path.
Cause: The configuration references an unknown converter '{class_name}' for {element_label}. If this is acustomconverter, ensure it is registered or use a fully qualified path.
Resolution: Correct the configuration to a valid value or configuration.
I812: Task Script Error¶
Message: Script error in {element_label}{descriptor}: {error}.
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I813: Task NestedKey Name Missing¶
Message: Missing name for
Cause: A required name for
Resolution: Provide the required configuration and retry.
I814: Task NestedKey Source Missing¶
Message: Cannot load original data for
Cause: The system could not load original data for
Resolution: Provide the required source and retry.
I815: Task NestedKey Script Type¶
Message: Expect evaluated datatype of script '{script}' for
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I816: Task NestedKey Result Type¶
Message: Expect evaluated datatype of script '{script}' for
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I817: Task NestedKey CSV Not List¶
Message: CSV source '{source}' must resolve to a list of records for
Cause: The configuration violates the requirement that CSV source '{source}' must resolve to a list of recordsfor
Resolution: Provide a list value for the CSV content.
I818: Task NestedKey Invalid Source¶
Message: Invalid source '{source}' of
Cause: The configuration provides an invalid source '{source}' of
Resolution: Correct the source to a valid value or configuration.
I819: Task NestedKey Dict Source Unsupported¶
Message: Source of
Cause: The task configuration specifies an unsupported configuration.
Resolution: Use a supported source or adjust the configuration.
I820: Task NestedKey Source Unsupported¶
Message: Cannot load data from source '{source}' of
Cause: The system could not load data from source '{source}' of
Resolution: Use a supported source or adjust the configuration.
I821: Task Key Subtask Invalid¶
Message: Cannot execute subtask {task_name} of
Cause: The system could not execute subtask {task_name} of
Resolution: Correct the configuration to a valid value or configuration.
I822: Task NestedKey Item Not Dict¶
Message: Expect current product of
Cause: A value expected to be a dictionary was not a dictionary in the task configuration.
Resolution: Provide a dictionary value for the configuration.
I823: Task Execute Client Not Found¶
Message: Client '{client_id}' not found for
Cause: The referenced client could not be found for the task configuration.
Resolution: Ensure the referenced client exists and the identifier/path is correct.
I824: Task Execute Script Not Found¶
Message: Script file '{script_name}' not found in task workspace. Check your project environment configuration or uploaded script assets.
Cause: The referenced script could not be found for the task configuration.
Resolution: Ensure the referenced script exists and the identifier/path is correct.
I873: Task Execute SQL Failed¶
Message: Failed to execute SQL script '{script_name}' on client '{client_id}': {error_type}{error_code_hint}{error_category_hint}: {error}.
Cause: SQL execution failed while running the
Resolution: Review client configuration, SQL statement, and database permissions before retrying.
I825: Task Key Script Invalid Type¶
Message:
Cause: The script value is invalid for the task configuration.
Resolution: Correct the script to a valid value or configuration.
I826: Task Generate Iteration Selector Root¶
Message: iterationSelector is not supported on root-level
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I827: Task Variable Unknown Client¶
Message: Unknown database client '{client_id}' for
Cause: The configuration references an unknown database client '{client_id}' for
Resolution: Correct the client to a valid value or configuration.
I828: Task Variable Selector Only DB¶
Message:
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I829: Task Variable Selector Missing¶
Message: No selector value in
Cause: A required configuration is missing in the task configuration.
Resolution: Provide the required configuration and retry.
I830: Task Variable Source Unsupported¶
Message: Cannot get data from source '{source}' of
Cause: The system could not get data from source '{source}' of
Resolution: Use a supported source or adjust the configuration.
I831: Task Variable Source Scripted Unsupported¶
Message: sourceScripted only supports CSV or JSON data sources for
Cause: The task configuration specifies an unsupported script.
Resolution: Use a supported source or adjust the configuration.
I832: Task Expression Eval Failed¶
Message: Failed to evaluate expression '{expr}': {error}.
Cause: The system failed to evaluate expression '{expr}': {error}.
Resolution: Fix the expression or script and retry.
I833: Task Common Subtask Invalid¶
Message: Common sub-task expected for {element_label}, but got {found_type}.
Cause: The configuration value is invalid for the task configuration.
Resolution: Correct the configuration to a valid value or configuration.
I834: Task Unknown Statement¶
Message: Cannot create task for statement {statement_type}.
Cause: The system could not create task for statement {statement_type}.
Resolution: Correct the statement to a valid value or configuration.
I835: Task Converter Registry Missing¶
Message: Missing converter registrations for: {missing}.
Cause: A required converter registrations for: {missing}.
Resolution: Provide the required configuration and retry.
I836: Task Values Invalid¶
Message: Invalid values list for <{element_tag}> '{name}': {values}.
Cause: The configuration provides an invalid values list for <{element_tag}> '{name}': {values}.
Resolution: Correct the configuration to a valid value or configuration.
I837: Task Weighted Source Invalid¶
Message: Data source of {element_label} must be type of: 'wgt.csv'.
Cause: The configuration violates the requirement that Data source of {element_label} must be type of: 'wgt.csv'.
Resolution: Correct the source to a valid value or configuration.
I838: Task Pattern Missing¶
Message: Pattern is missing for <{element_tag}> '{name}'.
Cause: A required pattern is missing in the task configuration.
Resolution: Provide the required pattern and retry.
I839: Task Generation Mode Unknown¶
Message: Cannot find data generation mode for <{element_tag}> '{name}'.
Cause: The system could not find data generation mode for <{element_tag}> '{name}'.
Resolution: Correct the configuration to a valid value or configuration.
I840: Task Converter Failed¶
Message: Failed to generate data for <{element_tag}> '{name}': {error}.
Cause: The system failed to generate data for <{element_tag}> '{name}': {error}.
Resolution: Review the configuration and retry.
I841: Task Type Cast Failed¶
Message: Failed to cast value '{value}' to type '{data_type}' for <{element_tag}> '{name}': {error}.
Cause: The system failed to cast value '{value}' to type '{data_type}' for <{element_tag}> '{name}': {error}.
Resolution: Review the configuration and retry.
I842: Task Datatype Invalid¶
Message: Failed to convert datatype for <{element_tag}> '{name}'. Expect datatype {expected} but get '{data_type}'.
Cause: The system failed to convert datatype for <{element_tag}> '{name}'. Expect datatype {expected} butget'{data_type}'.
Resolution: Correct the configuration to a valid value or configuration.
I843: Task Reference Unsupported Source¶
Message: Reference '{name}' only supports RDBMS data sources.
Cause: The task configuration specifies an unsupported configuration.
Resolution: Use a supported source or adjust the configuration.
I844: Task Reference No Data¶
Message: No data found for reference '{name}'.
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I845: Task Reference Unique Too Few¶
Message: Cannot generate {requested} unique values - only {available} available for reference '{name}'.
Cause: The system could not generate {requested} unique values - only {available} available for reference '{name}'.
Resolution: Review the configuration and retry.
I846: Task Reference Iterator Not Initialized¶
Message: Iterator was not properly initialized for reference '{name}'.
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I874: Task Reference Query Failed¶
Message: Failed to resolve reference '{name}' from source '{source_type}' and sourceKey '{source_key}': {error_type}{error_code_hint}{error_category_hint}: {error}.
Cause: Database query failed while resolving values for a
Resolution: Review sourceType/sourceKey, SQL identifier validity, and database permissions before retrying.
I875: Task Reference Single Weighting Multi Field¶
Message: Reference '{name}' uses single-column weighting source '{source}' with {target_count} mapped fields. Use exactly one field for '.wgt.csv' or switch to '.wgt.ent.csv' for tuple references.
Cause: Single-column weighting files cannot represent multi-column tuple references.
Resolution: Map exactly one target field for '.wgt.csv' or use '.wgt.ent.csv' with
I876: Task Reference Unique Duplicates¶
Message: Reference '{name}' requires business-unique values but source has {duplicates} duplicate rows ({unique_available} unique values from {total_rows} rows). Set platform_json 'reference_unique_duplicate_policy' to warning/skip/ignore if deduplication is acceptable.
Cause: The unique reference source contains duplicate business tuples while strict duplicate policy is enabled.
Resolution: Deduplicate the source values, or change reference_unique_duplicate_policy to warning/skip/ignore when duplicates are expected.
I847: Task Object Storage Unsupported Type¶
Message: Unsupported object storage type '{object_storage_type}'.
Cause: The configuration uses an unsupported object storage type '{object_storage_type}'.
Resolution: Use a supported object storage configuration or adjust the configuration.
I848: Task MP Platform Unsupported¶
Message: Multiprocessing platform '{mp_platform}' of
Cause: The mpPlatform value is not supported by the runtime.
Resolution: Use one of fork, spawn, or forkserver (or omit to use the system default).
I849: Task Generate Product Not Dict Source¶
Message: Generate product must be a dictionary, but got {value_type} for statement '{stmt_name}'. If this comes from Kafka with format='string', switch to format='json' or wrap the value into a dict at the source.
Cause: The configuration violates the requirement that Generate product must be a dictionary, but got {value_type}forstatement '{stmt_name}'. If this comes from Kafka with format='string', switch to format='json' or wrapthevalue into a dict at the source.
Resolution: Provide a dictionary value for the source.
I850: Task Generate Product Not Dict Template¶
Message: Template resolution result must be a dictionary, but got {value_type} for statement '{stmt_name}'.
Cause: The configuration violates the requirement that Template resolution result must be a dictionary, butgot{value_type} for statement '{stmt_name}'.
Resolution: Provide a dictionary value for the template file.
I851: Task Generate Product Not Dict Script¶
Message: Source script evaluated result must be a dictionary, but got {value_type} for statement '{stmt_name}'.
Cause: The configuration violates the requirement that Source script evaluated result must be a dictionary, butgot{value_type} for statement '{stmt_name}'.
Resolution: Provide a dictionary value for the script.
I852: Task Generate Product Not Dict Converter¶
Message: Generate product must be a dictionary after converters, but got {value_type} for statement '{stmt_name}'.
Cause: The configuration violates the requirement that Generate product must be a dictionary after converters, butgot{value_type} for statement '{stmt_name}'.
Resolution: Provide a dictionary value for the configuration.
I853: Task Iteration Selector Not String¶
Message: iteration_selector must be a string.
Cause: The configuration violates the requirement that iteration_selector must be a string.
Resolution: Set the iteration selector to a string value.
I854: Task DB Table Unresolved¶
Message: Could not resolve source entity/table name.
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I855: Task Entity Not Found¶
Message: Entity name '{entity_name}' not found in the XML model.
Cause: The referenced entity could not be found for the task configuration.
Resolution: Ensure the referenced entity exists and the identifier/path is correct.
I856: Task Variable Eval Failed¶
Message: Failed to evaluate
Cause: The system failed to evaluate
Resolution: Fix the expression or script and retry.
I857: Task Descriptor Dir Missing¶
Message: Descriptor directory is required for
Cause: A required script is missing in the task configuration.
Resolution: Provide the required script and retry.
I858: Task Scripting Context Missing¶
Message: Scripting API is only available during expression evaluation.
Cause: The scripting API was used outside of expression evaluation.
Resolution: Call scripting helpers only inside expression evaluation contexts.
I859: Task Scripting Product Name Invalid¶
Message: product_name must be a non-empty string.
Cause: The configuration violates the requirement that product_name must be a non-empty string.
Resolution: Correct the script to a valid value or configuration.
I860: Task Scripting Pagination Invalid¶
Message: skip must be >= 0 and limit must be > 0.
Cause: Pagination parameters are invalid (skip < 0 or limit <= 0).
Resolution: Provide skip >= 0 and limit > 0.
I861: Task Encoding Invalid¶
Message: Invalid encoding name '{encoding}'.
Cause: The encoding name is not recognized by Python.
Resolution: Use a valid encoding name such as utf-8 or latin-1.
Guidance: Use a valid Python encoding name (e.g., utf-8, latin-1, windows-1250).
I862: Task AMA Unresolved Placeholders¶
Message: AMA output contains unresolved placeholders in {scope}: {tokens}.
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
Guidance: Resolve AMA placeholders or set ama_unresolved_variable_mode to warning/ignore in platform_json.
I863: Task ML Empty Dataset¶
Message: Empty dataset for ml-train '{name}' (source='{source}').
Cause: A required configuration is empty in the task configuration.
Resolution: Provide a non-empty configuration and retry.
Guidance: Provide data for the ml-train source or set ml_train_on_empty to skip/warn in platform_json.
I864: Task Weighted Source Parse Failed¶
Message: Invalid weighted source file '{name}' for {element_label}: {error}.
Cause: The configuration provides an invalid weighted source file '{name}' for {element_label}: {error}.
Resolution: Fix the input format and retry.
I865: Task Weighted Entity Weight Column Missing¶
Message: Weighted entity source '{name}' is missing weight column '{weight_column}' for {element_label}.
Cause: A required weight values is missing in the task configuration.
Resolution: Provide the required weight values and retry.
I866: Task Entity Invalid Format¶
Message: Invalid entity '{entity}' for {element_label}: expected 'schema.table' or 'table'.
Cause: The configuration provides an invalid entity '{entity}' for {element_label}: expected 'schema.table'or'table'.
Resolution: Correct the entity to a valid value or configuration.
I867: Task Weighted Entity Empty¶
Message: Weighted entity source '{name}' is empty for {element_label}.
Cause: A required weight values is empty in the task configuration.
Resolution: Provide a non-empty weight values and retry.
I868: Task Weighted Entity No Weight Values¶
Message: Weighted entity source '{name}' has no usable weight values for {element_label} (column '{weight_column}').
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
Guidance: Provide non-empty numeric weights in column '{weight_column}', or remove the weighted source.
I869: Task Variable No Data¶
Message: No data available for {element_label}.
Cause: An error occurred during task configuration.
Resolution: Review the configuration and retry.
I870: Task Dynamic Pattern Not Allowed¶
Message: Attribute '{attribute}' does not support {{{{expr}}}} (DYNAMIC) pattern; use {{expr}} (CACHED) or a literal value.
Cause: A DYNAMIC pattern ({{expr}}) was used where it is not supported.
Resolution: Use {expr} (CACHED) or a literal value for the attribute.
I871: Task Nested Source Dynamic Requires Count¶
Message: Nested
Cause: A nested generate uses a dynamic source expression, which requires a stable count.
Resolution: Provide an explicit count or ensure the source is stable at setup time.
I872: Task Nested Source URI Dynamic Unsupported¶
Message: Nested
Cause: sourceUri was provided as a dynamic expression for a nested generate.
Resolution: Use a literal sourceUri value resolved at the root context.
Operation Issues¶
I901: Operation Execution Failed¶
Message: Operation '{target}' failed: {error}.
Cause: An error occurred during operation execution.
Resolution: Review the configuration and retry.
I902: Operation Template Variables Missing¶
Message: Template variable(s) {missing} not found. Available variables: {available}. Template path: {template_path}.
Cause: A required template is missing in the operation execution.
Resolution: Provide the required template file and retry.
I903: Operation Mongo Duplicate Key¶
Message: Mongo {operation} failed on collection '{collection}': duplicate key error ({reason}).
Cause: A duplicate key was detected while performing the operation execution.
Resolution: Ensure values are unique or adjust constraints, then retry.
I904: Operation Mongo Write Not Allowed¶
Message: Mongo {operation} not allowed for collection '{collection}': {reason}.
Cause: An error occurred during operation execution.
Resolution: Review the configuration and retry.
I905: Operation Mongo Validation Failed¶
Message: Mongo {operation} validation failed for collection '{collection}': {reason}.
Cause: An error occurred during operation execution.
Resolution: Review the configuration and retry.
I906: Operation Mongo Namespace Not Found¶
Message: Mongo {operation} namespace '{namespace}' not found.
Cause: The referenced Mongo could not be found for the operation execution.
Resolution: Ensure the referenced Mongo namespace exists and the identifier/path is correct.
I907: Operation Read-Only Write Blocked¶
Message: Operation '{target}' blocked by read-only datasource mode: {reason}.
Cause: A write operation was attempted against a datasource configured for read-only access.
Resolution: Disable read-only mode or use a writable datasource for update/delete/insert operations.
Viewing Errors¶
In the UI¶
- Go to Tasks - Select task - Logs
- Error codes appear with full context
- Expand error details for guidance
Log Format¶
1 2 3 | |
Troubleshooting Tips¶
- Check the Issue Code: The code (e.g., I322) identifies the exact error type
- Review the Location: The file and line number help locate the problem
- Follow the Guidance: Each error includes actionable resolution steps
- Enable DEBUG Logging: Set log level to DEBUG for more detailed context
- Check Runtime Config: Many behaviors can be adjusted via
platform_json - Validate XML/JSON: Use validators to catch syntax errors early