vacuumdb
Синтаксис
vacuumdb [ параметр-подключения ...] [ параметр ...] [ --table | -t таблица [( колонка [,...] )] ] ... [ база_данных ]
vacuumdb [ параметр-подключения ...] [ параметр ...] --all | -a
Описание
Утилита vacuumdb предназначена для очистки базы данных PostgreSQL. Кроме того, vacuumdb генерирует внутреннюю статистику, которую использует оптимизатор запросов PostgreSQL.
Утилита vacuumdb представляют собой обёртку SQL-команды VACUUM. Выполнение очистки и анализа баз данных с её помощью по сути не отличается от выполнения тех же действий при обращении к серверу другими способами.
Параметры
Утилита vacuumdb принимает следующие аргументы командной строки:
- -a
--all Очистить все базы данных.
- [-d] база_данных
[--dbname=]база_данных Задаёт имя базы данных, подлежащей очистке. Если это имя не задано и отсутствует параметр -a (или --all), имя базы данных берётся из переменной окружения PGDATABASE. Если и эта переменная не задана, выбирается имя подключающегося пользователя.
- -e
--echo Выводить команды, которые vacuumdb генерирует и передаёт серверу.
- -f
--full Произвести "полную" очистку.
- -F
--freeze Агрессивно "замораживать" версии строк.
- -q
--quiet Подавлять вывод сообщений о прогрессе выполнения.
- -t таблица [ (колонка [,...]) ]
--table=таблица [ (колонка [,...]) ] Производить очистку или анализ только указанной таблицы. Имена колонок можно указать только в сочетании с параметрами --analyze и --analyze-only. Добавив дополнительные ключи -t, можно обработать несколько таблиц.
Подсказка: Если вы указываете колонки, вам, вероятно, придётся экранировать скобки в оболочке. (См. примеры ниже.)
- -v
--verbose Вывести подробную информацию во время процесса.
- -V
--version Сообщить версию vacuumdb и завершиться.
- -z
--analyze Также вычислить статистику для оптимизатора.
- -Z
--analyze-only Только вычислить статистику для оптимизатора (не производить очистку).
- --analyze-in-stages
Только вычислить статистику для оптимизатора (без очистки), подобно --analyze-only. Но для скорейшего получения полезной статистики, выполнить анализ в несколько проходов (в настоящее время, три) с разными параметрами.
Этот параметр полезен при необходимости провести анализ базы данных, только что наполненной данными из архива или командой pg_upgrade. С этим параметром vacuumdb постарается получить некоторую статистику как можно скорее, чтобы базой можно было пользоваться, а на следующих проходах вычислит полную статистику.
- -?
--help Показать справку по аргументам командной строки vacuumdb и завершиться.
Утилита reindexdb также принимает следующие аргументы командной строки в качестве параметров подключения:
- -h host
--host=host Указывает имя компьютера, на котором запущен сервер. Если значение начинается с косой черты, оно интерпретируется как имя каталога с доменным сокетом Unix.
- -p порт
--port=порт Указывает TCP-порт или расширение файла Unix-сокета, на котором сервер слушает подключения.
- -U имя_пользователя
--username=имя_пользователя Имя пользователя, под которым производится подключение.
- -w
--no-password Не выдавать запрос на ввод пароля. Если сервер требует аутентификацию по паролю и пароль не доступен с помощью других средств, таких как файл .pgpass, попытка соединения не удастся. Этот параметр может быть полезен в пакетных заданиях и скриптах, где нет пользователя, который вводит пароль.
- -W
--password Принудительно запрашивать пароль перед подключением к базе данных.
Это несущественный параметр, так как vacuumdb запрашивает пароль автоматически, если сервер проверяет подлинность по паролю. Однако, чтобы понять это, vacuumdb лишний раз подключается к серверу. Поэтому иногда имеет смысл ввести -W, чтобы исключить эту ненужную попытку подключения.
- --maintenance-db=база_данных
Задаёт имя базы данных, через подключение к которой будут находиться другие базы, подлежащие очистке. По умолчанию используется postgres, а в случае её отсутствия — template1.
Переменные окружения
- PGDATABASE
PGHOST
PGPORT
PGUSER Параметры подключения по умолчанию
Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные среды, поддерживаемые libpq (см. Раздел 31.14).
Диагностика
В случае возникновения трудностей, обратитесь к описаниям VACUUM и psql , где обсуждаются потенциальные проблемы и сообщения об ошибках. Учтите, что на целевом компьютере должен работать сервер баз данных. При этом применяются все свойства подключения по умолчанию и переменные окружения, которые использует клиентская библиотека libpq.
Замечания
Утилите vacuumdb может потребоваться подключаться к серверу PostgreSQL несколько раз, и при этом она будет каждый раз запрашивать пароль. В таких случаях удобно иметь файл ~/.pgpass. За дополнительными сведениями обратитесь к Разделу 31.15.
Примеры
Очистка базы данных test:
$ vacuumdb test
Очистка и анализ для оптимизатора базы данных bigdb:
$ vacuumdb --analyze bigdb
Очистка одной таблицы foo в базе данных xyzzy и анализ только колонки bar этой таблицы для оптимизатора:
$ vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy
| Пред. | Начало | След. |
| reindexdb | Уровень выше | Серверные утилиты PostgreSQL |
CREATE SERVER
CREATE SERVER — define a new foreign server
Synopsis
CREATE SERVER [IF NOT EXISTS]server_name[ TYPE 'server_type' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPERfdw_name[ OPTIONS (option'value' [, ... ] ) ]
Description
CREATE SERVER defines a new foreign server. The user who defines the server becomes its owner.
A foreign server typically encapsulates connection information that a foreign-data wrapper uses to access an external data resource. Additional user-specific connection information may be specified by means of user mappings.
The server name must be unique within the database.
Creating a server requires USAGE privilege on the foreign-data wrapper being used.
Parameters
IF NOT EXISTSDo not throw an error if a server with the same name already exists. A notice is issued in this case. Note that there is no guarantee that the existing server is anything like the one that would have been created.
server_nameThe name of the foreign server to be created.
server_typeOptional server type, potentially useful to foreign-data wrappers.
server_versionOptional server version, potentially useful to foreign-data wrappers.
fdw_nameThe name of the foreign-data wrapper that manages the server.
OPTIONS (option'value' [, ... ] )This clause specifies the options for the server. The options typically define the connection details of the server, but the actual names and values are dependent on the server's foreign-data wrapper.
Notes
When using the dblink module, a foreign server's name can be used as an argument of the dblink_connect function to indicate the connection parameters. It is necessary to have the USAGE privilege on the foreign server to be able to use it in this way.
Examples
Create a server myserver that uses the foreign-data wrapper postgres_fdw:
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');
See postgres_fdw for more details.
Compatibility
CREATE SERVER conforms to ISO/IEC 9075-9 (SQL/MED).