4041fbc062
Right should be: If `check_query_single_value_result` = 1, the `CHECK TABLE` query shows the general table check status. Old wrong: If `check_query_single_value_result` = 0, the `CHECK TABLE` query shows the general table check status.
2.9 KiB
| toc_priority | toc_title |
|---|---|
| 41 | CHECK |
CHECK TABLE Statement
Checks if the data in the table is corrupted.
CHECK TABLE [db.]name
The CHECK TABLE query compares actual file sizes with the expected values which are stored on the server. If the file sizes do not match the stored values, it means the data is corrupted. This can be caused, for example, by a system crash during query execution.
The query response contains the result column with a single row. The row has a value of
Boolean type:
- 0 - The data in the table is corrupted.
- 1 - The data maintains integrity.
The CHECK TABLE query supports the following table engines:
Performed over the tables with another table engines causes an exception.
Engines from the *Log family do not provide automatic data recovery on failure. Use the CHECK TABLE query to track data loss in a timely manner.
Checking the MergeTree Family Tables
For MergeTree family engines, if check_query_single_value_result = 0, the CHECK TABLE query shows a check status for every individual data part of a table on the local server.
SET check_query_single_value_result = 0;
CHECK TABLE test_table;
┌─part_path─┬─is_passed─┬─message─┐
│ all_1_4_1 │ 1 │ │
│ all_1_4_2 │ 1 │ │
└───────────┴───────────┴─────────┘
If check_query_single_value_result = 1, the CHECK TABLE query shows the general table check status.
SET check_query_single_value_result = 1;
CHECK TABLE test_table;
┌─result─┐
│ 1 │
└────────┘
If the Data Is Corrupted
If the table is corrupted, you can copy the non-corrupted data to another table. To do this:
- Create a new table with the same structure as damaged table. To do this execute the query
CREATE TABLE <new_table_name> AS <damaged_table_name>. - Set the max_threads value to 1 to process the next query in a single thread. To do this run the query
SET max_threads = 1. - Execute the query
INSERT INTO <new_table_name> SELECT * FROM <damaged_table_name>. This request copies the non-corrupted data from the damaged table to another table. Only the data before the corrupted part will be copied. - Restart the
clickhouse-clientto reset themax_threadsvalue.