You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ignite.apache.org by sk...@apache.org on 2022/10/06 10:35:04 UTC
[ignite-3] branch main updated: IGNITE-17768 Add descriptions for AI3 exceptions. Fixes #1123
This is an automated email from the ASF dual-hosted git repository.
sk0x50 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/ignite-3.git
The following commit(s) were added to refs/heads/main by this push:
new 0cb65d0978 IGNITE-17768 Add descriptions for AI3 exceptions. Fixes #1123
0cb65d0978 is described below
commit 0cb65d097821b8f0d38a6a8556601a91aa7527d3
Author: IgGusev <de...@mail.ru>
AuthorDate: Thu Oct 6 13:34:54 2022 +0300
IGNITE-17768 Add descriptions for AI3 exceptions. Fixes #1123
Signed-off-by: Slava Koptilin <sl...@gmail.com>
---
docs/_docs/handling-exceptions.adoc | 119 ++++++++++++++++++++++++++++++++++--
1 file changed, 115 insertions(+), 4 deletions(-)
diff --git a/docs/_docs/handling-exceptions.adoc b/docs/_docs/handling-exceptions.adoc
index 8a4b7a0baa..0ce9d421cb 100644
--- a/docs/_docs/handling-exceptions.adoc
+++ b/docs/_docs/handling-exceptions.adoc
@@ -17,8 +17,119 @@
This section outlines basic exceptions that can be generated by Ignite 3 and provides basic instructions for handling them.
-[cols="20%,40%,40%", width="100%"]
-|=======================================================================
-|Exception |Description |Action
+== Finding Stack Trace Information
-|`exception`|What causes exception|Recommended actions
\ No newline at end of file
+When the exception happens, Apache Ignite 3 provides a UUID of the specific exception, but not a full stack trace. For a full stack trace, check cluster logs.
+
+== Common Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-CMN-1`|Unexpected error occurred.
+|`IGN-CMN-2`|Operation was stopped because node is stopping.
+|`IGN-CMN-3`|Required component was not started.
+|===
+
+== Table Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-TBL-1`|Table already exists.
+|`IGN-TBL-2`|Table not found.
+|`IGN-TBL-3`|Column already exists.
+|`IGN-TBL-4`|Column not found.
+|===
+
+== Client Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-CLIENT-1`|Connection to client failed.
+|`IGN-CLIENT-2`|An issue happened with connection protocol.
+|`IGN-CLIENT-3`|Incompatible protocol version.
+|`IGN-CLIENT-4`|Table not found by ID.
+|`IGN-CLIENT-5`|An error with authentication parameters.
+|`IGN-CLIENT-6`|An error occurred during server authorization.
+|`IGN-CLIENT-7`|An error occurred while reading client configuration.
+|===
+
+== SQL Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-SQL-1`|Ignite tried to read a page after last one.
+|`IGN-SQL-2`|The specified either does not exist or is closed.
+|`IGN-SQL-3`|SQL query is incorrect.
+|`IGN-SQL-4`|Query returned no result set.
+|`IGN-SQL-5`|Table is missing primary key.
+|`IGN-SQL-6`|Multiple primary keys found in a table.
+|`IGN-SQL-7`|Failed to find schema.
+|`IGN-SQL-8`|Specified storage engine is not supported.
+|`IGN-SQL-9`|Cursor is already closed when another operation starts.
+|`IGN-SQL-10`|Some keys could not be inserted because they are duplicates.
+|`IGN-SQL-11`|Cannot delete a column that belongs to the primary key.
+|`IGN-SQL-12`|Too many grouping expressions.
+|`IGN-SQL-13`|Unsupported SQL operation.
+|`IGN-SQL-14`|Unsupported DDL operation.
+|`IGN-SQL-15`|Query validation error.
+|`IGN-SQL-16`|Specified table not found.
+|`IGN-SQL-17`|Specified table version not found.
+|`IGN-SQL-18`|Invalid table option specified.
+|`IGN-SQL-19`|Query mapping error.
+|`IGN-SQL-20`|DDL execution error.
+|`IGN-SQL-21`|DML result error.
+|`IGN-SQL-22`|Failed to map SQL data type to relational.
+|`IGN-SQL-23`|Failed to serialize relational expression.
+|`IGN-SQL-24`|Failed to deserialized relational expression.
+|`IGN-SQL-25`|Class not found.
+|`IGN-SQL-26`|Failed to compile an SQL expression.
+|`IGN-SQL-27`|Node left the cluster.
+|`IGN-SQL-28`|Failed to send a message.
+|`IGN-SQL-29`|Operation aborted or interrupted.
+|`IGN-SQL-30`|An error occurred while canceling the operation.
+|`IGN-SQL-31`|Session expired.
+|`IGN-SQL-32`|Session evaluation error.
+|`IGN-SQL-33`|Execution cancelled.
+|===
+
+== Meta Storage Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-META-1`|Failed to start the underlying key value storage.
+|`IGN-META-2`|Failed to restore the underlying key value storage.
+|`IGN-META-3`|Failed to close the underlying key value storage.
+|`IGN-META-4`|Failed to compact the underlying key value storage.
+|`IGN-META-5`|Failed to perform an operation on the underlying key value storage.
+|`IGN-META-6`|Failed to perform an operation within a specified time period. Usually in such cases the operation should be retried.
+|`IGN-META-7`|Failed to iterate over the underlying key value storage.
+|`IGN-META-8`|Failed to stop a watcher.
+|`IGN-META-9`|Failed to deploy or update a watcher.
+|`IGN-META-10`|Failed to iterate over meta storage cursor.
+|`IGN-META-11`|Failed to close a cursor.
+|===
+
+== Index Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-IDX-1`|Invalid index definition.
+|`IGN-IDX-2`|Failed to find the specified index.
+|===
+
+== Transactions Exceptions
+
+[cols="20%,80%", width="100%"]
+|===
+|Exception |Description
+|`IGN-TX-1`|Failed to create a transaction state storage.
+|`IGN-TX-2`|Failed to destroy the transaction state storage.
+|`IGN-TX-3`|Failed to work with the transaction state storage.
+|`IGN-TX-4`|Transaction state storage is stopped when a different operation is planned.
+|===
\ No newline at end of file