From 74fe727662509f43e70c3653d4bcc65d6bfa042c Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 18 Feb 2025 13:44:06 +0800 Subject: [PATCH 1/9] Add temp.md --- temp.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 temp.md diff --git a/temp.md b/temp.md new file mode 100644 index 000000000000..af27ff4986a7 --- /dev/null +++ b/temp.md @@ -0,0 +1 @@ +This is a test file. \ No newline at end of file From 38f9b0e4a373398c0686dcd60f829b715122d2e2 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 18 Feb 2025 13:44:11 +0800 Subject: [PATCH 2/9] Delete temp.md --- temp.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 temp.md diff --git a/temp.md b/temp.md deleted file mode 100644 index af27ff4986a7..000000000000 --- a/temp.md +++ /dev/null @@ -1 +0,0 @@ -This is a test file. \ No newline at end of file From 65bccae6a03f8ed2c5e1b28927555de139c462d6 Mon Sep 17 00:00:00 2001 From: qiancai Date: Tue, 18 Feb 2025 14:09:15 +0800 Subject: [PATCH 3/9] add translation --- .github/workflows/link-fail-fast.yaml | 4 - develop/dev-guide-third-party-support.md | 172 ++---------------- dm/.lycheeignore | 38 ++++ .../vector-search-integration-overview.md | 35 +--- 4 files changed, 64 insertions(+), 185 deletions(-) create mode 100644 dm/.lycheeignore diff --git a/.github/workflows/link-fail-fast.yaml b/.github/workflows/link-fail-fast.yaml index a5e4677d0897..04ac603a65fe 100644 --- a/.github/workflows/link-fail-fast.yaml +++ b/.github/workflows/link-fail-fast.yaml @@ -17,10 +17,6 @@ jobs: CHANGED_FILES=$(git diff-tree --name-only --diff-filter 'AM' -r HEAD^1 HEAD -- "*.md" | sed -z "s/\n$//;s/\n/' '/g") echo "all_changed_files=${CHANGED_FILES}" >> $GITHUB_OUTPUT - - name: Download Exclude Path - run: | - curl https://raw.githubusercontent.com/pingcap/docs/master/.lycheeignore -O - - name: Link Checker if: ${{ steps.changed-files.outputs.all_changed_files }} uses: lycheeverse/lychee-action@v1.6.1 diff --git a/develop/dev-guide-third-party-support.md b/develop/dev-guide-third-party-support.md index 2a908c9142cb..0c33d0bc85b0 100644 --- a/develop/dev-guide-third-party-support.md +++ b/develop/dev-guide-third-party-support.md @@ -27,161 +27,29 @@ PingCAP 与开源社区合作，通过三方工具提供以下支持： ## Driver - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
编程语言驱动最新已测试版本支持等级TiDB 适配器教程
GoGo-MySQL-Driverv1.6.0FullN/A使用 Go-MySQL-Driver 连接到 TiDB
JavaJDBC8.0Full - - 使用 JDBC 连接到 TiDB
+| 编程语言 | 驱动 | 最新已测试版本 | 支持等级 | TiDB 适配器 | 教程 | +|----------|--------|-----------------------|---------------|--------------|----------| +| Go | [go-sql-driver/mysql](https://github.com/go-sql-driver/mysql) | v1.6.0 | Full | N/A | [使用 Go-MySQL-Driver 连接到 TiDB](/develop/dev-guide-sample-application-golang-sql-driver.md) | +| Java | [MySQL Connector/J](https://dev.mysql.com/downloads/connector/j/) | 8.0 | Full | [pingcap/mysql-connector-j](/develop/dev-guide-choose-driver-or-orm.md#java-drivers)
[pingcap/tidb-loadbalance](/develop/dev-guide-choose-driver-or-orm.md#java-client-load-balancing) | [使用 JDBC 连接到 TiDB](/develop/dev-guide-sample-application-java-jdbc.md) | ## ORM - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
编程语言ORM 框架最新已测试版本支持等级TiDB 适配器教程
Gogormv1.23.5FullN/A使用 GORM 连接到 TiDB
beegov2.0.3FullN/AN/A
upper/dbv4.5.2FullN/AN/A
xormv1.3.1FullN/AN/A
JavaHibernate6.1.0.FinalFullN/A使用 Hibernate 连接到 TiDB
MyBatisv3.5.10FullN/A使用 MyBatis 连接到 TiDB
Spring Data JPA2.7.2FullN/A使用 Spring Boot 连接到 TiDB
jOOQv3.16.7 (Open Source)FullN/AN/A
RubyActive Recordv7.0FullN/A使用 Rails 框架和 ActiveRecord ORM 连接到 TiDB
JavaScript / TypeScriptSequelizev6.20.1FullN/AN/A
Prisma4.16.2FullN/A使用 Prisma 连接到 TiDB
TypeORMv0.3.17FullN/A使用 TypeORM 连接到 TiDB
PythonDjangov4.2Fulldjango-tidb使用 Django 连接到 TiDB
SQLAlchemyv1.4.37FullN/A使用 SQLAlchemy 连接到 TiDB
+| 编程语言 | ORM 框架 | 最新已测试版本 | 支持等级 | TiDB 适配器 | 教程 | +|-------------------------|-------------------------------------------|-----------------------|-------------|--------------|----------| +| Go | [gorm](https://github.com/go-gorm/gorm) | v1.23.5 | Full | N/A | [使用 GORM 连接到 TiDB](/develop/dev-guide-sample-application-golang-gorm.md) | +| Go | [beego](https://github.com/beego/beego) | v2.0.3 | Full | N/A | N/A | +| Go | [upper/db](https://github.com/upper/db) | v4.5.2 | Full | N/A | N/A | +| Go | [xorm](https://gitea.com/xorm/xorm) | v1.3.1 | Full | N/A | N/A | +| Java | [Hibernate](https://hibernate.org/orm/) | 6.1.0.Final | Full | N/A | [使用 Hibernate 连接到 TiDB](/develop/dev-guide-sample-application-java-hibernate.md) | +| Java | [MyBatis](https://mybatis.org/mybatis-3/) | v3.5.10 | Full | N/A | [使用 MyBatis 连接到 TiDB](/develop/dev-guide-sample-application-java-mybatis.md) | +| Java | [Spring Data JPA](https://spring.io/projects/spring-data-jpa/) | 2.7.2 | Full | N/A | [使用 Spring Boot 连接到 TiDB](/develop/dev-guide-sample-application-java-spring-boot.md) | +| Java | [jOOQ](https://github.com/jOOQ/jOOQ) | v3.16.7 (Open Source) | Full | N/A | N/A | +| Ruby | [Active Record](https://guides.rubyonrails.org/active_record_basics.html) | v7.0 | Full | N/A | [使用 Rails 框架和 ActiveRecord ORM 连接到 TiDB](/develop/dev-guide-sample-application-ruby-rails.md) | +| JavaScript / TypeScript | [Sequelize](https://sequelize.org/) | v6.20.1 | Full | N/A | [使用 Sequelize 连接到 TiDB](/develop/dev-guide-sample-application-nodejs-sequelize.md) | +| JavaScript / Typescript | [Prisma](https://www.prisma.io/) | 4.16.2 | Full | N/A | [使用 Prisma 连接到 TiDB](/develop/dev-guide-sample-application-nodejs-prisma.md) | +| JavaScript / Typescript | [TypeORM](https://typeorm.io/) | v0.3.17 | Full | N/A | [使用 TypeORM 连接到 TiDB](/develop/dev-guide-sample-application-nodejs-typeorm.md) | +| Python | [Django](https://www.djangoproject.com/) | v4.2 | Full | [django-tidb](https://github.com/pingcap/django-tidb) | [使用 Django 连接到 TiDB](/develop/dev-guide-sample-application-python-django.md) | +| Python | [SQLAlchemy](https://www.sqlalchemy.org/) | v1.4.37 | Full | N/A | [使用 SQLAlchemy 连接到 TiDB](/develop/dev-guide-sample-application-python-sqlalchemy.md) | ## GUI diff --git a/dm/.lycheeignore b/dm/.lycheeignore new file mode 100644 index 000000000000..04189621d038 --- /dev/null +++ b/dm/.lycheeignore @@ -0,0 +1,38 @@ +https://mvnrepository\.com/artifact/mysql/mysql-connector-java/8\.0\.28 +https://github\.com/.*/issues/? +https://github\.com/.*/pull/? +https://github\.com/.*/pull/[0-9]+ +https://github\.com/.*/issues/[0-9]+ +https?://\$?\{host}/dashboard.* +http://xn--\$?\{ip}-m86ht9t5l1bhz9ayu7b:3000.* +http://ip:2379.* +http://10\.0.* +http://172\.16\..* +http://192\.168\.* +http://127\.0\.0\.1.* +http://localhost.* +http://grafana_ip:3000.* +http://\$?\{remote-server-ip}:3000.* +file:///home/runner/work/(docs|docs-cn)/(docs|docs-cn)/develop/.* +file://.*https:/%7BnodeIP%7D:%7BnodePort%7D/dashboard +file://.*?http:/\$%7BPD_IP%7D:\$%7BPD_PORT%7D/dashboard.* +http://\{grafana-ip\}:3000 +http://\{pd-ip\}:2379/dashboard +http://localhost:\d+/ +https://github\.com/\$user/(docs|docs-cn) +https://linux\.die\.net/man.* +https://dev\.mysql\.com/doc/.+/5.7/en/.* +https://dev\.mysql\.com/doc/.+/8\.0/en/.* +https://dev\.mysql\.com/doc/.+/8\.4/en/.* +https://dev\.mysql\.com/doc/[a-z\-]+/en/.* +https://dev\.mysql\.com/doc/relnotes/[a-z\-]+/en/.* +https://dev\.mysql\.com/doc/dev/mysql-server/.* +https://dev\.mysql\.com/downloads/.* +https://bugs\.mysql\.com/bug\.php.* +https://www\.mysql\.com/products/.* +https://platform\.openai\.com/docs/.* +https://openai\.com/.* +https://jwt\.io/ +https://typeorm\.io/.* +https://dash\.cloudflare\.com/.* +https://centminmod\.com/mydumper\.html \ No newline at end of file diff --git a/vector-search/vector-search-integration-overview.md b/vector-search/vector-search-integration-overview.md index b7d15a018486..49bfba686a99 100644 --- a/vector-search/vector-search-integration-overview.md +++ b/vector-search/vector-search-integration-overview.md @@ -40,32 +40,9 @@ TiDB 向量搜索支持存储高达 16383 维的向量，可适应大多数嵌 下表列出了支持的 ORM 库和相应的使用教程： - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
语言ORM/客户端安装说明教程
PythonTiDB Vector Clientpip install tidb-vector[client]使用 Python 开始向量搜索
SQLAlchemypip install tidb-vector在 SQLAlchemy 中使用 TiDB 向量搜索
peeweepip install tidb-vector在 peewee 中使用 TiDB 向量搜索
Djangopip install django-tidb[vector]在 Django 中使用 TiDB 向量搜索
\ No newline at end of file +| 语言 | ORM/客户端 | 安装说明 | 教程 | +|----------|--------------------|-----------------------------------|----------| +| Python | TiDB Vector Client | `pip install tidb-vector[client]` | [使用 Python 开始向量搜索](/vector-search/vector-search-get-started-using-python.md) | +| Python | SQLAlchemy | `pip install tidb-vector` | [在 SQLAlchemy 中使用 TiDB 向量搜索](/vector-search/vector-search-integrate-with-sqlalchemy.md) +| Python | peewee | `pip install tidb-vector` | [在 peewee 中使用 TiDB 向量搜索](/vector-search/vector-search-integrate-with-peewee.md) | +| Python | Django | `pip install django-tidb[vector]` | [在 Django 中使用 TiDB 向量搜索](/vector-search/vector-search-integrate-with-django-orm.md) \ No newline at end of file From 8a865165b434f7c886d2106b59e305ffdd0f9ab2 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Feb 2025 11:10:33 +0800 Subject: [PATCH 4/9] Update develop/dev-guide-third-party-support.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Daniël van Eeden --- develop/dev-guide-third-party-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop/dev-guide-third-party-support.md b/develop/dev-guide-third-party-support.md index 0c33d0bc85b0..51cca8d04b9e 100644 --- a/develop/dev-guide-third-party-support.md +++ b/develop/dev-guide-third-party-support.md @@ -30,7 +30,7 @@ PingCAP 与开源社区合作，通过三方工具提供以下支持： | 编程语言 | 驱动 | 最新已测试版本 | 支持等级 | TiDB 适配器 | 教程 | |----------|--------|-----------------------|---------------|--------------|----------| | Go | [go-sql-driver/mysql](https://github.com/go-sql-driver/mysql) | v1.6.0 | Full | N/A | [使用 Go-MySQL-Driver 连接到 TiDB](/develop/dev-guide-sample-application-golang-sql-driver.md) | -| Java | [MySQL Connector/J](https://dev.mysql.com/downloads/connector/j/) | 8.0 | Full | [pingcap/mysql-connector-j](/develop/dev-guide-choose-driver-or-orm.md#java-drivers)
[pingcap/tidb-loadbalance](/develop/dev-guide-choose-driver-or-orm.md#java-client-load-balancing) | [使用 JDBC 连接到 TiDB](/develop/dev-guide-sample-application-java-jdbc.md) | +| Java | [MySQL Connector/J](https://dev.mysql.com/downloads/connector/j/) | 8.0 | Full | [pingcap/mysql-connector-j](/develop/dev-guide-choose-driver-or-orm.md#java-drivers)
[pingcap/tidb-loadbalance](/develop/dev-guide-choose-driver-or-orm.md#java-客户端负载均衡) | [使用 JDBC 连接到 TiDB](/develop/dev-guide-sample-application-java-jdbc.md) | ## ORM From 7a1a35673e919113755098c4cd3c132662d08272 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Feb 2025 11:10:44 +0800 Subject: [PATCH 5/9] Update dm/.lycheeignore MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Daniël van Eeden --- dm/.lycheeignore | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/dm/.lycheeignore b/dm/.lycheeignore index 04189621d038..98307a2b9b08 100644 --- a/dm/.lycheeignore +++ b/dm/.lycheeignore @@ -35,4 +35,6 @@ https://openai\.com/.* https://jwt\.io/ https://typeorm\.io/.* https://dash\.cloudflare\.com/.* -https://centminmod\.com/mydumper\.html \ No newline at end of file +https://centminmod\.com/mydumper\.html +https://learn\.pingcap\.com/learner/ +https://zhuanlan\.zhihu\.com/p/ \ No newline at end of file From 0fadcae289433262c91f8ffce8beb3fad5850fda Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Feb 2025 11:11:06 +0800 Subject: [PATCH 6/9] Update develop/dev-guide-third-party-support.md --- develop/dev-guide-third-party-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop/dev-guide-third-party-support.md b/develop/dev-guide-third-party-support.md index 51cca8d04b9e..f6b3f9299486 100644 --- a/develop/dev-guide-third-party-support.md +++ b/develop/dev-guide-third-party-support.md @@ -30,7 +30,7 @@ PingCAP 与开源社区合作，通过三方工具提供以下支持： | 编程语言 | 驱动 | 最新已测试版本 | 支持等级 | TiDB 适配器 | 教程 | |----------|--------|-----------------------|---------------|--------------|----------| | Go | [go-sql-driver/mysql](https://github.com/go-sql-driver/mysql) | v1.6.0 | Full | N/A | [使用 Go-MySQL-Driver 连接到 TiDB](/develop/dev-guide-sample-application-golang-sql-driver.md) | -| Java | [MySQL Connector/J](https://dev.mysql.com/downloads/connector/j/) | 8.0 | Full | [pingcap/mysql-connector-j](/develop/dev-guide-choose-driver-or-orm.md#java-drivers)
[pingcap/tidb-loadbalance](/develop/dev-guide-choose-driver-or-orm.md#java-客户端负载均衡) | [使用 JDBC 连接到 TiDB](/develop/dev-guide-sample-application-java-jdbc.md) | +| Java | [MySQL Connector/J](https://dev.mysql.com/downloads/connector/j/) | 8.0 | Full | [pingcap/mysql-connector-j](/develop/dev-guide-choose-driver-or-orm.md#java-drivers)
[pingcap/tidb-loadbalance](/develop/dev-guide-choose-driver-or-orm.md#java-客户端负载均衡) | [使用 JDBC 连接到 TiDB](/develop/dev-guide-sample-application-java-jdbc.md) | ## ORM From a52a2e7c2693ccabecef26abfcb6f1d8750787b6 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Feb 2025 11:12:33 +0800 Subject: [PATCH 7/9] Update link-fail-fast.yaml --- .github/workflows/link-fail-fast.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/link-fail-fast.yaml b/.github/workflows/link-fail-fast.yaml index 04ac603a65fe..9f3466d0c899 100644 --- a/.github/workflows/link-fail-fast.yaml +++ b/.github/workflows/link-fail-fast.yaml @@ -19,9 +19,9 @@ jobs: - name: Link Checker if: ${{ steps.changed-files.outputs.all_changed_files }} - uses: lycheeverse/lychee-action@v1.6.1 + uses: lycheeverse/lychee-action@v2.3.0 with: fail: true - args: -E --exclude-mail -i -n -t 45 -- '${{ steps.changed-files.outputs.all_changed_files }}' + args: --root-dir $(pwd) -E -i -n -t 45 -- '${{ steps.changed-files.outputs.all_changed_files }}' env: GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}} From d1b2f065e4a4dab9f3dd08992ed82ee97a32356a Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 19 Feb 2025 11:17:43 +0800 Subject: [PATCH 8/9] move .lycheeignore to the root path --- dm/.lycheeignore => .lycheeignore | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename dm/.lycheeignore => .lycheeignore (100%) diff --git a/dm/.lycheeignore b/.lycheeignore similarity index 100% rename from dm/.lycheeignore rename to .lycheeignore From c0a7bb186f9bcab71d5d956e21e9cd524e17cabb Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Feb 2025 11:36:42 +0800 Subject: [PATCH 9/9] sync en changes --- .lycheeignore | 5 ----- 1 file changed, 5 deletions(-) diff --git a/.lycheeignore b/.lycheeignore index 98307a2b9b08..73000bc18ebb 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -6,11 +6,6 @@ https://github\.com/.*/issues/[0-9]+ https?://\$?\{host}/dashboard.* http://xn--\$?\{ip}-m86ht9t5l1bhz9ayu7b:3000.* http://ip:2379.* -http://10\.0.* -http://172\.16\..* -http://192\.168\.* -http://127\.0\.0\.1.* -http://localhost.* http://grafana_ip:3000.* http://\$?\{remote-server-ip}:3000.* file:///home/runner/work/(docs|docs-cn)/(docs|docs-cn)/develop/.*