- Docs Home
- About TiDB
- Quick Start
- Develop
- Overview
- Quick Start
- Build a TiDB Cluster in TiDB Cloud (Developer Tier)
- CRUD SQL in TiDB
- Build a Simple CRUD App with TiDB
- Example Applications
- Connect to TiDB
- Design Database Schema
- Write Data
- Read Data
- Transaction
- Optimize
- Troubleshoot
- Reference
- Cloud Native Development Environment
- Third-party Support
- Deploy
- Software and Hardware Requirements
- Environment Configuration Checklist
- Plan Cluster Topology
- Install and Start
- Verify Cluster Status
- Test Cluster Performance
- Migrate
- Overview
- Migration Tools
- Migration Scenarios
- Migrate from Aurora
- Migrate MySQL of Small Datasets
- Migrate MySQL of Large Datasets
- Migrate and Merge MySQL Shards of Small Datasets
- Migrate and Merge MySQL Shards of Large Datasets
- Migrate from CSV Files
- Migrate from SQL Files
- Migrate from One TiDB Cluster to Another TiDB Cluster
- Migrate from TiDB to MySQL-compatible Databases
- Advanced Migration
- Integrate
- Overview
- Integration Scenarios
- Maintain
- Monitor and Alert
- Troubleshoot
- TiDB Troubleshooting Map
- Identify Slow Queries
- Analyze Slow Queries
- SQL Diagnostics
- Identify Expensive Queries Using Top SQL
- Identify Expensive Queries Using Logs
- Statement Summary Tables
- Troubleshoot Hotspot Issues
- Troubleshoot Increased Read and Write Latency
- Save and Restore the On-Site Information of a Cluster
- Troubleshoot Cluster Setup
- Troubleshoot High Disk I/O Usage
- Troubleshoot Lock Conflicts
- Troubleshoot TiFlash
- Troubleshoot Write Conflicts in Optimistic Transactions
- Troubleshoot Inconsistency Between Data and Indexes
- Performance Tuning
- Tuning Guide
- Configuration Tuning
- System Tuning
- Software Tuning
- SQL Tuning
- Overview
- Understanding the Query Execution Plan
- SQL Optimization Process
- Overview
- Logic Optimization
- Physical Optimization
- Prepare Execution Plan Cache
- Control Execution Plans
- Tutorials
- TiDB Tools
- Overview
- Use Cases
- Download
- TiUP
- Documentation Map
- Overview
- Terminology and Concepts
- Manage TiUP Components
- FAQ
- Troubleshooting Guide
- Command Reference
- Overview
- TiUP Commands
- TiUP Cluster Commands
- Overview
- tiup cluster audit
- tiup cluster check
- tiup cluster clean
- tiup cluster deploy
- tiup cluster destroy
- tiup cluster disable
- tiup cluster display
- tiup cluster edit-config
- tiup cluster enable
- tiup cluster help
- tiup cluster import
- tiup cluster list
- tiup cluster patch
- tiup cluster prune
- tiup cluster reload
- tiup cluster rename
- tiup cluster replay
- tiup cluster restart
- tiup cluster scale-in
- tiup cluster scale-out
- tiup cluster start
- tiup cluster stop
- tiup cluster template
- tiup cluster upgrade
- TiUP DM Commands
- Overview
- tiup dm audit
- tiup dm deploy
- tiup dm destroy
- tiup dm disable
- tiup dm display
- tiup dm edit-config
- tiup dm enable
- tiup dm help
- tiup dm import
- tiup dm list
- tiup dm patch
- tiup dm prune
- tiup dm reload
- tiup dm replay
- tiup dm restart
- tiup dm scale-in
- tiup dm scale-out
- tiup dm start
- tiup dm stop
- tiup dm template
- tiup dm upgrade
- TiDB Cluster Topology Reference
- DM Cluster Topology Reference
- Mirror Reference Guide
- TiUP Components
- PingCAP Clinic Diagnostic Service
- TiDB Operator
- Dumpling
- TiDB Lightning
- TiDB Data Migration
- About TiDB Data Migration
- Architecture
- Quick Start
- Deploy a DM cluster
- Tutorials
- Advanced Tutorials
- Maintain
- Cluster Upgrade
- Tools
- Performance Tuning
- Manage Data Sources
- Manage Tasks
- Export and Import Data Sources and Task Configurations of Clusters
- Handle Alerts
- Daily Check
- Reference
- Architecture
- Command Line
- Configuration Files
- OpenAPI
- Compatibility Catalog
- Secure
- Monitoring and Alerts
- Error Codes
- Glossary
- Example
- Troubleshoot
- Release Notes
- Backup & Restore (BR)
- Point-in-Time Recovery
- TiDB Binlog
- TiCDC
- Dumpling
- sync-diff-inspector
- TiSpark
- Reference
- Cluster Architecture
- Key Monitoring Metrics
- Secure
- Privileges
- SQL
- SQL Language Structure and Syntax
- SQL Statements
ADD COLUMNADD INDEXADMINADMIN CANCEL DDLADMIN CHECKSUM TABLEADMIN CHECK [TABLE|INDEX]ADMIN SHOW DDL [JOBS|QUERIES]ADMIN SHOW TELEMETRYALTER DATABASEALTER INDEXALTER INSTANCEALTER PLACEMENT POLICYALTER TABLEALTER TABLE COMPACTALTER TABLE SET TIFLASH MODEALTER USERANALYZE TABLEBACKUPBATCHBEGINCHANGE COLUMNCOMMITCHANGE DRAINERCHANGE PUMPCREATE [GLOBAL|SESSION] BINDINGCREATE DATABASECREATE INDEXCREATE PLACEMENT POLICYCREATE ROLECREATE SEQUENCECREATE TABLE LIKECREATE TABLECREATE USERCREATE VIEWDEALLOCATEDELETEDESCDESCRIBEDODROP [GLOBAL|SESSION] BINDINGDROP COLUMNDROP DATABASEDROP INDEXDROP PLACEMENT POLICYDROP ROLEDROP SEQUENCEDROP STATSDROP TABLEDROP USERDROP VIEWEXECUTEEXPLAIN ANALYZEEXPLAINFLASHBACK TABLEFLUSH PRIVILEGESFLUSH STATUSFLUSH TABLESGRANT <privileges>GRANT <role>INSERTKILL [TIDB]LOAD DATALOAD STATSMODIFY COLUMNPREPARERECOVER TABLERENAME INDEXRENAME TABLEREPLACERESTOREREVOKE <privileges>REVOKE <role>ROLLBACKSAVEPOINTSELECTSET DEFAULT ROLESET [NAMES|CHARACTER SET]SET PASSWORDSET ROLESET TRANSACTIONSET [GLOBAL|SESSION] <variable>SHOW ANALYZE STATUSSHOW [BACKUPS|RESTORES]SHOW [GLOBAL|SESSION] BINDINGSSHOW BUILTINSSHOW CHARACTER SETSHOW COLLATIONSHOW [FULL] COLUMNS FROMSHOW CONFIGSHOW CREATE PLACEMENT POLICYSHOW CREATE SEQUENCESHOW CREATE TABLESHOW CREATE USERSHOW DATABASESSHOW DRAINER STATUSSHOW ENGINESSHOW ERRORSSHOW [FULL] FIELDS FROMSHOW GRANTSSHOW INDEX [FROM|IN]SHOW INDEXES [FROM|IN]SHOW KEYS [FROM|IN]SHOW MASTER STATUSSHOW PLACEMENTSHOW PLACEMENT FORSHOW PLACEMENT LABELSSHOW PLUGINSSHOW PRIVILEGESSHOW [FULL] PROCESSSLISTSHOW PROFILESSHOW PUMP STATUSSHOW SCHEMASSHOW STATS_HEALTHYSHOW STATS_HISTOGRAMSSHOW STATS_METASHOW STATUSSHOW TABLE NEXT_ROW_IDSHOW TABLE REGIONSSHOW TABLE STATUSSHOW [FULL] TABLESSHOW [GLOBAL|SESSION] VARIABLESSHOW WARNINGSSHUTDOWNSPLIT REGIONSTART TRANSACTIONTABLETRACETRUNCATEUPDATEUSEWITH
- Data Types
- Functions and Operators
- Overview
- Type Conversion in Expression Evaluation
- Operators
- Control Flow Functions
- String Functions
- Numeric Functions and Operators
- Date and Time Functions
- Bit Functions and Operators
- Cast Functions and Operators
- Encryption and Compression Functions
- Locking Functions
- Information Functions
- JSON Functions
- Aggregate (GROUP BY) Functions
- Window Functions
- Miscellaneous Functions
- Precision Math
- Set Operations
- List of Expressions for Pushdown
- TiDB Specific Functions
- Clustered Indexes
- Constraints
- Generated Columns
- SQL Mode
- Table Attributes
- Transactions
- Garbage Collection (GC)
- Views
- Partitioning
- Temporary Tables
- Cached Tables
- Character Set and Collation
- Placement Rules in SQL
- System Tables
mysql- INFORMATION_SCHEMA
- Overview
ANALYZE_STATUSCLIENT_ERRORS_SUMMARY_BY_HOSTCLIENT_ERRORS_SUMMARY_BY_USERCLIENT_ERRORS_SUMMARY_GLOBALCHARACTER_SETSCLUSTER_CONFIGCLUSTER_HARDWARECLUSTER_INFOCLUSTER_LOADCLUSTER_LOGCLUSTER_SYSTEMINFOCOLLATIONSCOLLATION_CHARACTER_SET_APPLICABILITYCOLUMNSDATA_LOCK_WAITSDDL_JOBSDEADLOCKSENGINESINSPECTION_RESULTINSPECTION_RULESINSPECTION_SUMMARYKEY_COLUMN_USAGEMETRICS_SUMMARYMETRICS_TABLESPARTITIONSPLACEMENT_POLICIESPROCESSLISTREFERENTIAL_CONSTRAINTSSCHEMATASEQUENCESSESSION_VARIABLESSLOW_QUERYSTATISTICSTABLESTABLE_CONSTRAINTSTABLE_STORAGE_STATSTIDB_HOT_REGIONSTIDB_HOT_REGIONS_HISTORYTIDB_INDEXESTIDB_SERVERS_INFOTIDB_TRXTIFLASH_REPLICATIKV_REGION_PEERSTIKV_REGION_STATUSTIKV_STORE_STATUSUSER_PRIVILEGESVARIABLES_INFOVIEWS
METRICS_SCHEMA
- UI
- TiDB Dashboard
- Overview
- Maintain
- Access
- Overview Page
- Cluster Info Page
- Top SQL Page
- Key Visualizer Page
- Metrics Relation Graph
- SQL Statements Analysis
- Slow Queries Page
- Cluster Diagnostics
- Monitoring Page
- Search Logs Page
- Instance Profiling
- Session Management and Configuration
- FAQ
- CLI
- Command Line Flags
- Configuration File Parameters
- System Variables
- Storage Engines
- Telemetry
- Errors Codes
- Table Filter
- Schedule Replicas by Topology Labels
- FAQs
- Release Notes
- All Releases
- Release Timeline
- TiDB Versioning
- TiDB Installation Packages
- v6.2
- v6.1
- v6.0
- v5.4
- v5.3
- v5.2
- v5.1
- v5.0
- v4.0
- v3.1
- v3.0
- v2.1
- v2.0
- v1.0
- Glossary
TiDB 2.1.17 Release Notes
Release date: September 11, 2019
TiDB version: 2.1.17
TiDB Ansible version: 2.1.17
New features
- Add the
WHEREclause in TiDB’sSHOW TABLE REGIONSsyntax - Add the
config-checkfeature in TiKV and PD to check the configuration items - Add the
remove-tombstonecommand in pd-ctl to clear tombstone store records - Add the
worker-countandtxn-batchconfiguration items in Reparo to control the recovery speed
- Add the
Improvements
- Optimize PD’s scheduling process by supporting actively pushing operators
- Optimize TiKV’s starting process to reduce jitters caused by restarting nodes
Changed behaviors
- Change
start tsin TiDB slow query logs from the last retry time to the first execution time - Replace the
Index_idsfield in TiDB slow query logs with theIndex_namesfield to improve the usability of slow query logs - Add the
split-region-max-numparameter in TiDB’s configuration files to modify the maximum number of Regions allowed by theSPLIT TABLEsyntax, which is increased from 1,000 to 10,000 in the default configuration
- Change
TiDB
- SQL Optimizer
- Fix the issue that the error message is not returned correctly when an error occurs during
EvalSubquerybuildingExecutor#11811 - Fix the issue that the query result might be incorrect when the number of rows in the outer table is greater than that in a single batch in Index Lookup Join; expand the functional scope of Index Lookup Join;
UnionScancan be used as a subnode ofIndexJoin#11843 - Add the display of invalid keys (like
invalid encoded key flag 252) in theSHOW STAT_BUCKETSsyntax, for the situation where invalid keys might occur during the statistics feedback process #12098
- Fix the issue that the error message is not returned correctly when an error occurs during
- SQL Execution Engine
- Fix some incorrect results (like
select cast(13835058000000000000 as double)) caused by the number value that is first converted toUINTwhen theCASTfunction is converting the number value type #11712 - Fix the issue that the calculation result might be incorrect when the dividend of the
DIVcalculation is a decimal and this calculation contains a negative number #11812 - Add the
ConvertStrToIntStrictfunction to fix the MySQL incompatibility issue caused by some strings being converted to theINTtype when executing theSELECT/EXPLAINstatement #11892 - Fix the issue that the
Explainresult might be incorrect caused by wrong configuration ofstmtCtxwhenEXPLAIN ... FOR CONNECTIONis used #11978 - Fix the issue that the result returned by the
unaryMinusfunction is incompatible with MySQL, caused by the non-decimal result when the integer result overflows #11990 - Fix the issue that
last_insert_id()might be incorrect, caused by the counting order when theLOAD DATAstatement is being executed #11994 - Fix the issue that
last_insert_id()might be incorrect when the user writes auto-increment column data in an explicit-implicit mixed way #12001 - Fix an over-quoted bug for the
JSON_UNQUOTEfunction: only values enclosed by double quote marks (") should be unquoted. For example, the result of “SELECT JSON_UNQUOTE("\\\\")” should be “\\” (not changed) #12096
- Fix some incorrect results (like
- Server
- Change
start tsrecorded in slow query logs from the last retry time to the first execution time when retrying TiDB transactions #11878 - Add the number of keys of a transaction in
LockResolverto avoid the scan operation on the whole Region and reduce costs of resolving locking when the number of keys is reduced #11889 - Fix the issue that the
succfield value might be incorrect in slow query logs #11886 - Replace the
Index_idsfiled in slow query logs with theIndex_namesfield to improve the usability of slow query logs #12063 - Fix the connection break issue caused by TiDB parsing
-into EOF Error whenDurationcontains-(likeselect time(‘--’)) #11910 - Remove an invalid Region from
RegionCachemore quickly to reduce the number of requests sent to this Region #11931 - Fix the connection break issue caused by incorrectly handling the OOM panic issue when
oom-action = "cancel"and OOM occurs in theInsert Into … Selectsyntax #12126
- Change
- DDL
- Add the reverse scan interface for
tikvSnapshotto efficiently query DDL history jobs. After using this interface, the execution time ofADMIN SHOW DDL JOBSis remarkably decreased #11789 - Improve the
CREATE TABLE ... PRE_SPLIT_REGIONsyntax: change the number of pre-splitting Regions from 2^(N-1) to 2^N whenPRE_SPLIT_REGION = N#11797 - Decrease the default parameter value for the background worker thread of the
Add Indexoperation to avoid great impacts on online workloads #11875 - Improve the
SPLIT TABLEsyntax behavior: generate N data Region(s) and one index Region whenSPLIT TABLE ... REGIONS Nis used to divide Regions #11929 - Add the
split-region-max-numparameter (10000by default) in the configuration file to make the maximum number of Regions allowed by theSPLIT TABLEsyntax adjustable #12080 - Fix the issue that the
CREATE TABLEclause cannot be parsed by the downstream MySQL, caused by uncommentedPRE_SPLIT_REGIONSin this clause when the system writes the binlog #12121 - Add the
WHEREsub-clause inSHOW TABLE … REGIONSandSHOW TABLE .. INDEX … REGIONS#12124
- Add the reverse scan interface for
- Monitor
- Add the
connection_transient_failure_countmonitoring metric to count gRPC connection errors oftikvclient#12092
- Add the
TiKV
- Fix the incorrect result of counting keys in a Region in some cases #5415
- Add the
config-checkoption in TiKV to check whether the TiKV configuration item is valid #5391 - Optimize the starting process to reduce jitters caused by restarting nodes #5277
- Optimize the resolving locking process in some cases to speed up resolving locking for transactions #5339
- Optimize the
get_txn_commit_infoprocess to speed up committing transactions #5062 - Simplify Raft-related logs #5425
- Resolve the issue that TiKV exits abnormally in some cases #5441
PD
- Add the
config-checkoption in PD to check whether the PD configuration item is valid #1725 - Add the
remove-tombstonecommand in pd-ctl to support clearing tombstone store records #1705 - Support actively pushing operators to speed up scheduling #1686
Tools
- TiDB Binlog
- Add
worker-countandtxn-batchconfiguration items in Reparo to control the recovery speed #746 - Optimize the memory usage of Drainer to improve the parallel execution efficiency #735
- Fix the bug that Pump cannot quit normally in some cases #739
- Optimize the processing logic of
LevelDBin Pump to improve the execution efficiency of GC #720
- Add
- TiDB Lightning
- Fix the bug that tidb-lightning might crash caused by re-importing data from the checkpoint #239
TiDB Ansible
What’s on this page
Was this page helpful?