錯誤碼

PXC-1305 ERR_UNKNOWN_SAVEPOINT

• 描述：指定名稱的SAVEPOINT不存在。
• 示例：

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

• 說明：在PolarDB-X上執行

  ROLLBACK TO SAVEPOINT

  或者

  RELEASE SAVEPOINT

  指令時，如果指定的SAVEPOINT名稱不存在，會提示PXC-1305錯誤。建議檢查SAVEPOINT指令傳回的名稱是否和使用的名稱一緻。

PXC-1094 ERR_UNKNOWN_THREAD_ID

• 描述：KILL指令指定的會話ID不存在。

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

• KILL

  指令取消執行的SQL語句時，如果指定的會話ID不存在，或者對應的SQL語句已經結束執行，會提示PXC-1094錯誤。建議使用

  SHOW PROCESSLIST

  指令檢視正在執行的SQL語句會話ID，并隻針對傳回的ID執行

  KILL

  指令。

PXC-4006 ERR_TABLE_NOT_EXIST

• 描述：PolarDB-X資料表不存在。

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

• 說明：該錯誤碼表示PolarDB-X資料表不存在，或者由于未知原因，PolarDB-X無法加載資料表的中繼資料資訊。

PXC-4007 ERR_CANNOT_FETCH_TABLE_META

• 描述：PolarDB-X無法加載資料表的中繼資料資訊。

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

• 說明：該錯誤碼表示PolarDB-X嘗試讀取資料表的中繼資料資訊失敗。可能的錯誤原因如下：

• • 資料表未建立。
  • 維護的中繼資料庫資訊不一緻。
  • 表被删除或者改名。

• 出現該錯誤時，首先檢查表名是否存在，或者執行

  check table

  指令确認PolarDB-X維護的中繼資料庫資訊是否一緻。如果确定表被人為删除或改名，可以通過PolarDB-X提供的資料恢複功能修複。如果仍無法修複，請聯系技術支援。

PXC-4018 ERR_INVALID_DDL_PARAMS

• 描述：PolarDB-X執行DDL過程失敗。

• ERR-CODE: [PXC-4018][ERR_INVALID_DDL_PARAMS] invalid '*****'.

• 說明：該錯誤表示使用者執行DDL的參數有錯誤，請檢查參數正确性。如果确認參數正确，請聯系技術支援。

PXC-4100 ERR_ATOM_NOT_AVALILABLE

• 描述：PolarDB-X後端資料節點暫時不可用。

• ERR-CODE: [PXC-4100][ERR_ATOM_NOT_AVALILABLE] Atom : ***** isNotAvailable

• 說明：如果PolarDB-X探測到後端某個資料節點狀态異常，會臨時阻止通路該執行個體并提示PXC-4100錯誤。當遇到該錯誤，請檢查PolarDB-X後端所有資料節點是否異常。當後端資料節點從異常狀态恢複後，PolarDB-X将自動解除不可用狀态，恢複應用正常通路。

PXC-4101 ERR_ATOM_GET_CONNECTION_FAILED_UNKNOWN_REASON

• 描述：PolarDB-X計算節點和資料節點連接配接擷取失敗。

• ERR-CODE: [PXC-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在處理請求時會向資料節點異步建立連接配接。如果無法在等待時間内完成資料節點連接配接建立，而異步任務又尚未傳回錯誤原因，PolarDB-X會向應用傳回PXC-4101錯誤。該錯誤通常是由後端資料節點異常導緻的。如果排除資料節點問題後仍然出現該錯誤，請聯系技術支援。

PXC-4102 ERR_ATOM_GET_CONNECTION_FAILED_KNOWN_REASON

• 描述：已知原因的PolarDB-X後端連接配接擷取失敗。

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

• 說明：PolarDB-X計算節點擷取資料節點連接配接時出錯，錯誤原因已經在ERR-CODE消息中給出。常見PolarDB-X資料節點連接配接失敗的原因如下：

• • 後端資料節點連接配接數已滿
  • 計算節點到資料節點的連接配接逾時
  • 資料節點拒絕連接配接

• 如果排除後端資料節點問題後仍然出現該錯誤，請聯系技術支援。

PXC-4103 ERR_ATOM_CONNECTION_POOL_FULL

• 描述：PolarDB-X後端資料節點連接配接池已滿。

• ERR-CODE: [PXC-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後端連接配接池已滿。導緻PXC-4103錯誤的常見原因如下：

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

• 解決方法建議如下：

• • 盡量使用架構通路資料庫，如Spring JDBC、MyBatis等；
  • 按性能分析報告與DBA建議優化業務SQL語句；
  • 使用PolarDB-X讀寫分離将跨庫查詢轉發至讀庫處理；
  • 更新更高規格的PolarDB-X，提升後端處理能力；
  • 聯系技術支援調整PolarDB-X後端連接配接數。

PXC-4104 ERR_ATOM_CREATE_CONNECTION_TOO_SLOW

• 描述：PolarDB-X後端資料節點連接配接建立太慢。

• ERR-CODE: [PXC-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向後端資料節點異步建立連接配接時，如果在短時間建立大量連接配接，或者資料節點建立連接配接速度太慢，會出現等待逾時。該問題通常是由于後端資料節點壓力過大或異常導緻的，建議使用PolarDB-X讀寫分離，或者更新更高規格，減輕後端處理壓力。如果排除後端資料節點問題後仍然出現該錯誤，請聯系技術支援。如果問題是由短時間建立大量連接配接導緻，建議聯系技術支援調整PolarDB-X最小連接配接數。

PXC-4105 ERR_ATOM_ACCESS_DENIED

• 描述：PolarDB-X後端資料節點拒絕建立連接配接。

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

• 說明：該錯誤表明PolarDB-X通過使用者名和密碼連接配接資料節點時被拒絕通路，請聯系技術支援。

PXC-4106 ERR_ATOM_DB_DOWN

• 描述：PolarDB-X後端資料節點無法連接配接。

• ERR-CODE: [PXC-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向後端資料節點建立連接配接逾時或者沒有響應。遇到該錯誤的通常原因是資料節點故障，請聯系技術支援。

PXC-4108 ERR_VARIABLE_CAN_NOT_SET_TO_NULL_FOR_NOW

• 描述：變量（variable）不允許被設定為NULL。

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

• 說明：有些資料節點變量（variable）不允許用

  SET var = x

  語句設定成NULL值。遇到這種情況，PolarDB-X會提示PXC-4108錯誤。

PXC-4200 ERR_GROUP_NOT_AVALILABLE

• 描述：PolarDB-X下的某個資料節點暫時不可用。

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

• 說明：當分庫包含的資料節點出現通路異常，并且分庫下沒有其他可用資料節點時，PolarDB-X會将分庫置于fail-fast狀态并提示PXC-4200錯誤。通常該錯誤是由于資料節點故障導緻的。請根據包含的資料節點異常資訊定位和解決問題。當故障資料節點恢複後，PolarDB-X将自動取消fail-fast狀态。

  如果資料節點故障解決後仍然出現PXC-4200錯誤，請聯系技術支援。

PXC-4201 ERR_GROUP_NO_ATOM_AVALILABLE

• 描述：PolarDB-X分庫内暫時沒有可用資料節點。

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

• 說明：當分庫包含的資料節點全都不可用，或者處于fail-fast狀态時，PolarDB-X會提示PXC-4201錯誤。通常該錯誤是由于資料節點故障導緻的。請檢查後端資料節點狀态以定位和解決問題。如果故障解決後仍然出現PXC-4201錯誤，請聯系技術支援。

PXC-4202 ERR_SQL_QUERY_TIMEOUT

• 描述：PolarDB-X查詢逾時。

• ERR-CODE: [PXC-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語句在後端資料節點上的執行時間超過PolarDB-X設定的socketTimeout參數限制。預設的PolarDB-X逾時（socketTimeout）時間設定是900秒。建議優化SQL語句，以及在後端資料節點上建立适合的索引以提升SQL語句的執行性能。如果優化後的SQL語句仍然較慢，可以參見如下Hint文法臨時設定PolarDB-X的逾時時間：

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

  ，其中SOCKET_TIMEOUT設定的機關是毫秒。關于PolarDB-X的Hint用法，詳情請參見 自定義SQL逾時時間 。如果需要永久調整PolarDB-X逾時設定，請聯系技術支援。

PXC-4203 ERR_SQL_QUERY_MERGE_TIMEOUT

• 描述：PolarDB-X分布式查詢逾時。

• ERR-CODE: [PXC-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執行分布式查詢逾時，預設的逾時設定是900秒。産生PXC-4203錯誤表示SQL語句掃描了多個分庫的資料并且執行時間超過900秒。建議進行如下優化：

• • 在WHERE條件中添加分庫鍵（Sharding key）條件，将SQL語句優化成單庫執行；
  • 檢查是否可以在後端資料節點上建立适合的索引，提升掃描各個分庫資料的性能；
  • 設法消除分布式查詢中的跨庫JOIN，資料重排序等耗時操作，降低PolarDB-X資料合并階段的消耗。

• 如果優化後的SQL語句仍然較慢，可以使用如下Hint文法臨時設定PolarDB-X的逾時時間：

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

  自定義SQL逾時時間。

PXC-4400 ERR_SEQUENCE

• 描述：處理Sequence（全局唯一序列）失敗。

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

• 說明：處理Sequence出錯，錯誤資訊在

  Sequence :

  中給出。導緻PXC-4400的常見原因是資料節點故障，無法通路Sequence有關的資料表。建議先檢查後端資料節點狀态。如果排除資料節點故障後仍然發生錯誤，請聯系技術支援。

PXC-4401 ERR_MISS_SEQUENCE

• 描述：Sequence不存在。

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

• 說明：指令中使用的Sequence名稱不存在。建議用

  SHOW SEQUENCES

  指令檢查PolarDB-X中所有已建立的Sequence名稱，并且選擇正确的Sequence使用。如果使用的Sequence尚不存在，可以用如下語句建立：

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

• 如果使用的Sequence已經存在，但是仍然提示PXC-4401錯誤，請聯系技術支援。關于PolarDB-X的Sequence用法，詳情請參見 PolarDB-X Sequence介紹 。

PXC-4403 ERR_MISS_SEQUENCE_TABLE_ON_DEFAULT_DB

• 描述：Sequence使用的資料表不存在。

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

• 說明：無法在PolarDB-X後端的資料庫裡通路名稱叫sequence或者sequence_opt的資料表，請聯系技術支援。

PXC-4404 ERR_SEQUENCE_TABLE_META

• 描述：Sequence資料表結構錯誤。

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

• 說明：Sequence相關資料表（如sequence或sequence_opt）中缺少相應的字段，請聯系技術支援。

PXC-4405 ERR_INIT_SEQUENCE_FROM_DB

• 描述：初始化Sequence錯誤。

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

• 說明：初始化需要通路的Sequence時出錯，錯誤資訊在init sequence manager error:後給出。建議先檢查PolarDB-X後端資料節點狀态。如果排除資料節點故障後仍然提示PXC-4405錯誤，請聯系技術支援。

PXC-4407 ERR_OTHER_WHEN_BUILD_SEQUENCE

• 描述：通路Sequence資料表出錯。

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

• 說明：在通路Sequence相關資料表（如sequence或sequence_opt）時發生錯誤。錯誤資訊在error when build sequence:後給出。建議先檢查PolarDB-X後端資料節點狀态。如果排除資料節點故障後仍然提示PXC-4407錯誤，請聯系技術支援。

PXC-4408 ERR_SEQUENCE_NEXT_VALUE

• 描述：擷取Sequence值出錯。

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

• 說明：使用PolarDB-X自增主鍵，或者使用

  .NEXTVAL

  文法手工擷取全局唯一ID時發生錯誤。錯誤原因在error:提示後給出。産生PXC-4408錯誤的原因是後端資料節點故障。建議先檢查PolarDB-X後端資料節點狀态和通路壓力。如果排除資料節點故障後仍然提示PXC-4408錯誤，請聯系技術支援。

PXC-4500 ERR_PARSER

• 描述：解析SQL語句失敗。

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

• 說明：PolarDB-X支援符合SQL-92标準的SQL文法，以及MySQL支援的文法擴充與函數。請檢查執行的SQL語句是否符合PolarDB-X相容的SQL标準及MySQL規範。關于SQL标準文法，請參見 SQL标準文法 。關于SQL相容性，請參見 SQL相容性 。關于MySQL 5.6 SQL文法，請參見 MySQL 5.6 SQL文法 。如果您的SQL語句符合上述文法規則仍然提示PXC-4500錯誤，請聯系技術支援。

PXC-4501 ERR_OPTIMIZER

• 描述：優化器轉換SQL語句失敗。

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

• 說明：PolarDB-X優化器的工作是轉換SQL語句到内部文法樹。如果SQL語句中出現邏輯錯誤，優化器轉換就會失敗，産生PXC-4501錯誤。建議按照optimize error by:後的提示檢查和調整您的SQL語句。如果調整SQL語句後仍然提示PXC-4501錯誤，請聯系技術支援。

PXC-4502 ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT

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

• ERR-CODE: [PXC-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要求同樣的函數列必須也在SELECT子句中出現，否則提示PXC-4502錯誤。建議在SELECT子句中添加相應的函數列。

PXC-4504 ERR_OPTIMIZER_SELF_CROSS_JOIN

• 描述：相同表JOIN的條件不足。

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

• 說明：PolarDB-X在執行相同表的JOIN時，如果WHERE子句隻包含其中一張左表（或右表）的拆分字段（sharding column）條件，會提示PXC-4504錯誤。建議調整SQL語句，在WHERE子句中補全JOIN左表（或右表）的拆分字段條件。

PXC-4506 ERR_MODIFY_SHARD_COLUMN

• 描述：禁止更新拆分鍵。

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

• 說明：這是禁止修改拆分鍵（sharding key）的異常，PolarDB-X目前靜止修複包含GSI的表的分區鍵。建議将對應UPDATE語句修改為相同效果的INSERT+DELETE語句。

PXC-4508 ERR_OPTIMIZER_NOT_ALLOWED_SORT_MERGE_JOIN

• 描述：無法執行合并排序JOIN。

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

• 說明：如果SQL語句中需要JOIN的資料表分别來自不同的資料節點，PolarDB-X會優先選擇合并排序（Sort-merge Join）算法。該算法要求JOIN的左表與右表必須包含字段相等的關聯條件，否則PolarDB-X将提示PXC-4508錯誤。建議調整SQL語句，在JOIN或WHERE部分添加相應的關聯條件。

PXC-4509 ERR_OPTIMIZER_ERROR_HINT

• 描述：Hint文法錯誤。

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

• 說明：該錯誤表示SQL語句中的Hint文法無法被PolarDB-X解析。更多關于Hint文法資訊，請參見 自定義HINT簡介

PXC-4510 ERR_CONTAINS_NO_SHARDING_KEY

• 描述：缺少拆分鍵（sharding key）條件。

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

• 說明：禁止全表掃描（full-table scan）功能，PolarDB-X在建表時預設開啟全表掃描功能。如果手動關閉全表掃描，建議确認與該表有關的SQL語句都已添加拆分鍵條件。

PXC-4511 ERR_INSERT_CONTAINS_NO_SHARDING_KEY

• 描述：INSERT語句缺少拆分鍵 (sharding key）。

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

• 說明：當INSERT語句的目标是一張PolarDB-X拆分表時，必須在插入資料中包含拆分鍵的值（拆分鍵是自增主鍵例外）。否則，PolarDB-X将提示PXC-4511錯誤。如果遇到該錯誤，建議修改INSERT語句補充缺少的拆分鍵值。

PXC-4515 ERR_CONNECTION_CHARSET_NOT_MATCH

• 描述：輸入字元集不比對。

• ERR-CODE: [PXC-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支援用中文字元命名表名及字段名。在執行含有中文字元的SQL語句時，如果資料庫連接配接的字元集設定（character_set_connection）不支援中文（如 latin1），會提示PXC-4515錯誤。您可以使用

  SHOW VARIABLES LIKE 'character_set_connection'

  查詢MySQL用戶端目前的連接配接字元集，使用

  SET NAMES

  指令修改目前連接配接字元集。如果是Java程式JDBC方式連接配接PolarDB-X，請設定資料庫連接配接參數characterEncoding。

PXC-4517 ERR_MODIFY_SYSTEM_TABLE

• 描述：禁止修改系統表。

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

• 說明：PolarDB-X内部維護了一些系統表，使用SQL語句更新其中的資料會提示PXC-4517錯誤。限制的系統表包括sequence、sequence_opt、txc_undo_log等，請避免在業務或資料庫設計中使用這些表名。

PXC-4520 ERR_DML_WITH_SUBQUERY

• 描述：不支援在DML使用子查詢語句。

• ERR-CODE: [PXC-4520][ERR_DML_WITH_SUBQUERY] DO NOT support UPDATE/DELETE with subQuery

• 說明：目前PolarDB-X中禁止在DML語句中包含子查詢語句，遇到此類問題建議先從業務上改寫SQL，避免使用子查詢。

PXC-4521 ERR_INSERT_SHARD

• 描述：Insert過程中一條記錄被路由到了多個分片。

• ERR-CODE: [PXC-4521][ERR_INSERT_SHARD] Cannot decide which group to insert

• 說明：Insert過程中一條記錄被路由到了多個分片，導緻不知道這條記錄被插入到哪個分片，出現這類問題，請聯系技術支援。

PXC-4523 ERR_TODNF_LIMIT_EXCEED

• 描述：where後面的過濾條件太多。

• ERR-CODE: [PXC-4523][ERR_TODNF_LIMIT_EXCEED] toDnf has exceed the limit size

• 說明：PolarDB-X會對使用者SQL的查詢條件（即where子句）進行CNF/DNF的條件範式轉換，并進行條件推導與優化，為了優化穩定性，限制了條件數2000。使用者可以将DNF_REX_NODE_LIMIT參數調整大。

PXC-4524 ERR_TOCNF_LIMIT_EXCEED

• ERR-CODE: [PXC-4524][ERR_TODNF_LIMIT_EXCEED] toCnf has exceed the limit size

• 說明：PolarDB-X會對使用者SQL的查詢條件（即where子句）進行CNF/DNF的條件範式轉換，并進行條件推導與優化，為了優化穩定性，限制了條件數2000。使用者可以将CNF_REX_NODE_LIMIT參數調整大。

PXC-4526 ERR_FUNCTION_NOT_FOUND

• 描述：該函數不支援調用。

• ERR-CODE: [PXC-4526][ERR_FUNCTION_NOT_FOUND] No match found for function signature

• 說明：該錯誤表明在SQL語句中使用了錯誤的文法或不支援的函數。建議仔細檢查SQL語句中的函數調用部分，使用正确的參數個數和類型調用函數。

PXC-4527 ERR_MODIFY_SHARD_COLUMN_ON_TABLE_WITHOUT_PK

• 描述：不允許在無主鍵的表上修改分庫鍵。

• ERR-CODE: [PXC-4527][ERR_MODIFY_SHARD_COLUMN_ON_TABLE_WITHOUT_PK] 

• 說明：PolarDB-X目前不允許在無主鍵的表上修改分庫鍵。

PXC-4595 ERR_UNKNOWN_TZ

• 描述：設定錯誤的時區。

• ERR-CODE: [PXC-4595][ERR_UNKNOWN_TZ] 

• 說明：建議檢查時間的文法和格式是否設定正确。

PXC-4600 ERR_FUNCTION

• 描述：錯誤的函數調用。

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

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

PXC-4602 ERR_CONVERTOR

• 描述：錯誤的類型轉換。

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

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

PXC-4603 ERR_ACCROSS_DB_TRANSACTION

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

PXC-4604 ERR_CONCURRENT_TRANSACTION

• 描述：嵌套事務失敗。

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

• 說明：PolarDB-X不支援嵌套事務，如果在同一個資料庫連接配接裡嘗試同時開啟2個以上事務，将提示PXC-4604錯誤。建議在應用開發時避免使用嵌套事務，或者使用應用層的事務架構防止産生嵌套事務。

PXC-4606 ERR_QUERY_CANCLED

• 描述：目前執行的SQL被取消。

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

• 說明：使用

  KILL

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

PXC-4610 ERR_CONNECTION_CLOSED

• 描述：連接配接已經關閉。

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

• 說明：當事務中的SQL語句執行出錯，或者被

  KILL

  指令取消後，重複使用同一個資料庫連接配接執行其他SQL語句會提示PXC-4610錯誤。建議在該情況下關閉連接配接，重新擷取一個新的資料庫連接配接。

PXC-4612 ERR_CHECK_SQL_PRIV

• 描述：由于權限不夠，SQL語句無法執行。

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

• 說明：PolarDB-X的新版本支援賬号和授權，類似MySQL賬号權限體系，隻有擁有對應類型權限的賬号才能執行該SQL語句。如果賬号權限不足，PolarDB-X将提示PXC-4612錯誤。建議檢查使用者擁有的PolarDB-X權限。如果權限不足，請在PolarDB-X控制台設定。關于PolarDB-X賬号與權限設定，請參見 PolarDB-X賬号和權限系統

PXC-4614 ERR_EXECUTE_ON_MYSQL

• 描述：SQL語句在DN上執行報錯。

ERR-CODE: [PXC-4614][ERR_EXECUTE_ON_MYSQL] Error occurs when execute on  GROUP '*****': Duplicate entry '*****' for key 'PRIMARY'
PolarDB-X在後端資料節點資料庫上執行SQL語句報錯，末尾包含了從資料節點傳回的原始錯誤資訊，例如：
 
Duplicate entry '*****' for key 'PRIMARY'
表示寫入資料節點資料表發生了主鍵沖突。
   
The table '*****' is full
表示資料節點使用的臨時表已滿，需要調整臨時表空間或優化SQL語句。
     
Deadlock found when trying to get lock;
表示在資料節點中出現了死鎖，通常是資料寫入存在較多事務沖突導緻的。      

• 說明：建議參見PXC-4614提供的原始錯誤資訊排查問題。更多關于SQL語句錯誤資訊請參見 MySQL 5.6文檔 。如果排除應用或資料節點問題後仍然發生PXC-4614錯誤，請聯系技術支援。

PXC-4616 ERR_UNKNOWN_DATABASE

• 描述：錯誤的資料庫。

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

• 說明：PolarDB-X允許在DDL語句中指定資料庫名稱。如果指定的資料庫名稱與PolarDB-X提供的資料庫名稱不一緻，将傳回PXC-4616錯誤。建議修改DDL語句中的資料庫名稱，確定與PolarDB-X資料庫名稱一緻。

PXC-4620 ERR_FORBID_EXECUTE_DML_ALL

說明：PolarDB-X禁止不帶where條件執行delete和update操作。

PXC-4633 ERR_DB_STATUS_READ_ONLY

• ERR-CODE: [PXC-4633][ERR_DB_STATUS_READ_ONLY] Database is read-only, only read sql are supported

• 說明：該錯誤碼表示資料庫隻有讀權限，請檢查下目前賬号的權限是否受限。

PXC-4707 ERR_OUT_OF_MEMORY

• 描述：臨時表使用記憶體超限。

• ERR-CODE: [PXC-4707][ERR_OUT_OF_MEMORY]

• 說明：為了保證資料庫穩定性，PolarDB-X限制了每條查詢的臨時表使用記憶體量，說明使用者目前的查詢涉及到的資料比較多，可以打開SPILL或者調大目前查詢臨時表記憶體限制。

PXC-4709 ERR_IVENTORY_HINT_NOT_SUPPORT_CROSS_SHARD

• ERR-CODE: [PXC-4709][ERR_IVENTORY_HINT_NOT_SUPPORT_CROSS_SHARD]

• 說明：熱點秒殺功能要求是單分片事務，如果涉及到多分片事務，會出現該錯誤。請調整業務邏輯，確定在單分片事務下使用熱點功能。

PXC-4994 ERR_FLOW_CONTROL

• 描述：流量已達上限。

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

• 說明：該錯誤代表PolarDB-X處理SQL請求已達到内部流量上限，目前請求被拒絕。建議檢查SQL請求量是否存在異常峰值。如果觀察到SQL請求量下降後，仍然大量提示PXC-4994錯誤，請聯系技術支援。

PXC-4998 ERR_NOT_SUPPORT

• 描述：不支援的特性。

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

• 說明：該錯誤代表使用的SQL文法或者功能PolarDB-X尚不支援。如果這些SQL文法或者功能對您十分重要，請聯系技術支援。

PXC-5001 ERR_TRANS

• 描述：一般性的事務錯誤。

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

• 說明：請參見錯誤資訊處理。

• • Too many lines updated in statement

    事務中的UPDATE語句更新行數超出限制（1000），建議檢查UPDATE語句的WHERE條件。如果需要在事務中執行大批量資料更新，可以使用PolarDB-X

    Hint/*TDDL:UNDO_LOG_LIMIT={number}*/

    調整限制值。

  • Deferred execution is only supported in Flexible or XA Transaction

    後置執行功能僅僅在柔性事務與XA事務政策下可用。在用PolarDB-X的

    Hint/*TDDL:DEFER*/

    語句送出後置執行功能之前，請先用

    SET drds_transaction_policy = ***

    指令更改PolarDB-X事務政策。
  • 其他錯誤資訊，請聯系技術支援。

PXC-5002 ERR_TRANS_UNSUPPORTED

• 描述：事務中的文法或功能尚不支援。

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

• 說明：該功能在PolarDB-X事務中尚不支援。如果此功能很重要，請聯系技術支援。

PXC-5003 ERR_TRANS_LOG

• 描述：無法通路事務日志。

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

• 說明：為保證分布式事務的原子性，PolarDB-X在事務中會通路後端資料節點上的事務日志。如果PolarDB-X在讀寫事務日志時出錯，将傳回PXC-5003錯誤。産生PXC-5003錯誤的原因通常來自後端的資料節點故障。建議檢查PolarDB-X後端資料節點狀态和通路壓力。如果排除資料節點問題後仍然産生PXC-5003錯誤，請聯系技術支援。

PXC-5006 ERR_TRANS_COMMIT

• 描述：事務送出過程中出錯。

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

• 說明：PolarDB-X在送出事務分支過程中出錯，TRANS_ID對應的事務将被自動復原。産生PXC-5006錯誤的原因通常來自後端的資料節點故障。建議檢查PolarDB-X後端資料節點狀态和通路壓力。如果排除資料節點問題後仍然産生PXC-5006錯誤，請聯系技術支援。

PXC-5008 ERR_TRANS_TERMINATED

• 描述：事務已被Kill或逾時中止。

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

• 說明：如果PolarDB-X事務在執行中被Kill或者逾時（執行時間超出drds_transaction_timeout值），則出現該錯誤。如果是事務逾時導緻報錯，建議使用

  SET drds_transaction_timeout = ***

  指令修改PolarDB-X事務的執行時間上限，機關是毫秒。

PXC-5010 ERR_TRANS_CONTINUE_AFTER_WRITE_FAIL

• 描述：寫入失敗後，不允許繼續進行事務操作。

• ERR-CODE: [PXC-5010][ERR_TRANS_CONTINUE_AFTER_WRITE_FAIL] Cannot continue or commit transaction after writing failed

• 說明：如果PolarDB-X事務中涉及到分布式事務，執行失敗後，不允許繼續進行事務，這個時候需要前端主動執行rollback，重試事務操作。

PXC-5108 ERR_CHECK_PRIVILEGE_FAILED_ON_TABLE

說明：目前賬号沒有對目前表的操作權限，請檢查權限。

PXC-5119 ERR_FILE_CANNOT_BE_CREATE

說明：PolarDB-X預設關閉對

select outfile

語句的支援，如有需要請聯系技術支援。

PXC-5302 ERR_GLOBAL_SECONDARY_INDEX_UNSUPPORTED

說明：目前表不支援建立全局二級索引。可能是如下原因導緻的：1. 目前表是單表或者廣播表；2. 全局二級索引的列不包含分區鍵。其他情況請聯系技術支援。

PXC-5306 ERR_GLOBAL_SECONDARY_INDEX_INSERT_DUPLICATE_VALUES

說明：在資料寫入到全局二級索引表過程中存在主鍵沖突，請根據報錯資訊提示的記錄值，确認是否存在主鍵沖突。

PXC-5308 ERR_GLOBAL_SECONDARY_INDEX_MODIFY_UNIQUE_KEY

說明：在執行DML過程中，全局二級索引表存在唯一鍵沖突，請根據報錯資訊提示的記錄值，确認是否存在唯一鍵沖突。

PXC-5310 ERR_GLOBAL_SECONDARY_INDEX_ONLY_SUPPORT_XA

說明：PolarDB-X隻有在XA/TSO分布式事務下，才支援全局二級索引，如果産生此報錯，可能業務之前調整過預設事務政策，請調整回XA/TSO分布式事務，再建立全局二級索引。

PXC-5313 ERR_GLOBAL_SECONDARY_INDEX_MODIFY_GSI_TABLE_WITH_DDL

說明：PolarDB-X預設不支援對全局二級索引表做DDL操作，如有需要請聯系技術支援。

PXC-5316 ERR_GLOBAL_SECONDARY_INDEX_INDEX_AND_SHARDING_COLUMNS_NOT_MATCH

說明：PolarDB-X在建立全局二級索引時，要求索引表字段必須包含主表分區鍵，因為在回表過程中需要根據分區鍵定位到具體的分片和具體記錄。如果産生此報錯，請檢查DDL語句中索引表字段是否包含了分區鍵。

PXC-5317 ERR_GLOBAL_SECONDARY_INDEX_CONTINUE_AFTER_WRITE_FAIL

• ERR-CODE: [PXC-5317][ERR_GLOBAL_SECONDARY_INDEX_CONTINUE_AFTER_WRITE_FAIL] Cannot continue or commit transaction after writing global secondary index failed

• 說明：在包含GSI的表上執行DML語句時，如果産生此報錯，則不允許繼續送出包含該失敗DML語句的事務。需要修改業務代碼，DML報錯後需要復原事務之後重試。

PXC-5321 ERR_GLOBAL_SECONDARY_INDEX_BACKFILL_DUPLICATE_ENTRY

說明：在建立全局二級索引過程中，資料回填出現了索引表主鍵沖突，請确認索引表的主鍵是否存在相同值。

PXC-8007 ERR_ABANDONED_TASK

說明：查詢過慢或者由于不明原因卡住超過2小時，資料庫系統會終止查詢，出現該異常。請先優化查詢，確定不會出現超慢查詢，若無法解決，請聯系技術支援。

PXC-8008 ERR_EXECUTE_SPILL

說明：查詢過程中，資料過大會觸發臨時表落盤，這個錯誤是在資料落盤過程中出現的異常，請聯系技術支援。

PXC-8011 ERR_OUT_OF_SPILL_SPACE

說明：查詢過程中，資料過大會觸發臨時表落盤，如果臨時表生産的檔案過多，超過了系統允許的可落盤的最大磁盤空間就會出現此錯誤。請先優化查詢，減少計算過程中對臨時表的依賴。若無法解決請聯系技術支援。

PXC-8012 ERR_OUT_OF_SPILL_FD

說明：查詢過程中，資料過大會觸發臨時表落盤，如果臨時表生産的檔案過多，超過了系統允許的檔案句柄個數就會出現此錯誤。請聯系技術支援，確定是否存在檔案句柄洩漏，若沒有洩漏，可以适當調大檔案句柄個數限制。

PXC-8102 ERR_PAGE_TOO_LARGE

說明：在MPP并計算過程中，資料是按批在多個計算節點網絡互動，如果一個批的資料過大超過RPC限制最大值，就會出現此錯誤，可以嘗試調小預設CHUNK_SIZE值。

PXC-8103 ERR_NO_NODES_AVAILABLE

說明：在MPP并行計算過程中可能有計算節點出現故障，導緻執行排程之初沒有計算節點可排程，請确認計算節點服務是否正常，如果計算節點服務都正常仍然出現報此類錯誤，請聯系技術支援。

PXC-9301 ERR_DUPLICATED_PARTITION_NAME

說明：在執行分區表相關的DDL操作過程中，使用了相同的分區表名。

PXC-9305 ERR_PARTITION_NAME_NOT_EXISTS

說明：在執行分區表相關的DDL操作過程中，提示分區表名不存在。請檢查下分表名是否拼寫正常，使用

show create table

和

check table

檢查表中繼資料是否一緻，如果不一緻，可能是中繼資料維護資訊不一緻導緻。請聯系技術支援。

PXC-10004 ERR_X_PROTOCOL_RESULT

• ERR-CODE: [PXC-10004][ERR_X_PROTOCOL_RESULT] Should use chunk2chunk to fetch data

• 說明：PolarDB-X計算節點和資料節點采用的是私有RPC通信，出現這類異常主要是計算節點和資料節點建立的連接配接異常，具體原因有很多種，需要檢視異常資訊，如果無法定位具體問題，請聯系技術支援。