PXC-1305 ERR_UNKNOWN_SAVEPOINT

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

• 示例：ERR-CODE: [PXC-1305][ERR_UNKNOWN_SAVEPOINT] SAVEPOINT ***** does not exist

• 說明：在PolarDB-X上執(zhí)行ROLLBACK TO SAVEPOINT或者RELEASE SAVEPOINT命令時(shí)，如果指定的SAVEPOINT名稱不存在，會(huì)提示PXC-1305錯(cuò)誤。

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

PXC-1094 ERR_UNKNOWN_THREAD_ID

• 描述：KILL命令指定的會(huì)話ID不存在。

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

• 說明：在PolarDB-X上執(zhí)行KILL命令取消執(zhí)行的SQL語句時(shí)，如果指定的會(huì)話ID不存在，或者對應(yīng)的SQL語句已經(jīng)結(jié)束執(zhí)行，會(huì)提示PXC-1094錯(cuò)誤。

  建議使用SHOW PROCESSLIST命令查看正在執(zhí)行的SQL語句會(huì)話ID，并只針對返回的ID執(zhí)行KILL命令。

PXC-4006 ERR_TABLE_NOT_EXIST

• 描述：PolarDB-X數(shù)據(jù)表不存在。

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

• 說明：該錯(cuò)誤碼表示PolarDB-X數(shù)據(jù)表不存在，或者由于未知原因，PolarDB-X無法加載數(shù)據(jù)表的元數(shù)據(jù)信息。

PXC-4007 ERR_CANNOT_FETCH_TABLE_META

• 描述：PolarDB-X無法加載數(shù)據(jù)表的元數(shù)據(jù)信息。

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

• 說明：該錯(cuò)誤碼表示PolarDB-X嘗試讀取數(shù)據(jù)表的元數(shù)據(jù)信息失敗?？赡艿腻e(cuò)誤原因如下：

  • 數(shù)據(jù)表未創(chuàng)建。

  • 維護(hù)的元數(shù)據(jù)庫信息不一致。

  • 表被刪除或者改名。

  出現(xiàn)該錯(cuò)誤時(shí)，首先檢查表名是否存在，或者執(zhí)行check table 命令確認(rèn)PolarDB-X維護(hù)的元數(shù)據(jù)庫信息是否一致。如果確定表被人為刪除或改名，可以通過PolarDB-X提供的數(shù)據(jù)恢復(fù)功能修復(fù)。如果仍無法修復(fù)，請聯(lián)系技術(shù)支持。

PXC-4018 ERR_INVALID_DDL_PARAMS

• 描述：PolarDB-X執(zhí)行DDL過程失敗。

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

• 說明：該錯(cuò)誤表示用戶執(zhí)行DDL的參數(shù)有錯(cuò)誤，請檢查參數(shù)正確性。如果確認(rèn)參數(shù)正確，請聯(lián)系技術(shù)支持。

PXC-4100 ERR_ATOM_NOT_AVALILABLE

• 描述：PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)暫時(shí)不可用。

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

• 說明：如果PolarDB-X探測到后端某個(gè)數(shù)據(jù)節(jié)點(diǎn)狀態(tài)異常，會(huì)臨時(shí)阻止訪問該實(shí)例并提示PXC-4100錯(cuò)誤。

  當(dāng)遇到該錯(cuò)誤，請檢查PolarDB-X后端所有數(shù)據(jù)節(jié)點(diǎn)是否異常。當(dāng)后端數(shù)據(jù)節(jié)點(diǎn)從異常狀態(tài)恢復(fù)后，PolarDB-X將自動(dòng)解除不可用狀態(tài)，恢復(fù)應(yīng)用正常訪問。

PXC-4101 ERR_ATOM_GET_CONNECTION_FAILED_UNKNOWN_REASON

• 描述：PolarDB-X計(jì)算節(jié)點(diǎn)和數(shù)據(jù)節(jié)點(diǎn)連接獲取失敗。

• 示例：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在處理請求時(shí)會(huì)向數(shù)據(jù)節(jié)點(diǎn)異步創(chuàng)建連接。如果無法在等待時(shí)間內(nèi)完成數(shù)據(jù)節(jié)點(diǎn)連接創(chuàng)建，而異步任務(wù)又尚未返回錯(cuò)誤原因，PolarDB-X會(huì)向應(yīng)用返回PXC-4101錯(cuò)誤。

  該錯(cuò)誤通常是由后端數(shù)據(jù)節(jié)點(diǎn)異常導(dǎo)致的。如果排除數(shù)據(jù)節(jié)點(diǎn)問題后仍然出現(xiàn)該錯(cuò)誤，請聯(lián)系技術(shù)支持。

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計(jì)算節(jié)點(diǎn)獲取數(shù)據(jù)節(jié)點(diǎn)連接時(shí)出錯(cuò)，錯(cuò)誤原因已經(jīng)在ERR-CODE消息中給出。常見PolarDB-X數(shù)據(jù)節(jié)點(diǎn)連接失敗的原因如下：

  • 后端數(shù)據(jù)節(jié)點(diǎn)連接數(shù)已滿

  • 計(jì)算節(jié)點(diǎn)到數(shù)據(jù)節(jié)點(diǎn)的連接超時(shí)

  • 數(shù)據(jù)節(jié)點(diǎn)拒絕連接

  如果排除后端數(shù)據(jù)節(jié)點(diǎn)問題后仍然出現(xiàn)該錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4103 ERR_ATOM_CONNECTION_POOL_FULL

• 描述：PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)連接池已滿。

• 示例：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.

• 說明：該錯(cuò)誤表示PolarDB-X后端連接池已滿。導(dǎo)致PXC-4103錯(cuò)誤的常見原因如下：

  • 應(yīng)用SQL語句執(zhí)行比較慢，占用單個(gè)連接的時(shí)間過長，導(dǎo)致連接數(shù)不夠；

  • 應(yīng)用端沒有關(guān)閉數(shù)據(jù)庫連接，導(dǎo)致連接泄露；

  • 有很多跨庫查詢（例如聚合統(tǒng)計(jì)類查詢，未帶分庫條件的查詢）同時(shí)執(zhí)行，占用大量連接。

  解決方法建議如下：

  • 盡量使用框架訪問數(shù)據(jù)庫，如Spring JDBC、MyBatis等；

  • 按性能分析報(bào)告與DBA建議優(yōu)化業(yè)務(wù)SQL語句；

  • 使用PolarDB-X讀寫分離將跨庫查詢轉(zhuǎn)發(fā)至讀庫處理；

  • 升級更高規(guī)格的PolarDB-X，提升后端處理能力；

  • 聯(lián)系技術(shù)支持調(diào)整PolarDB-X后端連接數(shù)。

PXC-4104 ERR_ATOM_CREATE_CONNECTION_TOO_SLOW

• 描述：PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)連接創(chuàng)建太慢。

• 示例：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向后端數(shù)據(jù)節(jié)點(diǎn)異步創(chuàng)建連接時(shí)，如果在短時(shí)間創(chuàng)建大量連接，或者數(shù)據(jù)節(jié)點(diǎn)建立連接速度太慢，會(huì)出現(xiàn)等待超時(shí)。該問題通常是由于后端數(shù)據(jù)節(jié)點(diǎn)壓力過大或異常導(dǎo)致的，建議使用PolarDB-X讀寫分離，或者升級更高規(guī)格，減輕后端處理壓力。

  如果排除后端數(shù)據(jù)節(jié)點(diǎn)問題后仍然出現(xiàn)該錯(cuò)誤，請聯(lián)系技術(shù)支持。如果問題是由短時(shí)間創(chuàng)建大量連接導(dǎo)致，建議聯(lián)系技術(shù)支持調(diào)整PolarDB-X最小連接數(shù)。

PXC-4105 ERR_ATOM_ACCESS_DENIED

• 描述：PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)拒絕創(chuàng)建連接。

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

• 說明：該錯(cuò)誤表明PolarDB-X通過用戶名和密碼連接數(shù)據(jù)節(jié)點(diǎn)時(shí)被拒絕訪問，請聯(lián)系技術(shù)支持。

PXC-4106 ERR_ATOM_DB_DOWN

• 描述：PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)無法連接。

• 示例：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.

• 說明：該錯(cuò)誤表明PolarDB-X向后端數(shù)據(jù)節(jié)點(diǎn)創(chuàng)建連接超時(shí)或者沒有響應(yīng)。遇到該錯(cuò)誤的通常原因是數(shù)據(jù)節(jié)點(diǎn)故障，請聯(lián)系技術(shù)支持。

PXC-4108 ERR_VARIABLE_CAN_NOT_SET_TO_NULL_FOR_NOW

• 描述：變量（variable）不允許被設(shè)置為NULL。

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

• 說明：有些數(shù)據(jù)節(jié)點(diǎn)變量（variable）不允許用SET var = x語句設(shè)置成NULL值。遇到這種情況，PolarDB-X會(huì)提示PXC-4108錯(cuò)誤。

PXC-4200 ERR_GROUP_NOT_AVALILABLE

• 描述：PolarDB-X下的某個(gè)數(shù)據(jù)節(jié)點(diǎn)暫時(shí)不可用。

• 示例：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 *****.

• 說明：當(dāng)分庫包含的數(shù)據(jù)節(jié)點(diǎn)出現(xiàn)訪問異常，并且分庫下沒有其他可用數(shù)據(jù)節(jié)點(diǎn)時(shí)，PolarDB-X會(huì)將分庫置于fail-fast狀態(tài)并提示PXC-4200錯(cuò)誤。

  通常該錯(cuò)誤是由于數(shù)據(jù)節(jié)點(diǎn)故障導(dǎo)致的。請根據(jù)包含的數(shù)據(jù)節(jié)點(diǎn)異常信息定位和解決問題。當(dāng)故障數(shù)據(jù)節(jié)點(diǎn)恢復(fù)后，PolarDB-X將自動(dòng)取消fail-fast狀態(tài)。

  如果數(shù)據(jù)節(jié)點(diǎn)故障解決后仍然出現(xiàn)PXC-4200錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4201 ERR_GROUP_NO_ATOM_AVALILABLE

• 描述：PolarDB-X分庫內(nèi)暫時(shí)沒有可用數(shù)據(jù)節(jié)點(diǎn)。

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

• 說明：當(dāng)分庫包含的數(shù)據(jù)節(jié)點(diǎn)全都不可用，或者處于fail-fast狀態(tài)時(shí)，PolarDB-X會(huì)提示PXC-4201錯(cuò)誤。

  通常該錯(cuò)誤是由于數(shù)據(jù)節(jié)點(diǎn)故障導(dǎo)致的。請檢查后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)以定位和解決問題。如果故障解決后仍然出現(xiàn)PXC-4201錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4202 ERR_SQL_QUERY_TIMEOUT

• 描述：PolarDB-X查詢超時(shí)。

• 示例：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.

• 說明：該錯(cuò)誤表示SQL語句在后端數(shù)據(jù)節(jié)點(diǎn)上的執(zhí)行時(shí)間超過PolarDB-X設(shè)置的socketTimeout參數(shù)限制。默認(rèn)的PolarDB-X超時(shí)（socketTimeout）時(shí)間設(shè)置是900秒。

  建議優(yōu)化SQL語句，以及在后端數(shù)據(jù)節(jié)點(diǎn)上創(chuàng)建適合的索引以提升SQL語句的執(zhí)行性能。如果優(yōu)化后的SQL語句仍然較慢，可以參見如下Hint語法臨時(shí)設(shè)置PolarDB-X的超時(shí)時(shí)間：/*TDDL:SOCKET_TIMEOUT=900000*/ SELECT * FROM dual;，其中SOCKET_TIMEOUT設(shè)置的單位是毫秒。關(guān)于PolarDB-X的Hint用法，詳情請參見如何自定義SQL超時(shí)時(shí)間。如果需要永久調(diào)整PolarDB-X超時(shí)設(shè)置，請聯(lián)系技術(shù)支持。

PXC-4203 ERR_SQL_QUERY_MERGE_TIMEOUT

• 描述：PolarDB-X分布式查詢超時(shí)。

• 示例：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執(zhí)行分布式查詢超時(shí)，默認(rèn)的超時(shí)設(shè)置是900秒。產(chǎn)生PXC-4203錯(cuò)誤表示SQL語句掃描了多個(gè)分庫的數(shù)據(jù)并且執(zhí)行時(shí)間超過900秒。

  建議進(jìn)行如下優(yōu)化：

  • 在WHERE條件中添加分庫鍵（Sharding key）條件，將SQL語句優(yōu)化成單庫執(zhí)行；

  • 檢查是否可以在后端數(shù)據(jù)節(jié)點(diǎn)上創(chuàng)建適合的索引，提升掃描各個(gè)分庫數(shù)據(jù)的性能；

  • 設(shè)法消除分布式查詢中的跨庫JOIN，數(shù)據(jù)重排序等耗時(shí)操作，降低PolarDB-X數(shù)據(jù)合并階段的消耗。

  如果優(yōu)化后的SQL語句仍然較慢，可以使用如下Hint語法臨時(shí)設(shè)置PolarDB-X的超時(shí)時(shí)間：/*TDDL:SOCKET_TIMEOUT=900000*/ SELECT * FROM dual;，其中SOCKET_TIMEOUT設(shè)置的單位是毫秒。關(guān)于PolarDB-X的Hint用法，詳情請參見如何自定義SQL超時(shí)時(shí)間。

PXC-4400 ERR_SEQUENCE

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

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

• 說明：處理Sequence出錯(cuò)，錯(cuò)誤信息在Sequence :中給出。導(dǎo)致PXC-4400的常見原因是數(shù)據(jù)節(jié)點(diǎn)故障，無法訪問Sequence有關(guān)的數(shù)據(jù)表。

  建議先檢查后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)。如果排除數(shù)據(jù)節(jié)點(diǎn)故障后仍然發(fā)生錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4401 ERR_MISS_SEQUENCE

• 描述：Sequence不存在。

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

• 說明：命令中使用的Sequence名稱不存在。建議用SHOW SEQUENCES命令檢查PolarDB-X中所有已創(chuàng)建的Sequence名稱，并且選擇正確的Sequence使用。

  如果使用的Sequence尚不存在，可以用如下語句創(chuàng)建：

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

  如果使用的Sequence已經(jīng)存在，但是仍然提示PXC-4401錯(cuò)誤，請聯(lián)系技術(shù)支持。關(guān)于PolarDB-X的Sequence用法，詳情請參見概述。

PXC-4403 ERR_MISS_SEQUENCE_TABLE_ON_DEFAULT_DB

• 描述：Sequence使用的數(shù)據(jù)表不存在。

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

• 說明：無法在PolarDB-X后端的數(shù)據(jù)庫里訪問名稱叫sequence或者sequence_opt的數(shù)據(jù)表，請聯(lián)系技術(shù)支持。

PXC-4404 ERR_SEQUENCE_TABLE_META

• 描述：Sequence數(shù)據(jù)表結(jié)構(gòu)錯(cuò)誤。

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

• 說明：Sequence相關(guān)數(shù)據(jù)表（如sequence或sequence_opt）中缺少相應(yīng)的字段，請聯(lián)系技術(shù)支持。

PXC-4405 ERR_INIT_SEQUENCE_FROM_DB

• 描述：初始化Sequence錯(cuò)誤。

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

• 說明：初始化需要訪問的Sequence時(shí)出錯(cuò)，錯(cuò)誤信息在init sequence manager error后給出。建議先檢查PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)。如果排除數(shù)據(jù)節(jié)點(diǎn)故障后仍然提示PXC-4405錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4407 ERR_OTHER_WHEN_BUILD_SEQUENCE

• 描述：訪問Sequence數(shù)據(jù)表出錯(cuò)。

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

• 說明：在訪問Sequence相關(guān)數(shù)據(jù)表（如sequence或sequence_opt）時(shí)發(fā)生錯(cuò)誤。錯(cuò)誤信息在error when build sequence后給出。

  建議先檢查PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)。如果排除數(shù)據(jù)節(jié)點(diǎn)故障后仍然提示PXC-4407錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4408 ERR_SEQUENCE_NEXT_VALUE

• 描述：獲取Sequence值出錯(cuò)。

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

• 說明：使用PolarDB-X自增主鍵，或者使用<sequence name>.NEXTVAL語法手工獲取全局唯一ID時(shí)發(fā)生錯(cuò)誤。錯(cuò)誤原因在error提示后給出。

  產(chǎn)生PXC-4408錯(cuò)誤的原因是后端數(shù)據(jù)節(jié)點(diǎn)故障。建議先檢查PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)和訪問壓力。如果排除數(shù)據(jù)節(jié)點(diǎn)故障后仍然提示PXC-4408錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4500 ERR_PARSER

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

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

• 說明：PolarDB-X支持符合SQL-92標(biāo)準(zhǔn)的SQL語法，以及MySQL支持的語法擴(kuò)展與函數(shù)。請檢查執(zhí)行的SQL語句是否符合PolarDB-X兼容的SQL標(biāo)準(zhǔn)及MySQL規(guī)范。

  關(guān)于SQL標(biāo)準(zhǔn)語法，請參見SQL標(biāo)準(zhǔn)語法。關(guān)于SQL兼容性，請參見SQL語法使用限制。如果您的SQL語句符合上述語法規(guī)則仍然提示PXC-4500錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4501 ERR_OPTIMIZER

• 描述：優(yōu)化器轉(zhuǎn)換SQL語句失敗。

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

• 說明：PolarDB-X優(yōu)化器的工作是轉(zhuǎn)換SQL語句到內(nèi)部語法樹。如果SQL語句中出現(xiàn)邏輯錯(cuò)誤，優(yōu)化器轉(zhuǎn)換就會(huì)失敗，產(chǎn)生PXC-4501錯(cuò)誤。

  建議按照optimize error by后的提示檢查和調(diào)整您的SQL語句。如果調(diào)整SQL語句后仍然提示PXC-4501錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4502 ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT

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

• 示例：ERR-CODE: [PXC-4502][ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT] Syntax Error: orderBy/GroupBy Column ***** is not existed in select clause`

• 說明：當(dāng)SQL語句中的ORDER BY子句包含函數(shù)列（例如RAND()）時(shí)，PolarDB-X要求同樣的函數(shù)列必須也在SELECT子句中出現(xiàn)，否則提示PXC-4502錯(cuò)誤。

  建議在SELECT子句中添加相應(yīng)的函數(shù)列。

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在執(zhí)行相同表的JOIN時(shí)，如果WHERE子句只包含其中一張左表（或右表）的拆分字段（sharding column）條件，會(huì)提示PXC-4504錯(cuò)誤。

  建議調(diào)整SQL語句，在WHERE子句中補(bǔ)全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的表的分區(qū)鍵。

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

PXC-4508 ERR_OPTIMIZER_NOT_ALLOWED_SORT_MERGE_JOIN

• 描述：無法執(zhí)行合并排序JOIN。

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

• 說明：如果SQL語句中需要JOIN的數(shù)據(jù)表分別來自不同的數(shù)據(jù)節(jié)點(diǎn)，PolarDB-X會(huì)優(yōu)先選擇合并排序（Sort-merge Join）算法。該算法要求JOIN的左表與右表必須包含字段相等的關(guān)聯(lián)條件，否則PolarDB-X將提示PXC-4508錯(cuò)誤。

  建議調(diào)整SQL語句，在JOIN或WHERE部分添加相應(yīng)的關(guān)聯(lián)條件。

PXC-4509 ERR_OPTIMIZER_ERROR_HINT

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

• 說明：該錯(cuò)誤表示SQL語句中的Hint語法無法被PolarDB-X解析。更多關(guān)于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在建表時(shí)默認(rèn)開啟全表掃描功能。如果手動(dòng)關(guān)閉全表掃描，建議確認(rèn)與該表有關(guān)的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 '*****'.

• 說明：當(dāng)INSERT語句的目標(biāo)是一張PolarDB-X拆分表時(shí)，必須在插入數(shù)據(jù)中包含拆分鍵的值（拆分鍵是自增主鍵例外）。否則，PolarDB-X將提示PXC-4511錯(cuò)誤。

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

PXC-4515 ERR_CONNECTION_CHARSET_NOT_MATCH

• 描述：輸入的字符串與數(shù)據(jù)庫的字符集不匹配。

• 示例：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支持用中文字符命名表名及字段名。在執(zhí)行含有中文字符的SQL語句時(shí)，如果數(shù)據(jù)庫連接的字符集設(shè)置（character_set_connection）不支持中文（如 latin1），會(huì)提示PXC-4515錯(cuò)誤。

  您可以使用SHOW VARIABLES LIKE 'character_set_connection'查詢MySQL客戶端當(dāng)前的連接字符集，使用SET NAMES命令修改當(dāng)前連接字符集。如果是Java程序JDBC方式連接PolarDB-X，請?jiān)O(shè)置數(shù)據(jù)庫連接參數(shù)characterEncoding。

PXC-4517 ERR_MODIFY_SYSTEM_TABLE

• 描述：禁止修改系統(tǒng)表。

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

• 說明：PolarDB-X內(nèi)部維護(hù)了一些系統(tǒng)表，使用SQL語句更新其中的數(shù)據(jù)會(huì)提示PXC-4517錯(cuò)誤。限制的系統(tǒng)表包括sequence、sequence_opt、txc_undo_log等，請避免在業(yè)務(wù)或數(shù)據(jù)庫設(shè)計(jì)中使用這些表名。

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語句中包含子查詢語句，遇到此類問題建議先從業(yè)務(wù)上改寫SQL，避免使用子查詢。

PXC-4521 ERR_INSERT_SHARD

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

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

• 說明：Insert過程中一條記錄被路由到了多個(gè)分片，導(dǎo)致不知道這條記錄被插入到哪個(gè)分片，出現(xiàn)這類問題，請聯(lián)系技術(shù)支持。

PXC-4523 ERR_TODNF_LIMIT_EXCEED

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

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

• 說明：PolarDB-X會(huì)對用戶SQL的查詢條件（即where子句）進(jìn)行CNF/DNF的條件范式轉(zhuǎn)換，并進(jìn)行條件推導(dǎo)與優(yōu)化，為了優(yōu)化穩(wěn)定性，限制了條件數(shù)2000。用戶可以將DNF_REX_NODE_LIMIT參數(shù)調(diào)整大。

PXC-4524 ERR_TOCNF_LIMIT_EXCEED

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

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

• 說明：PolarDB-X會(huì)對用戶SQL的查詢條件（即where子句）進(jìn)行CNF/DNF的條件范式轉(zhuǎn)換，并進(jìn)行條件推導(dǎo)與優(yōu)化，為了優(yōu)化穩(wěn)定性，限制了條件數(shù)2000。用戶可以將CNF_REX_NODE_LIMIT參數(shù)調(diào)整大。

PXC-4526 ERR_FUNCTION_NOT_FOUND

• 描述：該函數(shù)不支持調(diào)用。

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

• 說明：該錯(cuò)誤表明在SQL語句中使用了錯(cuò)誤的語法或不支持的函數(shù)。建議仔細(xì)檢查SQL語句中的函數(shù)調(diào)用部分，使用正確的參數(shù)個(gè)數(shù)和類型調(diào)用函數(shù)。

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

• 描述：設(shè)置錯(cuò)誤的時(shí)區(qū)。

• 示例：ERR-CODE: [PXC-4595][ERR_UNKNOWN_TZ]

• 說明：建議檢查時(shí)間的語法和格式是否設(shè)置正確。

PXC-4600 ERR_FUNCTION

• 描述：錯(cuò)誤的函數(shù)調(diào)用。

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

• 說明：該錯(cuò)誤表明在SQL語句中使用了錯(cuò)誤的語法或參數(shù)調(diào)用函數(shù)。建議仔細(xì)檢查SQL語句中的函數(shù)調(diào)用部分，使用正確的參數(shù)個(gè)數(shù)和類型調(diào)用函數(shù)。

PXC-4602 ERR_CONVERTOR

• 描述：錯(cuò)誤的類型轉(zhuǎn)換。

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

• 說明：該錯(cuò)誤表明PolarDB-X在執(zhí)行SQL時(shí)進(jìn)行數(shù)據(jù)類型轉(zhuǎn)換失敗。請檢查SQL語句中是否存在需要隱式類型轉(zhuǎn)換的數(shù)據(jù)，并且盡量使用相同類型進(jìn)行比較和計(jì)算。

PXC-4603 ERR_ACCROSS_DB_TRANSACTION

• 描述：跨庫事務(wù)失敗。

• 示例：ERR-CODE: [PXC-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默認(rèn)支持跨庫事務(wù)，請檢查之前是否設(shè)置過其他事務(wù)策略。

PXC-4604 ERR_CONCURRENT_TRANSACTION

• 描述：嵌套事務(wù)失敗。

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

• 說明：PolarDB-X不支持嵌套事務(wù)，如果在同一個(gè)數(shù)據(jù)庫連接里嘗試同時(shí)開啟2個(gè)以上事務(wù)，將提示PXC-4604錯(cuò)誤。

  建議在應(yīng)用開發(fā)時(shí)避免使用嵌套事務(wù)，或者使用應(yīng)用層的事務(wù)框架防止產(chǎn)生嵌套事務(wù)。

PXC-4606 ERR_QUERY_CANCLED

• 描述：當(dāng)前執(zhí)行的SQL被取消。

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

• 說明：使用KILL取消某條SQL語句的執(zhí)行時(shí)，被取消的SQL語句會(huì)返回該錯(cuò)誤。如果經(jīng)常出現(xiàn)這一情況，請排查是否有客戶端或程序在執(zhí)行KILL命令。

PXC-4610 ERR_CONNECTION_CLOSED

• 描述：連接已經(jīng)關(guān)閉。

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

• 說明：當(dāng)事務(wù)中的SQL語句執(zhí)行出錯(cuò)，或者被KILL命令取消后，重復(fù)使用同一個(gè)數(shù)據(jù)庫連接執(zhí)行其他SQL語句會(huì)提示PXC-4610錯(cuò)誤。

  建議在該情況下關(guān)閉連接，重新獲取一個(gè)新的數(shù)據(jù)庫連接。

PXC-4612 ERR_CHECK_SQL_PRIV

• 描述：由于權(quán)限不夠，SQL語句無法執(zhí)行。

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

• 說明：PolarDB-X的新版本支持為賬號授權(quán)，類似MySQL賬號權(quán)限體系，只有擁有對應(yīng)類型權(quán)限的賬號才能執(zhí)行該SQL語句。如果賬號權(quán)限不足，PolarDB-X將提示PXC-4612錯(cuò)誤。

  建議檢查用戶擁有的PolarDB-X權(quán)限。如果權(quán)限不足，請?jiān)?span data-tag="ph" id="ph-j8i-yxe-nqz" class="ph">PolarDB-X控制臺設(shè)置。關(guān)于PolarDB-X賬號與權(quán)限設(shè)置，請參見管理數(shù)據(jù)庫賬號。

PXC-4614 ERR_EXECUTE_ON_MYSQL

• 描述：SQL語句在DN上執(zhí)行報(bào)錯(cuò)。

• 示例：

  ERR-CODE: [PXC-4614][ERR_EXECUTE_ON_MYSQL] Error occurs when execute on  GROUP '*****': Duplicate entry '*****' for key 'PRIMARY'
  PolarDB-X在后端數(shù)據(jù)節(jié)點(diǎn)數(shù)據(jù)庫上執(zhí)行SQL語句報(bào)錯(cuò)，末尾包含了從數(shù)據(jù)節(jié)點(diǎn)返回的原始錯(cuò)誤信息，例如：
   
  Duplicate entry '*****' for key 'PRIMARY'
  表示寫入數(shù)據(jù)節(jié)點(diǎn)數(shù)據(jù)表發(fā)生了主鍵沖突。
     
  The table '*****' is full
  表示數(shù)據(jù)節(jié)點(diǎn)使用的臨時(shí)表已滿，需要調(diào)整臨時(shí)表空間或優(yōu)化SQL語句。
       
  Deadlock found when trying to get lock;
  表示在數(shù)據(jù)節(jié)點(diǎn)中出現(xiàn)了死鎖，通常是數(shù)據(jù)寫入存在較多事務(wù)沖突導(dǎo)致的。

• 說明：建議參見PXC-4614提供的原始錯(cuò)誤信息排查問題。更多關(guān)于SQL語句錯(cuò)誤信息請參見MySQL 5.6文檔。如果排除應(yīng)用或數(shù)據(jù)節(jié)點(diǎn)問題后仍然發(fā)生PXC-4614錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4616 ERR_UNKNOWN_DATABASE

• 描述：錯(cuò)誤的數(shù)據(jù)庫。

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

• 說明：PolarDB-X允許在DDL語句中指定數(shù)據(jù)庫名稱。如果指定的數(shù)據(jù)庫名稱與PolarDB-X提供的數(shù)據(jù)庫名稱不一致，將返回PXC-4616錯(cuò)誤。

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

PXC-4620 ERR_FORBID_EXECUTE_DML_ALL

說明：PolarDB-X禁止不帶where條件執(zhí)行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

• 說明：該錯(cuò)誤碼表示數(shù)據(jù)庫只有讀權(quán)限，請檢查下當(dāng)前賬號的權(quán)限是否受限。

PXC-4636 ERR_DDL_JOB_ERROR

DDL語句執(zhí)行失敗。

示例：

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

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

PXC-4642 ERR_UNKNOWN_TABLE

數(shù)據(jù)庫中不存在這張表。

示例：

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

請檢查當(dāng)前數(shù)據(jù)庫中是否有這張表。

PXC-4707 ERR_OUT_OF_MEMORY

• 描述：臨時(shí)表使用內(nèi)存超限。

• 示例：ERR-CODE: [PXC-4707][ERR_OUT_OF_MEMORY]

• 說明：為了保證數(shù)據(jù)庫穩(wěn)定性，PolarDB-X限制了每條查詢的臨時(shí)表使用內(nèi)存量，說明用戶當(dāng)前的查詢涉及到的數(shù)據(jù)比較多，可以打開SPILL或者調(diào)大當(dāng)前查詢臨時(shí)表內(nèi)存限制。

PXC-4709 ERR_IVENTORY_HINT_NOT_SUPPORT_CROSS_SHARD

• 示例：ERR-CODE: [PXC-4709][ERR_IVENTORY_HINT_NOT_SUPPORT_CROSS_SHARD]

• 說明：熱點(diǎn)秒殺功能要求是單分片事務(wù)，如果涉及到多分片事務(wù)，會(huì)出現(xiàn)該錯(cuò)誤。請調(diào)整業(yè)務(wù)邏輯，確保在單分片事務(wù)下使用熱點(diǎn)功能。

PXC-4994 ERR_FLOW_CONTROL

• 描述：流量已達(dá)上限。

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

• 說明：該錯(cuò)誤代表PolarDB-X處理SQL請求已達(dá)到內(nèi)部流量上限，當(dāng)前請求被拒絕。建議檢查SQL請求量是否存在異常峰值。如果觀察到SQL請求量下降后，仍然大量提示PXC-4994錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-4998 ERR_NOT_SUPPORT

• 描述：不支持的特性。

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

• 說明：該錯(cuò)誤代表使用的SQL語法或者功能PolarDB-X尚不支持。如果這些SQL語法或者功能對您十分重要，請聯(lián)系技術(shù)支持。

PXC-5001 ERR_TRANS

• 描述：一般性的事務(wù)錯(cuò)誤。

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

• 說明：請參見錯(cuò)誤信息處理。

  • Too many lines updated in statement

    事務(wù)中的UPDATE語句更新行數(shù)超出限制（1000），建議檢查UPDATE語句的WHERE條件。如果需要在事務(wù)中執(zhí)行大批量數(shù)據(jù)更新，可以使用PolarDB-XHint/*TDDL:UNDO_LOG_LIMIT={number}*/調(diào)整限制值。

  • Deferred execution is only supported in Flexible or XA Transaction

    后置執(zhí)行功能僅僅在柔性事務(wù)與XA事務(wù)策略下可用。在用PolarDB-X的Hint/*TDDL:DEFER*/語句提交后置執(zhí)行功能之前，請先用SET drds_transaction_policy = ***命令更改PolarDB-X事務(wù)策略。

  • 其他錯(cuò)誤信息，請聯(lián)系技術(shù)支持。

PXC-5002 ERR_TRANS_UNSUPPORTED

• 描述：事務(wù)中的語法或功能尚不支持。

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

• 說明：該功能在PolarDB-X事務(wù)中尚不支持。如果此功能很重要，請聯(lián)系技術(shù)支持。

PXC-5003 ERR_TRANS_LOG

• 描述：無法訪問事務(wù)日志。

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

• 說明：為保證分布式事務(wù)的原子性，PolarDB-X在事務(wù)中會(huì)訪問后端數(shù)據(jù)節(jié)點(diǎn)上的事務(wù)日志。如果PolarDB-X在讀寫事務(wù)日志時(shí)出錯(cuò)，將返回PXC-5003錯(cuò)誤。

  產(chǎn)生PXC-5003錯(cuò)誤的原因通常來自后端的數(shù)據(jù)節(jié)點(diǎn)故障。建議檢查PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)和訪問壓力。如果排除數(shù)據(jù)節(jié)點(diǎn)問題后仍然產(chǎn)生PXC-5003錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-5006 ERR_TRANS_COMMIT

• 描述：事務(wù)提交過程中出錯(cuò)。

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

• 說明：PolarDB-X在提交事務(wù)分支過程中出錯(cuò)，TRANS_ID對應(yīng)的事務(wù)將被自動(dòng)回滾。產(chǎn)生PXC-5006錯(cuò)誤的原因通常來自后端的數(shù)據(jù)節(jié)點(diǎn)故障。建議檢查PolarDB-X后端數(shù)據(jù)節(jié)點(diǎn)狀態(tài)和訪問壓力。如果排除數(shù)據(jù)節(jié)點(diǎn)問題后仍然產(chǎn)生PXC-5006錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-5008 ERR_TRANS_TERMINATED

• 描述：事務(wù)已被Kill或超時(shí)中止。

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

• 說明：如果PolarDB-X事務(wù)在執(zhí)行中被Kill或者超時(shí)（執(zhí)行時(shí)間超出drds_transaction_timeout值），則出現(xiàn)該錯(cuò)誤。如果是事務(wù)超時(shí)導(dǎo)致報(bào)錯(cuò)，建議使用SET drds_transaction_timeout = ***命令修改PolarDB-X事務(wù)的執(zhí)行時(shí)間上限，單位是毫秒。

PXC-5010 ERR_TRANS_CONTINUE_AFTER_WRITE_FAIL

• 描述：寫入失敗后，不允許繼續(xù)進(jìn)行事務(wù)操作。

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

• 說明：如果PolarDB-X事務(wù)中涉及到分布式事務(wù)，執(zhí)行失敗后，不允許繼續(xù)進(jìn)行事務(wù)，這個(gè)時(shí)候需要前端主動(dòng)執(zhí)行rollback，重試事務(wù)操作。

PXC-5108 ERR_CHECK_PRIVILEGE_FAILED_ON_TABLE

說明：當(dāng)前賬號沒有對當(dāng)前表的操作權(quán)限，請檢查權(quán)限。

PXC-5119 ERR_FILE_CANNOT_BE_CREATE

說明：PolarDB-X默認(rèn)關(guān)閉對SELECT INTO OUTFILE語句的支持，如有需要請聯(lián)系技術(shù)支持。

PXC-5302 ERR_GLOBAL_SECONDARY_INDEX_UNSUPPORTED

說明：當(dāng)前表不支持創(chuàng)建全局二級索引。可能是如下原因?qū)е碌模?. 當(dāng)前表是單表或者廣播表；2. 全局二級索引的列不包含分區(qū)鍵。其他情況請聯(lián)系技術(shù)支持。

PXC-5306 ERR_GLOBAL_SECONDARY_INDEX_INSERT_DUPLICATE_VALUES

說明：在數(shù)據(jù)寫入到全局二級索引表過程中存在主鍵沖突，請根據(jù)報(bào)錯(cuò)信息提示的記錄值，確認(rèn)是否存在主鍵沖突。

PXC-5308 ERR_GLOBAL_SECONDARY_INDEX_MODIFY_UNIQUE_KEY

說明：在執(zhí)行DML過程中，全局二級索引表存在唯一鍵沖突，請根據(jù)報(bào)錯(cuò)信息提示的記錄值，確認(rèn)是否存在唯一鍵沖突。

PXC-5310 ERR_GLOBAL_SECONDARY_INDEX_ONLY_SUPPORT_XA

說明：PolarDB-X只有在XA/TSO分布式事務(wù)下，才支持全局二級索引，如果產(chǎn)生此報(bào)錯(cuò)，可能業(yè)務(wù)之前調(diào)整過默認(rèn)事務(wù)策略，請調(diào)整回XA/TSO分布式事務(wù)，再創(chuàng)建全局二級索引。

PXC-5313 ERR_GLOBAL_SECONDARY_INDEX_MODIFY_GSI_TABLE_WITH_DDL

說明：PolarDB-X默認(rèn)不支持對全局二級索引表做DDL操作，如有需要請聯(lián)系技術(shù)支持。

PXC-5316 ERR_GLOBAL_SECONDARY_INDEX_INDEX_AND_SHARDING_COLUMNS_NOT_MATCH

說明：PolarDB-X在創(chuàng)建全局二級索引時(shí)，要求索引字段中必須包含全局索引的區(qū)鍵（如果全局索引有多個(gè)分區(qū)鍵，例如分庫鍵和分表鍵，則必須全部包含在索引列中），例如CREATE GLOBAL INDEX idx_1 ON t(a, b) DBPARTITION BY HASH(c)會(huì)產(chǎn)生錯(cuò)誤PXC-5316，原因是ON t(a, b)子句指定了a和b為索引列，但未包含全局索引的分區(qū)鍵c。如果產(chǎn)生此報(bào)錯(cuò)，請檢查DDL語句中索引字段是否包含了全局索引的全部分區(qū)鍵。

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的表上執(zhí)行DML語句時(shí)，如果產(chǎn)生此報(bào)錯(cuò)，則不允許繼續(xù)提交包含該失敗DML語句的事務(wù)。需要修改業(yè)務(wù)代碼，DML報(bào)錯(cuò)后需要回滾事務(wù)之后重試。

PXC-5321 ERR_GLOBAL_SECONDARY_INDEX_BACKFILL_DUPLICATE_ENTRY

說明：在創(chuàng)建全局二級索引過程中，數(shù)據(jù)回填出現(xiàn)了索引表主鍵沖突，請確認(rèn)索引表的主鍵是否存在相同值。

PXC-8007 ERR_ABANDONED_TASK

說明：查詢過慢或者由于不明原因卡住超過2小時(shí)，數(shù)據(jù)庫系統(tǒng)會(huì)終止查詢，出現(xiàn)該異常。請先優(yōu)化查詢，確保不會(huì)出現(xiàn)超慢查詢，若無法解決，請聯(lián)系技術(shù)支持。

PXC-8008 ERR_EXECUTE_SPILL

說明：查詢過程中，數(shù)據(jù)過大會(huì)觸發(fā)臨時(shí)表落盤，這個(gè)錯(cuò)誤是在數(shù)據(jù)落盤過程中出現(xiàn)的異常，請聯(lián)系技術(shù)支持。

PXC-8011 ERR_OUT_OF_SPILL_SPACE

說明：查詢過程中，數(shù)據(jù)過大會(huì)觸發(fā)臨時(shí)表落盤，如果臨時(shí)表生產(chǎn)的文件過多，超過了系統(tǒng)允許的可落盤的最大磁盤空間就會(huì)出現(xiàn)此錯(cuò)誤。請先優(yōu)化查詢，減少計(jì)算過程中對臨時(shí)表的依賴。若無法解決請聯(lián)系技術(shù)支持。

PXC-8012 ERR_OUT_OF_SPILL_FD

說明：查詢過程中，數(shù)據(jù)過大會(huì)觸發(fā)臨時(shí)表落盤，如果臨時(shí)表生產(chǎn)的文件過多，超過了系統(tǒng)允許的文件句柄個(gè)數(shù)就會(huì)出現(xiàn)此錯(cuò)誤。請聯(lián)系技術(shù)支持，確保是否存在文件句柄泄漏，若沒有泄漏，可以適當(dāng)調(diào)大文件句柄個(gè)數(shù)限制。

PXC-8102 ERR_PAGE_TOO_LARGE

說明：在MPP并計(jì)算過程中，數(shù)據(jù)是按批在多個(gè)計(jì)算節(jié)點(diǎn)網(wǎng)絡(luò)交互，如果一個(gè)批的數(shù)據(jù)過大超過RPC限制最大值，就會(huì)出現(xiàn)此錯(cuò)誤，可以嘗試調(diào)小默認(rèn)CHUNK_SIZE值。

PXC-8103 ERR_NO_NODES_AVAILABLE

說明：在MPP并行計(jì)算過程中可能有計(jì)算節(jié)點(diǎn)出現(xiàn)故障，導(dǎo)致執(zhí)行調(diào)度之初沒有計(jì)算節(jié)點(diǎn)可調(diào)度，請確認(rèn)計(jì)算節(jié)點(diǎn)服務(wù)是否正常，如果計(jì)算節(jié)點(diǎn)服務(wù)都正常仍然出現(xiàn)報(bào)此類錯(cuò)誤，請聯(lián)系技術(shù)支持。

PXC-9301 ERR_DUPLICATED_PARTITION_NAME

說明：在執(zhí)行分區(qū)表相關(guān)的DDL操作過程中，使用了相同的分區(qū)表名。

PXC-9305 ERR_PARTITION_NAME_NOT_EXISTS

說明：在執(zhí)行分區(qū)表相關(guān)的DDL操作過程中，提示分區(qū)表名不存在。請檢查下分表名是否拼寫正常，使用show create table和 check table檢查表元數(shù)據(jù)是否一致，如果不一致，可能是元數(shù)據(jù)維護(hù)信息不一致導(dǎo)致。請聯(lián)系技術(shù)支持。

PXC-10004 ERR_X_PROTOCOL_RESULT

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

• 說明：PolarDB-X計(jì)算節(jié)點(diǎn)和數(shù)據(jù)節(jié)點(diǎn)采用的是私有RPC通信，出現(xiàn)這類異常主要是計(jì)算節(jié)點(diǎn)和數(shù)據(jù)節(jié)點(diǎn)建立的連接異常，具體原因有很多種，需要查看異常信息，如果無法定位具體問題，請聯(lián)系技術(shù)支持。

TDDL-4601 ERR_EXECUTOR

• 示例：

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

• 說明：SQL執(zhí)行過程出錯(cuò)。該錯(cuò)誤代表PolarDB-X在執(zhí)行SQL語句過程中出現(xiàn)了意外錯(cuò)誤。這類錯(cuò)誤通常與后端RDS MySQL異常狀態(tài)有關(guān)。