错误码列表

GBase 8a数据库在运行过程中会通过特定的错误码来报告问题。下面我为你梳理了常见的错误码、其含义以及基本的排查方向，希望能帮助你快速定位问题。

常见错误码速查表

错误码 错误说明/含义 常见原因与排查方向

ERROR 1046 (3D000) 未选择数据库。 在执行操作前，需要使用 USE database_name; 语句指定当前数据库。

ERROR 1049 (42000) 未知数据库。 指定的数据库不存在。请检查数据库名是否拼写正确，或确认数据库是否已创建。

ERROR 1050 (42S01) 表已存在。 尝试创建的表名与现有表重复。需要更换表名或先删除已存在的表。

ERROR 1105 (HY000) DBLink相关错误。 这是一个大类，可能包括：网关服务未启动 (connect gateway server timeout)、配置文件丢失 (data source file ... is not exists)、网络或权限问题 (The message from gateway is invalid)、DML操作不支持 (DBLink-Table does not support update operation)等。

ERROR 1133 (42000) 用户不存在。 使用 gccli 连接时，默认使用了操作系统用户名。请使用 -u 参数明确指定数据库用户名。

ERROR 1146 (42S02) 表不存在。 查询或操作的表在当前数据库中不存在。检查表名拼写和当前数据库是否正确。

ERROR 1191 (HY000) 找不到全文索引。 尝试使用 CONTAINS 函数进行全文检索，但对应的列上没有建立全文索引。

ERROR 1264 (22003) 列值超出范围。 插入或更新的数据超出了列定义的数据类型范围，例如向一个整型字段插入了过大的数值。

ERROR 1292 (22007) 不正确的日期/时间值。 提供的日期、时间或日期时间格式非法或不存在的值（如 '2010-09-31'）。

ERROR 1305 (42000) 函数不存在。 调用的函数名拼写错误，或该函数在当前版本中确实不支持。

ERROR 1317 (70100) 查询执行被中断。 可能由用户主动取消（如Ctrl+C）、查询超时或加载错误行数超限等原因引起。

ERROR 1702 (HY000) 集群表错误。 可能原因包括：表不存在（GBA-02DD-0017）、不支持修改列定义（如修改非VARCHAR类型的列）等。

ERROR 1705 (HY000) DML操作错误（HDFS存储）。 当表空间指定为HDFS时，执行DML操作可能因HDFS服务异常、网络不通或权限不足（如GBase用户无HDFS目录写权限）而失败。

ERROR 1722 (HY000) 不能更新分布列。 尝试更新作为Hash分布条件的列，这是当前版本不支持的操作。

ERROR 1733 (HY000) 通用错误（常见于数据加载）。 这是数据加载（LOAD DATA）中最常见的错误，可能原因非常多：<br>• Login denied: FTP等服务用户名或密码错误。<br>• Couldn't connect to server: 服务器IP错误或FTP等服务未启动。<br>• failed to get table distribution information: 要加载数据的表不存在。<br>• Could not get file size / Remote file not found: 指定的数据文件不存在。<br>• Too many bad records: 数据文件中格式错误或与表结构不匹配的行数超过了 MAX_BAD_RECORDS 参数的限制。<br>• Line length is more than...: 数据文件的某行长度超过了 gbase_loader_max_line_length 参数的设置。

ERROR 1818 (HY000) 未选择虚拟集群（VC）。 在支持多虚拟集群（VC）的环境中，未使用 USE VC vc_name; 选择虚拟集群。

错误排查通用建议

当遇到错误时，除了参考上表，还可以遵循以下步骤：

1.  仔细阅读错误信息：GBase 8a的错误信息通常比较详细，会直接指出问题所在，例如表不存在、权限不足等。这是解决问题的第一步。
2.  查看详细日志：对于复杂的错误（特别是以 (GBA-XX...) 开头的内部错误码），需要登录到数据库节点，查看 gcluster.log, gnode.log, express.log 等日志文件，里面通常有更详细的堆栈信息。
3.  核对配置和权限：对于网络连接、数据加载、DBlink等问题，很大概率是配置文件、网络连通性、或者操作系统/HDFS目录权限导致的。请仔细检查相关配置和权限设置。