lake: update ecosystem integrations by lilin90 · Pull Request #22874 · pingcap/docs

lilin90 · 2026-05-11T07:29:53Z

What is changed, added or deleted? (Required)

Renamed BendSQL to LakeSQL
Updated files affected by ecosystem integration progress for multiple drivers
Removed two MCP files for TOC for now

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

What is the related PR or file link(s)?

This PR is translated from:
Other reference link(s):

Do your changes match any of the following descriptions?

Delete files
Change aliases
Need modification after applied to another branch
Might cause conflicts after applied to another branch

ti-chi-bot · 2026-05-11T07:30:04Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please ask for approval from lilin90. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

gemini-code-assist

Code Review

This pull request renames the command-line tool 'BendSQL' to 'LakeSQL' across the documentation, including updates to repository URLs, installation commands, and environment variables. The review feedback identifies several instances in example outputs where the old naming or external documentation links were missed, specifically in ASCII art headers and help text.

Replace databend driver references with lake equivalents across tidb-cloud-lake guides. Updated package names, import paths, dependency coordinates (Go, Java, Node.js, Python, Rust), JDBC artifactId, example import lines, and registry/GitHub links in connect guides, driver-overview, load-from-local-file, and Tableau docs to reflect lake-* drivers and tidbcloud repositories.

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

lilin90 · 2026-05-11T09:00:51Z

/hold

Align docs and examples with TiDB Cloud Lake naming and new artifacts: update Java Maven groupId to com.tidbcloud and JDBC version (0.4.1 -> 0.4.6), change Gradle groupId to com.tidbcloud; switch LakeSQL installer URL to lakesql-bin.tidbcloud.com and hide the non-public Homebrew tap; rename Python BlockingDatabendClient to BlockingLakeClient; replace Rust crate tidbcloudlake-driver with lake-driver (0.1.5-alpha.2) and update imports/comments; change local file load placeholder from @_lake_load to @_tidbcloud_load across CLI, Python and Java examples; and update Tableau docs Maven path to com/tidbcloud. These changes standardize package names, binary source, and example placeholders to reflect product/packaging changes.

Replace distro-specific DEB822/legacy Apt instructions with a unified Apt repository setup: add the lakesql archive keyring, create a signed sources.list entry, and use apt-get update/install (with -y). This simplifies installation on Ubuntu/Debian and removes the old-format examples.

In tidb-cloud-lake/guides/driver-overview.md, update example package names to match current branding: replace `databend-sqlalchemy` with `lake-sqlalchemy` for Python and `databend-go` with `lake-go` for Go. This keeps the driver overview accurate and aligned with the published package names.

Remove two MCP-related links from the AI and ML Integration section in TOC-tidb-cloud-lake.md: 'MCP Server' and 'MCP Client Integration'. Cleans up the table of contents by removing these MCP entries.

lilin90 · 2026-06-08T07:24:32Z

Note

Reason for f8554df: The corresponding lake-mcp repo is not public now.

awxxxxxx · 2026-06-08T08:41:54Z


 ```shell
-❯ bendsql --query='INSERT INTO book_db.books from @_databend_load file_format=(type=csv)' --data=@books.csv
+❯ lakesql --query='INSERT INTO book_db.books from @_tidbcloud_load file_format=(type=csv)' --data=@books.csv


awxxxxxx · 2026-06-08T08:44:24Z

 import java.sql.Statement;
 import java.io.FileInputStream;
 import java.nio.file.Files;
 import com.databend.jdbc.DatabendConnection;


awxxxxxx · 2026-06-08T08:46:36Z

+| **[Go](/tidb-cloud-lake/guides/connect-using-golang.md)**      | `lake-go`                               | • database/sql interface<br/>• Connection pooling<br/>• Bulk operations       |
+| **[Node.js](/tidb-cloud-lake/guides/connect-using-node-js.md)** | `tidbcloudlake-driver`                           | • TypeScript support<br/>• Promise-based API<br/>• Streaming results          |
+| **[Java](/tidb-cloud-lake/guides/connect-using-java.md)**      | `lake-jdbc`                             | • JDBC 4.0 compatible<br/>• Connection pooling<br/>• Prepared statements      |
+| **[Rust](/tidb-cloud-lake/guides/connect-using-rust.md)**      | `tidbcloudlake-driver`                           | • Async/await support<br/>• Type-safe queries<br/>• Zero-copy deserialization |


Suggested change

| **[Rust](/tidb-cloud-lake/guides/connect-using-rust.md)** | `tidbcloudlake-driver` | • Async/await support<br/>• Type-safe queries<br/>• Zero-copy deserialization |

| **[Rust](/tidb-cloud-lake/guides/connect-using-rust.md)** | `lake-driver` | • Async/await support<br/>• Type-safe queries<br/>• Zero-copy deserialization |

待确认包名是 https://crates.io/crates/lake-driver lake-driver

Co-authored-by: awxxxxxx <7347183+awxxxxxx@users.noreply.github.com>

awxxxxxx · 2026-06-08T08:59:25Z


 ```gradle
-implementation 'com.databend:databend-jdbc:0.4.1'
+implementation 'com.tidbcloud:lake-jdbc:0.4.1'


Suggested change

implementation 'com.tidbcloud:lake-jdbc:0.4.1'

implementation 'com.tidbcloud:lake-jdbc:0.4.6'

lake: update bendsql to lakesql

73e27e5

lilin90 self-assigned this May 11, 2026

lilin90 added translation/no-need No need to translate this PR. area/tidb-cloud This PR relates to the area of TiDB Cloud. nextgen Indicates that the Issue or PR belongs to the nextgen kernel architecture. labels May 11, 2026

ti-chi-bot Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 11, 2026

gemini-code-assist Bot reviewed May 11, 2026

View reviewed changes

Comment thread tidb-cloud-lake/guides/connect-using-lakesql.md Outdated

Comment thread tidb-cloud-lake/guides/connect-using-lakesql.md Outdated

Comment thread tidb-cloud-lake/guides/connect-using-lakesql.md Outdated

ti-chi-bot Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels May 11, 2026

lilin90 and others added 3 commits May 11, 2026 16:12

Update tidb-cloud-lake/guides/connect-using-lakesql.md

15942e0

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Update tidb-cloud-lake/guides/connect-using-lakesql.md

9891eae

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Update connect-using-lakesql.md

f150969

lilin90 changed the title ~~lake: update bendsql to lakesql~~ lake: update ecosystem integrations May 11, 2026

lilin90 added 2 commits May 11, 2026 16:57

Fix two links

2bf8891

Update wording

0318be1

ti-chi-bot Bot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label May 11, 2026

lilin90 added 2 commits May 25, 2026 15:26

Use tidbcloudlake-driver

edba388

Update links and names

55c9cb0

lilin90 requested a review from sdojjy May 25, 2026 08:59

Update two links

06f41cf

lilin90 commented May 29, 2026

View reviewed changes

Comment thread tidb-cloud-lake/guides/connect-using-python.md Outdated

lilin90 requested a review from awxxxxxx May 29, 2026 07:36

sdojjy reviewed May 29, 2026

View reviewed changes

Comment thread tidb-cloud-lake/guides/connect-using-lakesql.md Outdated

lilin90 added 4 commits June 8, 2026 13:39

Update command to address comment

04f8ac9

Remove inapplicable sqlalchemy links

ff730dd

lilin90 added 3 commits June 8, 2026 15:18

Remove inapplicable Go package link

4838c64

toc: remove two MCP entries

f8554df

Remove two MCP-related links from the AI and ML Integration section in TOC-tidb-cloud-lake.md: 'MCP Server' and 'MCP Client Integration'. Cleans up the table of contents by removing these MCP entries.

Update ai-ml-integration.md

23e3147

awxxxxxx reviewed Jun 8, 2026

View reviewed changes

lilin90 and others added 4 commits June 8, 2026 16:56

Update tidb-cloud-lake/guides/connect-using-lakesql.md

2ae948b

Co-authored-by: awxxxxxx <7347183+awxxxxxx@users.noreply.github.com>

Update tidb-cloud-lake/guides/connect-using-python.md

a98117d

Co-authored-by: awxxxxxx <7347183+awxxxxxx@users.noreply.github.com>

Update tidb-cloud-lake/guides/connect-using-lakesql.md

88ccd62

Co-authored-by: awxxxxxx <7347183+awxxxxxx@users.noreply.github.com>

Update tidb-cloud-lake/guides/load-from-local-file.md

78ed897

Co-authored-by: awxxxxxx <7347183+awxxxxxx@users.noreply.github.com>

awxxxxxx reviewed Jun 8, 2026

View reviewed changes

	\| [Rust](/tidb-cloud-lake/guides/connect-using-rust.md) \| `tidbcloudlake-driver` \| • Async/await support<br/>• Type-safe queries<br/>• Zero-copy deserialization \|
	\| [Rust](/tidb-cloud-lake/guides/connect-using-rust.md) \| `lake-driver` \| • Async/await support<br/>• Type-safe queries<br/>• Zero-copy deserialization \|

	implementation 'com.tidbcloud:lake-jdbc:0.4.1'
	implementation 'com.tidbcloud:lake-jdbc:0.4.6'

Conversation

lilin90 commented May 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

Uh oh!

ti-chi-bot Bot commented May 11, 2026

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lilin90 commented May 11, 2026

Uh oh!

Uh oh!

Uh oh!

lilin90 commented Jun 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

awxxxxxx Jun 8, 2026

Choose a reason for hiding this comment

Uh oh!

awxxxxxx Jun 8, 2026

Choose a reason for hiding this comment

Uh oh!

awxxxxxx Jun 8, 2026

Choose a reason for hiding this comment

Uh oh!

awxxxxxx Jun 8, 2026 • edited by lilin90 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

awxxxxxx Jun 8, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lilin90 commented May 11, 2026 •

edited

Loading

lilin90 commented Jun 8, 2026 •

edited

Loading

awxxxxxx Jun 8, 2026 •

edited by lilin90

Loading