TDDL-4006 ERR_TABLE_NOT_EXIST

數據表不存在。

示例：

ERR-CODE: [TDDL-4006][ERR_TABLE_NOT_EXIST] Table '*****' doesn't exist.
            

該錯誤表示PolarDB-X 1.0數據表不存在，或者由于未知原因PolarDB-X 1.0無法加載數據表的元數據信息。

TDDL-4007 ERR_CANNOT_FETCH_TABLE_META

PolarDB-X 1.0無法加載數據表的元數據信息。

示例：

ERR-CODE: [TDDL-4007][ERR_CANNOT_FETCH_TABLE_META] Table '*****' metadata 
cannot be fetched because Table '*****.*****' doesn't exist.

該錯誤表示PolarDB-X 1.0嘗試讀取數據表的元數據信息失敗。可能的錯誤原因如下：

• 未創建數據表。
• 分庫上的表名被人為刪除或改名。
• 無法連接RDS MySQL。

出現該錯誤時，首先請檢查表名是否存在，然后確認PolarDB-X 1.0后端所有RDS MySQL狀態是否正常。

如果確定表名被人為刪除或改名，可以通過RDS MySQL的數據恢復功能修復。

TDDL-4100 ERR_ATOM_NOT_AVALILABLE

PolarDB-X 1.0后端RDS MySQL暫時不可用。

示例：

ERR-CODE: [TDDL-4100][ERR_ATOM_NOT_AVALILABLE] Atom : ***** isNotAvailable

如果PolarDB-X 1.0探測到后端某個RDS MySQL實例狀態異常，會臨時阻止訪問該實例并提示TDDL-4100錯誤。當遇到該錯誤，請檢查PolarDB-X 1.0后端所有RDS MySQL是否異常，并嘗試進行恢復。

當RDS MySQL實例從異常狀態恢復后，PolarDB-X 1.0將自動解除不可用狀態，恢復應用正常訪問。

TDDL-4101 ERR_ATOM_GET_CONNECTION_FAILED_UNKNOWN_REASON

未知原因的PolarDB-X 1.0后端連接獲取失敗。

示例：

ERR-CODE: [TDDL-4101][ERR_ATOM_GET_CONNECTION_FAILED_UNKNOWN_REASON] Get 
connection for db '*****' from pool failed. AppName:*****, Env:*****, 
UnitName:null. Message from pool: wait millis 5000, active 0, maxActive 5. 
You should look for the following logs which contains the real reason.

PolarDB-X 1.0在處理請求時會向后端RDS MySQL異步創建連接。如果無法在等待時間內完成RDS MySQL連接創建，而異步任務又尚未返回錯誤原因，PolarDB-X 1.0會向應用返回TDDL-4101錯誤。

該錯誤通常是由后端RDS MySQL異常導致的。

TDDL-4102 ERR_ATOM_GET_CONNECTION_FAILED_KNOWN_REASON

已知原因的PolarDB-X 1.0后端連接獲取失敗。

示例：

ERR-CODE: [TDDL-4102][ERR_ATOM_GET_CONNECTION_FAILED_KNOWN_REASON] Get 
connection for db '*****' failed because wait millis 5000, active 0, 
maxActive 5

PolarDB-X 1.0獲取后端RDS MySQL連接時出錯，錯誤原因已經在ERR-CODE消息中給出。

常見PolarDB-X 1.0后端連接失敗的原因如下：

• 后端RDS MySQL連接數已滿；
• RDS MySQL連接超時；
• RDS MySQL拒絕連接。

TDDL-4103 ERR_ATOM_CONNECTION_POOL_FULL

PolarDB-X 1.0后端RDS MySQL連接池已滿。

示例：

ERR-CODE: [TDDL-4103][ERR_ATOM_CONNECTION_POOL_FULL] Pool of DB '*****' is 
full. Message from pool: wait millis 5000, active 5, maxActive 5. 
AppName:*****, Env:*****, UnitName:null.

該錯誤表示PolarDB-X 1.0后端連接池已滿。導致TDDL-4103錯誤的常見原因如下：

• 應用SQL語句執行比較慢，占用單個連接的時間過長，導致連接數不夠。
• 應用端沒有關閉數據庫連接，導致連接泄露。
• 有很多跨庫查詢（例如聚合統計類查詢或未帶分庫條件的查詢）同時執行，占用大量連接。

解決方法建議如下：

• 盡量使用框架訪問數據庫，如Spring JDBC、MyBatis等。
• 按RDS性能分析報告與DBA建議優化業務SQL語句。
• 使用PolarDB-X 1.0讀寫分離將跨庫查詢轉發至讀庫處理。
• 升級更高規格的RDS實例，提升后端處理能力。

TDDL-4104 ERR_ATOM_CREATE_CONNECTION_TOO_SLOW

PolarDB-X 1.0后端RDS MySQL連接創建太慢。

示例：

ERR-CODE: [TDDL-4104][ERR_ATOM_CREATE_CONNECTION_TOO_SLOW] Get connection 
for db '*****' from pool timeout. AppName:*****, Env:*****, UnitName:null. 
Message from pool: wait millis 5000, active 3, maxActive 5.

PolarDB-X 1.0向后端RDS MySQL異步創建連接時，如果短時間內創建大量連接，或者RDS MySQL建立連接速度太慢，會出現等待超時。

該問題通常是由后端RDS MySQL壓力過大或異常導致的，建議使用PolarDB-X 1.0讀寫分離，或者升級更高規格的RDS實例，減輕后端處理壓力。

如果問題是由于短時間內創建大量連接導致，請調整PolarDB-X 1.0最小連接數。

TDDL-4105 ERR_ATOM_ACCESS_DENIED

PolarDB-X 1.0后端RDS MySQL拒絕創建連接。

示例：

ERR-CODE: [TDDL-4105][ERR_ATOM_ACCESS_DENIED] DB '*****' Access denied for 
user '*****'@'*****'. AppName:*****, Env:*****, UnitName:null. Please 
contact DBA to check.

該錯誤表明PolarDB-X 1.0通過用戶名和密碼連接RDS MySQL時被拒絕訪問。

如果不小心在后端RDS MySQL上修改了由PolarDB-X 1.0自動創建的用戶名或密碼，就會導致PolarDB-X 1.0提示TDDL-4105錯誤。修復該問題需要手工訂正PolarDB-X 1.0的用戶名或密碼。

此外，后端RDS實例欠費或到期后會拒絕所有訪問請求，也會導致PolarDB-X 1.0產生TDDL-4105錯誤。如果遇到這種情況，請及時給RDS實例續費。

TDDL-4106 ERR_ATOM_DB_DOWN

PolarDB-X 1.0后端RDS MySQL無法連接。

示例：

ERR-CODE: [TDDL-4106][ERR_ATOM_DB_DOWN] DB '*****' cannot be connected. 
AppName:*****, Env:*****, UnitName:null. It seems a very real possibility 
that this DB IS DOWN. Please contact DBA to check.

該錯誤表示PolarDB-X 1.0向后端RDS MySQL創建連接超時或沒有響應。

TDDL-4108 ERR_VARIABLE_CAN_NOT_SET_TO_NULL_FOR_NOW

變量（variable）不允許被設置為NULL。

示例：

ERR-CODE: [TDDL-4108][ERR_VARIABLE_CAN_NOT_SET_TO_NULL_FOR_NOW] System 
variable ***** can''t set to null for now;

部分MySQL變量（variable）不允許用SET var = x語句設置成NULL值。遇到這種情況，PolarDB-X 1.0會提示TDDL-4108錯誤。

如果遇到該錯誤，請檢查傳遞的變量（variable）值，并參考MySQL官方文檔改正，詳情請參見 MySQL官網。

TDDL-4200 ERR_GROUP_NOT_AVALILABLE

PolarDB-X 1.0分庫暫時不可用。

示例：

ERR-CODE: [TDDL-4200][ERR_GROUP_NOT_AVALILABLE] The TDDL Group ***** is 
running in fail-fast status, caused by this SQL:***** which threw a fatal 
exception as *****.

當分庫包含的RDS MySQL實例出現訪問異常，并且分庫下沒有其他可用實例時，PolarDB-X 1.0會將分庫置于fail-fast狀態并提示TDDL-4200錯誤。

通常該錯誤是由于RDS MySQL故障導致的。請根據包含的RDS MySQL實例異常信息定位和解決問題。當故障RDS MySQL實例恢復后，PolarDB-X 1.0將自動取消fail-fast狀態。

TDDL-4201 ERR_GROUP_NO_ATOM_AVALILABLE

PolarDB-X 1.0分庫內暫時沒有可用RDS MySQL實例。

示例：

ERR-CODE: [TDDL-4201][ERR_GROUP_NO_ATOM_AVALILABLE] All weights of DBs in 
Group '*****' is 0. Weights is: *****.

當分庫包含的RDS MySQL實例全都不可用，或者處于fail-fast狀態時，PolarDB-X 1.0會提示TDDL-4201錯誤。

通常該錯誤是由于RDS MySQL故障導致。請檢查后端RDS MySQL實例狀態以定位和解決問題。

TDDL-4202 ERR_SQL_QUERY_TIMEOUT

PolarDB-X 1.0查詢超時。

示例：

ERR-CODE: [TDDL-4202][ERR_SQL_QUERY_TIMEOUT] Slow query leads to a timeout 
exception, please contact DBA to check slow sql. SocketTimout:*** ms, 
Atom:*****, Group:*****, AppName:*****, Env:*****, UnitName:null.

該錯誤表示SQL語句在后端RDS MySQL實例上的執行時間超過PolarDB-X 1.0設置的socketTimeout參數限制。默認的PolarDB-X 1.0超時（socketTimeout）時間設置是900秒。

建議優化SQL語句，以及在后端RDS MySQL上創建適合的索引以提升SQL語句的執行性能。

如果優化后的SQL語句仍然執行較慢，可以參考如下PolarDB-X 1.0 Hint語法臨時設置超時時間：

/*TDDL:SOCKET_TIMEOUT=900000*/ SELECT * FROM dual;

其中SOCKET_TIMEOUT設置的單位是毫秒。

關于PolarDB-X 1.0 Hint，詳情請參見自定義SQL超時時間。

TDDL-4203 ERR_SQL_QUERY_MERGE_TIMEOUT

分布式查詢超時。

示例：

ERR-CODE: [TDDL-4203][ERR_SQL_QUERY_MERGE_TIMEOUT] Slow sql query leads to 
a timeout exception during merging results, please optimize the slow sql. 
The the default timeout is *** ms. DB is *****

PolarDB-X 1.0執行分布式查詢超時，默認的超時設置是900秒。

產生TDDL-4203錯誤表示SQL語句掃描了多個分庫的數據并且執行時間超過900秒，建議進行如下優化：

• 盡量在WHERE條件中添加分庫鍵（Sharding key）條件，將SQL語句優化成單庫執行。
• 檢查是否可以在后端RDS MySQL上創建適合的索引，提升掃描各個分庫數據的性能。
• 設法消除分布式查詢中的跨庫JOIN，數據重排序等耗時操作，降低數據合并階段的消耗。

如果優化后的SQL語句仍然執行較慢，可以使用下面的Hint語法臨時設置PolarDB-X 1.0的超時時間：

/*TDDL:SOCKET_TIMEOUT=900000*/ SELECT * FROM dual;

其中SOCKET_TIMEOUT設置的單位是毫秒。

關于PolarDB-X 1.0 Hint，詳情請參見自定義SQL超時時間。

TDDL-4400 ERR_SEQUENCE

處理Sequence（全局唯一序列）失敗。

示例：

ERR-CODE: [TDDL-4400][ERR_SEQUENCE] Sequence : All dataSource faild to get 
value!

該錯誤表示處理Sequence出錯，錯誤信息在Sequence :中給出。

導致該錯誤的常見原因是RDS MySQL故障，無法訪問Sequence有關的數據表。建議先檢查后端RDS MySQL狀態。

TDDL-4401 ERR_MISS_SEQUENCE

Sequence不存在。

示例：

ERR-CODE: [TDDL-4401][ERR_MISS_SEQUENCE] Sequence '*****' is not found

命令中使用的Sequence名稱不存在。建議用SHOW SEQUENCES命令檢查PolarDB-X 1.0中所有已創建的Sequence名稱，并且選擇正確的Sequence名稱。

如果使用的Sequence尚不存在，可以用CREATE SEQUENCE語法創建：

CREATE SEQUENCE <sequence name> [ START WITH <numeric value> ] 
[ INCREMENT BY <numeric value> ] [ MAXVALUE <numeric value> ] 
[ CYCLE | NOCYCLE ]` 

關于Sequence，詳情請參見Sequence。

TDDL-4403 ERR_MISS_SEQUENCE_TABLE_ON_DEFAULT_DB

Sequence使用的數據表不存在。

示例：

ERR-CODE: [TDDL-4403][ERR_MISS_SEQUENCE_TABLE_ON_DEFAULT_DB] Sequence table 
is not in default db.

無法在后端的數據庫里訪問名稱為sequence或者sequence_opt的數據表。

TDDL-4404 ERR_SEQUENCE_TABLE_META

Sequence數據表結構錯誤。

示例：

ERR-CODE: [TDDL-4404][ERR_SEQUENCE_TABLE_META] the meta of sequence table 
is error, some columns missed

Sequence相關數據表（如sequence或sequence_opt）中缺少相應的字段。

TDDL-4405 ERR_INIT_SEQUENCE_FROM_DB

初始化Sequence錯誤。

示例：

ERR-CODE: [TDDL-4405][ERR_INIT_SEQUENCE_FROM_DB] init sequence manager 
error: *****

在初始化需要訪問的Sequence時出錯，錯誤信息在init sequence manager error:后給出。

建議先檢查后端RDS MySQL狀態。

TDDL-4407 ERR_OTHER_WHEN_BUILD_SEQUENCE

訪問Sequence數據表出錯。

示例：

ERR-CODE: [TDDL-4407][ERR_OTHER_WHEN_BUILD_SEQUENCE] error when build 
sequence: *****

在訪問Sequence相關數據表（如sequence 或 sequence_opt）時發生錯誤。錯誤信息在error when build sequence:后給出。

建議先檢查后端RDS MySQL狀態。

DDL-4408 ERR_SEQUENCE_NEXT_VALUE

獲取Sequence值出錯。

示例：

ERR-CODE: [TDDL-4408][ERR_SEQUENCE_NEXT_VALUE] error when get sequence's 
next value, sequence is: *****, error: *****

使用PolarDB-X 1.0自增主鍵，或者使用<sequence name>.NEXTVAL語法手工獲取全局唯一ID時發生錯誤。錯誤原因在error:提示后給出。

產生TDDL-4408錯誤的原因一般來自后端的RDS MySQL故障。建議先檢查后端RDS MySQL狀態和訪問壓力。

TDDL-4500 ERR_PARSER

解析SQL語句失敗。

示例：

ERR-CODE: [TDDL-4500][ERR_PARSER] not support statement: '*****'

PolarDB-X 1.0支持符合SQL-92標準的SQL語法，以及MySQL支持的語法擴展與函數。請檢查執行的SQL語句是否符合PolarDB-X 1.0兼容的SQL語法標準及MySQL規范。

關于SQL標準語法，請參見SQL標準語法。

關于PolarDB-X 1.0兼容的SQL語法，請參見SQL使用限制。

TDDL-4501 ERR_OPTIMIZER

優化器轉換SQL語句失敗。

示例：

ERR-CODE: [TDDL-4501][ERR_OPTIMIZER] optimize error by: Unknown column 
'*****' in 'order clause'

PolarDB-X 1.0優化器的工作是轉換SQL語句到內部語法樹。如果SQL語句中出現邏輯錯誤，優化器轉換就會失敗，產生TDDL-4501錯誤。

建議按照optimize error by:后的提示檢查和調整您的SQL語句。

TDDL-4502 ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT

ORDER BY包含的函數列在SELECT子句中不存在。

示例：

ERR-CODE: [TDDL-4502][ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT] Syntax 
Error: orderBy/GroupBy Column ***** is not existed in select clause` 

當SQL語句中的ORDER BY子句包含函數列（例如RAND（））時，PolarDB-X 1.0要求同樣的函數列必須也在SELECT子句中出現，否則提示TDDL-4502錯誤。

建議在SELECT子句中添加相應的函數列。

TDDL-4504 ERR_OPTIMIZER_SELF_CROSS_JOIN

相同表JOIN的條件不足。

示例：

ERR-CODE: [TDDL-4504][ERR_OPTIMIZER_SELF_CROSS_JOIN] self cross join case, 
add shard column filter on right table

PolarDB-X 1.0在執行相同表的JOIN時，如果WHERE子句只包含其中一張左表（或右表）的拆分字段（sharding column）條件，會提示TDDL-4504錯誤。

建議調整SQL語句，在WHERE子句中補全JOIN左表（或右表）的拆分字段條件。

TDDL-4506 ERR_MODIFY_SHARD_COLUMN

禁止更新拆分鍵。

示例：

ERR-CODE: [TDDL-4506][ERR_MODIFY_SHARD_COLUMN] Column '*****' is a sharding 
key of table '*****', which is forbidden to be modified.

PolarDB-X 1.0禁止使用UPDATE語句修改拆分鍵（sharding key）的值。由于更新操作很可能會改變數據所在的分片，PolarDB-X 1.0無法保證操作的原子性與數據的一致性。

建議將對應UPDATE語句修改為相同效果的INSERT+DELETE語句。

TDDL-4508 ERR_OPTIMIZER_NOT_ALLOWED_SORT_MERGE_JOIN

無法執行合并排序JOIN。

示例：

ERR-CODE: [TDDL-4508][ERR_OPTIMIZER_NOT_ALLOWED_SORT_MERGE_JOIN] sort merge 
join is not allowed when missing equivalent filter

如果SQL語句中需要JOIN的數據表分別來自不同的RDS MySQL實例，PolarDB-X 1.0會優先選擇合并排序（Sort-merge Join）算法。該算法要求JOIN的左表與右表必須包含字段相等的關聯條件，否則將提示TDDL-4508錯誤。

建議調整SQL語句，在JOIN或WHERE部分添加相應的關聯條件。

TDDL-4509 ERR_OPTIMIZER_ERROR_HINT

Hint語法錯誤。

示例：

ERR-CODE: [TDDL-4509][ERR_OPTIMIZER_ERROR_HINT] Hint Syntax Error: 
unexpected operation: *****.

該錯誤表示SQL語句中的Hint語法無法被PolarDB-X 1.0解析。更多關于Hint語法信息，請參見Hint簡介。

TDDL-4510 ERR_CONTAINS_NO_SHARDING_KEY

缺少拆分鍵（sharding key）條件。

示例：

ERR-CODE: [TDDL-4510][ERR_CONTAINS_NO_SHARDING_KEY] Your SQL contains NO 
SHARDING KEY '*****' for table '*****', which is not allowed in DEFAULT.

如果PolarDB-X 1.0拆分表沒有開啟全表掃描（full-table scan）功能，則訪問該表時必須在WHERE子句中包含拆分鍵條件。否則，將提示TDDL-4510錯誤。

PolarDB-X 1.0在建表時默認開啟全表掃描功能。如果手工關閉全表掃描，建議確認與該表有關的SQL語句都已添加拆分鍵條件。

TDDL-4511 ERR_INSERT_CONTAINS_NO_SHARDING_KEY

INSERT語句缺少拆分鍵 (sharding key)。

示例：

ERR-CODE: [TDDL-4511][ERR_INSERT_CONTAINS_NO_SHARDING_KEY] Your INSERT SQL 
contains NO SHARDING KEY '*****' for table '*****'.

當INSERT語句的目標是一張PolarDB-X 1.0拆分表時，必須在插入數據中包含拆分鍵的值（拆分鍵是自增主鍵例外）。否則，將提示TDDL-4511錯誤。

如果遇到該錯誤，建議修改INSERT語句補充缺少的拆分鍵值。

TDDL-4515 ERR_CONNECTION_CHARSET_NOT_MATCH

輸入字符集不匹配。

示例：

ERR-CODE: [TDDL-4515][ERR_CONNECTION_CHARSET_NOT_MATCH] Caused by MySQL's 
character_set_connection doesn't match your input charset. Partition DDL can 
only take ASCII or chinese column name. If you want use chinese table or 
column name, Make sure MySQL connection's charset support chinese character. 
Use "set names xxx" to set correct charset.

PolarDB-X 1.0支持用中文字符命名表名及字段名。在執行含有中文字符的SQL語句時，如果數據庫連接的字符集設置（character_set_connection）不支持中文（如 latin1），會提示TDDL-4515錯誤。

您可以使用SHOW VARIABLES LIKE 'character_set_connection'查詢MySQL客戶端當前的連接字符集，使用SET NAMES x命令修改當前連接字符集。如果是Java程序JDBC方式連接PolarDB-X 1.0，請設置數據庫連接參數characterEncoding。

TDDL-4516 ERR_TRUNCATED_DOUBLE_VALUE_OVERFLOW

浮點數轉換為整數溢出。

示例：

ERR-CODE: [TDDL-4516][ERR_TRUNCATED_DOUBLE_VALUE_OVERFLOW] Truncated 
incorrect DOUBLE value '*****' over column[*****]'s value range.

PolarDB-X 1.0將浮點數轉換成對應類型的整數時，結果超過了整數類型的取值范圍。建議檢查SQL語句中的字段類型和輸入參數。

TDDL-4517 ERR_MODIFY_SYSTEM_TABLE

禁止修改系統表。

示例：

ERR-CODE: [TDDL-4517][ERR_MODIFY_SYSTEM_TABLE] Table '*****' is PolarDB-XSYSTEM 
TABLE, which is forbidden to be modified.

PolarDB-X 1.0內部維護了一些系統表，使用SQL語句更新其中的數據會提示TDDL-4517錯誤。

限制的系統表包括sequence、sequence_opt、txc_undo_log和__DRDS__SYSTEM__LOCK__，請避免在業務或數據庫設計中使用這些表名。

TDDL-4518 ERR_VALIDATE

元數據校驗失敗。

示例：

ERR-CODE: [TDDL-4518][ERR_VALIDATE] Object 'optest1' not found

SQL發送到PolarDB-X 1.0計算節點上，會基于現有的元信息做校驗，這個異常說明查詢的表或者列等信息不符合現有元信息要求。

TDDL-4600 ERR_FUNCTION

錯誤的函數調用。

示例：

ERR-CODE: [TDDL-4600][ERR_FUNCTION] function compute error by Incorrect 
parameter count in the call to native function '*****'

該錯誤表明在SQL語句中使用了錯誤的語法或參數調用函數。建議仔細檢查SQL語句中的函數調用部分，并且使用正確的參數個數和類型調用函數。

TDDL-4601 ERR_EXECUTOR

SQL執行過程出錯。

示例：

ERR-CODE: [TDDL-4601][ERR_EXECUTOR] only one column is supported in 
distinct aggregate

該錯誤代表PolarDB-X 1.0在執行SQL語句過程中出現了意外錯誤。這類錯誤通常與后端RDS MySQL異常狀態有關。

TDDL-4602 ERR_CONVERTOR

錯誤的類型轉換。

示例：

ERR-CODE: [TDDL-4602][ERR_CONVERTOR] convertor error by Unsupported convert: 
[*****]

該錯誤表明PolarDB-X 1.0在執行SQL時進行數據類型轉換失敗。請檢查SQL語句中是否存在需要隱式類型轉換的數據，并且盡量使用相同類型進行比較和計算。

TDDL-4603 ERR_ACCROSS_DB_TRANSACTION

跨庫事務失敗。

示例：

ERR-CODE: [TDDL-4603][ERR_ACCROSS_DB_TRANSACTION] Transaction accross db is 
not supported in current transaction policy, transaction node is: {0}, but 
this sql execute on: *****.

PolarDB-X 1.0默認僅支持單庫事務，即事務中的所有SQL語句都必須按規則轉發到相同RDS MySQL分庫執行。否則，將提示TDDL-4603錯誤。

TDDL-4604 ERR_CONCURRENT_TRANSACTION

嵌套事務失敗。

示例：

ERR-CODE: [TDDL-4604][ERR_CONCURRENT_TRANSACTION] Concurrent query is not 
supported on transaction group, transaction group is: {0}.

PolarDB-X 1.0不支持嵌套事務，如果在同一個數據庫連接里嘗試同時開啟2個以上事務，將提示TDDL-4604錯誤。

建議在應用開發時避免使用嵌套事務，或者使用應用層的事務框架防止產生嵌套事務。

TDDL-4606 ERR_QUERY_C

當前執行的SQL被取消。

示例：

ERR-CODE: [TDDL-4606][ERR_QUERY_CANCLED] Getting connection is not allowed 
when query has been cancled, group is *****

使用KILL x取消某條正在執行的SQL語句時，被取消的SQL語句會返回該錯誤。如果經常出現這一情況，請排查是否有客戶端或程序在執行KILL命令。

TDDL-4607 ERR_INSERT_WHEN_UPDATE

以INSERT DELETE方式執行UPDATE語句時出錯。

示例：

ERR-CODE: [TDDL-4607][ERR_INSERT_WHEN_UPDATE] Insert new values error, 
table is: *****, old Values: *****, new Values: *****

開啟允許更新分庫鍵（Sharding-key）功能后，PolarDB-X 1.0可以將UPDATE分庫鍵值的SQL語句按照INSERT+DELETE方式轉換執行。如果執行失敗，則提示TDDL-4607錯誤。

該錯誤通常是因為后端RDS MySQL故障導致的。建議首先檢查RDS MySQL狀態。

TDDL-4610 ERR_CONNECTION_CLOSED

連接已經關閉。

示例：

ERR-CODE: [TDDL-4610][ERR_CONNECTION_CLOSED] connection has been closed

當事務中的SQL語句執行出錯，或者被KILL命令取消后，重復使用同一個數據庫連接執行其他SQL語句會提示TDDL-4610錯誤。

建議在該情況下關閉連接，重新獲取一個新的數據庫連接。

TDDL-4636 ERR_DDL_JOB_ERROR

DDL語句執行失敗。

示例：

ERR-CODE: [PXC-4636][ERR_DDL_JOB_ERROR] xxxx

該錯誤碼表示DDL語句執行失敗，處理方法請參見如何處理DDL異常。

TDDL-4642 ERR_UNKNOWN_TABLE

數據庫中不存在這張表。

示例：

ERR-CODE: [PXC-4642][ERR_UNKNOWN_TABLE] Unknown table XX.XX

請檢查當前數據庫中是否有這張表。

TDDL-1305 ERR_UNKNOWN_SAVEPOINT

指定名稱的SAVEPOINT不存在。

示例：

ERR-CODE: [TDDL-1305][ERR_UNKNOWN_SAVEPOINT] SAVEPOINT ***** does not exist

在PolarDB-X 1.0上執行ROLLBACK TO SAVEPOINT x或者RELEASE SAVEPOINT x命令時，如果指定的SAVEPOINT名稱不存在，會提示TDDL-1305錯誤。

建議檢查SAVEPOINT命令返回的名稱是否和使用的名稱一致。

TDDL-1094 ERR_UNKNOWN_THREAD_ID

KILL命令指定的會話ID不存在。

示例：

ERR-CODE: [TDDL-1094][ERR_UNKNOWN_THREAD_ID] Unknown thread id: *****

在PolarDB-X 1.0上執行KILL x命令取消執行的SQL語句時，如果指定的會話ID不存在，或者對應的SQL語句已經結束執行，會提示TDDL-1094錯誤。

建議使用SHOW PROCESSLIST命令查看正在執行的SQL語句會話ID，并只使用返回的ID執行KILL操作。

TDDL-4612 ERR_CHECK_SQL_PRIV

由于權限不夠，SQL語句無法執行。

示例：

ERR-CODE: [TDDL-4612][ERR_CHECK_SQL_PRIV] check user ***** on db ***** sql 
privileges failed.

PolarDB-X 1.0支持賬號和授權，類似MySQL賬號權限體系，只有擁有對應類型權限的賬號才能執行該SQL語句。如果賬號權限不足，PolarDB-X 1.0將提示TDDL-4612錯誤。

建議檢查用戶擁有的PolarDB-X 1.0權限。如果權限不足，請在PolarDB-X 1.0控制臺設置。

TDDL-4613 ERR_INSERT_SELECT

執行INSERT ... SELECT語句出錯。

示例：

ERR-CODE: [TDDL-4613][ERR_INSERT_SELECT] insert error, table is: *****,
values: *****

PolarDB-X 1.0支持將跨庫的INSERT ... SELECT語句拆分成獨立的SELECT和INSERT語句批量執行。如果執行失敗，則提示TDDL-4613錯誤。

該錯誤通常是因為后端RDS MySQL故障導致的。建議首先檢查RDS MySQL狀態。

TDDL-4614 ERR_EXECUTE_ON_MYSQL

SQL語句在RDS MySQL上執行報錯。

示例：

ERR-CODE: [TDDL-4614][ERR_EXECUTE_ON_MYSQL] Error occurs when execute on GROUP '*****': Duplicate entry '*****' for key 'PRIMARY'

建議參考TDDL-4614提供的原始錯誤信息排查問題。更多關于SQL語句錯誤信息請參見MySQL(5.6)文檔。

TDDL-4615 ERR_CROSS_JOIN_SIZE_PROTECTION

分布式JOIN返回的數據行數超出限制。

示例：

ERR-CODE: [TDDL-4615][ERR_CROSS_JOIN_SIZE_PROTECTION] across join table size protection, check your sql or enlarge the limination size .

當PolarDB-X 1.0以嵌套循環（Nested-loop）方式執行分布式JOIN語句時，如果從右表返回大量數據，將嚴重占據內存，影響PolarDB-X 1.0服務的穩定性。因此，PolarDB-X 1.0限制這種情況下右表返回的數據行數最多不能超過5000。如果超出這一限制，PolarDB-X 1.0會提示TDDL-4615錯誤。

建議優化SQL語句避免從右表返回大量數據，或者讓PolarDB-X 1.0能夠使用更好的算法（如合并排序Sort-merge Join）執行分布式JOIN。

TDDL-4616 ERR_UNKNOWN_DATABASE

錯誤的數據庫。

示例：

ERR-CODE: [TDDL-4616][ERR_UNKNOWN_DATABASE] Unknown database '*****'

PolarDB-X 1.0允許在DDL語句中指定數據庫名稱。如果指定的數據庫名稱與PolarDB-X 1.0提供的數據庫名稱不一致，將返回TDDL-4616錯誤。

建議修改DDL語句中的數據庫名稱，確保與PolarDB-X 1.0數據庫名稱一致。

TDDL-4617 ERR_SUBQUERY_LIMIT_PROTECTION

子查詢返回的數據行數超出限制。

示例：

ERR-CODE: [TDDL-4617][ERR_SUBQUERY_LIMIT_PROTECTION] The number of rows returned by the subquery exceeds the maximum number of 20000.

當PolarDB-X 1.0執行含子查詢（Sub-query）的SQL語句時，如果子查詢返回大量數據，會嚴重占據內存，影響PolarDB-X 1.0服務的穩定性。因此，PolarDB-X 1.0限制這種情況下子查詢返回的數據行數最多不能超過20000。如果超出這一限制，PolarDB-X 1.0會返回TDDL-4617錯誤。

建議優化SQL語句中的子查詢避免返回大量數據。或者設法將子查詢改寫成JOIN形式，讓PolarDB-X 1.0能夠使用更好的算法（如合并排序Sort-merge Join）執行。

TDDL-4800 ERR_SET_TXCID

執行SET TXC_ID x命令失敗。

示例：

ERR-CODE: [TDDL-4800][ERR_SET_TXCID] set txc_id failed: *****

具體原因請參見GTS文檔什么是全局事務服務GTS。

TDDL-4801 ERR_TXCID_NULL

執行SELECT LAST_TXC_ID返回NULL。

示例：

ERR-CODE: [TDDL-4801][ERR_TXCID_NULL] txc_xid is null: *****

具體原因請參見GTS文檔什么是全局事務服務GTS。

TDDL-4802 ERR_SELECT_LAST_TXCID

執行SELECT LAST_TXC_ID命令失敗。

示例：

ERR-CODE: [TDDL-4802][ERR_SELECT_LAST_TXCID] select last_txc_xid failed: *****

具體原因請參見GTS文檔什么是全局事務服務GTS。

TDDL-4994 ERR_FLOW_CONTROL

流量控制。

示例：

ERR-CODE: [TDDL-4994][ERR_FLOW_CONTROL] [*****] flow control by *****

該錯誤代表PolarDB-X 1.0處理SQL請求已達到內部流量上限，當前請求被拒絕。

建議檢查SQL請求量是否存在異常峰值。

TDDL-4998 ERR_NOT_SUPPORT

不支持的特性。

示例：

ERR-CODE: [TDDL-4998][ERR_NOT_SUPPORT] ***** not support yet!

該錯誤表示使用的SQL語法或者功能PolarDB-X 1.0尚不支持。

TDDL-5001 ERR_TRANS

一般性的事務錯誤。

示例：

ERR-CODE: [TDDL-5001][ERR_TRANS] Too many lines updated in statement.

請參考錯誤信息處理，Too many lines updated in statement表示事務中的UPDATE語句更新行數超出限制（1000），建議檢查UPDATE語句的WHERE條件。如果需要在事務中執行大批量數據更新，可以使用PolarDB-X 1.0 Hint語句/*TDDL:UNDO_LOG_LIMIT={number}*/調整限制值。

Deferred execution is only supported in Flexible or XA Transaction表示后置執行功能僅僅在柔性事務與XA事務策略下可用。在用PolarDB-X 1.0 Hint語句/*TDDL:DEFER*/提交后置執行語句之前，請先用SET drds_transaction_policy = ***命令更改事務策略。

TDDL-5002 ERR_TRANS_UNSUPPORTED

事務中的語法或功能尚不支持。

示例：

ERR-CODE: [TDDL-5002][ERR_TRANS_UNSUPPORTED] Table without primary keys is not
supported.

TDDL-5003 ERR_TRANS_LOG

無法訪問事務日志。

示例：

ERR-CODE: [TDDL-5003][ERR_TRANS_LOG] Failed to update transaction state: *****

為保證分布式事務的原子性，PolarDB-X 1.0在事務中會訪問后端RDS MySQL上的事務日志。如果PolarDB-X 1.0在讀寫事務日志時出錯，將返回TDDL-5003錯誤。

產生TDDL-5003錯誤的原因通常來自后端的RDS MySQL故障。建議檢查PolarDB-X 1.0后端RDS MySQL狀態和訪問壓力。

TDDL-5004 ERR_TRANS_NOT_FOUND

事務ID不存在。

ERR-CODE: [TDDL-5008][ERR_TRANS_TERMINATED] Current transaction was killed 
or timeout. You may need to set a longer timeout value.          

如果事務在執行中被Kill或者超時（執行時間超出drds_transaction_timeout值），則出現該錯誤。

如果是事務超時導致報錯，建議使用SET drds_transaction_timeout = ***命令修改事務的執行時間上限，單位是毫秒。

TDDL-5006 ERR_TRANS_COMMIT

事務提交過程中出錯。

ERR-CODE: [TDDL-5006][ERR_TRANS_COMMIT] Failed to commit primary group *****: 
*****, TRANS_ID = ***** 

PolarDB-X 1.0在提交事務分支過程中出錯，TRANS_ID對應的事務將被自動回滾。

產生TDDL-5006錯誤的原因通常來自后端的RDS MySQL故障。建議檢查PolarDB-X 1.0后端RDS MySQL狀態和訪問壓力。

TDDL-5007 ERR_TRANS_PARAM

事務參數不正確。

ERR-CODE: [TDDL-5007][ERR_TRANS_PARAM] Illegal timeout value: ***** 

命令中指定事務參數不正確，例如SET drds_transaction_timeout = ***指定的參數值是負數。

TDDL-5008 ERR_TRANS_TERMINATED

事務已Kill或超時中止。

ERR-CODE: [TDDL-5008][ERR_TRANS_TERMINATED] Current transaction was killed 
or timeout. You may need to set a longer timeout value.             

如果事務在執行中被Kill或者超時（執行時間超出drds_transaction_timeout值），則出現該錯誤。

如果是事務超時導致報錯，建議使用SET drds_transaction_timeout = ***事務的執行時間上限，單位是毫秒。