Skip to content

mysql-schema: add information about several missing system tables #20409

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.

Sign up for GitHub

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 5 commits into from
Mar 4, 2025
Merged

mysql-schema: add information about several missing system tables #20409

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
c358b90
add
time-and-fate Feb 28, 2025
672afaa
update
time-and-fate Feb 28, 2025
be41759
update
time-and-fate Feb 28, 2025
a468479
revise wording
Oreoxmt Mar 3, 2025
bbfbd97
make ci happy
Oreoxmt Mar 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions mysql-schema/mysql-schema.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,9 @@ Currently, the `help_topic` is NULL.
- `stats_extended`: extended statistics, such as the order correlation between columns
- `stats_feedback`: the query feedback of statistics
- `stats_fm_sketch`: the FMSketch distribution of the histogram of the statistics column
- `stats_table_locked`: information about the locked statistics
- `stats_meta_history`: the meta information in the historical statistics
- `stats_history`: the other information in the historical statistics
- `analyze_options`: the default `analyze` options for each table
- `column_stats_usage`: the usage of column statistics
- `analyze_jobs`: the ongoing statistics collection tasks and the history task records within the last 7 days
Expand All @@ -57,6 +60,11 @@ Currently, the `help_topic` is NULL.
- `bind_info`: the binding information of execution plans
- `capture_plan_baselines_blacklist`: the blocklist for the automatic binding of the execution plan

## System tables related to PLAN REPLAYER

- `plan_replayer_status`: the [`PLAN REPLAYER CAPTURE`](https://docs.pingcap.com/tidb/stable/sql-plan-replayer#use-plan-replayer-capture) tasks registered by the user
- `plan_replayer_task`: the results of [`PLAN REPLAYER CAPTURE`](https://docs.pingcap.com/tidb/stable/sql-plan-replayer#use-plan-replayer-capture) tasks

## GC worker system tables

> **Note:**
Expand Down Expand Up @@ -118,6 +126,7 @@ Currently, the `help_topic` is NULL.
- `opt_rule_blacklist`: the blocklist for logical optimization rules
Copy link
Collaborator

Choose a reason for hiding this comment

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

docs/mysql-schema/mysql-schema.md

Lines 118 to 122 in a468479

<CustomContent platform="tidb">
> **Note:**
>
> The `tidb`, `expr_pushdown_blacklist`, `opt_rule_blacklist`, `table_cache_meta`, `tidb_import_jobs`, and `tidb_timers` system tables are only applicable to TiDB Self-Managed and not available on [TiDB Cloud](https://docs.pingcap.com/tidbcloud/).

@Defined2014 Could you please confirm whether advisory_locks is applicable to/supported in TiDB Cloud? Thank you.

Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure about it. Maybe ask the member of could team?

- `tidb_import_jobs`: the job information of [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md)
- `tidb_timers`: the metadata of internal timers
- `advisory_locks`: information related to [Locking functions](/functions-and-operators/locking-functions.md)

</CustomContent>

Expand Down