| Code | Title | Message |
|---|---|---|
| PRQL-RZBD | All Records Errored | None of the source provided rows were processed successfully. Please review the error records to determine the cause of the failure. |
| PRQL-BNOD | Athena Authorization Failed | The Athena engine encountered an error. Please check that the provided connection principal has been granted sufficient permissions. Specifically, please check the s3:ListBucket permission. |
| PRQL-DDAK | Athena Authorization Failed | The Athena engine encountered an error. Please check that the provided connection principal has been granted sufficient permissions. Specifically, please check for Create Database on Catalog permission. |
| PRQL-FDEW | Athena Authorization Failed | The Athena engine encountered an error. Please check that the provided connection principal has been granted sufficient permissions. |
| PRQL-RWCV | Athena Authorization Failed | The Athena engine encountered an error. Please check that the provided connection principal has been granted sufficient permissions. Specifically, please verify the glue:DeleteTable permission exists on the generated tables. |
| PRQL-VDMC | Athena Authorization Failed | The Athena engine encountered an error. Please check that the provided connection principal has been granted sufficient permissions. Specifically, please check the s3:GetObject permission. |
| PRQL-XZWE | Athena Cannot Find Requested Iceberg Entity | Athena has detected a corrupted Iceberg table. Full refresh to resolve. |
| PRQL-ONNN | Athena Connection Refused | The Athena connection was refused. Please check that the provided Athena access details are correct. |
| PRQL-QDPO | Athena DDL Execution Timeout Error | The Athena query exceeded the engine’s DDL query timeout. If this error persists, please contact support. |
| PRQL-XJWM | Athena Data Catalog Timeout Error | The Athena data catalog connection timed out. If this error persists, please contact support. |
| PRQL-AFOK | Athena Data Processing Failed | The Athena engine encountered a ConcurrentModificationException while executing a query. |
| PRQL-AWRI | Athena Data Processing Failed | The Athena engine encountered a problem while attempting to process Iceberg formatted data. |
| PRQL-BKDL | Athena Data Processing Failed | The Athena query engine encountered an error. A value found in the underlying source data is incompatible with the type double defined in the Athena table schema. Please review the source’s data type and either cast the type or update your Prequel data model accordingly. |
| PRQL-BSAX | Athena Data Processing Failed | The Athena engine encountered an error related to the timestamp precision on some timestamp data. |
| PRQL-CFGX | Athena Data Processing Failed | The Athena engine encountered a problem while attempting to process data in hive mode. |
| PRQL-FLUU | Athena Data Processing Failed | The Athena engine encountered a problem while attempting to process Iceberg formatted data. |
| PRQL-GVZM | Athena Data Processing Failed | The Athena engine encountered a problem while attempting to process Hive formatted data. |
| PRQL-CERZ | Athena Federated Read Error | Athena encountered an exception reading from a federated data source. Please refer to Athena logs for more information. |
| PRQL-YOTO | Athena Iceberg Partitions Exceeded | The Athena engine exceeded the maximum number of open partition writers. Please contact support for more information. |
| PRQL-IVCA | Athena Invalid Cast Argument | One or more column was unable to be cast to the data type from the corresponding model. Please ensure that are source column data types are compatible with model data types and try again. |
| PRQL-MSQX | Athena Invalid Date Value | Athena could not cast a data value to type DATE. Check the source data to ensure dates are in the format YYYY-MM-DD. |
| PRQL-TKVM | Athena Invalid Timestamp Value | Athena could not cast a data value to type TIMESTAMP. Check the source data to ensure the data can be properly cast into timestamp or determine if it requires additional handling. |
| PRQL-LFDR | Athena Lake Formation Permissions Error | The connection encountered one or more Lake Formation permissions errors. Please ensure any Lake Formation policy contains sufficient permissions and try again. Contact support if the issue persists. |
| PRQL-LRCT | Athena Lambda Timeout | Athena encountered an exception reading from a federated data source. A lambda function timed out. |
| PRQL-CKSC | Athena Missing Column | The Athena query engine encountered an error. A column name was not recognized. |
| PRQL-KZWP | Athena NOT NULL Value Constraint Failed | A NULL value was found in a column with non-null requirements. Please check the model’s columns designated as is_primary_key and is_last_modified for any null values in your source. |
| PRQL-XIEA | Athena Query Timeout | The Athena query execution timed out. If this error persists, please contact support. |
| PRQL-NXQP | Athena Read Error | The Athena engine encountered a problem while attempting to read the source view. Please confirm the view is not stale. |
| PRQL-FJOD | Athena Runtime Encountered Error | The provided AWS role does not have access to the Athena Workgroup. If the Athena Workgroup does not exist, the provided role does not have permission to create the workgroup. |
| PRQL-TJCZ | Athena Runtime Encountered Error | The Athena connection encountered a memory limit. |
| PRQL-VKEV | Athena Runtime Encountered Error | The Athena catalog encountered an internal server error. If this error persists, please contact support. |
| PRQL-WJTE | Athena Runtime Encountered Error | The Athena connection encountered an error. |
| PRQL-WRFA | Athena Runtime Encountered Error | The Athena engine encountered an error. |
| PRQL-YTNS | Athena Runtime Encountered Error | The Athena connection encountered a resource limit. |
| PRQL-ASFB | Athena S3 Access Denied | The provided credentials were denied access to the S3 source bucket. Please check that the IAM role has s3:GetObject, s3:ListBucket, and s3:GetBucketLocation granted on the source bucket and its contents. |
| PRQL-CMYT | Athena Schema Does Not Exist Error | The Athena schema could not be found. Please check that the schema exists and that the provided connection principal has been granted sufficient permissions. |
| PRQL-HDXP | Athena Server Encountered Generic Error | The Athena connection encountered a generic internal error. If this error persists, please contact support. |
| PRQL-KLBO | Athena Server Encountered Internal Error | The Athena connection encountered an internal error. If this error persists, please contact support. |
| PRQL-GAIX | Athena Table Missing | The Athena query engine encountered an error. The table name was not recognized. |
| PRQL-MZXD | Athena Table Not Found | The Athena engine could not find the table to read from or merge into. Please verify that the table exists and the connection principal has been granted sufficient permissions. |
| PRQL-XYYX | Athena Type Mismatch | Athena attempted to use an operator on values of differing types. Please check the source query for type mismatches. |
| PRQL-WHHO | Athena Unable To Assume Role | Athena was unable to assume the specified role. Please verify the role ARN. |
| PRQL-VMEX | Athena Unsupported Timestamp Precision Error | Athena source data of type “timestamp(6)” is unsupported. Please expose the column as type “timestamp(3)”. |
| PRQL-QTSM | Athena Unsupported Timestamp Type Error | Athena source data of type “timestamp with time zone” is unsupported. Please expose the column as type “timestamp”. |
| PRQL-MDSR | Azure Authorization Expired | The Azure server returned an error indicating the access token is expired. Please check that the provided shared access key is valid and has been granted sufficient permissions. |
| PRQL-ZDJR | Azure Blob Storage Authentication Failed | Azure Blob Storage encountered an error. Please check that the provided connection principal has been granted sufficient permissions. |
| PRQL-UXWZ | Azure Blob Storage Authorization Error | Azure Blob Storage returned an authorization error. Please verify your SAS token includes the required permissions on the target Container and has not expired. If network access is restricted on the storage account, ensure the service egress IP is in the allowed range. |
| PRQL-GJWR | Azure Blob Storage Host Not Found | The Azure Blob Storage host could not be found. Please check that the provided host name is valid. |
| PRQL-VMDR | Azure Blob Storage Invalid SAS Token | Azure Blob Storage could not authenticate the request. Please verify you have generated an SAS token (access keys are not supported), your SAS token has not expired, and was copied correctly, then try again. |
| PRQL-YZQZ | Azure Databricks Storage Request Not Authorized | The Azure Databricks storage request failed authorization. The storage account’s ‘Firewalls and virtual networks’ settings may be blocking access to storage services. Please verify your Azure storage credentials or firewall exception settings. |
| PRQL-JRKJ | BigQuery Authentication Failed | The BigQuery connection was refused. Please check that that the provided connection principal has been granted sufficient access. |
| PRQL-PVER | BigQuery Authentication Failed | The BigQuery connection was refused. Please check that that the provided connection principal has been granted sufficient access. |
| PRQL-SPJT | BigQuery Authentication Failed | The BigQuery server rejected the connection. Please check that the provided authentication principal and credentials are valid. |
| PRQL-UJSZ | BigQuery Column Already Exists | The BigQuery engine encountered an error. The target column name already exists. |
| PRQL-NIKQ | BigQuery Column Does Not Exist | The BigQuery engine encountered an error. The target column name is unrecognized. |
| PRQL-UCFB | BigQuery Connection Refused | The provided Google Cloud project has not enabled BigQuery. |
| PRQL-FGWV | BigQuery Data Processing Failed | The BigQuery data transfer encountered an error during data transfer. The BigQuery target table may have duplicate data preventing successful updates. |
| PRQL-JEBJ | BigQuery Dataset Not Found | The specified BigQuery dataset was not found in the configured project and region. Please verify the dataset name and region provided and try again. |
| PRQL-TIRE | BigQuery Disallowed Bucket Retention Policy | Bucket and object retention policies are disallowed on BigQuery staging policies. Please remove the policy or use a bucket without a retention policy. |
| PRQL-ZVKN | BigQuery GCS Authentication Error | The service account does not have sufficient access to the GCS bucket. Please review the list bucket permissions provided via IAM roles. |
| PRQL-BRLC | BigQuery Invalid Bucket Region | The provided GCS bucket region is invalid. Please ensure the specified region field is exactly one of the following valid GCS bucket location names: https://docs.cloud.google.com/storage/docs/locations. |
| PRQL-WMRB | BigQuery Rate Limit Exceeded | One or more queries has exceeded a BigQuery rate limit. Please contact support for more information. |
| PRQL-PWQD | BigQuery Runtime Encountered Error | The BigQuery connection encountered an error. |
| PRQL-GKCB | BigQuery Server Encountered Error | The BigQuery API was temporarily unavailable (HTTP 503). This is typically a temporary issue and resolves automatically. If the error persists, check the Google Cloud status page to confirm service health. |
| PRQL-FGCV | BigQuery Service Account Disabled | The BigQuery connection was refused because the configured service account has been disabled. Please re-enable the service account in GCP IAM & Admin, or create a new service account and update configuration details. Then, try again. |
| PRQL-AEVP | BigQuery Table Not Accessible | The user does not have permission to query the specified BigQuery Table, or it was not found in the configured region and dataset. Please review the user’s permissions on the table and dataset, and the region and dataset names provided. |
| PRQL-MJOZ | ClickHouse Connection Refused | The provided ClickHouse host was not found. Please check that the provided host name is valid and accessible. |
| PRQL-OEVX | ClickHouse Connection Refused | The provided ClickHouse host was not found. Please check that the provided host name is valid and accessible. |
| PRQL-UFTZ | ClickHouse Connection Refused | The provided ClickHouse host refused the connection. Please check that the provided host name is valid and accessible. |
| PRQL-CTBL | ClickHouse Insufficient Create Table Permissions | The ClickHouse user does not have permission to create tables. Please ensure both CREATE TABLE and CREATE TEMPORARY TABLE are granted to the ClickHouse user on the target database and try again. |
| PRQL-BKFC | ClickHouse Insufficient Read Permissions | The ClickHouse user does not have permission to read from the data tables and/or schema. Please ensure to grant SELECT on the database, tables for sync, and information_schema and try again. |
| PRQL-DSAJ | ClickHouse Insufficient S3 Staging Bucket List Permissions | The ClickHouse instance was denied access to the S3 staging bucket while checking whether a staged file exists before writing. Please check that you have provided the s3:ListBucket permission on the staging bucket itself (without any key prefix added), and try again. |
| PRQL-WKRF | ClickHouse Insufficient S3 Write Permissions | The ClickHouse user cannot write to the S3 staging bucket. Please grant the S3 write permission to the ClickHouse user with GRANT S3 ON . to <username>@’%’ (or GRANT WRITE ON S3 if your instance uses granular enable_read_write_grants) and try again. |
| PRQL-BNPN | ClickHouse Insufficient View Permissions | The ClickHouse user does not have permissions to create and/or drop views generated during transfers. Please grant CREATE VIEW and/or DROP VIEW to the ClickHouse user on the target database and try again. |
| PRQL-SKFD | ClickHouse Invalid Connection Parameter | The provided ClickHouse credentials contain an invalid character. Please check that the username and password do not contain special characters such as @, /, or ?. |
| PRQL-XCNS | ClickHouse Rate Limited | The Clickhouse server encountered a resource quota limit for simultaneous queries. |
| PRQL-VCXL | Clickhouse Invalid Truncate Permissions | The Clickhouse engine encountered an error. Please check that the provided user has been granted sufficient permissions to truncate tables. |
| PRQL-NJEW | Data Serialization Error | One or more rows from the source cannot be parsed. This may be caused by a row exceeding byte size limits, invalid/non-supported encoded characters, unquoted values, or column errors. Please contact support for more information. |
| PRQL-BKRG | Databricks Authorization Failed | The provided service principal is not authorized to use the SQL endpoint. Please confirm that the service principal is listed as an authorized user with Can Use within the SQL Warehouse permissions, and try again. |
| PRQL-CJFX | Databricks Catalog Permission Denied | The Databricks connection was refused due to insufficient catalog permissions. Please check that the provided connection principal has been granted USE CATALOG permission on the specified catalog. |
| PRQL-CSVN | Databricks Concurrent Append Error Encountered | The Databricks server encountered a concurrent update to the target table. Please ensure no other INSERT, DELETE, UPDATE, or MERGE queries are running. |
| PRQL-LADF | Databricks Connection Closed Prematurely | The Databricks connection closed before the statement finished executing. Check the Databricks status page and confirm the target SQL warehouse is running and reachable. |
| PRQL-MKEW | Databricks Connection Temporarily Rejected | The Databricks connection was temporarily rejected because the service is under maintenance. |
| PRQL-VIDE | Databricks Duplicate Row Error | The Databricks data transfer encountered an error during data transfer. The Databricks target table or staged data may have duplicate data preventing successful updates. Please confirm there is no duplicate data in the data source, and contact support if the issue persists. |
| PRQL-OLKS | Databricks Encountered Internal Error | Databricks returned an internal server error (HTTP 500). This is usually a temporary issue on the Databricks platform. If the error persists, check the Databricks status page to confirm service health. |
| PRQL-IPBL | Databricks IP Access List Restriction | The Databricks connection was blocked by an IP access list restriction at the Databricks account or workspace-level. Please ensure any configured IP access lists include the data sync service’s static egress IP(s). |
| PRQL-XTZH | Databricks Insufficient Credits Available | The connection to Databricks could not be established as the Databricks account has insufficient credits. Please add a payment method or purchase additional credits. |
| PRQL-JZQZ | Databricks Invalid Access Token | The Databricks connection was refused due to an invalid access token. Please check that the access token (dapi...) is valid and the provided connection principal has been granted sufficient access. |
| PRQL-OAUT | Databricks Invalid OAuth Credentials | The Databricks connection was refused because the OAuth client credentials were rejected. Please verify that the Client ID and Client Secret are correct and the credential has not expired, then please try again. |
| PRQL-QOCK | Databricks Java IO Error Encountered | Databricks encountered an I/O error while executing the operation. Review the Databricks query/driver logs and the Databricks status page to identify the failure. |
| PRQL-VIZF | Databricks Network Error Encountered | The connection to Databricks was dropped unexpectedly. Check the Databricks status page and confirm the target SQL warehouse is running and reachable. |
| PRQL-FUOM | Databricks Operation Not Supported | The Databricks server encountered an error. Please check that the provided connection principal has been granted sufficient access. |
| PRQL-QWEO | Databricks Query Timeout | The Databricks query connection timed out. If this error persists, please contact support. |
| PRQL-CKSR | Databricks Rate Limit | The Databricks server encountered a rate limit. If this error persists, please contact support. |
| PRQL-CYNR | Databricks Runtime Error Encountered | Databricks could not schedule the query and returned a temporary error (HTTP 503) asking to retry. This usually resolves on the next run. If the error persists, check the Databricks status page and the target SQL warehouse’s health and load. |
| PRQL-GMXD | Databricks Runtime Error Encountered | The Databricks server does not have Predictive Optimization enabled. |
| PRQL-INXB | Databricks Serverless Warehouse Disabled | The Databricks warehouse cannot start because serverless warehouse compute is disabled in the global warehouse configuration. Please contact your Databricks administrator to enable compute for serverless warehouses, and try again. |
| PRQL-YBLK | Databricks Service Unavailable | Databricks returned a 503 Service Unavailable response. This may be caused by Databricks SQL warehouse autoscaling, startup delays, warehouse load, or a transient Databricks service issue. Please check that both the target SQL warehouse and Databricks servers are healthy, and try again. |
| PRQL-CMRT | Databricks Storage Authorization Failure | Databricks failed to execute one or more staging upload queries with PUT. If using Unity Catalog, please ensure the Write Volume permission has been provided to the Service Principal or user. If using Hive Metastore, please ensure write and delete permissions have been provided on the object storage location. |
| PRQL-FSKS | Databricks Unexpected Operation State Error | The Databricks server encountered an unexpected operation state error. |
| PRQL-PSZD | Databricks Warehouse Stopped | The Databricks transfer failed because the target warehouse was stopped. |
| PRQL-DBSH | Databricks no such host | Connection to Databricks could not be established on failure to reach host. Please ensure that the provided hostname is accurate and the Databricks cluster is publicly accessible. |
| PRQL-DLDQ | Delta Lake Duplicate Row Error | One or more duplicate rows have been detected in the source data. Please ensure that each row’s primary key is unique/de-duplicated and retry. |
| PRQL-UFQE | Delta Lake Object Not Found | The Delta Lake engine could not find an object. Make sure the object exists and the writer has read access to the bucket. |
| PRQL-GFIS | Delta Lake Runtime Error | The Delta Lake engine encountered an error. |
| PRQL-CISE | Delta Lake Table Creation Failed | The delta lake table could not be created due to existing conflicting metadata in the bucket prefix. |
| PRQL-BERH | Destination Table Not Found | The destination table was not found in the target schema. Please ensure the destination table exists at the configured schema and with the target table name. Contact support for more information. |
| PRQL-DOOM | DuckDB Out of Memory | The transfer worker ran out of memory. If this error persists, please contact support. |
| PRQL-SLVK | GCS Missing Bucket Storage GET Permission | The GCS server encountered an error due to insufficient permissions. Please check that the provided connection principal has been granted ‘storage.buckets.get’. |
| PRQL-ZQZQ | GCS Missing Create Permission | The GCS server encountered an error due to insufficient permissions. Please check that the provided connection principal has been granted ‘storage.objects.create’. |
| PRQL-AYSD | GCS Missing Delete Permission | The GCS server encountered an error due to insufficient permissions. Please check that the provided connection principal has been granted ‘storage.objects.delete’. |
| PRQL-KJCH | GCS Server Encountered Error | Google Cloud Storage returned an internal server error (HTTP 500). This is typically a temporary issue and resolves automatically. If the error persists, check the Google Cloud status page to confirm service health. |
| PRQL-NXPY | GCS Server Encountered Error | Google Cloud Storage was temporarily unavailable (HTTP 503). This is typically a temporary issue and resolves automatically. If the error persists, check the Google Cloud status page to confirm service health. |
| PRQL-IXOL | Google Sheets Authentication Failed | The Google Sheets server refused the connection. |
| PRQL-NEFP | Google Sheets Authentication Failed | The Google Sheets server refused the connection. |
| PRQL-VDJX | Google Sheets Data Processing Failed | The Google Sheets server encountered a temporary error and the connection was dropped. If this error persists, please contact support. |
| PRQL-LNWT | Google Sheets Host Not Found | The Google Sheets host could not be found. Please check that the provided host name is valid. |
| PRQL-CELL | Google Sheets Overloading Error | A Google Sheet may not have more than 10,000,000 cells. If the error persists, please choose another destination type. |
| PRQL-BOSR | Google Sheets Server Encountered Error | Google Sheets returned a bad gateway error (HTTP 502). This is typically a temporary issue and resolves automatically. |
| PRQL-CMET | Google Sheets Server Encountered Error | Google Sheets was temporarily unavailable (HTTP 503). This is typically a temporary issue and resolves automatically. If the error persists, check the Google Workspace status page to confirm service health. |
| PRQL-GPDB | Google Sheets Server Encountered Error | Google Sheets returned an internal server error (HTTP 500). This is typically a temporary issue and resolves automatically. |
| PRQL-YICW | Google Sheets Server Encountered Error | The Google Sheets server encountered a resource quota limit. |
| PRQL-ICED | Iceberg Authorization Failed | A query failed due to insufficient database permissions. Please check that the provided connection details are correct and the principal has been granted sufficient permissions to the target catalog and object store. |
| PRQL-QPMF | Import Destination Bad Gateway | The destination endpoint returned HTTP 502. The record will be retried automatically. |
| PRQL-JPDQ | Import Destination Bad Request | The destination endpoint rejected the record with HTTP 400. Check the record data and destination configuration. |
| PRQL-IMEK | Import Destination Client Error | The destination endpoint rejected the record with a client error (4xx). Check the destination configuration and record data. |
| PRQL-KTQN | Import Destination Connection Refused | The destination endpoint refused the connection. Verify the URI and that the endpoint is accepting connections. |
| PRQL-YCHU | Import Destination Context Cancelled | The delivery operation was cancelled before all records could be delivered. Undelivered records will be retried on the next load cycle. |
| PRQL-FVRM | Import Destination DNS Error | DNS resolution failed for the destination endpoint. Verify the hostname in the destination URI. |
| PRQL-CNJK | Import Destination Forbidden | The destination endpoint returned HTTP 403. Verify webhook signature configuration and credentials. |
| PRQL-PRHQ | Import Destination Gateway Timeout | The destination endpoint returned HTTP 504. The record will be retried automatically. |
| PRQL-QFJW | Import Destination Headers Too Large | The destination endpoint returned HTTP 431. Reduce the number or size of custom headers in the request template. |
| PRQL-PHOK | Import Destination Internal Server Error | The destination endpoint returned HTTP 500. The record will be retried automatically. If the error persists, check the destination endpoint health. |
| PRQL-HWLT | Import Destination Network Error | A network error occurred while delivering a record to the destination endpoint. Check the destination URI and network connectivity. |
| PRQL-VFTB | Import Destination Not Found | The destination endpoint returned HTTP 404. Verify the URI in the request template. |
| PRQL-QAHC | Import Destination Payload Too Large | The destination endpoint returned HTTP 413. Reduce the record size or adjust the destination’s payload limits. |
| PRQL-WQKF | Import Destination Rate Limited | The destination endpoint rate-limited the request (HTTP 429). The record will be retried automatically. |
| PRQL-EZDQ | Import Destination Request Error | Failed to construct the HTTP request for the destination endpoint. Check the destination configuration. |
| PRQL-TNXG | Import Destination Server Error | The destination endpoint returned a server error (5xx). The record will be retried automatically. If the error persists, check the destination endpoint health. |
| PRQL-HNNX | Import Destination Service Unavailable | The destination endpoint returned HTTP 503. The record will be retried automatically. |
| PRQL-XNWB | Import Destination TLS Error | TLS handshake failed with the destination endpoint. Verify the endpoint supports HTTPS and has a valid certificate. |
| PRQL-BXPM | Import Destination Template Error | The destination request template is misconfigured. Verify that the body template syntax is valid and all referenced fields exist in the destination’s record schema. |
| PRQL-GMVJ | Import Destination Timeout | The request to the destination endpoint timed out. The record will be retried automatically. If the error persists, check the destination endpoint latency. |
| PRQL-NROT | Import Destination Unprocessable Entity | The destination endpoint returned HTTP 422. The record data is syntactically valid but semantically incorrect. |
| PRQL-NBSI | Import Job Cancelled | The import job was cancelled. Please retry — or contact support if you did not initiate this and the issue persists. |
| PRQL-KVZK | Import Provider Not Configured | No enabled import provider is available for this request. Create one with POST /import/providers or enable an existing provider before creating datasets, extracts, or loads. |
| PRQL-WCKH | Import Transform Invalid Configuration | A stream mapping configuration was invalid or missing required fields like ‘name’ or ‘target_field’. |
| PRQL-BKDX | Import Transform Invalid Payload | The transformation pipeline encountered an invalid JSON payload. Please ensure that stream records are valid JSON. |
| PRQL-TRUN | Import Transform Runtime Error | The transformation pipeline encountered one or more runtime errors. Please review the mapping expressions and input data. |
| PRQL-NOTD | Import Transform Unsupported Mapping | An unsupported mapping type was used in stream configuration. Supported types are ‘field’ and ‘expr’. |
| PRQL-VKHA | Import Transform Validation Failed | A stream record failed validation against the destination record schema after transformations were applied. |
| PRQL-OHHG | Import Worker Unavailable | No import worker is currently available to process this request. The system will auto-recover shortly. Please retry. |
| PRQL-INUM | Invalid Input: Numerical Type | One or more values could not be cast to a numerical type. Please ensure all source data columns of numerical types contain valid numerical values. Contact support if this error persists. |
| PRQL-FGAD | Invalid Timestamp Value in Source Column | An invalid timestamp value was detected in a source column. Please review your timestamp columns for invalid values. |
| PRQL-KFSS | Job Circuit Breaker Tripped | The job encountered too many errors and triggered the circuit breaker. Execution was halted early to protect system resources. Please review the failed records to determine the root cause. |
| PRQL-CLNU | MongoDB Authentication Failed | The MongoDB connection was refused due to insufficient permissions. Please check that the provided connection principal has been granted sufficient access. |
| PRQL-KWZN | MongoDB Authentication Failed | The MongoDB connection was successful, but the user is not authorized. Please check that the provided user has access. |
| PRQL-MJUM | MongoDB Authentication Failed | The MongoDB connection was refused. Please check that the provided MongoDB access details are correct. |
| PRQL-FBNN | MongoDB Collection Not Found | The provided MongoDB collection was not found. |
| PRQL-BGZS | MongoDB Connection Failed | The MongoDB connection was unsuccessful due to an unexpected configuration error. If the error persists, please contact support. |
| PRQL-KDCW | MongoDB Connection Refused | The MongoDB connection was refused. Please check that the provided MongoDB server is valid and accessible. |
| PRQL-MDXE | MongoDB Runtime Encountered Error | The MongoDB connection exceeded a space quota. |
| PRQL-VIPD | MongoDB Runtime Encountered Error | The MongoDB connection encountered a memory limit. |
| PRQL-OPXQ | MotherDuck Duplicate Primary Key Error | The transfer could not be completed because the source data contains more than one row with the same primary key value for this model. Please check the source table duplicate primary key values, deduplicate if needed, and try again. |
| PRQL-QYYA | MySQL Authentication Failed | The MySQL connection was refused due to insufficient permissions. Please check that the provided connection details have been granted sufficient access. |
| PRQL-AZBE | MySQL Connection Failed | The provided MySQL host was not found. Please check the the provided host name is valid and accessible. |
| PRQL-DQTJ | MySQL Connection Failed | The provided MySQL port is invalid. |
| PRQL-EWAS | MySQL Insufficient Create Table Permissions | The writer user does not have sufficient permissions to create tables in the destination schema. Please grant CREATE on the destination schema to the configured user and try again. |
| PRQL-VMTE | MySQL Insufficient User Permissions | One or more permissions on the database are missing from the writer user. Please ensure all required permissions are provided and retry. |
| PRQL-WCLX | MySQL Invalid Syntax Error | A SQL syntax error was encountered. Please contact support for more information. |
| PRQL-AREW | Object Storage Connection Failed | The specified bucket name contains invalid characters. |
| PRQL-EGJN | Object Storage Connection Failed | The specified bucket does not exist. |
| PRQL-SAGK | Object Storage List IO Timeout | Object Storage client encountered IO timeout listing bucket objects. If this error persists, please contact support. |
| PRQL-NQFC | Oracle Authentication Failed | The provided Oracle credentials are invalid. Please check that the correct username and password have been provided and try again. |
| PRQL-WPMU | Oracle Connection Failed | The provided Oracle port is invalid. Please check that the provided port is a valid TCP port (typically 1521). |
| PRQL-VRDH | Oracle Database Not Found | The Oracle listener at the provided host does not recognize the configured database. Please check that the provided database name is correct and try again. |
| PRQL-OXKB | Oracle Host Not Found | The provided Oracle host was not found. Please check that the provided host name is valid and accessible. |
| PRQL-CIUS | Oversized Decimal Value | Encountered a value of type DECIMAL that is too large to be converted to DECIMAL(38,19). |
| PRQL-MCOQ | Postgres Authentication Failed | The Postgres connection was refused. Please check that the provided connection details are correct. |
| PRQL-JXOS | Postgres Conflict With Recovery | The Postgres connection was dropped by the server. This is usually due to a Hot Standby related query timeout. If this error persists, please contact support. |
| PRQL-RXOI | Postgres Connection Failed | The Postgres connection was refused. Please check that the provided host is valid and accessible. |
| PRQL-TPOQ | Postgres Connection Failed | The Postgres connection was refused. Please check that the provided host is valid and accessible. |
| PRQL-VLMV | Postgres Connection Failed | The Postgres connection was refused. Please check that the provided host is valid and accessible. |
| PRQL-QJXV | Postgres Data Processing Failed | The Postgres connection encountered an error. At least one expected column was not found. |
| PRQL-SMHC | Postgres Data Processing Failed | The Postgres connection encountered an error. At least one expected relation was not found. |
| PRQL-XLSX | Postgres Data Processing Failed | The Postgres data transfer encountered duplicate primary key values. Please check that the primary key column values are unique for this recipient. |
| PRQL-FLQR | Postgres Missing PostGIS Extension | The PostGIS extenstion is required for the Postgres to recognize the type geometry. Please make sure PostGIS is installed. |
| PRQL-KKIM | Postgres Runtime Encountered Error | The Postgres connection encountered an unexpected error and was dropped. If this error persists, please contact support. |
| PRQL-KPFZ | Postgres Runtime Encountered Error | The Postgres connection was dropped by the server. If this error persists, please contact support. |
| PRQL-UKMC | Postgres Runtime Encountered Error | The Postgres connection was dropped due to a conflict with the recovery instance. This is usually due to a Hot Standby related query timeout. If this error persists, please contact support. |
| PRQL-ZSRS | Postgres Runtime Encountered Error | The Postgres connection was refused on the view. Please check that the provided connection principal has been granted sufficient access. |
| PRQL-ZSRS | Postgres Runtime Encountered Error | The Postgres connection was refused on the schema. Please check that the provided connection principal has been granted sufficient access. |
| PRQL-ROTX | Postgres cannot execute write in read-only transaction | Postgres is unable to execute the write query. Please ensure that Postgres is configured upon a writer endpoint and with write permissions. |
| PRQL-QDFS | Postgres table missing replica identity | Postgres is unable to update a destination table because it is part of a logical replication publication but has no replica identity configured. Please ensure that any published tables have a primary key, or are set to REPLICA IDENTITY FULL, or exclude them from the publication. |
| PRQL-RSLM | Record Size Limit Exceeded | One or more records in the source data exceed the maximum allowed size for import. Please reduce the size of these records or contact support for assistance. |
| PRQL-DXHS | Redshift Authentication Failed | The provided Redshift connection was refused due to insufficient permissions. Please check that the provided connection details are correct and the principal has been granted sufficient permissions. |
| PRQL-RSFA | Redshift Authentication Failed | The Redshift connection was refused. Please check that the provided connection principal has been granted sufficient access. |
| PRQL-BOWD | Redshift Authorization Failed | The provided Redshift query failed due to insufficient database permissions. Please check that the provided connection details are correct and the principal has been granted sufficient permissions to the target database. |
| PRQL-XKWZ | Redshift Cannot Drop Table with Dependencies | A DROP table operation failed due to one or more downstream consumers dependent on it. Please temporarily revoke access from downstream consumers to the destination table for the full refresh transfer to succeed. |
| PRQL-BLHI | Redshift Connection Failed | The Redshift connection was refused. Please check that the provided host is valid and accessible. |
| PRQL-FTNX | Redshift Connection Failed | The Redshift connection was refused. Please check that the provided host is valid and accessible. |
| PRQL-ZJSM | Redshift Connection Reset By Peer | The Redshift connection was reset. This is likely due to a network issue. Please check your SSH, firewall, and network settings. If the issue persists, please contact support. |
| PRQL-CSNQ | Redshift Data Processing Failed | The Redshift connection encountered an unknown error, contact support. |
| PRQL-JCVI | Redshift Data Processing Failed | The Redshift connection encountered an error. At least one expected column was not found. |
| PRQL-KMNN | Redshift Data Processing Failed | The Redshift connection encountered an error. At least one expected relation was not found. |
| PRQL-WUZB | Redshift Runtime Encountered Error | The Redshift connection encountered an unexpected error and was dropped. If this error persists, please contact support. |
| PRQL-HMCK | S3 Invalid AWS Role ARN | The provided AWS IAM Role ARN is invalid. Please verify the ARN format and value is correct and try again. |
| PRQL-BKDC | S3 Invalid Hostname | The connection contains an invalid hostname. Please verify your bucket region is a valid AWS region code (e.g. eu-west-1). |
| PRQL-JSZM | S3 Missing Delete Permission | Unable to upload file to S3. Please check that the provided role has been granted s3:DeleteObject. |
| PRQL-RTTA | S3 Missing Upload Permission | Unable to upload file to S3. Please check that the provided role has been granted s3:PutObject. |
| PRQL-CIAC | S3 Tables Missing Get Table Metadata Location Permission | A query failed due to a missing s3tables:GetTableMetadataLocation permission in the user/role policy. Please check that the provided connection details are correct and the principal has been granted sufficient permissions. |
| PRQL-QLDD | S3 Tables Missing Get Table Permission | A query failed due to a missing s3tables:GetTableBucket permission in the user/role policy. Please check that the provided connection details are correct and the principal has been granted sufficient permissions. |
| PRQL-GXDD | S3 Tables Missing Update Table Metadata Location Permission | A query failed due to a missing s3tables:UpdateTableMetadataLocation permission in the user/role policy. Please check that the provided connection details are correct and the principal has been granted sufficient permissions. |
| PRQL-QGQQ | S3 Unable to Assume IAM Role | The S3 connection was denied permission to assume the configured IAM role. Please verify the custom trust policy on the role allows sts:AssumeRoleWithWebIdentity from the service identity, and that the required oaud/sub conditions are set correctly, and try again. |
| PRQL-AWJZ | SFTP Connection Lost | SFTP client experienced a connection loss. Please review any idle timeout or session limits configured on the SFTP server and retry. |
| PRQL-ANLW | SQL Server Connection Could Not Be Established | The SQL Server connection timed out. Please verify the host is reachable, firewall rules and/or security group allows access by whitelisting the static egress IP, and the port is reachable. |
| PRQL-GZDZ | SQL Server Connection Failed | The provided SQL Server host was not found. Please check that the provided host name is valid and accessible. |
| PRQL-VKDT | SQL Server Data Processing Failed | The SQL Server data transfer encountered duplicate primary key values. Please check that the primary key column values are unique for this recipient. |
| PRQL-UXPW | SQL Server Invalid Username/Password Characters | The transfer user’s username or password contains special characters that cannot be parsed during connection. Please update the user’s credentials and try again. |
| PRQL-LCNW | SQL Server Size Quota Exceeded | The database has reached its size quota. Please check the database service tier storage limit and any maximum dataset size configured, and increase allocations as needed. |
| PRQL-MURC | SQL Server unable to resolve collation conflict | A collation conflict cannot be resolved on the SQL Server table. Please contact support for more information. |
| PRQL-CLDD | Schema Not Found Error | A query failed due to a missing schema. Please check that the specified schema exists in the catalog or metastore. |
| PRQL-ZPLL | Service Temporarily Unavailable | Prequel’s import service is temporarily unavailable. Please retry shortly. If the issue persists, contact support. |
| PRQL-FKDS | Snowflake Authentication Error | Snowflake user access is disabled. Please contact the Snowflake admin to get more information. |
| PRQL-VKCP | Snowflake Authentication Failed | The Snowflake engine refused the operation due to insufficient permissions. Please check that the provided principal has been granted the required permissions. |
| PRQL-ZBSP | Snowflake Authentication Failed | The provided Snowflake credentials are invalid. Please check that the correct credentials have been provided. |
| PRQL-BJKE | Snowflake Authentication Policy Rejected | Snowflake rejected the login because the current authentication policy does not allow the attempted authentication method. Ensure the user/account policy allows DRIVERS and the chosen authentication method (PASSWORD or KEYPAIR). |
| PRQL-IGRW | Snowflake Authentication Rate Limited | The Snowflake connection was rejected. This is likely due to too many failed connection attempts. Please check that the correct credentials have been provided. |
| PRQL-HFCO | Snowflake Connection Failed | IP whitelisting has not been properly configured in the provided Snowflake account. Please contact support to confirm the correct IP address to whitelist within Snowflake. |
| PRQL-HFCO | Snowflake Connection Failed | The provided Snowflake Account Host is not valid. Please check that your provided host name is a valid Snowflake account URL (ending in ‘snowflakecomputing.com’). |
| PRQL-PKAN | Snowflake Data Processing Failed | The Snowflake connection has no active warehouse. Please ensure the provided user has a default warehouse configured. |
| PRQL-AFWL | Snowflake Database Does Not Exist or Not Authorized | The connection attempt failed due to an issue with permissions. Please confirm that the provided Snowflake database exists and the provided user has been authorized. If the error persists, please confirm that the provided user has been successfully granted access to the designated role, and that the default_role has been successfully configured on the user. |
| PRQL-NSOE | Snowflake Duplicate Row Error | The Snowflake data transfer encountered an error during data transfer. The Snowflake target table or staged data may have duplicate data preventing successful updates. Please confirm there is no duplicate data in the data source, and contact support if the issue persists. |
| PRQL-BIEM | Snowflake Host Does Not Exist | The Snowflake host was unreachable. Please ensure the host was properly entered. |
| PRQL-WLAM | Snowflake Incorrect Username or Password | The provided Snowflake username or passsword is incorrect. Please check that the correct username and password have been provided. |
| PRQL-JWCP | Snowflake Invalid Account Setting | Failed to read the information schema due to casing. If the Snowflake account has the setting QUOTED_IDENTIFIERS_IGNORE_CASE enabled, make sure it is set to FALSE on the data transfer user. |
| PRQL-COSD | Snowflake Invalid Identifier | A Snowflake query tried to reference a table or column that does not exist. If the table or column has been deleted, it may need to be recreated manually or via full refresh. Please contact support for more information. |
| PRQL-OFWE | Snowflake Key Auth Error | The Snowflake connection was refused. Please confirm that the provided Snowflake public key has been successfully assigned to the Snowflake user. |
| PRQL-AJHJ | Snowflake Multi-factor Authentication is Required | Multi-factor authentication is currently required for the authorized user and MFA is not supported with data syncing. Please ensure your user is of type SERVICE instead of HUMAN and try again. |
| PRQL-VIED | Snowflake No Such Host Error | The Snowflake connection failed to initialize, the host provided does not exist. |
| PRQL-YWUX | Snowflake Object Verification Error | The Snowflake server was unable to verify an object. Please check that the Snowflake principal has access to the required objects. |
| PRQL-UPSD | Snowflake Password Expired | The given Snowflake password has expired. Snowflake suggests updating the password via the Snowflake web console. |
| PRQL-QZQZ | Snowflake Quota Exceeded | The designated Snowflake warehouse cannot be resumed because the warehouse’s resource monitor has exceeded its credit quota. |
| PRQL-IRPW | Snowflake Runtime Encountered Error | The Snowflake account has run out of virtual warehouse trial credit. |
| PRQL-JWOD | Snowflake Runtime Encountered Error | Snowflake reported that the statement was no longer executing (error 000605). This usually means the query was canceled before it could run, which is typically transient and resolves automatically. If the error persists, check whether the target warehouse is overloaded and scale it up if queries are queuing. |
| PRQL-WTKQ | Snowflake Runtime Encountered Error | The Snowflake account has been suspended due to the lack of a payment method. |
| PRQL-SSTE | Snowflake Session Token Expired | The Snowflake session token has expired. Please ensure the configured warehouse is active and not overloaded, and retry the transfer. |
| PRQL-SNOA | Snowflake Stage is Not Authorized | The connection encountered an issue accessing a Snowflake stage. If you have existing FUTURE STAGE grants at the database or schema level, please ensure that the transfer user’s default role is provided GRANT READ and GRANT WRITE ON FUTURE STAGES in the target schema. |
| PRQL-DSIO | Snowflake Timeout | Snowflake client encountered statement or warehouse timeout and canceled query. |
| PRQL-BKEK | Snowflake Unknown Internal Error | Snowflake returned an internal error. Review the failed query in Snowflake’s query history and check the Snowflake status page to determine whether the issue is ongoing. |
| PRQL-DICX | Snowflake Warehouse Encountered Permissions Error | The Snowflake warehouse encountered an error. Please check that the provided service account has been granted sufficient permissions. Specifically, please check for permissions on existing tables and schemas. |
| PRQL-ANCT | Transfer Dispatch Error | The transfer failed to be dispatched to a worker. |
| PRQL-IDWD | Trino Exceeded Partitions Limit | The Trino engine encountered an error because too many partitions were found. |
| PRQL-ERMS | Unknown Error | An unknown error occurred. |
Error handling
Prequel error codes
Reference of Prequel error codes, their meaning, and how to resolve them.
Every Prequel error maps to a stable code. Use the table below to look up what a code means and how to resolve it.