From f1388d45af49f8238caddcbb65c409e52910518c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dani=C3=ABl=20van=20Eeden?= Date: Thu, 25 Jan 2024 03:12:21 +0100 Subject: [PATCH] More MySQL 8.x compatibility updates (#16270) --- dm/dm-overview.md | 4 ++-- error-codes.md | 2 +- faq/tidb-faq.md | 2 +- generated-columns.md | 2 +- overview.md | 4 ++-- tidb-architecture.md | 2 +- tidb-cloud/tidb-cloud-faq.md | 2 +- tidb-cloud/tidb-cloud-poc.md | 4 ++-- 8 files changed, 11 insertions(+), 11 deletions(-) diff --git a/dm/dm-overview.md b/dm/dm-overview.md index b1e9ba04f930d..a11d048cd5a51 100644 --- a/dm/dm-overview.md +++ b/dm/dm-overview.md @@ -16,7 +16,7 @@ aliases: ['/docs/tidb-data-migration/dev/overview/','/docs/tidb-data-migration/d ## Basic features -- **Compatibility with MySQL.** DM is compatible with MySQL 5.7 protocols and most of the features and syntax of MySQL 5.7. +- **Compatibility with MySQL.** DM is compatible with the MySQL protocol and most of the features and syntax of MySQL 5.7 and MySQL 8.0. - **Replicating DML and DDL events.** It supports parsing and replicating DML and DDL events in MySQL binlog. - **Migrating and merging MySQL shards.** DM supports migrating and merging multiple MySQL database instances upstream to one TiDB database downstream. It supports customizing replication rules for different migration scenarios. It can automatically detect and handle DDL changes of upstream MySQL shards, which greatly reduces the operational cost. - **Various types of filters.** You can predefine event types, regular expressions, and SQL expressions to filter out MySQL binlog events during the data migration process. @@ -90,4 +90,4 @@ Before v5.4, the DM documentation is independent of the TiDB documentation. To a > **Note:** > > - Since October 2021, DM's GitHub repository has been moved to [pingcap/tiflow](https://github.com/pingcap/tiflow/tree/master/dm). If you see any issues with DM, submit your issue to the `pingcap/tiflow` repository for feedback. -> - In earlier versions (v1.0 and v2.0), DM uses version numbers that are independent of TiDB. Since v5.3, DM uses the same version number as TiDB. The next version of DM v2.0 is DM v5.3. There are no compatibility changes from DM v2.0 to v5.3, and the upgrade process is the same as a normal upgrade, only an increase in version number. \ No newline at end of file +> - In earlier versions (v1.0 and v2.0), DM uses version numbers that are independent of TiDB. Since v5.3, DM uses the same version number as TiDB. The next version of DM v2.0 is DM v5.3. There are no compatibility changes from DM v2.0 to v5.3, and the upgrade process is the same as a normal upgrade, only an increase in version number. diff --git a/error-codes.md b/error-codes.md index 1069950f6a552..08252447127c5 100644 --- a/error-codes.md +++ b/error-codes.md @@ -10,7 +10,7 @@ This document describes the problems encountered during the use of TiDB and prov ## Error codes -TiDB is compatible with the error codes in MySQL, and in most cases returns the same error code as MySQL. For a list of error codes for MySQL, see [MySQL 5.7 Error Message Reference](https://dev.mysql.com/doc/mysql-errors/5.7/en/). In addition, TiDB has the following unique error codes: +TiDB is compatible with the error codes in MySQL, and in most cases returns the same error code as MySQL. For a list of error codes for MySQL, see [MySQL 8.0 Error Message Reference](https://dev.mysql.com/doc/mysql-errors/8.0/en/). In addition, TiDB has the following unique error codes: > **Note:** > diff --git a/faq/tidb-faq.md b/faq/tidb-faq.md index 4668ff9d06322..7d30346996796 100644 --- a/faq/tidb-faq.md +++ b/faq/tidb-faq.md @@ -44,7 +44,7 @@ Yes, it is. When all the required services are started, you can use TiDB as easi ### How is TiDB compatible with MySQL? -Currently, TiDB supports the majority of MySQL 5.7 syntax, but does not support triggers, stored procedures, and user-defined functions. For more details, see [Compatibility with MySQL](/mysql-compatibility.md). +Currently, TiDB supports the majority of MySQL 8.0 syntax, but does not support triggers, stored procedures, and user-defined functions. For more details, see [Compatibility with MySQL](/mysql-compatibility.md). ### Does TiDB support distributed transactions? diff --git a/generated-columns.md b/generated-columns.md index 7dac14075c60e..56238ddd2c034 100644 --- a/generated-columns.md +++ b/generated-columns.md @@ -20,7 +20,7 @@ You can create an index on a generated column whether it is virtual or stored. One of the main usage of generated columns is to extract data from the JSON data type and indexing the data. -In both MySQL 5.7 and TiDB, columns of type JSON cannot be indexed directly. That is, the following table schema is **not supported**: +In both MySQL 8.0 and TiDB, columns of type JSON cannot be indexed directly. That is, the following table schema is **not supported**: {{< copyable "sql" >}} diff --git a/overview.md b/overview.md index 65defc64836e4..96c17e9eb245d 100644 --- a/overview.md +++ b/overview.md @@ -38,9 +38,9 @@ The following video introduces key features of TiDB. TiDB is a distributed database designed for the cloud, providing flexible scalability, reliability, and security on the cloud platform. Users can elastically scale TiDB to meet the requirements of their changing workloads. In TiDB, each piece of data has at least 3 replicas, which can be scheduled in different cloud availability zones to tolerate the outage of a whole data center. [TiDB Operator](https://docs.pingcap.com/tidb-in-kubernetes/stable/tidb-operator-overview) helps manage TiDB on Kubernetes and automates tasks related to operating the TiDB cluster, making TiDB easier to deploy on any cloud that provides managed Kubernetes. [TiDB Cloud](https://pingcap.com/tidb-cloud/), the fully-managed TiDB service, is the easiest, most economical, and most resilient way to unlock the full power of [TiDB in the cloud](https://docs.pingcap.com/tidbcloud/), allowing you to deploy and run TiDB clusters with just a few clicks. -- **Compatible with the MySQL 5.7 protocol and MySQL ecosystem** +- **Compatible with the MySQL protocol and MySQL ecosystem** - TiDB is compatible with the MySQL 5.7 protocol, common features of MySQL, and the MySQL ecosystem. To migrate applications to TiDB, you do not need to change a single line of code in many cases, or only need to modify a small amount of code. In addition, TiDB provides a series of [data migration tools](/ecosystem-tool-user-guide.md) to help easily migrate application data into TiDB. + TiDB is compatible with the MySQL protocol, common features of MySQL, and the MySQL ecosystem. To migrate applications to TiDB, you do not need to change a single line of code in many cases, or only need to modify a small amount of code. In addition, TiDB provides a series of [data migration tools](/ecosystem-tool-user-guide.md) to help easily migrate application data into TiDB. ## Use cases diff --git a/tidb-architecture.md b/tidb-architecture.md index 590aa4bd3ee56..50fb12f6b32cf 100644 --- a/tidb-architecture.md +++ b/tidb-architecture.md @@ -9,7 +9,7 @@ aliases: ['/docs/dev/architecture/','/tidb/dev/architecture'] Compared with the traditional standalone databases, TiDB has the following advantages: * Has a distributed architecture with flexible and elastic scalability. -* Fully compatible with the MySQL 5.7 protocol, common features and syntax of MySQL. To migrate your applications to TiDB, you do not need to change a single line of code in many cases. +* Fully compatible with the MySQL protocol, common features and syntax of MySQL. To migrate your applications to TiDB, you do not need to change a single line of code in many cases. * Supports high availability with automatic failover when a minority of replicas fail; transparent to applications. * Supports ACID transactions, suitable for scenarios requiring strong consistency such as bank transfer. diff --git a/tidb-cloud/tidb-cloud-faq.md b/tidb-cloud/tidb-cloud-faq.md index 42abab3e2cce8..a58acf56737c8 100644 --- a/tidb-cloud/tidb-cloud-faq.md +++ b/tidb-cloud/tidb-cloud-faq.md @@ -25,7 +25,7 @@ TiDB Cloud is a fully managed cloud Database as a Service of TiDB. It has an eas ### Is TiDB Cloud compatible with MySQL? -Currently, TiDB Cloud supports the majority of MySQL 5.7 syntax with the exception of triggers, stored procedures, user-defined functions, and foreign keys. For more details, see [Compatibility with MySQL](https://docs.pingcap.com/tidb/stable/mysql-compatibility). +Currently, TiDB Cloud supports the majority of MySQL 5.7 and MySQL 8.0 syntax with the exception of triggers, stored procedures, and user-defined functions. For more details, see [Compatibility with MySQL](/mysql-compatibility.md). ### What programming languages can I use to work with TiDB Cloud? diff --git a/tidb-cloud/tidb-cloud-poc.md b/tidb-cloud/tidb-cloud-poc.md index ca02723d8d086..0afbfef8f87a1 100644 --- a/tidb-cloud/tidb-cloud-poc.md +++ b/tidb-cloud/tidb-cloud-poc.md @@ -52,7 +52,7 @@ TiDB Cloud is suitable for various use cases that require high availability and - Horizontally scaling out or scaling in - Financial-grade high availability - Real-time HTAP -- Compatible with the MySQL 5.7 protocol and MySQL ecosystem +- Compatible with the MySQL protocol and MySQL ecosystem You might also be interested in using [TiFlash](https://docs.pingcap.com/tidb/stable/tiflash-overview), a columnar storage engine that helps speed up analytical processing. During the PoC, you can use the TiFlash feature at any time. @@ -89,7 +89,7 @@ Next, you can load your database schemas to the TiDB cluster, including tables a Because the amount of PoC credits is limited, to maximize the value of credits, it is recommended that you create a [TiDB Serverless cluster](/tidb-cloud/select-cluster-tier.md#tidb-serverless) for compatibility tests and preliminary analysis on TiDB Cloud. -TiDB Cloud is highly compatible with MySQL 5.7. You can directly import your data into TiDB if it is MySQL-compatible or can be adapted to be compatible with MySQL. +TiDB Cloud is highly compatible with MySQL 8.0. You can directly import your data into TiDB if it is MySQL-compatible or can be adapted to be compatible with MySQL. For more information about compatibilities, see the following documents: