Document new database vacuum tasks
authorMark Felder <feld@FreeBSD.org>
Fri, 29 May 2020 15:17:06 +0000 (10:17 -0500)
committerMark Felder <feld@FreeBSD.org>
Fri, 29 May 2020 15:17:06 +0000 (10:17 -0500)
docs/administration/CLI_tasks/database.md

index ff400c8ed9437c69e222af3f283003d5903d1bb1..647f6f27467aa87689a518b54cb7467daf02b52d 100644 (file)
@@ -69,3 +69,32 @@ mix pleroma.database update_users_following_followers_counts
 ```sh tab="From Source"
 mix pleroma.database fix_likes_collections
 ```
+
+## Vacuum the database
+
+### Analyze
+
+Running an `analyze` vacuum job can improve performance by updating statistics used by the query planner. **It is safe to cancel this.**
+
+```sh tab="OTP"
+./bin/pleroma_ctl database vacuum analyze
+```
+
+```sh tab="From Source"
+mix pleroma.database vacuum analyze
+```
+
+### Full
+
+Running a `full` vacuum job rebuilds your entire database by reading all of the data and rewriting it into smaller
+and more compact files with an optimized layout. This process will take a long time and use additional disk space as
+it builds the files side-by-side the existing database files. It can make your database faster and use less disk space,
+but should only be run if necessary. **It is safe to cancel this.**
+
+```sh tab="OTP"
+./bin/pleroma_ctl database vacuum full
+```
+
+```sh tab="From Source"
+mix pleroma.database vacuum full
+```
\ No newline at end of file