PXB-3757 Document --check-tables feature in 8.4.0-6 by alina-derkach-oaza · Pull Request #475 · percona/pxb-docs

alina-derkach-oaza · 2026-05-14T16:12:25Z

No description provided.

new file: docs/innodb-btree-check.md

modified: docs/innodb-btree-check.md modified: docs/xtrabackup-option-reference.md

satya-bodapati · 2026-05-15T13:42:20Z

We should also add a link to How to section.
How to "verify a backup"

we already some references to pt-table-checkusm
we can add a new subtopic here (may be?):

[Side topic]

Ideally, I would love to see all workflows in howto section. ie duplicating some links.
currently they are in separate binary sections for xbcloud, xbstream etc. Specially the streaming/cloud backups part.

We already covered good number of Howtos.. the list in my mind so far (including what we have right now)

How to
take full backup
take inc backup
How to verify a backup
How to know the size of backup [new feature]
How to take partial backup (partitions should go heere)
how to prepare backups (full/incremental)
How to restore a full backup
how to restore to incremental backups
how to restore a single table
How to stream a backup to cloud
how to download a backup from cloud
How to stream backups to another hosts
how to encrypt
how to compress
how to setup replica from a backup
How to tune xtrabackup (advanced): --parallel, --encyrpt-threads, --compress-threads, --fifo-streams, --parallel in xbcloud,

satya-bodapati

Looks much much better Alina, thank you.

One minor comment. I will check in detail tomorrow.

satya-bodapati · 2026-05-18T15:34:41Z

@alina-derkach-oaza linkinspector check is failing, please hceck if we have some broken links?

patrickbirch

ok - after you fix one comment.

satya-bodapati · 2026-05-19T09:42:38Z

+The validation process performs the following structural checks:
+
+| Check | Detected condition |
+|------|---------------------|


There is one important point that I missed. CHECK TABLE will also detect mismatches in the record count between the PRIMARY and Secondary indexes.

A non-corrupted secondary index should always have the same number of records as the PRIMARY index has.

I don't have a sample output, though.

@satya-bodapati

Do you mean CHECK TABLE or --check-tables?

Both - they use the same internal command

PXB-3757 Document --check-tables feature in 8.4

f68f3d3

new file: docs/innodb-btree-check.md

alina-derkach-oaza requested review from patrickbirch and satya-bodapati May 14, 2026 16:12

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 14, 2026 16:12 — with Render View deployment

alina-derkach-oaza force-pushed the PXB-3757 branch from 80916db to 4082a04 Compare May 14, 2026 17:24

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 14, 2026 17:24 — with Render View deployment

patrickbirch reviewed May 14, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch reviewed May 14, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch reviewed May 14, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

PXB-3757 Document --check-tables feature in 8.4

95af2d0

modified: docs/innodb-btree-check.md modified: docs/xtrabackup-option-reference.md

alina-derkach-oaza force-pushed the PXB-3757 branch from 4082a04 to 95af2d0 Compare May 14, 2026 20:43

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 14, 2026 20:43 — with Render View deployment

patrickbirch reviewed May 15, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch reviewed May 15, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch reviewed May 15, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch reviewed May 15, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch reviewed May 15, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

satya-bodapati suggested changes May 15, 2026

View reviewed changes

Apply the part of changes after review

1ce0731

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 15, 2026 17:06 — with Render View deployment

Apply the changes to resolve the comments

6f08b20

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 18, 2026 15:20 — with Render View deployment

satya-bodapati reviewed May 18, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 18, 2026 16:29 — with Render View deployment

alina-derkach-oaza force-pushed the PXB-3757 branch from 1cec893 to eb12ae9 Compare May 18, 2026 16:39

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 18, 2026 16:39 — with Render View deployment

alina-derkach-oaza force-pushed the PXB-3757 branch from eb12ae9 to 88a5420 Compare May 18, 2026 21:04

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 18, 2026 21:04 — with Render View deployment

alina-derkach-oaza force-pushed the PXB-3757 branch from 88a5420 to d546db2 Compare May 20, 2026 16:28

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 20, 2026 16:28 — with Render View deployment

patrickbirch reviewed May 20, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

alina-derkach-oaza force-pushed the PXB-3757 branch from d546db2 to d598e27 Compare May 21, 2026 14:22

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 21, 2026 14:22 — with Render View deployment

patrickbirch reviewed May 21, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

patrickbirch approved these changes May 21, 2026

View reviewed changes

alina-derkach-oaza force-pushed the PXB-3757 branch from d598e27 to dd70026 Compare May 21, 2026 14:59

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 21, 2026 14:59 — with Render View deployment

satya-bodapati suggested changes May 21, 2026

View reviewed changes

satya-bodapati reviewed May 21, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

satya-bodapati reviewed May 21, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md

satya-bodapati reviewed May 21, 2026

View reviewed changes

Comment thread docs/innodb-btree-check.md Outdated

Adding references to the table and fixing links

2ea03b0

alina-derkach-oaza force-pushed the PXB-3757 branch from dd70026 to 2ea03b0 Compare May 21, 2026 16:40

alina-derkach-oaza deployed to PXB-3757 - percona-xtrabackup-docs-8.4 PR #475 May 21, 2026 16:40 — with Render View deployment

Conversation

alina-derkach-oaza commented May 14, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

satya-bodapati commented May 15, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

satya-bodapati left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

satya-bodapati commented May 18, 2026

Uh oh!

Uh oh!

Uh oh!

patrickbirch left a comment

Choose a reason for hiding this comment

Uh oh!

satya-bodapati May 19, 2026

Choose a reason for hiding this comment

Uh oh!

satya-bodapati May 19, 2026

Choose a reason for hiding this comment

Uh oh!

alina-derkach-oaza May 21, 2026

Choose a reason for hiding this comment

Uh oh!

patrickbirch May 21, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants