<!--

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at
    
        http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.

-->

# 状态码

IoTDB 引入了**状态码**这一概念。例如，因为 IoTDB 需要在写入数据之前首先注册时间序列，一种可能的解决方案是：

```
try {
    writeData();
} catch (SQLException e) {
  // the most case is that the time series does not exist
  if (e.getMessage().contains("exist")) {
      //However, using the content of the error message is not so efficient
      registerTimeSeries();
      //write data once again
      writeData();
  }
}

```

利用状态码，我们就可以不必写诸如`if (e.getErrorMessage().contains("exist"))`的代码，
只需要使用`e.getStatusType().getCode() == TSStatusCode.TIME_SERIES_NOT_EXIST_ERROR.getStatusCode()`。

这里是状态码和相对应信息的列表：

| 状态码  | 状态类型                                   | 状态信息                      |
|:-----|:---------------------------------------|:--------------------------|
| 200  | SUCCESS_STATUS                         | 成功状态                      |
| 201  | INCOMPATIBLE_VERSION                   | 版本不兼容                     |
| 202  | CONFIGURATION_ERROR                    | 配置文件有错误项                  |
| 203  | START_UP_ERROR                         | 启动错误                      |
| 204  | SHUT_DOWN_ERROR                        | 关机错误                      |
| 300  | UNSUPPORTED_OPERATION                  | 不支持的操作                    |
| 301  | EXECUTE_STATEMENT_ERROR                | 执行语句错误                    |
| 302  | MULTIPLE_ERROR                         | 多行语句执行错误                  |
| 303  | ILLEGAL_PARAMETER                      | 参数错误                      |
| 304  | OVERLAP_WITH_EXISTING_TASK             | 与正在执行的其他操作冲突              |
| 305  | INTERNAL_SERVER_ERROR                  | 服务器内部错误                   |
| 306  | DISPATCH_ERROR                         | 分发错误                      |
| 400  | REDIRECTION_RECOMMEND                  | 推荐客户端重定向                  |
| 500  | DATABASE_NOT_EXIST                     | 数据库不存在                    |
| 501  | DATABASE_ALREADY_EXISTS                | 数据库已存在                    |
| 502  | SERIES_OVERFLOW                        | 序列数量超过阈值                  |
| 503  | TIMESERIES_ALREADY_EXIST               | 时间序列已存在                   |
| 504  | TIMESERIES_IN_BLACK_LIST               | 时间序列正在删除                  |
| 505  | ALIAS_ALREADY_EXIST                    | 路径别名已经存在                  |
| 506  | PATH_ALREADY_EXIST                     | 路径已经存在                    |
| 507  | METADATA_ERROR                         | 处理元数据错误                   |
| 508  | PATH_NOT_EXIST                         | 路径不存在                     |
| 509  | ILLEGAL_PATH                           | 路径不合法                     |
| 510  | CREATE_TEMPLATE_ERROR                  | 创建物理量模板失败                 |
| 511  | DUPLICATED_TEMPLATE                    | 元数据模板重复                   |
| 512  | UNDEFINED_TEMPLATE                     | 元数据模板未定义                  |
| 513  | TEMPLATE_NOT_SET                       | 元数据模板未设置                  |
| 514  | DIFFERENT_TEMPLATE                     | 元数据模板不一致                  |
| 515  | TEMPLATE_IS_IN_USE                     | 元数据模板正在使用                 |
| 516  | TEMPLATE_INCOMPATIBLE                  | 元数据模板不兼容                  |
| 517  | SEGMENT_NOT_FOUND                      | 未找到 Segment               |
| 518  | PAGE_OUT_OF_SPACE                      | PBTreeFile 中 Page 空间不够    |
| 519  | RECORD_DUPLICATED                      | 记录重复                      |
| 520  | SEGMENT_OUT_OF_SPACE                   | PBTreeFile 中 segment 空间不够 |
| 521  | PBTREE_FILE_NOT_EXISTS                | PBTreeFile 不存在            |
| 522  | OVERSIZE_RECORD                        | 记录大小超过元数据文件页面大小           |
| 523  | PBTREE_FILE_REDO_LOG_BROKEN           | PBTreeFile 的 redo 日志损坏    |
| 524  | TEMPLATE_NOT_ACTIVATED                 | 元数据模板未激活                  |
| 526  | SCHEMA_QUOTA_EXCEEDED                  | 集群元数据超过配额上限               |
| 527  | MEASUREMENT_ALREADY_EXISTS_IN_TEMPLATE | 元数据模板中已存在物理量              |
| 600  | SYSTEM_READ_ONLY                       | IoTDB 系统只读                |
| 601  | STORAGE_ENGINE_ERROR                   | 存储引擎相关错误                  |
| 602  | STORAGE_ENGINE_NOT_READY               | 存储引擎还在恢复中，还不能接受读写操作       |
| 603  | DATAREGION_PROCESS_ERROR               | DataRegion 相关错误           |
| 604  | TSFILE_PROCESSOR_ERROR                 | TsFile 处理器相关错误            |
| 605  | WRITE_PROCESS_ERROR                    | 写入相关错误                    |
| 606  | WRITE_PROCESS_REJECT                   | 写入拒绝错误                    |
| 607  | OUT_OF_TTL                             | 插入时间少于 TTL 时间边界           |
| 608  | COMPACTION_ERROR                       | 合并错误                      |
| 609  | ALIGNED_TIMESERIES_ERROR               | 对齐时间序列错误                  |
| 610  | WAL_ERROR                              | WAL 异常                    |
| 611  | DISK_SPACE_INSUFFICIENT                | 磁盘空间不足                    |
| 700  | SQL_PARSE_ERROR                        | SQL 语句分析错误                |
| 701  | SEMANTIC_ERROR                         | SQL 语义错误                  |
| 702  | GENERATE_TIME_ZONE_ERROR               | 生成时区错误                    |
| 703  | SET_TIME_ZONE_ERROR                    | 设置时区错误                    |
| 704  | QUERY_NOT_ALLOWED                      | 查询语句不允许                   |
| 705  | LOGICAL_OPERATOR_ERROR                 | 逻辑符相关错误                   |
| 706  | LOGICAL_OPTIMIZE_ERROR                 | 逻辑优化相关错误                  |
| 707  | UNSUPPORTED_FILL_TYPE                  | 不支持的填充类型                  |
| 708  | QUERY_PROCESS_ERROR                    | 查询处理相关错误                  |
| 709  | MPP_MEMORY_NOT_ENOUGH                  | MPP 框架中任务执行内存不足           |
| 710  | CLOSE_OPERATION_ERROR                  | 关闭操作错误                    |
| 711  | TSBLOCK_SERIALIZE_ERROR                | TsBlock 序列化错误             |
| 712  | INTERNAL_REQUEST_TIME_OUT              | MPP 操作超时                  |
| 713  | INTERNAL_REQUEST_RETRY_ERROR           | 内部操作重试失败                  |
| 714  | NO_SUCH_QUERY                          | 查询不存在                     |
| 715  | QUERY_WAS_KILLED                       | 查询执行时被终止                  |
| 800  | UNINITIALIZED_AUTH_ERROR               | 授权模块未初始化                  |
| 801  | WRONG_LOGIN_PASSWORD                   | 用户名或密码错误                  |
| 802  | NOT_LOGIN                              | 没有登录                      |
| 803  | NO_PERMISSION                          | 没有操作权限                    |
| 804  | USER_NOT_EXIST                         | 用户不存在                     |
| 805  | USER_ALREADY_EXIST                     | 用户已存在                     |
| 806  | USER_ALREADY_HAS_ROLE                  | 用户拥有对应角色                  |
| 807  | USER_NOT_HAS_ROLE                      | 用户未拥有对应角色                 |
| 808  | ROLE_NOT_EXIST                         | 角色不存在                     |
| 809  | ROLE_ALREADY_EXIST                     | 角色已存在                     |
| 810  | ALREADY_HAS_PRIVILEGE                  | 已拥有对应权限                   |
| 811  | NOT_HAS_PRIVILEGE                      | 未拥有对应权限                   |
| 812  | CLEAR_PERMISSION_CACHE_ERROR           | 清空权限缓存失败                  |
| 813  | UNKNOWN_AUTH_PRIVILEGE                 | 未知权限                      |
| 814  | UNSUPPORTED_AUTH_OPERATION             | 不支持的权限操作                  |
| 815  | AUTH_IO_EXCEPTION                      | 权限模块IO异常                  |
| 900  | MIGRATE_REGION_ERROR                   | Region 迁移失败               |
| 901  | CREATE_REGION_ERROR                    | 创建 region 失败              |
| 902  | DELETE_REGION_ERROR                    | 删除 region 失败              |
| 903  | PARTITION_CACHE_UPDATE_ERROR           | 更新分区缓存失败                  |
| 904  | CONSENSUS_NOT_INITIALIZED              | 共识层未初始化，不能提供服务            |
| 905  | REGION_LEADER_CHANGE_ERROR             | Region leader 迁移失败        |
| 906  | NO_AVAILABLE_REGION_GROUP              | 无法找到可用的 Region 副本组        |
| 907  | LACK_DATA_PARTITION_ALLOCATION         | 调用创建数据分区方法的返回结果里缺少信息      |
| 1000 | DATANODE_ALREADY_REGISTERED            | DataNode 在集群中已经注册         |
| 1001 | NO_ENOUGH_DATANODE                     | DataNode 数量不足，无法移除节点或创建副本 |
| 1002 | ADD_CONFIGNODE_ERROR                   | 新增 ConfigNode 失败          |
| 1003 | REMOVE_CONFIGNODE_ERROR                | 移除 ConfigNode 失败          |
| 1004 | DATANODE_NOT_EXIST                     | 此 DataNode 不存在            |
| 1005 | DATANODE_STOP_ERROR                    | DataNode 关闭失败             |
| 1006 | REMOVE_DATANODE_ERROR                  | 移除 datanode 失败            |
| 1007 | REGISTER_DATANODE_WITH_WRONG_ID        | 注册的 DataNode 中有错误的注册id    |
| 1008 | CAN_NOT_CONNECT_DATANODE               | 连接 DataNode 失败            |
| 1100 | LOAD_FILE_ERROR                        | 加载文件错误                    |
| 1101 | LOAD_PIECE_OF_TSFILE_ERROR             | 加载 TsFile 片段异常            |
| 1102 | DESERIALIZE_PIECE_OF_TSFILE_ERROR      | 反序列化 TsFile 片段异常          |
| 1103 | SYNC_CONNECTION_ERROR                  | 同步连接错误                    |
| 1104 | SYNC_FILE_REDIRECTION_ERROR            | 同步文件时重定向异常                |
| 1105 | SYNC_FILE_ERROR                        | 同步文件异常                    |
| 1106 | CREATE_PIPE_SINK_ERROR                 | 创建 PIPE Sink 失败           |
| 1107 | PIPE_ERROR                             | PIPE 异常                   |
| 1108 | PIPESERVER_ERROR                       | PIPE server 异常            |
| 1109 | VERIFY_METADATA_ERROR                  | 校验元数据失败                   |
| 1200 | UDF_LOAD_CLASS_ERROR                   | UDF 加载类异常                 |
| 1201 | UDF_DOWNLOAD_ERROR                     | 无法从 ConfigNode 下载 UDF     |
| 1202 | CREATE_UDF_ON_DATANODE_ERROR           | 在 DataNode 创建 UDF 失败      |
| 1203 | DROP_UDF_ON_DATANODE_ERROR             | 在 DataNode 卸载 UDF 失败      |
| 1300 | CREATE_TRIGGER_ERROR                   | ConfigNode 创建 Trigger 失败  |
| 1301 | DROP_TRIGGER_ERROR                     | ConfigNode 删除 Trigger 失败  |
| 1302 | TRIGGER_FIRE_ERROR                     | 触发器执行错误                   |
| 1303 | TRIGGER_LOAD_CLASS_ERROR               | 触发器加载类异常                  |
| 1304 | TRIGGER_DOWNLOAD_ERROR                 | 从 ConfigNode 下载触发器异常      |
| 1305 | CREATE_TRIGGER_INSTANCE_ERROR          | 创建触发器实例异常                 |
| 1306 | ACTIVE_TRIGGER_INSTANCE_ERROR          | 激活触发器实例异常                 |
| 1307 | DROP_TRIGGER_INSTANCE_ERROR            | 删除触发器实例异常                 |
| 1308 | UPDATE_TRIGGER_LOCATION_ERROR          | 更新有状态的触发器所在 DataNode 异常   |
| 1400 | NO_SUCH_CQ                             | CQ 任务不存在                  |
| 1401 | CQ_ALREADY_ACTIVE                      | CQ 任务已激活                  |
| 1402 | CQ_AlREADY_EXIST                       | CQ 任务已存在                  |
| 1403 | CQ_UPDATE_LAST_EXEC_TIME_ERROR         | CQ 更新上一次执行时间失败            |

> 在最新版本中，我们重构了 IoTDB 的异常类。通过将错误信息统一提取到异常类中，并为所有异常添加不同的错误代码，从而当捕获到异常并引发更高级别的异常时，错误代码将保留并传递，以便用户了解详细的错误原因。
除此之外，我们添加了一个基础异常类“ProcessException”，由所有异常扩展。