chore(postgres): slightly extend knowledge on tools

This commit is contained in:
Michele Cereda
2025-08-30 11:29:32 +02:00
parent f24d6e5d8a
commit 3f740e64c7
4 changed files with 54 additions and 3 deletions

View File

@@ -3,7 +3,9 @@
> [!caution]
> TODO
Intro
Command-line tool for creating backups of entire PostgreSQL clusters, and/or global objects like roles and
tablespaces.<br/>
Consider using [`pg_dump`][pg_dump] to create backups of a single database when nothing else is needed.
<!-- Remove this line to uncomment if used
## Table of contents <!-- omit in toc -->
@@ -14,6 +16,25 @@ Intro
## TL;DR
It can dump databases in their entirety, or just specific parts of them such as individual tables or schemas.<br/>
It **can** dump objects like roles, groups, tablespace and others.
It produces sets of SQL statements that can be executed to reproduce the original databases' object definitions and
table data.
Suitable when:
- The databases' size is **less** than 100 GB.<br/>
It tends to start giving issues for bigger databases.
- One plans to migrate the databases' metadata as well as the table data.
- There is a relatively large number of tables to migrate.
> [!important]
> `pg_dumpall` works better when the database is taken offline, but it **does keep the database available** and will
> **not** prevent users from accessing it.<br/>
> Even with other users accessing the database during the backup process, `pg_dumpall` will **always** produce
> consistent results thanks to ACID properties.
<!-- Uncomment if used
<details>
<summary>Setup</summary>