Skip to content

lake: clarify LakeSQL PATH setup after installation - #24608

Merged
ti-chi-bot[bot] merged 3 commits into
pingcap:release-8.5from
awxxxxxx:docs/lake-lakesql-install-notes
Nov 3, 2026
Merged

ti-chi-bot[bot] merged 3 commits into
pingcap:release-8.5from
awxxxxxx:docs/lake-lakesql-install-notes

Conversation

@awxxxxxx

@awxxxxxx awxxxxxx commented Nov 2, 2026 •

Copy link
Copy Markdown
Collaborator

What is changed, added or deleted? (Required)

Users reported lakesql: command not found after installing LakeSQL with the default shell script on Linux. This PR updates Connect to TiDB Cloud Lake with LakeSQL to explain how to make the lakesql command available:

  • The installer appends the LakeSQL bin directory to PATH in ~/.zprofile and ~/.profile, which only take effect in a new login shell. The doc now tells users to run source ~/.profile in the current terminal.
  • Bash does not read ~/.profile when ~/.bash_profile exists (the default on CentOS, RHEL, and Alibaba Cloud Linux), so the doc notes that the export PATH=... line must also be added to ~/.bash_profile.

The installer behavior was verified against the current installer script (lakesql.sh).

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.

  • master (the latest development version)
  • v8.5 (TiDB 8.5 versions)
  • v8.4 (TiDB 8.4 versions)
  • v8.3 (TiDB 8.3 versions)
  • v8.2 (TiDB 8.2 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)

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

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

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

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Clarified that the installer places lakesql in ~/.lakesql/bin and adds that directory to ~/.zprofile and ~/.profile.
    • Explained that these profile files are not reloaded in the current shell and showed how to source ~/.profile.
    • Added guidance for Bash login shells, which read ~/.bash_profile or ~/.bash_login instead of ~/.profile when those files are present, including where to add the PATH command.

- Explain that the installer adds LakeSQL to PATH in ~/.zprofile and
  ~/.profile, how to apply it in the current shell, and that Bash skips
  ~/.profile when ~/.bash_profile exists.
- Note that the x86_64 Linux gnu build requires glibc 2.39 or later and
  point users on older systems to the statically linked musl build.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ti-chi-bot ti-chi-bot Bot added contribution This PR is from a community contributor. missing-translation-status This PR does not have translation status info. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Nov 2, 2026
@coderabbitai

coderabbitai Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • Resume reviews
  • Trigger review

No actionable comments were generated in the recent review.

Recent review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between 6955981 and f989356.

Files selected for processing: 1
  • tidb-cloud-lake/guides/connect-using-lakesql.md

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 2 remain after this review.

Walkthrough

The LakeSQL connection guide explains where the installer places lakesql, how to update the current terminal’s PATH, and which shell profile file Bash login shells read.

Changes: LakeSQL installation guide

Layer / File(s) Summary
Shell PATH setup
tidb-cloud-lake/guides/connect-using-lakesql.md
The guide documents installer PATH entries in ~/.zprofile and ~/.profile, sourcing ~/.profile in the current terminal, and adding the PATH command to the file Bash reads when ~/.bash_profile or ~/.bash_login exists.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Suggested reviewers: qiancai

Merge Risk: Minimal · up to f9893

This documentation-only change presents no identified merge-blocking risk.

Pre-merge checks: Passed 5
Check name Status Explanation
Title check Passed The title names the main change: clarifying the LakeSQL PATH setup after installation. It matches the raw summary and the PR objectives, which both describe documentation that explains how to make the…
Description check Passed The description covers the required sections. It states what changed and why, and it gives the reason for the change: users reported 'lakesql: command not found' after installation. It explains that t…
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Title check

Explanation

The title names the main change: clarifying the LakeSQL PATH setup after installation. It matches the raw summary and the PR objectives, which both describe documentation that explains how to make the lakesql command available after install. The title is short and specific, so a reviewer scanning history can identify the change.

Full details: Description check

Explanation

The description covers the required sections. It states what changed and why, and it gives the reason for the change: users reported 'lakesql: command not found' after installation. It explains that the installer writes PATH to ~/.zprofile and ~/.profile, that these only apply in a new login shell, and that Bash reads ~/.bash_profile when it exists. The version checkbox for v8.5 is ticked, and the AI agent involvement field is marked. The related reference links are provided. The template's first-time contributor checklist and the Contributor License Agreement item are not ticked. The description does not show whether that checklist applies, so the author should confirm it.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

Finishing Touches
Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@awxxxxxx awxxxxxx changed the title lake: clarify LakeSQL PATH setup and glibc requirement lake: clarify LakeSQL PATH setup after installation Nov 2, 2026
@qiancai qiancai added the lake Related to TiDB Cloud Lake docs. label Nov 2, 2026

@qiancai qiancai left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rest LGTM

@ti-chi-bot ti-chi-bot Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Nov 2, 2026
@ti-chi-bot

ti-chi-bot Bot commented Nov 2, 2026

Copy link
Copy Markdown

[LGTM Timeline notifier]

Timeline:

  • 2026-11-02 06:53:02.789086919 +0000 UTC m=+476707.414237205: ☑️ agreed by qiancai.

@qiancai qiancai added translation/no-need No need to translate this PR. area/tidb-cloud This PR relates to the area of TiDB Cloud. labels Nov 2, 2026
@ti-chi-bot ti-chi-bot Bot removed the missing-translation-status This PR does not have translation status info. label Nov 2, 2026
@qiancai qiancai self-assigned this Nov 2, 2026
Co-authored-by: qiancai <79440533+qiancai@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@qiancai

qiancai commented Nov 3, 2026

Copy link
Copy Markdown
Collaborator

/approve

@qiancai qiancai added the lgtm label Nov 3, 2026
@ti-chi-bot

ti-chi-bot Bot commented Nov 3, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: qiancai

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

The pull request process is described here

Details Needs approval from an approver in each of these files:

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

@ti-chi-bot ti-chi-bot Bot added the approved label Nov 3, 2026
@ti-chi-bot
ti-chi-bot Bot merged commit 515c315 into pingcap:release-8.5 Nov 3, 2026
12 checks passed
@qiancai qiancai added the ONCALL Relates to documentation oncall. label Nov 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved area/tidb-cloud This PR relates to the area of TiDB Cloud. contribution This PR is from a community contributor. lake Related to TiDB Cloud Lake docs. lgtm needs-1-more-lgtm Indicates a PR needs 1 more LGTM. ONCALL Relates to documentation oncall. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. translation/no-need No need to translate this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants