You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-8Lines changed: 8 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -6,12 +6,12 @@
6
6
7
7
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).
8
8
9
-
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)
9
+
Current patch are available forPostgreSQL[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)
10
10
11
11
##Enterprise edition
12
12
13
-
Enterprise PTRACK are part of[Postgres Pro Backup Enterprise](https://postgrespro.ru/products/postgrespro/enterprise) andshare posibilityto track more than 100 000 tables and indexesper timewithoutspeed degradationwith[CFS (compressed file system)](https://postgrespro.ru/docs/enterprise/15/cfs).
14
-
Benchmarks are x5 timefaster and useful for ERP and DWH with hugeamounth of tables and relations between them.
13
+
Enterprise PTRACK are part of[Postgres Pro Backup Enterprise](https://postgrespro.ru/products/postgrespro/enterprise) andoffers the capabilityto track more than 100 000 tables and indexesconcurrentlywithoutany degradationin speed[CFS (compressed file system)](https://postgrespro.ru/docs/enterprise/15/cfs).
14
+
According to benchmarks, it operated up to 5 timesfaster and useful for ERP and DWH with hugeamount of tables and relations between them.
15
15
16
16
##Installation
17
17
@@ -135,7 +135,7 @@ Since version 2.2 we use a different algorithm for tracking changed pages. Thus,
135
135
136
136
2. The only one production-ready backup utility, that fully supports`PTRACK` is[pg_probackup](https://github.com/postgrespro/pg_probackup).
137
137
138
-
3. You cannot resize`PTRACK` map in runtime, only on postmaster start. Also, you willloose all tracked changes, so it is recommended to do so in the maintainance window and accompany this operation with full backup.
138
+
3. You cannot resize`PTRACK` map in runtime, only on postmaster start. Also, you willlose all tracked changes, so it is recommended to do so in the maintainance window and accompany this operation with full backup.
139
139
140
140
4. You will need up to`ptrack.map_size * 2` of additional disk space, since`PTRACK` uses additional temporary file for durability purpose. See[Architecture section](#Architecture) for details.
141
141
@@ -145,13 +145,13 @@ Briefly, an overhead of using `PTRACK` on TPS usually does not exceed a couple o
145
145
146
146
##Architecture
147
147
148
-
It is designed toallow false positives (i.e. block/page is marked in the`PTRACK` map, but actually has not been changed), butto neverallow false negatives (i.e. loosingany`PGDATA` changes, excepting hint-bits).
148
+
It is designed topermit false positives (i.e., block/page is markedas alteredin the`PTRACK` map when it hasn't actually been changed), butit nevertolerates false negatives (i.e., it never losesany PGDATA modifications, barring hint-bits).
149
149
150
-
Currently,`PTRACK` codebase issplit between small PostgreSQL core patch and extension.All public SQL API methods and main engine areplaced in the`PTRACK` extension,while the core patchcontainsonlycertainhooks and modifies binary utilities toignore`ptrack.map.*` files.
150
+
At present, thePTRACK codebase isdivided betweenasmall PostgreSQL core patch andanextension.The public SQL API methods andthemain engine arehoused in the`PTRACK` extension,whereas the core patch onlyincludes specifichooks and modifies binary utilities todisregardptrack.map.* files.
151
151
152
-
Weuse a single shared hash table in`PTRACK`. Due to the fixed size of the map theremay be false positives (whensome block is marked as changed withoutbeing actually modified), butnotfalsenegative results. However, these falsepostives may be completelyeliminated by setting a highenough`ptrack.map_size`.
152
+
In`PTRACK`, weuse a single shared hash table. Due to the fixed size of the map, therecan be false positives (whena block is marked as changed withoutactual modification), but falsenegatives are not allowed. Nevertheless, these falsepositives can be completelyremoved by setting asufficientlyhigh ptrack.map_size.
153
153
154
-
All reads/writes aremade using atomic operations on`uint64` entries,so the mapiscompletely lockless duringthe normalPostgreSQL operation.Because we do notuse locks for read/write access,`PTRACK`keeps a map (`ptrack.map`) since the last checkpointintact and usesup to 1additional temporary file:
154
+
All reads/writes areperformed using atomic operations on uint64 entries,making the map completely lockless duringstandardPostgreSQL operation.Since we do notutilize locks for read/write access,`PTRACK`maintains a map (ptrack.map) from the last checkpointunaltered and usesa maximum of oneadditional temporary file.
155
155
156
156
* temporary file`ptrack.map.tmp` to durably replace`ptrack.map` during checkpoint.