Skip to content

tidb-cloud: refresh HATP quickstart and add connection steps to the TiDB Cloud quickstart#23157

Open
qiancai wants to merge 2 commits into
pingcap:release-8.5from
qiancai:refresh-htap-quickstart
Open

tidb-cloud: refresh HATP quickstart and add connection steps to the TiDB Cloud quickstart#23157
qiancai wants to merge 2 commits into
pingcap:release-8.5from
qiancai:refresh-htap-quickstart

Conversation

@qiancai

@qiancai qiancai commented Jun 27, 2026

Copy link
Copy Markdown
Collaborator

What is changed, added or deleted? (Required)

  1. tidb-cloud/tidb-cloud-htap-quickstart.md: Refreshed the HTAP quickstart guide:

    • Updated sample dataset from "Steam Game Stats" to "Steam Games Dataset 2021-2025"
    • Added detailed import instructions for the new dataset
    • Changed database references from game to steam
    • Changed metrics from average_playtime_forever to recommendations
    • Enhanced SQL queries with additional analytical columns (genres, developer)
    • Added WHERE, HAVING, and LIMIT clauses to queries
    • Updated all EXPLAIN ANALYZE outputs with new execution statistics
    • Refined descriptions and instructions
  2. tidb-cloud/tidb-cloud-quickstart.md: Added a new "Step 4: Connect to your instance" section with MySQL CLI connection instructions.

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

  • v8.5 (TiDB 8.5 versions)

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

  • Other reference link(s): N/A

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

ti-chi-bot Bot commented Jun 27, 2026

Copy link
Copy Markdown

[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 assign overvenus for approval. 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:

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 missing-translation-status This PR does not have translation status info. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Jun 27, 2026
@qiancai qiancai changed the title tidb-cloud: refresh htap quickstart and add connection steps tidb-cloud: refresh HATP quickstart and add connection steps to the TiDB Cloud quickstart Jun 27, 2026

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

Copy link
Copy Markdown
Contributor

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 updates the TiDB Cloud HTAP Quick Start guide to use the Kaggle 'Steam Games Dataset 2021-2025' instead of the previous sample dataset, adding detailed download and import instructions alongside updated SQL queries and execution plans. It also adds a new section to the Quick Start guide on connecting to a starter instance using the MySQL CLI. The review feedback focuses on aligning the new documentation with the style guide by suggesting the use of active voice, present tense, and more concise phrasing, as well as correcting minor grammatical errors.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread tidb-cloud/tidb-cloud-htap-quickstart.md Outdated
Comment thread tidb-cloud/tidb-cloud-htap-quickstart.md Outdated
Comment thread tidb-cloud/tidb-cloud-htap-quickstart.md Outdated
Comment thread tidb-cloud/tidb-cloud-htap-quickstart.md Outdated
Comment thread tidb-cloud/tidb-cloud-htap-quickstart.md
Comment thread tidb-cloud/tidb-cloud-htap-quickstart.md Outdated
Comment thread tidb-cloud/tidb-cloud-quickstart.md Outdated
Comment thread tidb-cloud/tidb-cloud-quickstart.md

1. On the **Import** page, click **Upload a local file**, and then select and upload the downloaded CSV file.
2. In the **Destination** section, enter `steam` in the **Database** field and `games` in the **Table** field.
3. Click **Define Table**, change the data type of the column `categories` to `TEXT`, and then change the data type of the column `developer` to `TEXT`.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Reason: This step is to avoid the following import errors.

CastValueError: when encoding 12712-th data row in file a_steam_data_2021_2025.csv: Value conversion failed for column 'developer'. Expected type: varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin, received value: ?. Reason: [types:1406]Data Too Long, field len 512, data len 584. Please correct the source data and retry.

CastValueError: when encoding 55532-th data row in file a_steam_data_2021_2025.csv: Value conversion failed for column 'categories'. Expected type: varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin, received value: ?. Reason: [types:1406]Data Too Long, field len 512, data len 522. Please correct the source data and retry.

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@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 Jun 27, 2026
@ti-chi-bot ti-chi-bot Bot removed the missing-translation-status This PR does not have translation status info. label Jun 27, 2026
@qiancai qiancai self-assigned this Jun 27, 2026
github-actions Bot pushed a commit to qiancai/pingcap-docsite-preview that referenced this pull request Jun 27, 2026
qiancai added a commit to qiancai/pingcap-docsite-preview that referenced this pull request Jun 27, 2026
github-actions Bot pushed a commit to qiancai/pingcap-docsite-preview that referenced this pull request Jun 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/tidb-cloud This PR relates to the area of TiDB Cloud. size/L Denotes a PR that changes 100-499 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.

1 participant