Use an HTAP Cluster

HTAP means Hybrid Transactional/Analytical Processing. With TiDB Cloud, you can create an HTAP cluster by choosing the h1.standard cluster tier.

The HTAP cluster in TiDB Cloud is composed of TiKV, a row-based storage engine designed for transactional processing, and TiFlash, a columnar storage designed for analytical processing. Your application data is first stored in TiKV and then replicated to TiFlash via the Raft consensus algorithm. So it's real time synchronization between the row store and the columnar store.

TiKV data is not replicated to TiFlash by default. You can select which table to replicate to TiFlash using the following SQL statement:


The number of replicas count must be smaller than the number of TiFlash nodes. Setting the number of replicas to 0 means deleting the replica in TiFlash.

To check the replication progress, use the following command:

SELECT * FROM information_schema.tiflash_replica WHERE TABLE_SCHEMA = '<db_name>' and TABLE_NAME = '<table_name>';

Use TiDB to read TiFlash replicas

After data is replicated to TiFlash, you can use one of the following three ways to read TiFlash replicas to accelerate your analytical computing.

Smart selection

For tables with TiFlash replicas, the TiDB optimizer automatically determines whether to use TiFlash replicas based on the cost estimation. For example:

explain analyze select count(*) from test.t;
| id                       | estRows | actRows | task         | access object | execution info                                                       | operator info                  | memory    | disk |
| StreamAgg_9              | 1.00    | 1       | root         |               | time:83.8372ms, loops:2                                              | funcs:count(1)->Column#4       | 372 Bytes | N/A  |
| └─TableReader_17         | 1.00    | 1       | root         |               | time:83.7776ms, loops:2, rpc num: 1, rpc time:83.5701ms, proc keys:0 | data:TableFullScan_16          | 152 Bytes | N/A  |
|   └─TableFullScan_16     | 1.00    | 1       | cop[tiflash] | table:t       | time:43ms, loops:1                                                   | keep order:false, stats:pseudo | N/A       | N/A  |

cop[tiflash] means that the task will be sent to TiFlash for processing. If your queries have not selected a TiFlash replica, try to update the statistics using the analyze table statement, and then check the result using the explain analyze statement.

Engine isolation

Engine isolation is to specify that all queries use a replica of the specified engine by configuring the tidb_isolation_read_engines variable. The optional engines are "tikv", "tidb" (indicates the internal memory table area of TiDB, which stores some TiDB system tables and cannot be actively used by users), and "tiflash".

set @@session.tidb_isolation_read_engines = "engine list separated by commas";

Manual hint

Manual hint can force TiDB to use specified replicas for one or more specific tables on the premise of satisfying engine isolation. Here is an example of using the manual hint:

select /*+ read_from_storage(tiflash[table_name]) */ ... from table_name;

To learn more about TiFlash, refer to TiFlash documentation.