| title | summary | aliases | ||
|---|---|---|---|---|
TiDB Features |
Learn about the feature overview of TiDB. |
|
This document lists the features supported in different TiDB versions, including Long-Term Support (LTS) versions and Development Milestone Release (DMR) versions after the latest LTS version.
You can try out TiDB features on TiDB Playground.
Note:
PingCAP does not provide patch releases for DMR versions. Any bugs will be fixed in future releases. For general purposes, it is recommended to use the latest LTS version.
The abbreviations in the table below have the following meanings:
- Y: the feature is generally available (GA) and can be used in production environments. Note that even if a feature is GA in a DMR version, it is recommended to use the feature in production environments in a later LTS version.
- N: the feature is not supported.
- E: the feature is not GA yet (experimental) and you need to be aware of the usage limitations. Experimental features are subject to change or removal without prior notice. The syntax and implementation might be modified before the general availability. If you encounter any problems, you can report an issue on GitHub.
| Data types, functions, and operators | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Numeric types | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Date and time types | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| String types | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| JSON type | Y | Y | Y | Y | E | E | E | E | E | E | E |
| Control flow functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| String functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Numeric functions and operators | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Date and time functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Bit functions and operators | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Cast functions and operators | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Encryption and compression functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Information functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| JSON functions | Y | Y | Y | Y | E | E | E | E | E | E | E |
| Aggregation functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Window functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Miscellaneous functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Operators | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Character sets and collations 1 | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| User-level lock | Y | Y | Y | Y | Y | N | N | N | N | N | N |
| Indexing and constraints | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Expression indexes 2 | Y | Y | Y | Y | E | E | E | E | E | E | E |
| Columnar storage (TiFlash) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Use FastScan to accelerate queries in OLAP scenarios | Y | Y | Y | E | N | N | N | N | N | N | N |
| RocksDB engine | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Titan plugin | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Titan Level Merge | E | E | E | E | E | E | E | E | E | E | E |
| Use buckets to improve scan concurrency | E | E | E | E | E | N | N | N | N | N | N |
| Invisible indexes | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
Composite PRIMARY KEY |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
CHECK constraints |
Y | Y | N | N | N | N | N | N | N | N | N |
| Unique indexes | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
Clustered index on integer PRIMARY KEY |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Clustered index on composite or non-integer key | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
| Multi-valued indexes | Y | Y | Y | N | N | N | N | N | N | N | N |
| Foreign key | Y | Y | Y | N | N | N | N | N | N | N | N |
| TiFlash late materialization | Y | Y | Y | N | N | N | N | N | N | N | N |
| SQL statements 3 | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
Basic SELECT, INSERT, UPDATE, DELETE, REPLACE |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
INSERT ON DUPLICATE KEY UPDATE |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
LOAD DATA INFILE |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
SELECT INTO OUTFILE |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
INNER JOIN, LEFT|RIGHT [OUTER] JOIN |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
UNION, UNION ALL |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
EXCEPT and INTERSECT operators |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
GROUP BY, ORDER BY |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Window Functions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Common Table Expressions (CTE) | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N |
START TRANSACTION, COMMIT, ROLLBACK |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
EXPLAIN |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
EXPLAIN ANALYZE |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| User-defined variables | E | E | E | E | E | E | E | E | E | E | E |
BATCH [ON COLUMN] LIMIT INTEGER DELETE |
Y | Y | Y | Y | Y | N | N | N | N | N | N |
BATCH [ON COLUMN] LIMIT INTEGER INSERT/UPDATE/REPLACE |
Y | Y | Y | Y | N | N | N | N | N | N | N |
ALTER TABLE ... COMPACT |
Y | Y | Y | Y | E | N | N | N | N | N | N |
| Table Lock | E | E | E | E | E | E | E | E | E | E | E |
| TiFlash Query Result Materialization | Y | Y | Y | E | N | N | N | N | N | N | N |
| Advanced SQL features | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Prepared statement cache | Y | Y | Y | Y | Y | Y | Y | E | E | E | E |
| Non-prepared statement cache | E | E | E | N | N | N | N | N | N | N | N |
| SQL plan management (SPM) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Create bindings according to historical execution plans | Y | Y | Y | E | N | N | N | N | N | N | N |
| Coprocessor cache | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | E |
| Stale Read | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N |
| Follower reads | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Read historical data (tidb_snapshot) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Optimizer hints | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| MPP execution engine | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
| MPP execution engine - compression exchange | Y | Y | Y | N | N | N | N | N | N | N | N |
| TiFlash Pipeline Model | E | E | N | N | N | N | N | N | N | N | N |
| TiFlash replica selection strategy | Y | N | N | N | N | N | N | N | N | N | N |
| Index Merge | Y | Y | Y | Y | Y | Y | E | E | E | E | E |
| Placement Rules in SQL | Y | Y | Y | Y | Y | E | E | N | N | N | N |
| Cascades Planner | E | E | E | E | E | E | E | E | E | E | E |
| Runtime Filter | Y | N | N | N | N | N | N | N | N | N | N |
| Data definition language (DDL) | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
Basic CREATE, DROP, ALTER, RENAME, TRUNCATE |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Generated columns | Y | Y | Y | E | E | E | E | E | E | E | E |
| Views | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Sequences | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Auto increment | Y | Y | Y | Y4 | Y | Y | Y | Y | Y | Y | Y |
| Auto random | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| TTL (Time to Live) | Y | Y | Y | E | N | N | N | N | N | N | N |
| DDL algorithm assertions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Multi-schema change: add columns | Y | Y | Y | Y | E | E | E | E | E | E | E |
| Change column type | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N |
| Temporary tables | Y | Y | Y | Y | Y | Y | Y | N | N | N | N |
| Concurrent DDL statements | Y | Y | Y | Y | N | N | N | N | N | N | N |
Acceleration of ADD INDEX and CREATE INDEX |
Y | Y | Y | Y | N | N | N | N | N | N | N |
| Metadata lock | Y | Y | Y | Y | N | N | N | N | N | N | N |
FLASHBACK CLUSTER TO TIMESTAMP |
Y | Y | Y | Y | N | N | N | N | N | N | N |
| Pause/Resume DDL | E | E | N | N | N | N | N | N | N | N | N |
| Transactions | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Async commit | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
| 1PC | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
| Large transactions (10GB) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Pessimistic transactions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Optimistic transactions | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Repeatable-read isolation (snapshot isolation) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Read-committed isolation | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Partitioning | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Range partitioning | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Hash partitioning | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Key partitioning | Y | Y | Y | N | N | N | N | N | N | N | N |
| List partitioning | Y | Y | Y | Y | Y | E | E | E | E | E | N |
| List COLUMNS partitioning | Y | Y | Y | Y | Y | E | E | E | E | E | N |
| Default partition for List and List COLUMNS partitioned tables | Y | N | N | N | N | N | N | N | N | N | N |
EXCHANGE PARTITION |
Y | Y | Y | Y | E | E | E | E | E | E | N |
REORGANIZE PARTITION |
Y | Y | Y | N | N | N | N | N | N | N | N |
COALESCE PARTITION |
Y | Y | Y | N | N | N | N | N | N | N | N |
| Dynamic pruning | Y | Y | Y | Y | Y | E | E | E | E | N | N |
| Range COLUMNS partitioning | Y | Y | Y | Y | N | N | N | N | N | N | N |
| Range INTERVAL partitioning | Y | Y | Y | E | N | N | N | N | N | N | N |
| Statistics | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 6.0 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| CMSketch | Disabled by default | Disabled by default | Disabled by default | Disabled by default | Disabled by default | Disabled by default | Disabled by default | Disabled by default | Y | Y | Y |
| Histograms | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Extended statistics | E | E | E | E | E | E | E | E | E | E | E |
| Statistics feedback | N | N | N | N | Deprecated | Deprecated | Deprecated | E | E | E | E |
| Automatically update statistics | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Fast Analyze | E | E | E | E | E | E | E | E | E | E | E |
| Dynamic pruning | Y | Y | Y | Y | Y | E | E | E | E | E | N |
Collect statistics for PREDICATE COLUMNS |
E | E | E | E | E | E | E | N | N | N | N |
| Control the memory quota for collecting statistics | E | E | E | E | E | N | N | N | N | N | N |
| Randomly sample about 10000 rows of data to quickly build statistics | E | E | E | E | E | E | E | E | E | E | E |
| Lock statistics | E | E | E | E | N | N | N | N | N | N | N |
| Lightweight statistics initialization | Y | Y | E | N | N | N | N | N | N | N | N |
| Show the progress of collecting statistics | Y | N | N | N | N | N | N | N | N | N | N |
| Security | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Transparent layer security (TLS) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Encryption at rest (TDE) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Role-based authentication (RBAC) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Certificate-based authentication | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
caching_sha2_password authentication |
Y | Y | Y | Y | Y | Y | Y | Y | N | N | N |
tidb_sm3_password authentication |
Y | Y | Y | Y | N | N | N | N | N | N | N |
tidb_auth_token authentication |
Y | Y | Y | Y | N | N | N | N | N | N | N |
authentication_ldap_sasl authentication |
Y | Y | Y | N | N | N | N | N | N | N | N |
authentication_ldap_simple authentication |
Y | Y | Y | N | N | N | N | N | N | N | N |
| Password management | Y | Y | Y | Y | N | N | N | N | N | N | N |
MySQL compatible GRANT system |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Dynamic Privileges | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N |
| Security Enhanced Mode | Y | Y | Y | Y | Y | Y | Y | Y | Y | N | N |
| Redacted Log Files | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N |
| Data import and export | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Fast import using TiDB Lightning | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
Fast import using the IMPORT INTO statement |
E | E | N | N | N | N | N | N | N | N | N |
| mydumper logical dumper | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated | Deprecated |
| Dumpling logical dumper | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
Transactional LOAD DATA 5 |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | N 6 |
| Database migration toolkit (DM) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| TiDB Binlog | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Change data capture (CDC) | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Stream data to Amazon S3, GCS, Azure Blob Storage, and NFS through TiCDC | Y | Y | Y | E | N | N | N | N | N | N | N |
| TiCDC supports bidirectional replication between two TiDB clusters | Y | Y | Y | Y | N | N | N | N | N | N | N |
| TiCDC OpenAPI v2 | Y | Y | Y | N | N | N | N | N | N | N | N |
| Management, observability, and tools | 7.3 | 7.2 | 7.1 | 6.5 | 6.1 | 5.4 | 5.3 | 5.2 | 5.1 | 5.0 | 4.0 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| TiDB Dashboard UI | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| TiDB Dashboard Continuous Profiling | Y | Y | Y | Y | Y | E | E | N | N | N | N |
| TiDB Dashboard Top SQL | Y | Y | Y | Y | Y | E | N | N | N | N | N |
| TiDB Dashboard SQL Diagnostics | Y | Y | Y | Y | E | E | E | E | E | E | E |
| TiDB Dashboard Cluster Diagnostics | Y | Y | Y | Y | E | E | E | E | E | E | E |
| TiKV-FastTune dashboard | E | E | E | E | E | E | E | E | E | E | E |
| Information schema | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Metrics schema | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Statements summary tables | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Statements summary tables - summary persistence | E | E | E | N | N | N | N | N | N | N | N |
| Slow query log | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| TiUP deployment | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Kubernetes operator | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Built-in physical backup | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Global Kill | Y | Y | Y | Y | Y | E | E | E | E | E | E |
| Lock View | Y | Y | Y | Y | Y | Y | Y | Y | E | E | E |
SHOW CONFIG |
Y | Y | Y | Y | Y | Y | Y | Y | Y | Y | Y |
SET CONFIG |
Y | Y | Y | Y | Y | E | E | E | E | E | E |
| DM WebUI | E | E | E | E | E | N | N | N | N | N | N |
| Foreground Quota Limiter | Y | Y | Y | Y | E | N | N | N | N | N | N |
| Background Quota Limiter | E | E | E | E | N | N | N | N | N | N | N |
| EBS volume snapshot backup and restore | Y | Y | Y | Y | N | N | N | N | N | N | N |
| PITR | Y | Y | Y | Y | N | N | N | N | N | N | N |
| Global memory control | Y | Y | Y | Y | N | N | N | N | N | N | N |
| Cross-cluster RawKV replication | E | E | E | E | N | N | N | N | N | N | N |
| Green GC | E | E | E | E | E | E | E | E | E | E | N |
| Resource control | Y | Y | Y | N | N | N | N | N | N | N | N |
| Runaway Queries Management | E | E | N | N | N | N | N | N | N | N | N |
| TiFlash Disaggregated Storage and Compute Architecture and S3 Support | E | E | E | N | N | N | N | N | N | N | N |
Footnotes
-
TiDB incorrectly treats latin1 as a subset of utf8. See TiDB #18955 for more details. ↩
-
Starting from v6.5.0, the expression indexes created on the functions listed by the
tidb_allow_function_for_expression_indexsystem variable have been tested and can be used in production environments, and more functions will be supported in the future releases. For functions not listed by this variable, the corresponding expression indexes are not recommended for use in production environments. See expression indexes for details. ↩ -
See Statement Reference for a full list of SQL statements supported. ↩
-
Starting from v6.4.0, TiDB supports high-performance and globally monotonic
AUTO_INCREMENTcolumns ↩ -
Starting from TiDB v7.0.0, the new parameter
FIELDS DEFINED NULL BYand support for importing data from S3 and GCS are experimental features. ↩ -
For TiDB v4.0, the
LOAD DATAtransaction does not guarantee atomicity. ↩