Error codes
errors[].code is an OperationErrorCode name.
errors[].code is an OperationErrorCode name. Values are added, never renumbered or reused: a
code is part of the tool's contract once it has shipped.
Observable from list coverage today:
| Code | When |
|---|---|
WorkspaceNotOpen |
No workspace was found, or the one named does not exist (§3) |
DistributionListNotFound |
No target group by that name in the workspace |
SchemaReadFailed |
A database could not be read during the scan |
Unexpected |
A failure the layer did not anticipate. Carries the exception's type, never its text |
The rest of the enum, which becomes reachable as verbs land:
| Code | When |
|---|---|
ProjectNotTracked |
The workspace manifest does not track the project named |
ProjectFileMissing |
The project file named is not on disk |
FileLocked |
A file that had to be deleted is held open, so nothing was deleted |
ProjectFolderNotExclusive |
Permanent delete was asked for, but the folder holds things that are not this project |
Conflict |
The thing being written changed underneath |
AccessDenied |
The filesystem refused |
StalePlan |
A confirmation token no longer matches the plan it came from |
ConnectionNotFound |
No registered connection by that name or id |
VariableNotFound · VariableAlreadyDeclared · VariableNameInvalid |
Variable declaration errors |
EnvironmentNotFound · EnvironmentAlreadyExists · EnvironmentNameInvalid |
Environment errors |
ImportFileNotRecognized |
A file offered to the importer is not a SQL Multi Script file |
This table is hand-maintained and can fall behind the product; if a code you see is missing here, tell us.