`pg_restore --if-exists` clarification

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: toraritte(at)gmail(dot)com
Subject: `pg_restore --if-exists` clarification
Date: 2023-09-28 12:49:26
Message-ID: 169590536647.3727336.11070254203649648453@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/app-pgrestore.html
Description:

Good Morning,

In the `pg_restore` docs
(https://www.postgresql.org/docs/current/app-pgrestore.html) `--if-exists`
states that it is to

> Use conditional commands (i.e., add an IF EXISTS clause)
> to drop database objects. This option is not valid unless
> --clean is also specified.", but not being a SQL expert,
> I'm having a hard time deciphering this.

Suggestion: Would you consider adding the sentence (or something similar)?

> "--clean makes pg_restore drop all objects first,
> and --if-exists prevents that non-existent objects
> cause a failure."
Source: https://stackoverflow.com/a/75136163/1498178

This is succinct, and tells exactly what one needs to know. Thank you and
have a great day!

Appreciatively,
Attila

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2023-09-28 13:55:43 Re: Make SSPI documentation clearer
Previous Message Daniel Gustafsson 2023-09-28 12:13:44 Re: Hyperlinks for source file references