diff --git a/dashboard/dashboard-access.md b/dashboard/dashboard-access.md index 68f7b1fca85b..cbf8543e1ac6 100644 --- a/dashboard/dashboard-access.md +++ b/dashboard/dashboard-access.md @@ -37,10 +37,9 @@ TiDB Dashboard 可在常见的、更新及时的桌面浏览器中使用,具 访问 TiDB Dashboard 将会显示用户登录界面。 - 可使用 TiDB 的 root 用户登录。 +- 也可以使用单点登录 (Single Sign-On, SSO)。详情参见[配置 TiDB Dashboard 使用 SSO 登录](/dashboard/dashboard-session-sso.md)。 - 如果创建了[自定义 SQL 用户](/dashboard/dashboard-user.md),也可以使用自定义的 SQL 用户和密码登录。 -![登录界面](/media/dashboard/dashboard-access-login.png) - 如果存在以下情况,则可能会登录失败: - TiDB root 用户不存在 diff --git a/develop/dev-guide-bookshop-schema-design.md b/develop/dev-guide-bookshop-schema-design.md index 9ccaa1d27578..473854df96cf 100644 --- a/develop/dev-guide-bookshop-schema-design.md +++ b/develop/dev-guide-bookshop-schema-design.md @@ -64,30 +64,32 @@ tiup demo bookshop prepare --users=200000 --books=500000 --authors=100000 --rati ### 方法二:通过 TiDB Cloud Import 功能 -在 TiDB Cloud 的集群详情页面,你可以通过切换到 **Import** 标签页,点击 **Import Data** 按钮进入到 **Data Import** 页面。在该页面当中,按照以下步骤将 Bookshop 示例数据从 AWS S3 中导入到你的 TiDB Cloud 集群: +1. 打开目标集群的 **Import** 页面。 -1. 选择 **Data Format** 为 **SQL File**。 -2. 将以下 **Bucket URI** 和 **Role ARN** 复制到页面上对应的输入框当中: + 1. 登录 [TiDB Cloud](https://tidbcloud.com/),导航至 [**Clusters**](https://tidbcloud.com/console/clusters) 页面。 - **Bucket URI**: + > **Tip:** + > + > 如果你有多个 TiDB Cloud 项目,可以点击左下角的 切换项目。 - ``` - s3://developer.pingcap.com/bookshop/ - ``` + 2. 点击目标集群的名称,进入集群的 **Overview** 页面,然后在左侧导航栏中点击 **Import**。 - **Role ARN**: +2. 选择 **Import data from S3**。 - ``` - arn:aws:iam::494090988690:role/s3-tidb-cloud-developer-access - ``` + 如果这是你第一次使用 TiDB Cloud 的导入功能,选择 **Import From Amazon S3**。 -3. 点击 **Next** 按钮切换到 **Choose the tables to be imported** 步骤确认将要导入的文件的信息。 +3. 在 **Import Data from Amazon S3** 页面,配置以下源数据信息: -4. 点击 **Next** 按钮切换到 **Preview** 步骤确认将要导入的示例数据是否正确。 + - **Import File Count**:选择 **Multiple files** + - **Included Schema Files**:选择 **Yes** + - **Data Format**:选择 **SQL** + - **Folder URI**:输入 `s3://developer.pingcap.com/bookshop/` + - **Bucket Access**:选择 **AWS Role ARN** + - **Role ARN**:输入 `arn:aws:iam::494090988690:role/s3-tidb-cloud-developer-access` 在这个示例数据当中,预先生成了 20 万的用户信息、50 万条书籍信息、10 万条作者信息、100 万条评分记录以及 100 万条订单信息。 -5. 点击 **Start Import** 按钮开始导入数据,等待 TiDB Cloud 完成数据导入。 +4. 点击 **Connect** > **Start Import** 开始导入数据,等待 TiDB Cloud 完成数据导入。 你可以通过 [TiDB Cloud Migration Overview](https://docs.pingcap.com/tidbcloud/tidb-cloud-migration-overview) 文档获取更多有关 TiDB Cloud 数据导入和迁移的信息。 diff --git a/develop/dev-guide-gui-mysql-workbench.md b/develop/dev-guide-gui-mysql-workbench.md index 4eb66a57ee2a..a25577eccaf0 100644 --- a/develop/dev-guide-gui-mysql-workbench.md +++ b/develop/dev-guide-gui-mysql-workbench.md @@ -43,7 +43,7 @@ TiDB 是一个兼容 MySQL 的数据库。[MySQL Workbench](https://www.mysql.co 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 选择 `Public`。 + - **Connection Type** 选择 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `MySQL Workbench`。 - **Operating System** 为你的运行环境。 @@ -83,9 +83,11 @@ TiDB 是一个兼容 MySQL 的数据库。[MySQL Workbench](https://www.mysql.co 2. 点击右上角的 **Connect** 按钮,将会弹出连接对话框。 -3. 点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 有关如何获取连接字符串的更多详细信息,参考 [TiDB Cloud Dedicated 标准连接(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 启动 MySQL Workbench,并点击 **MySQL Connections** 标题旁边的 **+**。 diff --git a/develop/dev-guide-gui-navicat.md b/develop/dev-guide-gui-navicat.md index 669a86d894d0..b66c3921309b 100644 --- a/develop/dev-guide-gui-navicat.md +++ b/develop/dev-guide-gui-navicat.md @@ -44,7 +44,7 @@ TiDB 是一个兼容 MySQL 的数据库。[Navicat](https://www.navicat.com) 是 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 选择 `Public`。 + - **Connection Type** 选择 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `Navicat`。 - **Operating System** 为你的运行环境。 @@ -84,11 +84,13 @@ TiDB 是一个兼容 MySQL 的数据库。[Navicat](https://www.navicat.com) 是 2. 点击右上角的 **Connect** 按钮,将会弹出连接对话框。 -3. 点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**。 - 有关如何获取连接字符串的更多详细信息,参考 [TiDB Cloud Dedicated 标准连接(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 -4. 点击 **Download CA cert** 下载 CA 文件。 + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 + +4. 点击 **CA cert** 下载 CA 文件。 5. 启动 Navicat for MySQL,点击左上角的 **Connection**,并从下拉列表中选择 **MySQL**。 diff --git a/develop/dev-guide-sample-application-aws-lambda.md b/develop/dev-guide-sample-application-aws-lambda.md index 6a5246fa5e16..4916d71c6134 100644 --- a/develop/dev-guide-sample-application-aws-lambda.md +++ b/develop/dev-guide-sample-application-aws-lambda.md @@ -75,7 +75,7 @@ npm install 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为运行示例代码所在的操作系统。 diff --git a/develop/dev-guide-sample-application-golang-gorm.md b/develop/dev-guide-sample-application-golang-gorm.md index 20352f9a4ed8..7e81fdb4c37a 100644 --- a/develop/dev-guide-sample-application-golang-gorm.md +++ b/develop/dev-guide-sample-application-golang-gorm.md @@ -52,7 +52,7 @@ cd tidb-golang-gorm-quickstart 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -98,9 +98,11 @@ cd tidb-golang-gorm-quickstart 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-golang-sql-driver.md b/develop/dev-guide-sample-application-golang-sql-driver.md index 8e0399dc8572..6480ee54f160 100644 --- a/develop/dev-guide-sample-application-golang-sql-driver.md +++ b/develop/dev-guide-sample-application-golang-sql-driver.md @@ -53,7 +53,7 @@ cd tidb-golang-sql-driver-quickstart 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -99,9 +99,11 @@ cd tidb-golang-sql-driver-quickstart 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-java-hibernate.md b/develop/dev-guide-sample-application-java-hibernate.md index 0c8491bd36bb..2526294dd202 100644 --- a/develop/dev-guide-sample-application-java-hibernate.md +++ b/develop/dev-guide-sample-application-java-hibernate.md @@ -53,7 +53,7 @@ cd tidb-java-hibernate-quickstart 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -99,9 +99,11 @@ cd tidb-java-hibernate-quickstart 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `env.sh.example` 复制并重命名为 `env.sh`: diff --git a/develop/dev-guide-sample-application-java-jdbc.md b/develop/dev-guide-sample-application-java-jdbc.md index 8677a5521f6e..a9c7decf7e13 100644 --- a/develop/dev-guide-sample-application-java-jdbc.md +++ b/develop/dev-guide-sample-application-java-jdbc.md @@ -54,7 +54,7 @@ cd tidb-java-jdbc-quickstart 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -100,9 +100,11 @@ cd tidb-java-jdbc-quickstart 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `env.sh.example` 复制并重命名为 `env.sh`: diff --git a/develop/dev-guide-sample-application-java-mybatis.md b/develop/dev-guide-sample-application-java-mybatis.md index c48751419997..4952e0329f35 100644 --- a/develop/dev-guide-sample-application-java-mybatis.md +++ b/develop/dev-guide-sample-application-java-mybatis.md @@ -53,7 +53,7 @@ cd tidb-java-mybatis-quickstart 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -99,9 +99,11 @@ cd tidb-java-mybatis-quickstart 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `env.sh.example` 复制并重命名为 `env.sh`: diff --git a/develop/dev-guide-sample-application-java-spring-boot.md b/develop/dev-guide-sample-application-java-spring-boot.md index 4d2dce63ae13..1e165f1d7008 100644 --- a/develop/dev-guide-sample-application-java-spring-boot.md +++ b/develop/dev-guide-sample-application-java-spring-boot.md @@ -54,7 +54,7 @@ cd tidb-java-springboot-jpa-quickstart 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -100,9 +100,11 @@ cd tidb-java-springboot-jpa-quickstart 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `env.sh.example` 复制并重命名为 `env.sh`: diff --git a/develop/dev-guide-sample-application-nextjs.md b/develop/dev-guide-sample-application-nextjs.md index c44aa01b6851..efd888218fd1 100644 --- a/develop/dev-guide-sample-application-nextjs.md +++ b/develop/dev-guide-sample-application-nextjs.md @@ -69,7 +69,7 @@ npm install 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为运行示例代码所在的操作系统。 diff --git a/develop/dev-guide-sample-application-nodejs-mysql2.md b/develop/dev-guide-sample-application-nodejs-mysql2.md index 3080e19b810e..298c8cb3c0f9 100644 --- a/develop/dev-guide-sample-application-nodejs-mysql2.md +++ b/develop/dev-guide-sample-application-nodejs-mysql2.md @@ -71,7 +71,7 @@ npm install mysql2 dotenv --save 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为运行示例代码所在的操作系统。 @@ -111,9 +111,11 @@ npm install mysql2 dotenv --save 1. 在 TiDB Cloud 的 [**Clusters**](https://tidbcloud.com/console/clusters) 页面中,选择你的 TiDB Cloud Dedicated 集群,进入集群的 **Overview** 页面。 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-nodejs-mysqljs.md b/develop/dev-guide-sample-application-nodejs-mysqljs.md index 7596e7c14787..7a60c893f111 100644 --- a/develop/dev-guide-sample-application-nodejs-mysqljs.md +++ b/develop/dev-guide-sample-application-nodejs-mysqljs.md @@ -71,7 +71,7 @@ npm install mysql dotenv --save 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为运行示例代码所在的操作系统。 @@ -98,7 +98,7 @@ npm install mysql dotenv --save TIDB_DATABASE='test' TIDB_ENABLE_SSL='true' ``` - + > **Note** > > 当你使用 Public Endpoint 连接 TiDB Cloud Serverless 集群时,**必须**启用 TLS 连接,请将 `TIDB_ENABLE_SSL` 修改为 `true`。 @@ -111,9 +111,11 @@ npm install mysql dotenv --save 1. 在 TiDB Cloud 的 [**Clusters**](https://tidbcloud.com/console/clusters) 页面中,选择你的 TiDB Cloud Dedicated 集群,进入集群的 **Overview** 页面。 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 + + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-nodejs-prisma.md b/develop/dev-guide-sample-application-nodejs-prisma.md index 1e7bfd01ff4c..518a663ed46a 100644 --- a/develop/dev-guide-sample-application-nodejs-prisma.md +++ b/develop/dev-guide-sample-application-nodejs-prisma.md @@ -71,7 +71,7 @@ npm install prisma typescript ts-node @types/node --save-dev 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `Prisma`。 - **Operating System** 为运行示例代码所在的操作系统。 @@ -114,9 +114,11 @@ npm install prisma typescript ts-node @types/node --save-dev 1. 在 TiDB Cloud 的 [**Clusters**](https://tidbcloud.com/console/clusters) 页面中,选择你的 TiDB Cloud Dedicated 集群,进入集群的 **Overview** 页面。 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-nodejs-sequelize.md b/develop/dev-guide-sample-application-nodejs-sequelize.md index cbce05f64bdb..8814fb0bcb19 100644 --- a/develop/dev-guide-sample-application-nodejs-sequelize.md +++ b/develop/dev-guide-sample-application-nodejs-sequelize.md @@ -69,7 +69,7 @@ npm install 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为运行示例代码所在的操作系统。 @@ -109,9 +109,11 @@ npm install 1. 在 TiDB Cloud 的 [**Clusters**](https://tidbcloud.com/console/clusters) 页面中,选择你的 TiDB Cloud Dedicated 集群,进入集群的 **Overview** 页面。 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-nodejs-typeorm.md b/develop/dev-guide-sample-application-nodejs-typeorm.md index 1ab49f447b8f..ed4f4d65bb88 100644 --- a/develop/dev-guide-sample-application-nodejs-typeorm.md +++ b/develop/dev-guide-sample-application-nodejs-typeorm.md @@ -84,7 +84,7 @@ npm install @types/node ts-node typescript --save-dev 3. 确认对话框中的选项配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为运行示例代码所在的操作系统。 @@ -124,9 +124,11 @@ npm install @types/node ts-node typescript --save-dev 1. 在 TiDB Cloud 的 [**Clusters**](https://tidbcloud.com/console/clusters) 页面中,选择你的 TiDB Cloud Dedicated 集群,进入集群的 **Overview** 页面。 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-python-django.md b/develop/dev-guide-sample-application-python-django.md index d2e0d0b5faf9..f60260072427 100644 --- a/develop/dev-guide-sample-application-python-django.md +++ b/develop/dev-guide-sample-application-python-django.md @@ -71,7 +71,7 @@ pip install -r requirements.txt 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -115,9 +115,11 @@ pip install -r requirements.txt 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-python-mysql-connector.md b/develop/dev-guide-sample-application-python-mysql-connector.md index 6b4c4253fe7d..3bbf3f298193 100644 --- a/develop/dev-guide-sample-application-python-mysql-connector.md +++ b/develop/dev-guide-sample-application-python-mysql-connector.md @@ -61,7 +61,7 @@ pip install -r requirements.txt 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -105,9 +105,11 @@ pip install -r requirements.txt 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-python-mysqlclient.md b/develop/dev-guide-sample-application-python-mysqlclient.md index 4d15f2273fba..c80bdfd6f749 100644 --- a/develop/dev-guide-sample-application-python-mysqlclient.md +++ b/develop/dev-guide-sample-application-python-mysqlclient.md @@ -62,7 +62,7 @@ pip install -r requirements.txt 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -108,9 +108,11 @@ pip install -r requirements.txt 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-python-peewee.md b/develop/dev-guide-sample-application-python-peewee.md index 0a0bcecbed54..7ec85d99d9aa 100644 --- a/develop/dev-guide-sample-application-python-peewee.md +++ b/develop/dev-guide-sample-application-python-peewee.md @@ -64,7 +64,7 @@ peewee 是一个支持多种数据库的 ORM 库。它是对数据库的高层 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -108,9 +108,11 @@ peewee 是一个支持多种数据库的 ORM 库。它是对数据库的高层 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-python-pymysql.md b/develop/dev-guide-sample-application-python-pymysql.md index 9dbee1de0c27..75b667784c4c 100644 --- a/develop/dev-guide-sample-application-python-pymysql.md +++ b/develop/dev-guide-sample-application-python-pymysql.md @@ -60,7 +60,7 @@ pip install -r requirements.txt 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -104,9 +104,11 @@ pip install -r requirements.txt 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-python-sqlalchemy.md b/develop/dev-guide-sample-application-python-sqlalchemy.md index e1ce1db39c19..ee2bbe9b159f 100644 --- a/develop/dev-guide-sample-application-python-sqlalchemy.md +++ b/develop/dev-guide-sample-application-python-sqlalchemy.md @@ -70,7 +70,7 @@ SQLAlchemy 是一个支持多种数据库的 ORM 库。它是对数据库的高 3. 确认对话框中的配置和你的运行环境一致。 - - **Endpoint Type** 为 `Public`。 + - **Connection Type** 为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 选择 `General`。 - **Operating System** 为你的运行环境。 @@ -114,9 +114,11 @@ SQLAlchemy 是一个支持多种数据库的 ORM 库。它是对数据库的高 2. 点击右上角的 **Connect** 按钮,将会出现连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令,将 `.env.example` 复制并重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-ruby-mysql2.md b/develop/dev-guide-sample-application-ruby-mysql2.md index 8d2a2136f740..f12355d80180 100644 --- a/develop/dev-guide-sample-application-ruby-mysql2.md +++ b/develop/dev-guide-sample-application-ruby-mysql2.md @@ -76,7 +76,7 @@ bundle add mysql2 dotenv 3. 确保连接对话框中的配置与你的操作环境匹配。 - - **Endpoint Type** 设置为 `Public`。 + - **Connection Type** 设置为 `Public`。 - **Branch** 选择 `main`。 - **Connect With** 设置为 `General`。 - **Operating System** 与你运行应用程序的操作系统相匹配。 @@ -113,9 +113,11 @@ bundle add mysql2 dotenv 2. 点击右上角的 **Connect** 按钮,将会弹出连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令复制 `.env.example` 并将其重命名为 `.env`: diff --git a/develop/dev-guide-sample-application-ruby-rails.md b/develop/dev-guide-sample-application-ruby-rails.md index 843702174878..e0885bb7edf1 100644 --- a/develop/dev-guide-sample-application-ruby-rails.md +++ b/develop/dev-guide-sample-application-ruby-rails.md @@ -74,7 +74,7 @@ bundle add mysql2 dotenv 2. 点击右上角的 **Connect** 按钮,将会弹出连接对话框。 -3. 在连接对话框中,从 **Connect With** 下拉列表中选择 `Rails`,并保持 **Endpoint Type** 的默认设置为 `Public`。 +3. 在连接对话框中,从 **Connect With** 下拉列表中选择 `Rails`,并保持 **Connection Type** 的默认设置为 `Public`。 4. 如果你还没有设置密码,点击 **Generate Password** 生成一个随机密码。 @@ -103,9 +103,11 @@ bundle add mysql2 dotenv 2. 点击右上角的 **Connect** 按钮,将会弹出连接对话框。 -3. 在对话框中点击 **Allow Access from Anywhere**,然后点击 **Download CA cert** 下载 TiDB Cloud 提供的 CA 证书。 +3. 在连接对话框中,从 **Connection Type** 下拉列表中选择 **Public**,并点击 **CA cert** 下载 CA 文件。 - 更多配置细节,可参考 [TiDB Cloud Dedicated 标准连接教程(英文)](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection)。 + 如果你尚未配置 IP 访问列表,请在首次连接前点击 **Configure IP Access List** 或按照[配置 IP 访问列表(英文)](https://docs.pingcap.com/tidbcloud/configure-ip-access-list)中的步骤进行配置。 + + 除 **Public** 连接类型外,TiDB Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。详情请参阅[连接 TiDB Dedicated 集群(英文)](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令复制 `.env.example` 并将其重命名为 `.env`: diff --git a/glossary.md b/glossary.md index 119d45643b31..0f6a1ce7a2cc 100644 --- a/glossary.md +++ b/glossary.md @@ -14,7 +14,7 @@ ACID 是指数据库管理系统在写入或更新资料的过程中,为保证 * 原子性 (atomicity) 指一个事务中的所有操作,或者全部完成,或者全部不完成,不会结束在中间某个环节。TiDB 通过 Primary Key 所在 [Region](#regionpeerraft-group) 的原子性来保证分布式事务的原子性。 * 一致性 (consistency) 指在事务开始之前和结束以后,数据库的完整性没有被破坏。TiDB 在写入数据之前,会校验数据的一致性,校验通过才会写入内存并返回成功。 -* 隔离性 (isolation) 指数据库允许多个并发事务同时对其数据进行读写和修改的能力。隔离性可以防止多个事务并发执行时由于交叉执行而导致数据的不一致,主要用于处理并发场景。TiDB 目前只支持一种隔离级别,即可重复读。 +* 隔离性 (isolation) 指数据库允许多个并发事务同时对其数据进行读写和修改的能力。隔离性可以防止多个事务并发执行时由于交叉执行而导致数据的不一致,主要用于处理并发场景。关于 TiDB 支持的隔离级别,请参考 [TiDB 事务隔离级别](/transaction-isolation-levels.md#tidb-事务隔离级别)。 * 持久性 (durability) 指事务处理结束后,对数据的修改就是永久的,即便系统故障也不会丢失。在 TiDB 中,事务一旦提交成功,数据全部持久化存储到 TiKV,此时即使 TiDB 服务器宕机也不会出现数据丢失。 ## B diff --git a/information-schema/information-schema-inspection-result.md b/information-schema/information-schema-inspection-result.md index a94575b29010..3c996dfbff46 100644 --- a/information-schema/information-schema-inspection-result.md +++ b/information-schema/information-schema-inspection-result.md @@ -260,7 +260,7 @@ DETAILS | the cluster has 2 different tidb versions, execute the sql to see mo | ---- | ---- | ---- | ---- | | TiDB | panic-count | tidb_panic_count_total_count | TiDB 出现 panic 错误 | | TiDB | binlog-error | tidb_binlog_error_total_count | TiDB 写 binlog 时出现的错误 | - | TiKV | critical-error | tikv_critical_error_total_coun | TiKV 的 critical error | + | TiKV | critical-error | tikv_critical_error_total_count | TiKV 的 critical error | | TiKV | scheduler-is-busy | tikv_scheduler_is_busy_total_count | TiKV 的 scheduler 太忙,会导致 TiKV 临时不可用 | | TiKV | coprocessor-is-busy | tikv_coprocessor_is_busy_total_count | TiKV 的 coprocessor 太忙 | | TiKV | channel-is-full | tikv_channel_full_total_count | TiKV 出现 channel full 的错误 | diff --git a/pd-configuration-file.md b/pd-configuration-file.md index c17bd16b8e3e..4758f7dc0c0e 100644 --- a/pd-configuration-file.md +++ b/pd-configuration-file.md @@ -428,16 +428,20 @@ pd-server 相关配置项。 + v1:在 v1 模式下,你可以手动修改 `store limit` 以限制单个 TiKV 调度速度。 + v2:(实验特性)在 v2 模式下,你无需关注 `store limit` 值,PD 将根据 TiKV Snapshot 执行情况动态调整 TiKV 调度速度。详情请参考 [Store Limit v2 原理](/configure-store-limit.md#store-limit-v2-原理)。 -## label-property +## label-property(已废弃) -标签相关的配置项。 +标签相关的配置项,只支持 `reject-leader` 类型。 -### `key` +> **注意:** +> +> 标签相关的配置项已从 v5.2 开始废弃,建议使用 [Placement Rules](/configure-placement-rules.md#场景二5-副本按-2-2-1-的比例放置在-3-个数据中心且第-3-个中心不产生-leader) 设置副本策略。 + +### `key`(已废弃) + 拒绝 leader 的 store 带有的 label key。 + 默认值:"" -### `value` +### `value`(已废弃) + 拒绝 leader 的 store 带有的 label value。 + 默认值:"" diff --git a/pd-control.md b/pd-control.md index 0819dab1e0fc..7d706ff81e60 100644 --- a/pd-control.md +++ b/pd-control.md @@ -1149,8 +1149,6 @@ pd-ctl resource-manager config controller set ltb-max-wait-duration 30m >> scheduler config evict-leader-scheduler // v4.0.0 起,展示该调度器具体在哪些 store 上 >> scheduler config evict-leader-scheduler add-store 2 // 为 store 2 添加 leader 驱逐调度 >> scheduler config evict-leader-scheduler delete-store 2 // 为 store 2 移除 leader 驱逐调度 ->> scheduler add shuffle-leader-scheduler // 随机交换不同 store 上的 leader ->> scheduler add shuffle-region-scheduler // 随机调度不同 store 上的 Region >> scheduler add evict-slow-store-scheduler // 当有且仅有一个 slow store 时将该 store 上的所有 Region 的 leader 驱逐出去 >> scheduler remove grant-leader-scheduler-1 // 把对应的调度器删掉,`-1` 对应 store ID >> scheduler pause balance-region-scheduler 10 // 暂停运行 balance-region 调度器 10 秒 diff --git a/sql-plan-management.md b/sql-plan-management.md index 7dc2cdcf5d20..402b5f9fd751 100644 --- a/sql-plan-management.md +++ b/sql-plan-management.md @@ -31,8 +31,8 @@ CREATE [GLOBAL | SESSION] BINDING [FOR BindableStmt] USING BindableStmt; 该语句可以在 GLOBAL 或者 SESSION 作用域内为 SQL 绑定执行计划。目前,可创建执行计划绑定的 SQL 语句类型 (BindableStmt) 包括:`SELECT`、`DELETE`、`UPDATE` 和带有 `SELECT` 子查询的 `INSERT`/`REPLACE`。使用示例如下: ```sql -CREATE GLOBAL BINDING USING SELECT * /*+ use_index(t1, a) */ FROM t1; -CREATE GLOBAL BINDING FOR SELECT * FROM t1 USING SELECT * /*+ use_index(t1, a) */ FROM t1; +CREATE GLOBAL BINDING USING SELECT /*+ use_index(t1, idx_a) */ * FROM t1; +CREATE GLOBAL BINDING FOR SELECT * FROM t1 USING SELECT /*+ use_index(t1, idx_a) */ * FROM t1; ``` > **注意:** @@ -88,13 +88,13 @@ USING CREATE GLOBAL BINDING for INSERT INTO t1 SELECT * FROM t2 WHERE a > 1 AND b = 1 USING - INSERT INTO t1 SELECT /*+ use_index(@sel_1 t2, a) */ * FROM t2 WHERE a > 1 AND b = 1; + INSERT INTO t1 SELECT /*+ use_index(@sel_1 t2, idx_a) */ * FROM t2 WHERE a > 1 AND b = 1; -- Hint 不能生效的用法 CREATE GLOBAL BINDING for INSERT INTO t1 SELECT * FROM t2 WHERE a > 1 AND b = 1 USING - INSERT /*+ use_index(@sel_1 t2, a) */ INTO t1 SELECT * FROM t2 WHERE a > 1 AND b = 1; + INSERT /*+ use_index(@sel_1 t2, idx_a) */ INTO t1 SELECT * FROM t2 WHERE a > 1 AND b = 1; ``` 如果在创建执行计划绑定时不指定作用域,隐式作用域 SESSION 会被使用。TiDB 优化器会将被绑定的 SQL 进行“标准化”处理,然后存储到系统表中。在处理 SQL 查询时,只要“标准化”后的 SQL 和系统表中某个被绑定的 SQL 语句一致,并且系统变量 [`tidb_use_plan_baselines`](/system-variables.md#tidb_use_plan_baselines-从-v40-版本开始引入) 的值为 `on`(其默认值为 `on`),即可使用相应的优化器 Hint。如果存在多个可匹配的执行计划,优化器会从中选择代价最小的一个进行绑定。 @@ -127,7 +127,7 @@ SELECT * FROM test . t WHERE a > ? > > ```sql > CREATE TABLE t (a INT, KEY(a)); -> CREATE BINDING FOR SELECT * FROM t WHERE a IN (?) USING SELECT /*+ use_index(t, a) */ * FROM t WHERE a in (?); +> CREATE BINDING FOR SELECT * FROM t WHERE a IN (?) USING SELECT /*+ use_index(t, idx_a) */ * FROM t WHERE a in (?); > > SELECT * FROM t WHERE a IN (1); > SELECT @@LAST_PLAN_FROM_BINDING; @@ -152,21 +152,21 @@ SELECT * FROM test . t WHERE a > ? > > ```sql > -- 在 v7.3.0 集群上创建绑定 -> mysql> CREATE GLOBAL BINDING FOR SELECT * FROM t WHERE a IN (1) USING SELECT /*+ use_index(t, a) */ * FROM t WHERE a IN (1); +> mysql> CREATE GLOBAL BINDING FOR SELECT * FROM t WHERE a IN (1) USING SELECT /*+ use_index(t, idx_a) */ * FROM t WHERE a IN (1); > mysql> SHOW GLOBAL BINDINGS; -> +-----------------------------------------------+--------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ -> | Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | -> +-----------------------------------------------+--------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ -> | select * from `test` . `t` where `a` in ( ? ) | SELECT /*+ use_index(`t` `a`)*/ * FROM `test`.`t` WHERE `a` IN (1) | test | enabled | 2023-10-20 14:28:10.093 | 2023-10-20 14:28:10.093 | utf8 | utf8_general_ci | manual | 8b9c4e6ab8fad5ba29b034311dcbfc8a8ce57dde2e2d5d5b65313b90ebcdebf7 | | -> +-----------------------------------------------+--------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ +> +-----------------------------------------------+------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ +> | Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | +> +-----------------------------------------------+------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ +> | select * from `test` . `t` where `a` in ( ? ) | SELECT /*+ use_index(`t` `idx_a`)*/ * FROM `test`.`t` WHERE `a` IN (1) | test | enabled | 2024-09-03 15:39:02.695 | 2024-09-03 15:39:02.695 | utf8mb4 | utf8mb4_general_ci | manual | 8b9c4e6ab8fad5ba29b034311dcbfc8a8ce57dde2e2d5d5b65313b90ebcdebf7 | | +> +-----------------------------------------------+------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ > > -- 升级到 v7.4.0 或更高的版本后 > mysql> SHOW GLOBAL BINDINGS; -> +-------------------------------------------------+--------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ -> | Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | -> +-------------------------------------------------+--------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ -> | select * from `test` . `t` where `a` in ( ... ) | SELECT /*+ use_index(`t` `a`)*/ * FROM `test`.`t` WHERE `a` IN (1) | test | enabled | 2023-10-20 14:28:10.093 | 2023-10-20 14:28:10.093 | utf8 | utf8_general_ci | manual | 8b9c4e6ab8fad5ba29b034311dcbfc8a8ce57dde2e2d5d5b65313b90ebcdebf7 | | -> +-------------------------------------------------+--------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ +> +-------------------------------------------------+------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ +> | Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | +> +-------------------------------------------------+------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ +> | select * from `test` . `t` where `a` in ( ... ) | SELECT /*+ use_index(`t` `idx_a`)*/ * FROM `test`.`t` WHERE `a` IN (1) | test | enabled | 2024-09-03 15:35:59.861 | 2024-09-03 15:35:59.861 | utf8mb4 | utf8mb4_general_ci | manual | da38bf216db4a53e1a1e01c79ffa42306419442ad7238480bb7ac510723c8bdf | | +> +-------------------------------------------------+------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ > ``` 值得注意的是,如果一条 SQL 语句在 GLOBAL 和 SESSION 作用域内都有与之绑定的执行计划,因为优化器在遇到 SESSION 绑定时会忽略 GLOBAL 绑定的执行计划,该语句在 SESSION 作用域内绑定的执行计划会屏蔽掉语句在 GLOBAL 作用域内绑定的执行计划。 @@ -246,9 +246,9 @@ CREATE [GLOBAL | SESSION] BINDING FROM HISTORY USING PLAN DIGEST StringLiteralOr 例如: ```sql - CREATE TABLE t(id INT PRIMARY KEY , a INT, KEY(a)); - SELECT /*+ IGNORE_INDEX(t, a) */ * FROM t WHERE a = 1; - SELECT * FROM INFORMATION_SCHEMA.STATEMENTS_SUMMARY WHERE QUERY_SAMPLE_TEXT = 'SELECT /*+ IGNORE_INDEX(t, a) */ * FROM t WHERE a = 1'\G + CREATE TABLE t(id INT PRIMARY KEY , a INT, KEY idx_a(a)); + SELECT /*+ IGNORE_INDEX(t, idx_a) */ * FROM t WHERE a = 1; + SELECT * FROM INFORMATION_SCHEMA.STATEMENTS_SUMMARY WHERE QUERY_SAMPLE_TEXT = 'SELECT /*+ IGNORE_INDEX(t, idx_a) */ * FROM t WHERE a = 1'\G ``` 以下为 `statements_summary` 部分查询结果: @@ -283,7 +283,7 @@ SHOW BINDINGS\G ``` *************************** 1. row *************************** Original_sql: select * from `test` . `t` where `a` = ? - Bind_sql: SELECT /*+ use_index(@`sel_1` `test`.`t` ) ignore_index(`t` `a`)*/ * FROM `test`.`t` WHERE `a` = 1 + Bind_sql: SELECT /*+ use_index(@`sel_1` `test`.`t` ) ignore_index(`t` `idx_a`)*/ * FROM `test`.`t` WHERE `a` = 1 ........... Sql_digest: 6909a1bbce5f64ade0a532d7058dd77b6ad5d5068aee22a531304280de48349f Plan_digest: @@ -537,20 +537,20 @@ ORDER BY SUM(exec_count) DESC LIMIT 100; -- Top 100 high-f 使用跨数据库绑定,只需要在创建绑定的 SQL 语句中将数据库名用 `*` 表示,例如: ```sql -CREATE GLOBAL BINDING USING SELECT /*+ use_index(t, a) */ * FROM t; -- 创建 GLOBAL 作用域的普通绑定 -CREATE GLOBAL BINDING USING SELECT /*+ use_index(t, a) */ * FROM *.t; -- 创建 GLOBAL 作用域的跨数据库绑定 +CREATE GLOBAL BINDING USING SELECT /*+ use_index(t, idx_a) */ * FROM t; -- 创建 GLOBAL 作用域的普通绑定 +CREATE GLOBAL BINDING USING SELECT /*+ use_index(t, idx_a) */ * FROM *.t; -- 创建 GLOBAL 作用域的跨数据库绑定 SHOW GLOBAL BINDINGS; ``` 输出结果示例如下: ```sql -+----------------------------+---------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ -| Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | -+----------------------------+---------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ -| select * from `test` . `t` | SELECT /*+ use_index(`t` `a`)*/ * FROM `test`.`t` | test | enabled | 2023-12-29 14:19:01.332 | 2023-12-29 14:19:01.332 | utf8 | utf8_general_ci | manual | 8b193b00413fdb910d39073e0d494c96ebf24d1e30b131ecdd553883d0e29b42 | | -| select * from `*` . `t` | SELECT /*+ use_index(`t` `a`)*/ * FROM `*`.`t` | | enabled | 2023-12-29 14:19:02.232 | 2023-12-29 14:19:02.232 | utf8 | utf8_general_ci | manual | 8b193b00413fdb910d39073e0d494c96ebf24d1e30b131ecdd553883d0e29b42 | | -+----------------------------+---------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+-----------------+--------+------------------------------------------------------------------+-------------+ ++----------------------------+---------------------------------------------------+------------+---------+-------------------------+-------------------------+--------------+-----------------+--------+------------------------------------------------------------------+-------------+ +| Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | ++----------------------------+---------------------------------------------------+------------+---------+-------------------------+-------------------------+--------------+-----------------+--------+------------------------------------------------------------------+-------------+ +| select * from `test` . `t` | SELECT /*+ use_index(`t` `idx_a`)*/ * FROM `test`.`t` | test | enabled | 2023-12-29 14:19:01.332 | 2023-12-29 14:19:01.332 | utf8 | utf8_general_ci | manual | 8b193b00413fdb910d39073e0d494c96ebf24d1e30b131ecdd553883d0e29b42 | | +| select * from `*` . `t` | SELECT /*+ use_index(`t` `idx_a`)*/ * FROM `*`.`t` | | enabled | 2023-12-29 14:19:02.232 | 2023-12-29 14:19:02.232 | utf8 | utf8_general_ci | manual | 8b193b00413fdb910d39073e0d494c96ebf24d1e30b131ecdd553883d0e29b42 | | ++----------------------------+---------------------------------------------------+------------+---------+-------------------------+-------------------------+--------------+-----------------+--------+------------------------------------------------------------------+-------------+ ``` 在 `SHOW GLOBAL BINDINGS` 的输出结果中,跨数据库绑定的 `Default_db` 为空,且 `Original_sql` 和 `Bind_sql` 字段中的数据库名通过 `*` 表示。这条绑定会对所有 `select * from t` 查询生效,而不限于特定数据库。 @@ -579,7 +579,7 @@ SHOW GLOBAL BINDINGS; 3. 创建跨数据库绑定: ```sql - CREATE GLOBAL BINDING USING SELECT /*+ use_index(t1, a), use_index(t2, a) */ * FROM *.t1, *.t2; + CREATE GLOBAL BINDING USING SELECT /*+ use_index(t1, idx_a), use_index(t2, idx_a) */ * FROM *.t1, *.t2; ``` 4. 执行查询并查看是否使用了绑定: @@ -623,11 +623,11 @@ SHOW GLOBAL BINDINGS; ```sql SHOW GLOBAL BINDINGS; - +----------------------------------------------+------------------------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ - | Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | - +----------------------------------------------+------------------------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ - | select * from ( `*` . `t1` ) join `*` . `t2` | SELECT /*+ use_index(`t1` `a`) use_index(`t2` `a`)*/ * FROM (`*` . `t1`) JOIN `*` . `t2` | | enabled | 2023-12-29 14:22:28.144 | 2023-12-29 14:22:28.144 | utf8 | utf8_general_ci | manual | ea8720583e80644b58877663eafb3579700e5f918a748be222c5b741a696daf4 | | - +----------------------------------------------+------------------------------------------------------------------------------------------+------------+---------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ + +----------------------------------------------+------------------------------------------------------------------------------------------+------------+-----------------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ + | Original_sql | Bind_sql | Default_db | Status | Create_time | Update_time | Charset | Collation | Source | Sql_digest | Plan_digest | + +----------------------------------------------+------------------------------------------------------------------------------------------+------------+-----------------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ + | select * from ( `*` . `t1` ) join `*` . `t2` | SELECT /*+ use_index(`t1` `idx_a`) use_index(`t2` `idx_a`)*/ * FROM (`*` . `t1`) JOIN `*` . `t2` | | enabled | 2023-12-29 14:22:28.144 | 2023-12-29 14:22:28.144 | utf8 | utf8_general_ci | manual | ea8720583e80644b58877663eafb3579700e5f918a748be222c5b741a696daf4 | | + +----------------------------------------------+------------------------------------------------------------------------------------------+------------+-----------------+-------------------------+-------------------------+---------+--------------------+--------+------------------------------------------------------------------+-------------+ ``` 6. 删除绑定: diff --git a/ticdc/ticdc-sink-to-kafka.md b/ticdc/ticdc-sink-to-kafka.md index ce846e93aa12..fa3a92560847 100644 --- a/ticdc/ticdc-sink-to-kafka.md +++ b/ticdc/ticdc-sink-to-kafka.md @@ -225,10 +225,10 @@ dispatchers = [ Topic 分发器用 topic = "xxx" 来指定,并使用 topic 表达式来实现灵活的 topic 分发策略。topic 的总数建议小于 1000。 -Topic 表达式的基本规则为 `[prefix][{schema}][middle][{table}][suffix]`,详细解释如下: +Topic 表达式的基本规则为 `[prefix]{schema}[middle][{table}][suffix]`,详细解释如下: - `prefix`:可选项,代表 Topic Name 的前缀。 -- `{schema}`:可选项,用于匹配库名。 +- `{schema}`:必选项,用于匹配库名。从 v7.1.4 开始,该参数为可选项。 - `middle`:可选项,代表库表名之间的分隔符。 - `{table}`:可选项,用于匹配表名。 - `suffix`:可选项,代表 Topic Name 的后缀。 diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index 744beac640a2..a7fff3c342f9 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -538,6 +538,10 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ + 默认值:true + 默认可以执行在做 join 时两边表没有任何条件(where 字段)的语句;如果设置为 false,则有这样的 join 语句出现时,server 会拒绝执行 +> **注意:** +> +> 在创建集群时,不要将 `cross-join` 设置为 false,否则会导致集群启动失败。 + ### `stats-lease` + TiDB 重载统计信息,更新表行数,检查是否需要自动 analyze,利用 feedback 更新统计信息以及加载列的统计信息的时间间隔。 diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 115870f8e2eb..d8138d11bafd 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -193,6 +193,10 @@ delta_index_cache_size = 0 ## 在 v6.2.0 以及后续版本,强烈建议保留默认值 `false`,不要将其修改为 `true`。具体请参考已知问题 [#5576](https://github.com/pingcap/tiflash/issues/5576)。 # dt_enable_logical_split = false + ## `max_threads` 指的是执行一个 MMP Task 的内部线程并发度,默认值为 0。当值为 0 时,TiFlash 执行 MMP Task 的线程并发度为 CPU 核数。 + ## 该参数只有在系统变量 `tidb_max_tiflash_threads` 设置为 -1 时才会生效。 + max_threads = 0 + ## 单次查询过程中,节点对中间数据的内存限制 ## 设置为整数时,单位为 byte,比如 34359738368 表示 32 GiB 的内存限制,0 表示无限制 ## 设置为 [0.0, 1.0) 之间的浮点数时,指节点总内存的比值,比如 0.8 表示总内存的 80%,0.0 表示无限制