Troubleshooting and FAQ
Common messages and questions in Sovos Intelligence, and what to do about them.
Query and reconciliation validation errors
| Message | What it means and how to fix it |
|---|---|
Invalid query. |
The query is shorter than the six-character minimum. Enter a valid statement. |
Only one #[MATCH] could be added. |
A cross-check query contains more than one match marker. Use #[MATCH] exactly once. |
When specifying #[MATCH], two queries are needed... |
The match marker was used with other than two queries. A reconciliation query must contain exactly two SELECT statements. |
Invalid match condition setup. |
The match conditions are empty or invalid. Provide at least one column = column condition and give every key a value. |
For a RawQuery only one query is allowed. |
Multiple statements were entered without #[MATCH]. A non-reconciliation query allows only one statement. |
Semantic model must use different alias. |
An output column reuses a source column name. Give each selected column an alias that differs from the raw source column name. |
For the full rules, see Query and reconciliation reference.
Report statuses
A report run shows one of these statuses. See Reports for what each one means.
-
Not started
-
Generating
-
Rule validation not started
-
Processing
-
Ready to Review
-
Work in Progress
-
Completed
-
Failed
Exports and downloads
- My CSV download is a .csv.gz file
-
CSV exports are delivered gzip-compressed as
.csv.gz. Open it with any standard archive tool, or in a tool that reads gzip directly. See Retrieve a download. - My download is gone
- Downloads expire 30 days after they are requested. Re-export if you need the file again.
I don't see Insights, Queries, or Connectors
These sections are hidden for the Read-Only role. See Roles and permissions.
Upload data says I have no template
Sovos must provision a data-upload template during implementation. If the upload pop-up shows that you have no template, reach out to your Sovos administrator. See Upload data.
Logging in and loading
- You land on a Choose Workspace screen
- Your administrator may have assigned you a different email. Choose the workspace that applies, or log in with the correct email address. See Logging in and account access.
- The page is stuck on a loading spinner
- Clear your browser cache, then your cookies; try an incognito or private window; or close all browser windows and try again.
For additional error-recovery guidance (for example, a failed sync or an empty report), contact your Sovos administrator or support team.
