Skip to content

*: clarify feature availability on Starter and Essential clusters #21509

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Aug 6, 2025

Conversation

lilin90
Copy link
Member

@lilin90 lilin90 commented Aug 4, 2025

What is changed, added or deleted? (Required)

Updated documentation to indicate that various features and INFORMATION_SCHEMA tables are not available on both TiDB Cloud Starter and Essential clusters, instead of only Starter clusters. This change ensures accurate information about feature availability across different TiDB Cloud cluster tiers.

Note

This PR updated only those files outside the ./tidb-cloud directory. For changes inside the ./tidb-cloud directory, see #21516.

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)
  • 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)?

  • 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

Updated documentation to indicate that various features and INFORMATION_SCHEMA tables are not available on both TiDB Cloud Starter and Essential clusters, instead of only Starter clusters. This change ensures accurate information about feature availability across different TiDB Cloud cluster tiers.
@lilin90 lilin90 requested a review from qiancai August 4, 2025 08:17
@lilin90 lilin90 self-assigned this Aug 4, 2025
@lilin90 lilin90 added translation/no-need No need to translate this PR. rename-serverless This PR is caused by renaming TiDB Cloud Serverless. labels Aug 4, 2025
@ti-chi-bot ti-chi-bot bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Aug 4, 2025
Copy link

@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.

Summary of Changes

Hello @lilin90, 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 focuses on improving the precision of the TiDB documentation by extending the scope of feature unavailability notes. Previously, certain features and INFORMATION_SCHEMA tables were documented as unavailable only on TiDB Cloud Starter clusters. This PR updates these notes to correctly include Essential clusters as well, ensuring users have accurate information regarding functionality across different TiDB Cloud service tiers.

Highlights

  • Documentation Accuracy: Updated various documentation pages to accurately reflect feature unavailability on TiDB Cloud's 'Essential' cluster tier, in addition to the 'Starter' tier.
  • Feature Availability Clarification: Clarified the limitations of several TiDB features and INFORMATION_SCHEMA tables, such as JSON functions, Index Advisor, various CLUSTER_ and TIKV_ tables, SQL statements for resource management, backup/restore, and more, for specific cloud cluster types.
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 in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

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 issue 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 or fill out our survey to provide feedback.

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.

@lilin90 lilin90 added the area/tidb-cloud This PR relates to the area of TiDB Cloud. label Aug 4, 2025
Replaces plain '{{{ .essential }}}' mentions with proper links to the Essential tier documentation across all feature and table availability notes. Ensures consistent formatting and accurate references for TiDB Cloud Starter and Essential cluster limitations.
Copy link

Warning

Gemini encountered an error creating the review. You can try again by commenting /gemini review.

Updated multiple documentation files to include references to the Essential tier ({{{ .essential }}}) alongside Starter and other TiDB Cloud tiers. Adjusted compatibility notes, feature support, and configuration instructions to reflect Essential tier availability and limitations.
@ti-chi-bot ti-chi-bot bot added area/develop This PR relates to the area of TiDB App development. 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 Aug 5, 2025
lilin90 and others added 2 commits August 6, 2025 14:20
Replaces all occurrences of <div label="{{{ .starter }}}"> with <div label="{{{ .starter }}} or Essential"> across multiple developer guide and vector search documentation files. This clarifies that instructions apply to both Starter and Essential cluster types.
@ti-chi-bot ti-chi-bot bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Aug 6, 2025
Copy link

ti-chi-bot bot commented Aug 6, 2025

[LGTM Timeline notifier]

Timeline:

  • 2025-08-06 06:52:30.423006609 +0000 UTC m=+423860.565767785: ☑️ agreed by qiancai.

@lilin90 lilin90 added the lgtm label Aug 6, 2025
@lilin90
Copy link
Member Author

lilin90 commented Aug 6, 2025

/approve

Copy link

ti-chi-bot bot commented Aug 6, 2025

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: lilin90

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

The pull request process is described here

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 Aug 6, 2025
@ti-chi-bot ti-chi-bot bot merged commit d7c28f7 into pingcap:feature/preview-starter Aug 6, 2025
7 of 9 checks passed
@lilin90 lilin90 added translation/doing This PR's assignee is translating this PR. and removed translation/no-need No need to translate this PR. labels Aug 7, 2025
@lilin90 lilin90 changed the title *: clarify feature unavailability on Starter and Essential clusters *: clarify feature availability on Starter and Essential clusters Aug 7, 2025
@lilin90 lilin90 added translation/done This PR has been translated from English into Chinese and updated to pingcap/docs-cn in a PR. and removed translation/doing This PR's assignee is translating this PR. labels Aug 7, 2025
@lilin90 lilin90 deleted the starter-na-note branch August 7, 2025 08:10
@lilin90 lilin90 added needs-cherry-pick-master Should cherry pick this PR to master 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. labels Aug 11, 2025
@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-7.5: #21548.
But this PR has conflicts, please resolve them!

ti-chi-bot pushed a commit to ti-chi-bot/docs that referenced this pull request Aug 11, 2025
ti-chi-bot pushed a commit to ti-chi-bot/docs that referenced this pull request Aug 11, 2025
@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch master: #21549.
But this PR has conflicts, please resolve them!

@ti-chi-bot
Copy link
Member

In response to a cherrypick label: new pull request created to branch release-8.1: #21550.
But this PR has conflicts, please resolve them!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved area/develop This PR relates to the area of TiDB App development. area/tidb-cloud This PR relates to the area of TiDB Cloud. lgtm needs-1-more-lgtm Indicates a PR needs 1 more LGTM. needs-cherry-pick-master Should cherry pick this PR to master 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. rename-serverless This PR is caused by renaming TiDB Cloud Serverless. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. translation/done This PR has been translated from English into Chinese and updated to pingcap/docs-cn in a PR.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants