clusterdb
Синтаксис
clusterdb [ параметр-подключения ...] [ --verbose | -v ] [ --table | -t таблица ] ... [ база_данных ]
clusterdb [ параметр-подключения ...] [ --verbose | -v ] --all | -a
Описание
clusterdb это приложение для повторной кластеризации таблиц базы данных PostgreSQL. Утилита находит ранее кластеризованные таблицы и проводит операцию на основании последнего использованного индекса. Затрагиваются лишь ранее кластеризованные таблицы.
clusterdb это обёртка для SQL-команды CLUSTER. Оба пути кластеризации идентичны в результате.
Параметры
clusterdb принимает следующие аргументы командной строки:
- -a
--all Кластеризовать все базы данных.
- [-d] база_данных
[--dbname=]база_данных Указывает имя базы данных для кластеризации. Если оно не указано, и параметр -a (или --all) не используется, то имя базы берётся из переменной окружения PGDATABASE. Если переменная окружения не установлена, то берётся имя пользователя из параметров подключения в качестве имени целевой базы.
- -e
--echo Вывести команды к серверу, генерируемые при выполнении clusterdb.
- -q
--quiet Подавлять вывод сообщений о прогрессе выполнения.
- -t таблица
--table=таблица Кластеризовать таблицу. Возможно множественное использование параметра -t.
- -v
--verbose Вывести подробную информацию во время процесса.
- -V
--version Вывести версию clusterdb и прервать дальнейшее выполнение.
- -?
--help Вывести справку по аргументам команды clusterdb.
clusterdb также принимает из командной строки параметры подключения:
- -h host
--host=host Указывает имя компьютера, на котором запущен сервер. Если значение начинается с косой черты, оно интерпретируется как имя каталога с доменным сокетом Unix.
- -p порт
--port=порт Указывает TCP-порт или расширение файла Unix-сокета, на котором сервер слушает подключения.
- -U имя_пользователя
--username=имя_пользователя Имя пользователя, под которым производится подключение.
- -w
--no-password Не выдавать запрос на ввод пароля. Если сервер требует аутентификацию по паролю и пароль не доступен с помощью других средств, таких как файл .pgpass, попытка соединения не удастся. Этот параметр может быть полезен в пакетных заданиях и скриптах, где нет пользователя, который вводит пароль.
- -W
--password Принудительно запрашивать пароль перед подключением к базе данных.
Это несущественный параметр, так как clusterdb запрашивает пароль автоматически, если сервер проверяет подлинность по паролю. Однако, чтобы понять это, clusterdb лишний раз подключается к серверу. Поэтому иногда имеет смысл ввести -W, чтобы исключить эту ненужную попытку подключения.
- --maintenance-db=база_данных
Указывает имя базы данных, в качестве опорной, для определения необходимости кластеризации других баз данных. По умолчанию используется postgres, а если она не существует, то используется template1.
Переменные окружения
- PGDATABASE
PGHOST
PGPORT
PGUSER Параметры подключения по умолчанию
Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные среды, поддерживаемые libpq (см. Раздел 31.14).
Диагностика
В случае возникновения трудностей, обратитесь к CLUSTER и psql . Переменные окружения и параметры подключения по умолчанию libpq будут применены при запуске утилиты, это следует учитывать при диагностике.
Примеры
Для кластеризации базы данных test:
$ clusterdb test
Для кластеризации отдельной таблицы foo базы данных xyzzy:
$ clusterdb --table foo xyzzy
| Пред. | Начало | След. |
| Клиентские приложения PostgreSQL | Уровень выше | createdb |