全部產品
Search
文件中心

PolarDB:CHECK GLOBAL INDEX

更新時間:Jul 06, 2024

您可以使用CHECK GLOBAL INDEX語句檢查主表和索引表的資料是否完全一致,並修訂不一致的資料。

文法

CHECK GLOBAL INDEX gsi_name [ON tbl_name] [extra_cmd]
參數說明
gsi_name需要校正的全域二級索引名。
tbl_name全域二級索引所在的主表,非必選。若您輸入具體主表名稱,將會檢查全域二級索引表和主表間的索引關係是否正確。
extra_cmd保留的額外指令,目前支援如下指令:
  • -:不指定任何關鍵字時,即表示僅檢查全域二級索引。
  • SHOW:顯示指定GSI表的最近一次校正或訂正的結果。
  • CORRECTION_BASED_ON_PRIMARY:對全域二級索引表中的資料進行訂正,以主表為基準。
說明
  • 對全域二級索引表中的資料進行校正或訂正時會佔用一定的系統資源,特別是訂正操作會對主表或索引表內資料分批加鎖並訂正,建議您在業務低穀期進行操作。更多關於GSI的使用方式,請參見全域二級索引
  • 對大表的GSI校正可能會花費較多的時間,可以使用HINT指定PURE_ASYNC_DDL_MODE,以純非同步模式執行DDL語句。

樣本

  • 您可以使用如下語句進行校正:
    CHECK GLOBAL INDEX `g_i_check`;
    • 若校正沒有發現錯誤,則返回如下結果:
      +-------------+------------+--------+-------------+-----------------------------+
      | GSI_TABLE   | ERROR_TYPE | STATUS | PRIMARY_KEY | DETAILS                     |
      +-------------+------------+--------+-------------+-----------------------------+
      | `g_i_check` | SUMMARY    | --     | --          | OK (7025/7025 rows checked) |
      +-------------+------------+--------+-------------+-----------------------------+
      1 row in set (1.40 sec)
    • 若校正發現錯誤,則返回如下結果:
      +-------------+------------+--------+-------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
      | GSI_TABLE   | ERROR_TYPE | STATUS | PRIMARY_KEY | DETAILS                                                                                                                                                                                                                                                                                                                                                                                        |
      +-------------+------------+--------+-------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
      | `g_i_check` | ORPHAN     | FOUND  | (100722)    | {"GSI":{"id":100722,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_binary":"OTkAAAAAAAAAAA==","c_int_32":271}}                                                                                                                                                                                              |
      | `g_i_check` | CONFLICT   | FOUND  | (108710)    | {"Primary":{"id":108710,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_year":"2000","c_int_32":255},"GSI":{"c_int_32_un":123456,"id":108710,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_year":"2000","c_int_32":255}} |
      | `g_i_check` | MISSING    | FOUND  | (100090)    | {"Primary":{"id":100090,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_blob_tiny":"YeS4reWbvWE=","c_int_32":280}}                                                                                                                                                                                           |
      | `g_i_check` | SUMMARY    | --     | --          | 3 error found (7025/7025 rows checked)                                                                                                                                                                                                                                                                                                                                                         |
      +-------------+------------+--------+-------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
      4 rows in set (1.92 sec)
      說明 如果資料存在多種錯誤,同一行資料會報多個ERROR_TYPE值。
  • 您可以使用如下語句進行訂正:
    CHECK GLOBAL INDEX g_i_check CORRECTION_BASED_ON_PRIMARY;

    返回結果如下:

    +-------------+------------+--------+-------------+------------------------------------------------------------------------+
    | GSI_TABLE   | ERROR_TYPE | STATUS | PRIMARY_KEY | DETAILS                                                                |
    +-------------+------------+--------+-------------+------------------------------------------------------------------------+
    | `g_i_check` | SUMMARY    | --     | --          | Done. Use SQL: { CHECK GLOBAL INDEX `g_i_check` SHOW; } to get result. |
    +-------------+------------+--------+-------------+------------------------------------------------------------------------+
    1 row in set (1.40 sec)
  • 您可以使用如下語句查看最近一次校正或訂正的報告:
    CHECK GLOBAL INDEX `g_i_check` SHOW;

    返回結果如下:

    +-------------+------------+----------+-------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | GSI_TABLE   | ERROR_TYPE | STATUS   | PRIMARY_KEY | DETAILS                                                                                                                                                                                                                                                                                                                                                                                        |
    +-------------+------------+----------+-------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | `g_i_check` | MISSING    | REPAIRED | (100090)    | {"Primary":{"id":100090,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_blob_tiny":"YeS4reWbvWE=","c_int_32":280}}                                                                                                                                                                                           |
    | `g_i_check` | CONFLICT   | REPAIRED | (108710)    | {"Primary":{"id":108710,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_year":"2000","c_int_32":255},"GSI":{"c_int_32_un":123456,"id":108710,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_year":"2000","c_int_32":255}} |
    | `g_i_check` | ORPHAN     | REPAIRED | (100722)    | {"GSI":{"id":100722,"c_timestamp_6":"2000-01-01 00:00:00.000000","c_timestamp_3":"2000-01-01 00:00:00.000","c_timestamp_1":"2000-01-01 00:00:00.0","c_binary":"OTkAAAAAAAAAAA==","c_int_32":271}}                                                                                                                                                                                              |
    | `g_i_check` | SUMMARY    | --       | --          | 3 error found (7025/7026 rows checked.) Finish time: 2020-01-13 14:41:51.0                                                                                                                                                                                                                                                                                                                     |
    +-------------+------------+----------+-------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    4 rows in set (0.02 sec)
表 1. 列名說明
列名說明
GSI_TABLE全域二級索引名。
ERROR_TYPE錯誤類型,取值範圍如下:
  • MISSING:索引丟失;
  • ORPHAN:孤兒索引;
  • CONFLICT:索引資料不一致;
  • ERROR_SHARD:資料分區位置錯誤;
  • SUMMARY:結果匯總。
STATUS狀態,取值範圍如下:
  • FOUND:發現錯誤;
  • REPAIRED:已修複。
PRIMARY_KEY主鍵。
DETAILS錯誤的詳細資料。