Skip to content

Commit 3a44c53

Browse files
author
github-actions
committed
update MD by dispatch event pingcap/docs feature/preview-top-navigation
1 parent 3f1b183 commit 3a44c53

15 files changed

+52
-47
lines changed

markdown-pages/en/tidb/release-8.5/TOC-develop.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,6 @@
2020
- [VS Code](/develop/dev-guide-gui-vscode-sqltools.md)
2121
- [MySQL Workbench](/develop/dev-guide-gui-mysql-workbench.md)
2222
- [Navicat](/develop/dev-guide-gui-navicat.md)
23-
- [Looker Studio](/develop/dev-guide-bi-looker-studio.md)
2423
- Drivers & ORMs
2524
- [Choose a Driver or ORM](/develop/dev-guide-choose-driver-or-orm.md)
2625
- Java

markdown-pages/en/tidb/release-8.5/develop/dev-guide-bookshop-schema-design.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@ To make your reading on the application developer guide more smoothly, we presen
1212

1313
## Import table structures and data
1414

15-
Do one of the following:
15+
To import table structures and data of the Bookshop application, choose one of the following import methods:
1616

17-
- For TiDB Cloud, you can skip [Method 1: Via `tiup demo`](#method-1-via-tiup-demo) and import Bookshop table structures [via the import feature of TiDB Cloud](#method-2-via-tidb-cloud-import).
18-
- For TiDB Self-Managed, you can import Bookshop table structures and data either [via TiUP](#method-1-via-tiup-demo) and skip [Method 2: Via TiDB Cloud Import](#method-2-via-tidb-cloud-import).
17+
- [TiDB Self-Managed: via `tiup demo`](#tidb-self-managed-via-tiup-demo).
18+
- [TiDB Cloud: via the Import feature](#tidb-cloud-via-the-import-feature).
1919

20-
### Method 1: Via `tiup demo`
20+
### TiDB Self-Managed: via `tiup demo`
2121

2222
If your TiDB cluster is deployed using [TiUP](/tiup/tiup-reference.md#tiup-reference) or you can connect to your TiDB server, you can quickly generate and import sample data for the Bookshop application by running the following command:
2323

@@ -71,7 +71,7 @@ tiup demo bookshop prepare --users=200000 --books=500000 --authors=100000 --rati
7171

7272
You can delete the original table structure through the `--drop-tables` parameter. For more parameter descriptions, run the `tiup demo bookshop --help` command.
7373

74-
### Method 2: Via TiDB Cloud Import
74+
### TiDB Cloud: via the Import feature
7575

7676
1. Open the **Import** page for your target cluster.
7777

markdown-pages/en/tidb/release-8.5/develop/dev-guide-connection-parameters.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,13 @@ aliases: ['/tidb/stable/dev-guide-connection-parameters/','/tidb/dev/dev-guide-c
88

99
This document describes how to configure connection pools and connection parameters when you use a driver or ORM framework to connect to TiDB.
1010

11-
If you are interested in more tips about Java application development, see [Best Practices for Developing Java Applications with TiDB](/develop/java-app-best-practices.md#connection-pool)
11+
> **Tip:**
12+
>
13+
> In this document, the following sections are excerpted from [Best Practices for Developing Java Applications with TiDB](/develop/java-app-best-practices.md):
14+
>
15+
> - [Configure the number of connections](#configure-the-number-of-connections)
16+
> - [Probe configuration](#probe-configuration)
17+
> - [Connection parameters](#connection-parameters)
1218
1319
## Connection pool
1420

markdown-pages/en/tidb/release-8.5/develop/dev-guide-delete-data.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -161,11 +161,10 @@ with connection:
161161

162162
</SimpleTab>
163163

164-
The `rated_at` field is of the `DATETIME` type in [Date and Time Types](/data-type-date-and-time.md). You can assume that it is stored as a literal quantity in TiDB, independent of the time zone. On the other hand, the `TIMESTAMP` type stores a timestamp and thus displays a different time string in a different [time zone](/configure-time-zone.md).
165-
166164
> **Note:**
167165
>
168-
> Like MySQL, the `TIMESTAMP` data type is affected by the [year 2038 problem](https://en.wikipedia.org/wiki/Year_2038_problem). It is recommended to use the `DATETIME` type if you store values larger than 2038.
166+
> - The `rated_at` field is of the `DATETIME` type in [Date and Time Types](/data-type-date-and-time.md). You can assume that it is stored as a literal quantity in TiDB, independent of the time zone. On the other hand, the `TIMESTAMP` type stores a timestamp and thus displays a different time string in a different [time zone](/configure-time-zone.md).
167+
> - Like MySQL, the `TIMESTAMP` data type is affected by the [year 2038 problem](https://en.wikipedia.org/wiki/Year_2038_problem). It is recommended to use the `DATETIME` type if you store values larger than 2038.
169168
170169
## Performance considerations
171170

markdown-pages/en/tidb/release-8.5/develop/dev-guide-get-data-from-single-table.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ public class AuthorDAO {
114114
}
115115
```
116116

117-
After [connecting to TiDB using the JDBC driver](/develop/dev-guide-choose-driver-or-orm.md#java-drivers), you can create a `Statement` object with `conn.createStatus()`, and then call `stmt.executeQuery("query_sql")` to initiate a database query request to TiDB.
117+
After [connecting to TiDB using the JDBC driver](/develop/dev-guide-sample-application-java-jdbc.md), you can create a `Statement` object with `conn.createStatement()`, and then call `stmt.executeQuery("query_sql")` to initiate a database query request to TiDB.
118118

119119
The query results are stored in a `ResultSet` object. By traversing `ResultSet`, the returned results can be mapped to the `Author` object.
120120

markdown-pages/en/tidb/release-8.5/develop/dev-guide-insert-data.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -236,15 +236,15 @@ The following are the recommended tools for bulk-insert:
236236
<SimpleTab groupId="platform">
237237
<div label="TiDB Cloud" value="tidb-cloud">
238238

239-
- Data export: [Dumpling](https://docs.pingcap.com/tidb/stable/dumpling-overview). You can export MySQL or TiDB data to local or Amazon S3. For a TiDB Cloud Starter or Essential cluster, you can also use the [Export](/tidb-cloud/serverless-export.md) feature to export data more efficiently.
240-
- Data import: [Import](/tidb-cloud/import-sample-data.md) page in the [TiDB Cloud console](https://tidbcloud.com/). You can import **Dumpling** exported data, import a local **CSV** file, or [Import CSV Files from Amazon S3 or GCS into TiDB Cloud](/tidb-cloud/import-csv-files.md). It also supports reading data from a local disk, Amazon S3 cloud disk, or GCS cloud disk.
241-
- Data replication: [TiDB Data Migration](https://docs.pingcap.com/tidb/stable/dm-overview). You can replicate MySQL, MariaDB, and Amazon Aurora databases to TiDB. It also supports merging and migrating the sharded instances and tables from the source databases.
242-
- Data backup and restore: [Backup](/tidb-cloud/backup-and-restore.md) page in the TiDB Cloud console. Compared to **Dumpling**, backup and restore is more suitable for **_big data_** scenario.
239+
- Data export: use [Dumpling](/dumpling-overview.md) to export MySQL or TiDB data to local or your cloud storage. For a TiDB Cloud Starter or Essential cluster, you can also use the [Export](/tidb-cloud/serverless-export.md) feature in the [TiDB Cloud console](https://tidbcloud.com/) to export data more efficiently.
240+
- Data import: use the [Import](/tidb-cloud/import-sample-data.md) feature in the [TiDB Cloud console](https://tidbcloud.com/). You can import Dumpling exported data, import a local CSV file, or [import CSV files from cloud storage into TiDB Cloud](/tidb-cloud/import-csv-files.md).
241+
- Data replication: use the [TiDB Data Migration](/tidb-cloud/migrate-from-mysql-using-data-migration.md) feature in the [TiDB Cloud console](https://tidbcloud.com/). You can replicate MySQL-compatible databases to TiDB. It also supports merging and migrating the sharded instances and tables from the source databases.
242+
- Data backup and restore: use the [Backup](/tidb-cloud/backup-and-restore.md) feature in the [TiDB Cloud console](https://tidbcloud.com/). Compared to Dumpling, backup and restore is more suitable for big data scenario.
243243

244244
</div>
245245
<div label="TiDB Self-Managed" value="tidb">
246246

247-
- Data export: [Dumpling](https://docs.pingcap.com/tidb/stable/dumpling-overview). You can export MySQL or TiDB data to local or Amazon S3.
247+
- Data export: [Dumpling](/dumpling-overview.md). You can export MySQL or TiDB data to local or Amazon S3.
248248
- Data import: [TiDB Lightning](/tidb-lightning/tidb-lightning-overview.md). You can import **Dumpling** exported data, a **CSV** file, or [Migrate Data from Amazon Aurora to TiDB](/migrate-aurora-to-tidb.md). It also supports reading data from a local disk or Amazon S3 cloud disk.
249249
- Data replication: [TiDB Data Migration](/dm/dm-overview.md). You can replicate MySQL, MariaDB, and Amazon Aurora databases to TiDB. It also supports merging and migrating the sharded instances and tables from the source databases.
250250
- Data backup and restore: [Backup & Restore (BR)](/br/backup-and-restore-overview.md). Compared to **Dumpling**, **BR** is more suitable for **_big data_** scenario.

markdown-pages/en/tidb/release-8.5/develop/dev-guide-third-party-tools-compatibility.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,10 +41,10 @@ MySQL maintains a series of [server status variables starting with `Com_`](https
4141

4242
**Way to avoid**
4343

44-
Do not use these variables. One common scenario is monitoring. TiDB is well observable and does not require querying from server status variables.
44+
Do not use these variables. One common scenario is monitoring. TiDB is well observable and does not require querying from server status variables. For more information about monitoring services, refer to the following documentation:
4545

46-
- For more information about TiDB Cloud monitoring services, see [Monitor a TiDB Cluster](/tidb-cloud/monitor-tidb-cluster.md).
47-
- For more information about TiDB Self-Managed monitoring tools, see [TiDB Monitoring Framework Overview](/tidb-monitoring-framework.md).
46+
- TiDB Cloud documentation: [Monitor a TiDB Cluster](/tidb-cloud/monitor-tidb-cluster.md).
47+
- TiDB Self-Managed documentation: [TiDB Monitoring Framework Overview](/tidb-monitoring-framework.md).
4848

4949
### TiDB distinguishes between `TIMESTAMP` and `DATETIME` in error messages
5050

markdown-pages/en/tidb/release-8.5/develop/dev-guide-use-follower-read.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,10 @@ By default, TiDB only reads and writes data on the leader of the same Region. Wh
2020

2121
You can visually analyze whether your application has a hotspot Region by doing one of the following:
2222

23-
- For TiDB Cloud, use [Key Visualizer in the TiDB Cloud console](/tidb-cloud/tune-performance.md#key-visualizer) to analyze the hotspot Region.
24-
- For TiDB Self-Managed, use [Key Visualizer in TiDB Dashboard](/dashboard/dashboard-key-visualizer.md) to analyze the hotspot Region.
23+
- TiDB Cloud: navigate to the [Key Visualizer in the TiDB Cloud console](/tidb-cloud/tune-performance.md#key-visualizer), and then check whether a read hotspot occurs by selecting the "metrics selection box" to `Read (bytes)` or `Read (keys)`.
24+
- TiDB Self-Managed: navigate to the [Key Visualizer in TiDB Dashboard](/dashboard/dashboard-key-visualizer.md), and then check whether a read hotspot occurs by selecting the "metrics selection box" to `Read (bytes)` or `Read (keys)`.
2525

26-
You can check whether a read hotspot occurs by selecting the "metrics selection box" to `Read (bytes)` or `Read (keys)`.
27-
28-
For more information about handling hotspot, see [Troubleshoot Hotspot Issues](/troubleshoot-hot-spot-issues.md).
26+
If hotspot issues do exist, you can troubleshoot them by referring to [Handle TiDB Hotspot Issues](/troubleshoot-hot-spot-issues.md), which helps to avoid hotspot generation at the application level.
2927

3028
If read hotspots are unavoidable or the changing cost is very high, you can try using the Follower Read feature to better load the balance of reading requests to the follower Region.
3129

markdown-pages/en/tidbcloud/master/develop/dev-guide-bookshop-schema-design.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@ To make your reading on the application developer guide more smoothly, we presen
1212

1313
## Import table structures and data
1414

15-
Do one of the following:
15+
To import table structures and data of the Bookshop application, choose one of the following import methods:
1616

17-
- For TiDB Cloud, you can skip [Method 1: Via `tiup demo`](#method-1-via-tiup-demo) and import Bookshop table structures [via the import feature of TiDB Cloud](#method-2-via-tidb-cloud-import).
18-
- For TiDB Self-Managed, you can import Bookshop table structures and data either [via TiUP](#method-1-via-tiup-demo) and skip [Method 2: Via TiDB Cloud Import](#method-2-via-tidb-cloud-import).
17+
- [TiDB Self-Managed: via `tiup demo`](#tidb-self-managed-via-tiup-demo).
18+
- [TiDB Cloud: via the Import feature](#tidb-cloud-via-the-import-feature).
1919

20-
### Method 1: Via `tiup demo`
20+
### TiDB Self-Managed: via `tiup demo`
2121

2222
If your TiDB cluster is deployed using [TiUP](/tiup/tiup-reference.md#tiup-reference) or you can connect to your TiDB server, you can quickly generate and import sample data for the Bookshop application by running the following command:
2323

@@ -71,7 +71,7 @@ tiup demo bookshop prepare --users=200000 --books=500000 --authors=100000 --rati
7171

7272
You can delete the original table structure through the `--drop-tables` parameter. For more parameter descriptions, run the `tiup demo bookshop --help` command.
7373

74-
### Method 2: Via TiDB Cloud Import
74+
### TiDB Cloud: via the Import feature
7575

7676
1. Open the **Import** page for your target cluster.
7777

markdown-pages/en/tidbcloud/master/develop/dev-guide-connection-parameters.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,13 @@ aliases: ['/tidb/stable/dev-guide-connection-parameters/','/tidb/dev/dev-guide-c
88

99
This document describes how to configure connection pools and connection parameters when you use a driver or ORM framework to connect to TiDB.
1010

11-
If you are interested in more tips about Java application development, see [Best Practices for Developing Java Applications with TiDB](/develop/java-app-best-practices.md#connection-pool)
11+
> **Tip:**
12+
>
13+
> In this document, the following sections are excerpted from [Best Practices for Developing Java Applications with TiDB](/develop/java-app-best-practices.md):
14+
>
15+
> - [Configure the number of connections](#configure-the-number-of-connections)
16+
> - [Probe configuration](#probe-configuration)
17+
> - [Connection parameters](#connection-parameters)
1218
1319
## Connection pool
1420

0 commit comments

Comments
 (0)