Skip to content

nontransactional dml FAQ about alias#22523

Merged
ti-chi-bot[bot] merged 2 commits intopingcap:masterfrom
Oreoxmt:translate/docs-cn-21313
Mar 6, 2026
Merged

nontransactional dml FAQ about alias#22523
ti-chi-bot[bot] merged 2 commits intopingcap:masterfrom
Oreoxmt:translate/docs-cn-21313

Conversation

@Oreoxmt
Copy link
Collaborator

@Oreoxmt Oreoxmt commented Mar 4, 2026

First-time contributors' checklist

What is changed, added or deleted? (Required)

Added FAQ about Unknown column error when using alias.

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 (in Chinese).

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 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)
  • v6.1 (TiDB 6.1 versions)
  • v5.4 (TiDB 5.4 versions)

What is the related PR or file 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

@Oreoxmt Oreoxmt self-assigned this Mar 4, 2026
@Oreoxmt Oreoxmt added translation/from-docs-cn This PR is translated from a PR in pingcap/docs-cn. needs-cherry-pick-release-6.5 Should cherry pick this PR to release-6.5 branch. needs-cherry-pick-release-7.1 Should cherry pick this PR to release-7.1 branch. needs-cherry-pick-release-7.5 Should cherry pick this PR to release-7.5 branch. needs-cherry-pick-release-8.1 Should cherry pick this PR to release-8.1 branch. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. labels Mar 4, 2026
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the TiDB documentation by addressing a common issue where 'Unknown column' errors arise when using table aliases within non-transactional DML statements. It provides a detailed FAQ section with explanations and recommendations, alongside a concise warning in the BATCH statement documentation, to help users understand and mitigate this behavior.

Highlights

  • New FAQ on 'Unknown column' error: Added a new FAQ section to non-transactional-dml.md explaining why 'Unknown column' errors occur when using table aliases in non-transactional DML statements and providing recommendations to avoid them.
  • Alias warning in BATCH statement: Included a note in sql-statements/sql-statement-batch.md warning users about potential 'Unknown column' errors when using table aliases with BATCH statements due to internal rewriting.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • non-transactional-dml.md
    • Added a new FAQ section titled "The Unknown column '<alias>.<column>' in 'where clause' error occurs when using table aliases in non-transactional DML statements".
    • Provided an explanation of why the error occurs due to internal statement rewriting.
    • Offered recommendations to avoid the error, such as not using table aliases or fully qualifying column names.
    • Suggested using DRY RUN QUERY or DRY RUN to preview rewritten statements.
  • sql-statements/sql-statement-batch.md
    • Inserted a note (> **Note:**) explaining that BATCH statements might not preserve table aliases, leading to Unknown column errors.
    • Advised against using table aliases and recommended using DRY RUN QUERY or DRY RUN for preview.
    • Linked to the more detailed non-transactional-dml.md for further information.
Activity
  • The author has signed the Contributor License Agreement.
  • The changes apply to master and TiDB versions v9.0, v8.5, v8.1, v7.5, v7.1, and v6.5.
  • This PR is a translation from https://github.com/pingcap/docs-cn/pull/21313.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@ti-chi-bot ti-chi-bot bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Mar 4, 2026
@hfxsd hfxsd self-requested a review March 4, 2026 07:51
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request adds documentation about a potential Unknown column error when using table aliases in non-transactional DML statements. The changes include a new FAQ section in non-transactional-dml.md and a related note in sql-statements/sql-statement-batch.md. My review focuses on improving the clarity, conciseness, and readability of the new content, following the repository's documentation style guide. I've suggested several wording improvements to make the explanations more direct and easier for users to understand.

Note: Security Review has been skipped due to the limited scope of the PR.

@ti-chi-bot ti-chi-bot bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Mar 4, 2026
@ti-chi-bot
Copy link

ti-chi-bot bot commented Mar 4, 2026

[LGTM Timeline notifier]

Timeline:

  • 2026-03-04 08:10:50.334898161 +0000 UTC m=+345694.912977345: ☑️ agreed by hfxsd.

Co-authored-by: xixirangrang <hfxsd@hotmail.com>
@Oreoxmt
Copy link
Collaborator Author

Oreoxmt commented Mar 4, 2026

/cc @ekexium

@ti-chi-bot ti-chi-bot bot requested a review from ekexium March 4, 2026 08:27
@ti-chi-bot
Copy link

ti-chi-bot bot commented Mar 4, 2026

@ekexium: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@Oreoxmt Oreoxmt added the lgtm label Mar 6, 2026
@Oreoxmt
Copy link
Collaborator Author

Oreoxmt commented Mar 6, 2026

/approve

@ti-chi-bot
Copy link

ti-chi-bot bot commented Mar 6, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: Oreoxmt

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 Mar 6, 2026
@ti-chi-bot ti-chi-bot bot merged commit d789f71 into pingcap:master Mar 6, 2026
12 checks passed
@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-6.5: #22535.

@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-7.1: #22536.

@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-7.5: #22537.

@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-8.1: #22538.

@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-8.5: #22539.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved lgtm needs-1-more-lgtm Indicates a PR needs 1 more LGTM. needs-cherry-pick-release-6.5 Should cherry pick this PR to release-6.5 branch. needs-cherry-pick-release-7.1 Should cherry pick this PR to release-7.1 branch. needs-cherry-pick-release-7.5 Should cherry pick this PR to release-7.5 branch. needs-cherry-pick-release-8.1 Should cherry pick this PR to release-8.1 branch. needs-cherry-pick-release-8.5 Should cherry pick this PR to release-8.5 branch. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. translation/from-docs-cn This PR is translated from a PR in pingcap/docs-cn.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants