数据仓库服务 GAUSSDB(DWS)-SQL语句出错自动重试
SQL语句出错自动重试
GaussDB (DWS)支持在SQL语句执行出错时自动重试(下文简称CN Retry)。对于来自gsql客户端、JDBC、ODBC驱动的SQL语句,在SQL语句执行失败时,CN端能够自动识别语句执行过程中的报错,并重新下发任务进行自动重试。
该功能的限制和约束如下:
- 功能范围限制:
- 仅能提高故障发生时SQL语句执行成功率,不能保证100%的执行成功。
- CN Retry默认开启,开启后temp表会记录日志,关闭CN Retry后,temp表不会记录日志,因此不能在使用temp表时反复打开/关闭CN Retry开关,否则主备切换后再CN Retry会造成数据不一致。
- CN Retry默认开启,开启后新创建的unlogged表会忽视unlogged关键字,建成普通表。关闭CN Retry后,unlogged表不会记录日志,因此不能在使用unlogged表时反复打开/关闭CN Retry开关,否则主备切换后再CN Retry会造成数据不一致。
- 在使用gds进行数据导出时,支持CN Retry。现有机制导出时会对重复文件进行检测并删除相同的文件,因此建议不要对相同的外表重复导出数据,除非确定数据目录中相同文件名的文件需要删除。
- 错误类型约束:
SQL语句出错时能够被识别和重试的错误,仅限在错误类型列表(请参考表1)中定义的错误。
- 语句类型约束:
- 存储过程语句约束:
- 包含EXCEPTION的存储过程,如果在执行过程中(包含语句块执行和EXCEPTION中的语句执行)错误被抛出,可以retry,且系统内部错误发生时,retry会先于EXCEPTION被执行,而如果报错被EXCEPTION捕获则不能retry。
- 不支持使用全局变量的package。
- 不支持DBMS_JOB。
- 不支持UTL_FILE。
- 如果存储过程中有输出打印信息(如dbms_output.put_line或raise info等),则发生retry时会重复输出已打印的消息,并会在重复消息前输出“Notice:Retry triggered, some message may be duplicated.”加以提示。
- 集群状态约束:
- 仅支持DN、GTM实例故障。
- CN Retry有次数限制,如果在CN Retry达到最大尝试次数(最大次数由max_query_retry_times控制)之前,集群状态无法从故障状态恢复到正常状态,那么CN Retry不能保证执行成功。
- 扩容时不支持CN Retry。
- 数据导入约束:
- 不支持COPY FROM STDIN语句。
- 不支持gsql \copy from元命令。
- 不支持JDBC CopyManager copyIn导入数据。
CN Retry支持的错误类型列表和对应的错误码信息见表1, 可以通过GUC参数retry_ecode_list设置CN Retry支持的错误类型列表,但不建议用户直接修改该参数,如有修改需求请联系技术工程师协助处理。
错误类型 |
错误码 |
备注 |
---|---|---|
对端连接重置(CONNECTION_RESET_BY_PEER) |
YY001 |
TCP通信错误:Connection reset by peer(CN和DN间通信) |
对端流重置(STREAM_CONNECTION_RESET_BY_PEER) |
YY002 |
TCP通信错误:Stream connection reset by peer(DN和DN间通信) |
锁等待超时(LOCK_WAIT_TIMEOUT) |
YY003 |
锁超时,Lock wait timeout |
连接超时(CONNECTION_TIMED_OUT) |
YY004 |
TCP通信错误,Connection timed out |
查询设置错误(SET_QUERY_ERROR) |
YY005 |
SET命令发送失败,Set query |
超出逻辑内存(OUT_OF_ LOG ICAL_MEMORY) |
YY006 |
内存申请失败,Out of logical memory |
通信库内存分配(SCTP_MEMORY_ALLOC) |
YY007 |
SCTP通信错误,Memory allocate error |
无通信库缓存数据(SCTP_NO_DATA_IN_BUFFER) |
YY008 |
SCTP通信错误,SCTP no data in buffer |
通信库释放内存关闭(SCTP_RELEASE_MEMORY_CLOSE) |
YY009 |
SCTP通信错误,Release memory close |
SCTP、TCP断开(SCTP_TCP_DISCONNECT) |
YY010 |
SCTP通信错误,TCP disconnect |
通信库断开(SCTP_DISCONNECT) |
YY011 |
SCTP通信错误,SCTP disconnect |
通信库远程关闭(SCTP_REMOTE_CLOSE) |
YY012 |
SCTP通信错误,Stream closed by remote |
等待未知通信库通信(SCTP_WAIT_POLL_UNKNOW) |
YY013 |
等待未知通信库通信,SCTP wait poll unknow |
无效快照(SNAPSHOT_INVALID) |
YY014 |
快照非法,Snapshot invalid |
通讯接收信息错误(ERRCODE_CONNECTION_RECEIVE_WRONG) |
YY015 |
连接获取错误,Connection receive wrong |
内存耗尽(OUT_OF_MEMORY) |
53200 |
内存耗尽,Out of memory |
连接失败(CONNECTION_FAILURE) |
08006 |
GTM出错,Connection failure |
连接异常(CONNECTION_EXCEPTION) |
08000 |
连接出现错误,和DN的通讯失败,Connection exception |
管理员关闭系统(ADMIN_SHUTDOWN) |
57P01 |
管理员关闭系统,Admin shutdown |
关闭远程流接口(STREAM_REMOTE_CLOSE_SOCKET) |
XX003 |
关闭远程套接字,Stream remote close socket |
重复查询编号(ERRCODE_STREAM_DUPLICATE_QUERY_ID) |
XX009 |
重复查询,Duplicate query id |
stream查询并发更新同一行(ERRCODE_STREAM_CONCURRENT_UPDATE) |
YY016 |
stream查询并发更新同一行,Stream concurrent update |
LLVM内存分配错误(ERRCODE_LLVM_BAD_ALLOC_ERROR ) |
CG003 |
内存分配错误, Allocate error |
LLVM致命错误(ERRCODE_LLVM_FATAL_ERROR) |
CG004 |
致命错误,Fatal error |
HashJoin临时文件读取错误(ERRCODE_HASHJOIN_TEMP_FILE_ERROR) |
F0011 |
临时文件读取错误,File error |
Buffer文件读取错误(ERRCODE_BUFFER_FILE_ERROR) |
F0012 |
文件读取错误,File error |
分区个数发生变化(ERRCODE_PARTITION_NUM_CHANGED) |
45003 |
在扫描LIST分区表时,发现此时的分区个数和优化阶段的分区个数不一致,一般出现在查询和ADD/DROP分区并发时。(此错误类型仅8.1.3及以上集群版本支持) |
节点间对象SCHEMA名称不一致(ERRCODE_UNMATCH_OBJECT_SCHEMA) |
42P30 |
对象SCHEMA名称不一致,Unmatched schema name |
- 数据仓库服务GaussDB(DWS)_SQL on Anywhere
- GaussDB(DWS)常用SQL_常用SQL命令_SQL语法
- 调用GaussDB(DWS) API接口_数据仓库服务调用API_如何调用API_在DWS中调用API
- 数据库监控DMS_数据库智能运维_了解Auto Pilot_DMS_DWS节点监控
- DWS安全_数据仓库服务安全_DWS数据安全管理_DWS安全保障_DWS安全策略
- GAUSS(DWS)工具_gsql工具_DataStudio工具_DSC工具
- DWS产品介绍_DWS产品优势_DWS功能_DWS使用场景_DWS是什么
- 什么是数据湖探索服务_数据湖探索DLI用途与特点
- DWS资源管理_GaussDB(DWS)资源管理作用_DWS资源管控
- GaussDB数据库常用语句_GaussDB数据库_高斯数据库常用语句