Pbckp 690 update readme by demonolock · Pull Request #38 · postgrespro/ptrack

demonolock · 2023-08-03T18:14:47Z

No description provided.

demonolock · 2023-08-03T18:15:09Z

README.md

 ## Overview

-Ptrack is a block-level incremental backup engine for PostgreSQL. You can [effectively use](https://postgrespro.github.io/pg_probackup/#pbk-setting-up-ptrack-backups) `ptrack` engine for taking incremental backups with [pg_probackup](https://github.com/postgrespro/pg_probackup) backup and recovery manager for PostgreSQL.
+You can [effectively use](https://postgrespro.github.io/pg_probackup/#pbk-setting-up-ptrack-backups) `PTRACK` engine for taking incremental backups with [pg_probackup](https://github.com/postgrespro/pg_probackup) backup and recovery manager for PostgreSQL.


backups with - backups by

demonolock · 2023-08-03T18:19:18Z

README.md

+Currently, `PTRACK` codebase is split between small PostgreSQL core patch and extension. All public SQL API methods and main engine are placed in the `PTRACK` extension, while the core patch contains only certain hooks and modifies binary utilities to ignore `ptrack.map.*` files.

-This extension is compatible with PostgreSQL [11](https://github.com/postgrespro/ptrack/blob/master/patches/REL_11_STABLE-ptrack-core.diff), [12](https://github.com/postgrespro/ptrack/blob/master/patches/REL_12_STABLE-ptrack-core.diff), [13](https://github.com/postgrespro/ptrack/blob/master/patches/REL_13_STABLE-ptrack-core.diff), [14](https://github.com/postgrespro/ptrack/blob/master/patches/REL_14_STABLE-ptrack-core.diff).
+This extension is compatible with PostgreSQL [11](https://github.com/postgrespro/ptrack/blob/master/patches/REL_11_STABLE-ptrack-core.diff), [12](https://github.com/postgrespro/ptrack/blob/master/patches/REL_12_STABLE-ptrack-core.diff), [13](https://github.com/postgrespro/ptrack/blob/master/patches/REL_13_STABLE-ptrack-core.diff), [14](https://github.com/postgrespro/ptrack/blob/master/patches/REL_14_STABLE-ptrack-core.diff), [15](https://github.com/postgrespro/ptrack/blob/master/patches/REL_15_STABLE-ptrack-core.diff)


This extension is compatible with the next versions of PostgreSQL

demonolock · 2023-08-03T18:23:43Z

README.md

 ### TODO

-* Should we introduce `ptrack.map_path` to allow `ptrack` service files storage outside of `PGDATA`? Doing that we will avoid patching PostgreSQL binary utilities to ignore `ptrack.map.*` files.
-* Can we resize `ptrack` map on restart but keep the previously tracked changes?
-* Can we write a formal proof, that we never loose any modified page with `ptrack`? With TLA+?
+* Should we introduce `ptrack.map_path` to allow `PTRACK` service files storage outside of `PGDATA`? Doing that we will avoid patching PostgreSQL binary utilities to ignore `ptrack.map.*` files.
+* Can we resize `PTRACK` map on restart but keep the previously tracked changes?


Can be removed

demonolock · 2023-08-03T18:35:10Z

README.md

+## Enterprise edition
+
+Enterprise PTRACK are part of Postgres Pro Enterprise and share posibility to track more than 100 000 tables and indexes per time without speed degradation with [CFS (compressed file system)](https://postgrespro.ru/docs/enterprise/15/cfs).
+Benchmarcs are x5 time faster and useful for ERP and DWH with huge amounth of tables and relations between them.


demonolock · 2023-08-03T18:42:05Z

README.md

+PTRACK saves changes of physical blocks in the memory. You can [effectively use](https://postgrespro.github.io/pg_probackup/#pbk-setting-up-ptrack-backups) `PTRACK` engine for taking incremental backups by [pg_probackup](https://github.com/postgrespro/pg_probackup) backup and recovery manager for PostgreSQL.

-It is designed to allow false positives (i.e. block/page is marked in the `ptrack` map, but actually has not been changed), but to never allow false negatives (i.e. loosing any `PGDATA` changes, excepting hint-bits).
+Current patch are available for [11](https://github.com/postgrespro/ptrack/blob/master/patches/REL_11_STABLE-ptrack-core.diff), [12](https://github.com/postgrespro/ptrack/blob/master/patches/REL_12_STABLE-ptrack-core.diff), [13](https://github.com/postgrespro/ptrack/blob/master/patches/REL_13_STABLE-ptrack-core.diff), [14](https://github.com/postgrespro/ptrack/blob/master/patches/REL_14_STABLE-ptrack-core.diff), [15](https://github.com/postgrespro/ptrack/blob/master/patches/REL_15_STABLE-ptrack-core.diff)


for PostgreSQL

demonolock · 2023-08-03T18:47:01Z

README.md

+## Enterprise edition

-This extension is compatible with PostgreSQL [11](https://github.com/postgrespro/ptrack/blob/master/patches/REL_11_STABLE-ptrack-core.diff), [12](https://github.com/postgrespro/ptrack/blob/master/patches/REL_12_STABLE-ptrack-core.diff), [13](https://github.com/postgrespro/ptrack/blob/master/patches/REL_13_STABLE-ptrack-core.diff), [14](https://github.com/postgrespro/ptrack/blob/master/patches/REL_14_STABLE-ptrack-core.diff).
+Enterprise PTRACK are part of [Postgres Pro Backup Enterprise](https://postgrespro.ru/products/postgrespro/enterprise) and share posibility to track more than 100 000 tables and indexes per time without speed degradation with [CFS (compressed file system)](https://postgrespro.ru/docs/enterprise/15/cfs).


demonolock · 2023-08-03T18:48:13Z

README.md

+2. The only one production-ready backup utility, that fully supports `PTRACK` is [pg_probackup](https://github.com/postgrespro/pg_probackup).

-3. You cannot resize `ptrack` map in runtime, only on postmaster start. Also, you will loose all tracked changes, so it is recommended to do so in the maintainance window and accompany this operation with full backup.
+3. You cannot resize `PTRACK` map in runtime, only on postmaster start. Also, you will loose all tracked changes, so it is recommended to do so in the maintainance window and accompany this operation with full backup.


loose -> lose

Spell corrections

Burus added 2 commits August 3, 2023 20:58

Base commit

7bd6fc3

update ptrack to the uppercase style

40a60c8

demonolock commented Aug 3, 2023

View reviewed changes

update README

66ede22

demonolock commented Aug 3, 2023

View reviewed changes

update README

22d6948

demonolock commented Aug 3, 2023

View reviewed changes

demonolock and others added 2 commits August 3, 2023 21:30

Update README.md

913e0fc

Spell corrections

update README

abc1cfc

demonolock assigned Burus Aug 4, 2023

Burus added 4 commits August 4, 2023 15:01

update README

e928c82

update readme and Authors

cd78a08

Update README.md

33be898

Update AUTHORS.md

f7ecdd0

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

Pbckp 690 update readme#38

Pbckp 690 update readme#38
demonolock wants to merge 10 commits intomasterfrom
PBCKP-690-update-readme

demonolock commented Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023 •

edited

Loading

Uh oh!

demonolock Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Comments

Conversation

demonolock commented Aug 3, 2023

Uh oh!

demonolock Aug 3, 2023

Choose a reason for hiding this comment

Uh oh!

demonolock Aug 3, 2023

Choose a reason for hiding this comment

Uh oh!

demonolock Aug 3, 2023

Choose a reason for hiding this comment

Uh oh!

demonolock Aug 3, 2023

Choose a reason for hiding this comment

Uh oh!

demonolock Aug 3, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

demonolock Aug 3, 2023

Choose a reason for hiding this comment

Uh oh!

demonolock Aug 3, 2023

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

demonolock Aug 3, 2023 •

edited

Loading