multithreaded zstd backup compression for client and server
Robert Haas <robertmhaas@gmail.com>
Commits
GET /api/v1/messages/:b64id/commits
the thread's linked commits as JSON, with link sources.
API reference →
-
Document BaseBackupSync and BaseBackupWrite wait events.
- 749320cdc3fd 15.3 landed
- 4b1ad19a4e22 16.0 landed
-
Support long distance matching for zstd compression
- 2820adf7755d 16.0 landed
-
Fix possible NULL-pointer-deference in backup_compression.c.
- 8e053dc6dfbe 15.0 landed
-
Allow parallel zstd compression when taking a base backup.
- 51c0d186d99a 15.0 landed
-
Make PostgreSQL::Test::Cluster::run_log() return a useful value.
- ad4f2c47de44 15.0 landed
-
Fix a few goofs in new backup compression code.
- 61762426e6ed 15.0 landed
-
Replace BASE_BACKUP COMPRESSION_LEVEL option with COMPRESSION_DETAIL.
- ffd53659c46a 15.0 landed
-
Add 'basebackup_to_shell' contrib module.
- c6306db24bd9 15.0 landed
-
Allow extensions to add new backup targets.
- e4ba69f3f4a1 15.0 landed
-
Change HAVE_LIBLZ4 and HAVE_LIBZSTD tests to USE_LZ4 and USE_ZSTD.
- 75eae090876f 15.0 landed
-
pg_basebackup: Clean up some bogus file extension tests.
- d6f1cdeb9a9e 15.0 landed
-
pg_basebackup: Avoid unclean failure with server-compression and -D -.
- b2de45f9200d 15.0 landed
-
Fix LZ4 tests for remaining buffer space.
- 1d4be6be65ab 15.0 landed
-
Add support for zstd base backup compression.
- 7cf085f077df 15.0 landed
-
pg_basebackup: Allow client-side LZ4 (de)compression.
- 751b8d23b788 15.0 landed
-
Add suport for server-side LZ4 base backup compression.
- dab298471ff2 15.0 landed
-
Add min() and max() aggregates for xid8.
- 400fc6b6487d 15.0 cited
-
Remove superfluous variable.
- 82331ed4dd60 15.0 landed
-
pg_basebackup: Cleaner handling when compression is multiply specified.
- 51891d5a9560 15.0 landed
-
Allow server-side compression to be used with -Fp.
- d45099425eb1 15.0 landed
-
pg_basebackup: Fix a couple of recently-introduced bugs.
- dabf63bc9a5b 15.0 landed
-
Tidy up a few cosmetic issues related to pg_basebackup.
- e1f860f13459 15.0 landed
-
Server-side gzip compression.
- 0ad8032910d5 15.0 landed
-
Unbreak pg_basebackup/t/010_pg_basebackup.pl on msys
- 4f0bcc735038 15.0 cited
-
Suppress variable-set-but-not-used warning from clang 13.
- dc43fc9b3aa3 15.0 cited
-
Extend the options of pg_basebackup to control compression
- 5c649fe15336 15.0 cited
-
Support base backup targets.
- 3500ccc39b0d 15.0 landed
-
Modify pg_basebackup to use a new COPY subprotocol for base backups.
- cc333f32336f 15.0 landed
-
Document that tar archives are now properly terminated.
- 81fca310b38e 15.0 landed
-
Fix thinko in bbsink_throttle_manifest_contents.
- 1b098da20093 15.0 landed
-
Have the server properly terminate tar archives.
- 5a1007a5088c 15.0 landed
-
Minimal fix for unterminated tar archive problem.
- 57b5a9646d97 15.0 landed
-
Introduce 'bbstreamer' abstraction to modularize pg_basebackup.
- 23a1c6578c87 15.0 landed
-
Introduce 'bbsink' abstraction to modularize base backup code.
- bef47ff85df1 15.0 landed
-
Refactor basebackup.c's _tarWriteDir() function.
- 967a17fe2fa7 15.0 landed
-
Flexible options for CREATE_REPLICATION_SLOT.
- 0266e98c6b86 15.0 landed
-
Flexible options for BASE_BACKUP.
- 0ba281cb4bf9 15.0 landed
Attachments
- 0001-Allow-parallel-zstd-compression-when-taking-a-base-b.patch (application/octet-stream) patch 0001
[ Changing subject line in the hopes of attracting more eyeballs. ] On Mon, Mar 14, 2022 at 12:11 PM Dipesh Pandit <dipesh.pandit@gmail.com> wrote: > I tried to implement support for parallel ZSTD compression. Here's a new patch for this. It's more of a rewrite than an update, honestly; commit ffd53659c46a54a6978bcb8c4424c1e157a2c0f1 necessitated totally different options handling, but I also redid the test cases, the documentation, and the error message. For those who may not have been following along, here's an executive summary: libzstd offers an option for parallel compression. It's intended to be transparent: you just say you want it, and the library takes care of it for you. Since we have the ability to do backup compression on either the client or the server side, we can expose this option in both locations. That would be cool, because it would allow for really fast backup compression with a good compression ratio. It would also mean that we would be, or really libzstd would be, spawning threads inside the PostgreSQL backend. Short of cats and dogs living together, it's hard to think of anything more terrifying, because the PostgreSQL backend is very much not thread-safe. However, a lot of the things we usually worry about when people make noises about using threads in the backend don't apply here, because the threads are hidden away behind libzstd interfaces and can't execute any PostgreSQL code. Therefore, I think it might be safe to just ... turn this on. One reason I think that is that this whole approach was recommended to me by Andres ... but that's not to say that there couldn't be problems. I worry a bit that the mere presence of threads could in some way mess things up, but I don't know what the mechanism for that would be, and I don't want to postpone shipping useful features based on nebulous fears. In my ideal world, I'd like to push this into v15. I've done a lot of work to improve the backup code in this release, and this is actually a very small change yet one that potentially enables the project to get a lot more value out of the work that has already been committed. That said, I also don't want to break the world, so if you have an idea what this would break, please tell me. For those curious as to how this affects performance and backup size, I loaded up the UK land registry database. That creates a 3769MB database. Then I backed it up using client-side compression and server-side compression using the various different algorithms that are supported in the master branch, plus parallel zstd. no compression: 3.7GB, 9 seconds gzip: 1.5GB, 140 seconds with server-side, 141 seconds with client-side lz4: 2.0GB, 13 seconds with server-side, 12 seconds with client-side For both parallel and non-parallel zstd compression, I see differences between the compressed size depending on where the compression is done. I don't know whether this is an expected behavior of the zstd library or a bug. Both files uncompress OK and pass pg_verifybackup, but that doesn't mean we're not, for example, selecting different compression levels where we shouldn't be. I'll try to figure out what's going on here. zstd, client-side: 1.7GB, 17 seconds zstd, server-side: 1.3GB, 25 seconds parallel zstd, 4 workers, client-side: 1.7GB, 7.5 seconds parallel zstd, 4 workers, server-side: 1.3GB, 7.2 seconds Notice that compressing the backup with parallel zstd is actually faster than taking an uncompressed backup, even though this test is all being run on the same machine. That's kind of crazy to me: the parallel compression is so fast that we save more time on I/O than we spend compressing. This assumes of course that you have plenty of CPU resources and limited I/O resources, which won't be true for everyone, but it's not an unusual situation. I think the documentation changes in this patch might not be quite up to scratch. I think there's a brewing problem here: as we add more compression options, whether or not that happens in this release, and regardless of what specific options we add, the way things are structured right now, we're going to end up either duplicating a bunch of stuff between the pg_basebackup documentation and the BASE_BACKUP documentation, or else one of those places is going to end up lacking information that someone reading it might like to have. I'm not exactly sure what to do about this, though. This patch contains a trivial adjustment to PostgreSQL::Test::Cluster::run_log to make it return a useful value instead of not. I think that should be pulled out and committed independently regardless of what happens to this patch overall, and possibly back-patched. Thanks, -- Robert Haas EDB: http://www.enterprisedb.com