Установка PostgreSQL



       

Параметры командной строки



Параметры командной строки

Полная команда запуска psql имеет следующий синтаксис:

psql[ ключи ] [ бдЗд_дднных [ пользователь ] ]

Необязательный параметр база_дсптых определяет базу данных, к которой производится исходное подключение. Необязательный параметр пользователь определяет имя пользователя PostgreSQL, применяемое для подключения. При отсутствии этих параметров используются имя пользователя операционной системы, запустившего программу, и ассоциированная с ним база данных.

В командной строке также могут задаваться дополнительные ключи. По умолчанию psql поддерживает как стандартные короткие ключи в стиле Unix (например, -с), так и длинные ключи в стиле GNU (например, --command). В некоторых системах второй вариант недоступен. В следующем перечне приведены короткие ключи Unix, всегда состоящие из одной буквы, за которыми указывается эквивалентный длинный ключ.

  • -а, -echo- al I. Включение режима полного вывода эха для всех строк, полученных psql. Ключ обычно используется при написании сценариев и эквивалентен команде \set ECHO all клиента psql.
  • -A, -no-al ign. Клиент psql выводит результаты без выравнивания. Если ключ не задан, по умолчанию выбирается режим вывода с выравниванием.
  • -с команда, --command команда. Вместо запуска в интерактивном режиме psql выполняет всего одну команду. Команда должна иметь правильный синтаксис SQL, причем в ней не могут использоваться специфические команды psql.
  • -d база_данных, --dbname база_данных. База данных, к которой производится исходное подключение.
  • -е, - -echo-queries. Включение режима вывода эха для запросов.
  • -Е, - -echo-hidden. Включение режима вывода скрытых запросов, сгенерированных командами psql. Аналогичного эффекта можно добиться командой \set ECHOJHIDDEN клиента psql.
  • - f файл, - - f i 1 е файл. Вместо запуска в интерактивном режиме psql читает код SQL из файла с заданным именем и выполняет его так, как если бы он был введен непосредственно в командной строке. После обработки файла psql завершает работу.





  • -F разделитель, -field- separator разделитель. Заданный символ используется psql в качестве разделителя нолей.

  • - h хост, - - host хост. Имя компьютера, на котором работает сервер PostgreSQL. Обычно не является обязательным при подключении к локальному серверному процессу с использованием доменных сокетов Unix. Тем не менее если процесс postmaster работает с файлом доменного сокета в каталоге, отличном от принятого по умолчанию каталога /tmp, то параметр хост с начальным символом / интерпретируется как локальный каталог, содержащий файл доменного сокета (например, при передаче параметра -h /var/pgsql клиент psql ищет файл доменного сокета в каталоге /var/pgsql).

  • -H, -html. Запуск psql в режиме вывода в формате HTML.

  • -1, - -11 st. Вывод списка баз данных, к которым может подключиться клиент.

  • -о файл, -output файл. Выходные данные psql направляются в заданный файл.

  • -р порт, -port порт. Порт TCP/IP (или числовой доменный сокет Unix), на котором в данный момент ведется прослушивание. Совпадает со значением переменной PGPORT (по умолчанию — 5432).

  • -Р имя=значение, - -pset имя=зпачение. Параметры форматирования выходных данных в синтаксисе команды \pset. Имена совпадают с именами параметров \pset, но значение параметра отделяется от имени не пробелом, а знаком равенства (=).

  • -q, - -quiet. Режим минимального вывода, в котором не выводятся ни информационные сообщения psql, ни пояснительный текст.

  • -R разделитель, -record-separator разделитель. Заданный символ используется psql в качестве разделителя записей.

  • -s, - -single-step. Пошаговый режим работы. После выполнения команды SQL пользователю предлагается продолжить или завершить работу.

  • -S, - -single-1 ine. Строчный режим работы. В этом режиме символ новой строки интерпретируется как символ точки с запятой (;), завершающий команду SQL.

  • -1, - - tupl es - on! у. Подавление вывода дополнительных данных (например, имен полей и итоговых данных). В psql эта задача решается командой \t.

  • -Т атрибут, -table-attr атрибут. Атрибут HTML, включаемый в тег <tab1e> в режиме вывода HTML (например, width=100X). Чтобы передать в этом параметре несколько табличных атрибутов, заключите их в кавычки. В psql атрибуты также могут задаваться командой \pset.



  • -U пользователь, -username пользователь. Подключение к базе данных с заданным именем пользователя.

  • -v имя=значение, --variable имя=значение. Присваивание значения переменной с заданным именем (по аналогии с командой \set в psql). Значение отделяется от имени не пробелом, а знаком равенства (=).

  • -V, - -version. Вывод информации о версии.

  • -W. -password. Запрос пароля перед подключением к базе данных. Введенный пароль продолжает действовать в течение всего сеанса psql.

  • -х, -expanded. Расширенный режим форматирования записей. Активизируется в psql командой \х.

  • -X, - -no-psqlrc. Запрет чтения и выполнения стартового файла (~/.psqlrc).

  • -?, - -help. Вывод краткой справки по аргументам командной строки psql.

  • ВНИМАНИЕ
    В версии 7.0 код, запрашивающий пароль у пользователя, если серверный процесс требует аутентификации при подключении к базе, работает нестабильно, что иногда приводит к ошибке и отказу в подключении. Если вы знаете, что подключение должно сопровождаться аутентификацией, задайте ключ принудительного запроса пароля -W (--password).

    Содержание раздела