psql - Интернет в облаке

ПРОГРАММА:

ИМЯ

psql - интерактивный терминал PostgreSQL

СИНТАКСИС

PSQL [вариант...] [имя_базы_данных [username]]

ОПИСАНИЕ

psql - это интерфейс для PostgreSQL на основе терминала. Это позволяет вам вводить запросы
интерактивно отправьте их в PostgreSQL и просмотрите результаты запроса. В качестве альтернативы введите
можно из файла. Кроме того, он предоставляет ряд мета-команд и различные
Функции, похожие на оболочку, для облегчения написания сценариев и автоматизации широкого спектра задач.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-a
--эхо-все
Вывести все непустые строки ввода в стандартный вывод по мере их чтения. (Это не
применяется к строкам, читаемым в интерактивном режиме.) Это эквивалентно установке переменной ЭХО в
все.

-A
--no-выравнивание
Переключает в режим невыровненного вывода. (В противном случае режим вывода по умолчанию выравнивается.)

-b
--эхо-ошибки
Вывести неудачные команды SQL в стандартный вывод ошибок. Это эквивалентно установке
переменная ЭХО к ошибкам.

-c команду
--command =команду
Указывает, что psql должен выполнить одну командную строку, команду, а затем выйдите. Это
полезно в сценариях оболочки. Файлы запуска (psqlrc и ~ / .psqlrc) игнорируются этим
опцию.

команду должна быть либо командной строкой, которая полностью анализируется сервером
(т.е. он не содержит специфичных для psql функций) или одной команды с обратной косой чертой. Таким образом, вы
нельзя смешивать мета-команды SQL и psql с этой опцией. Для этого вы могли
передать строку в psql, например: echo '\ x \\ SELECT * FROM foo;' | psql. (\\ является
мета-команда разделителя.)

Если командная строка содержит несколько команд SQL, они обрабатываются за один
транзакция, если нет явных НАЧАТЬ/COMMIT команды, включенные в строку, чтобы
разделить его на несколько транзакций. Это отличается от поведения, когда
та же строка подается на стандартный ввод psql. Кроме того, только результат последнего SQL
команда возвращается.

Из-за этого устаревшего поведения размещение более одной команды в -c string
часто дает неожиданные результаты. Лучше скармливать несколько команд стандарту psql.
ввод, либо с помощью эха, как показано выше, либо через оболочку здесь-документ для
пример:

psql <
\x
ВЫБЕРИТЕ * ИЗ foo;
EOF

-d имя_базы_данных
--dbname =имя_базы_данных
Задает имя базы данных для подключения. Это эквивалентно указанию
имя_базы_данных в качестве первого аргумента командной строки, не являющегося параметром.

Если этот параметр содержит знак = или начинается с допустимого префикса URI (postgresql: //
или postgres: //), он рассматривается как Conninfo нить. См. Раздел 31.1.1, «Подключение
Строки »в документации для получения дополнительной информации.

-e
--эхо-запросы
Скопируйте все команды SQL, отправленные на сервер, также в стандартный вывод. Это
эквивалентно установке переменной ЭХО на запросы.

-E
- скрытый эхом
Повторите фактические запросы, сгенерированные \d и другие команды с обратной косой чертой. Вы можете использовать это
изучить внутренние операции psql. Это эквивалентно установке переменной
ECHO_HIDDEN вкл.

-f имя файла
--file =имя файла
Используйте файл имя файла как источник команд вместо чтения команд
интерактивно. После обработки файла psql завершает свою работу. Это во многом
эквивалент метакоманды \i.

If имя файла - (дефис), то стандартный ввод читается до индикации EOF или \q
мета-команда. Обратите внимание, однако, что Readline в этом случае не используется (как если бы -n было
указано).

Использование этой опции немного отличается от написания psql. имя файла. В общем, оба
будет делать то, что вы ожидаете, но использование -f включает некоторые приятные функции, такие как ошибка
сообщения с номерами строк. Также существует небольшая вероятность того, что использование этой опции приведет к
уменьшить накладные расходы на запуск. С другой стороны, вариант, использующий ввод оболочки
перенаправление (теоретически) гарантированно даст точно такой же результат, как и у вас
получил, если бы вы ввели все вручную.

-F разделитель
--field-separator =разделитель
Используйте разделитель как разделитель полей для невыровненного вывода. Это эквивалентно \ pset
Fieldsep or \f.

-h хоста
--host =хоста
Задает имя хоста машины, на которой работает сервер. Если значение
начинается с косой черты, он используется как каталог для сокета Unix-домена.

-H
--html
Включите табличный вывод HTML. Это эквивалентно \ pset format html или \H
команда.

-l
--список
Перечислите все доступные базы данных и выйдите. Другие варианты, не связанные с подключением, игнорируются.
Это похоже на мета-команду \список.

-L имя файла
--log-файл =имя файла
Записать весь вывод запроса в файл имя файла, в дополнение к нормальному выходу
место назначения.

-n
--no-readline
Не используйте Readline для редактирования строки и не используйте историю команд. Это может быть
полезно для отключения расширения табуляции при вырезании и вставке.

-o имя файла
--output =имя файла
Поместите весь вывод запроса в файл имя файла. Это эквивалентно команде \o.

-p порт
--port =порт
Задает TCP-порт или расширение файла сокета локального домена Unix, на котором
сервер прослушивает соединения. По умолчанию значение ПГПОРТ охрана окружающей среды
переменной или, если не установлен, на порт, указанный во время компиляции, обычно 5432.

-P назначение
--pset =назначение
Определяет параметры печати в стиле \ pset. Обратите внимание, что здесь вы должны отделить
имя и значение со знаком равенства вместо пробела. Например, чтобы установить выход
format в LaTeX, вы можете написать -P format = latex.

-q
--тихий
Указывает, что psql должен выполнять свою работу тихо. По умолчанию он печатает приветственные сообщения.
и различная информационная продукция. Если используется этот параметр, ничего из этого не происходит. Этот
полезно с -c вариант. Это эквивалентно установке переменной ТИХО вкл.

-R разделитель
--record-separator =разделитель
Используйте разделитель как разделитель записей для невыровненного вывода. Это эквивалентно
\ pset Recordsep команда.

-s
--Единственный шаг
Запускаем в пошаговом режиме. Это означает, что пользователю предлагается перед отправкой каждой команды.
на сервер, с возможностью также отменить выполнение. Используйте это для отладки скриптов.

-S
--одна линия
Работает в однострочном режиме, где новая строка завершает команду SQL как точка с запятой.
делает.

Внимание
Этот режим предназначен для тех, кто на нем настаивает, но вы не обязательно
рекомендуется использовать его. В частности, если вы смешиваете SQL и мета-команды в строке
порядок выполнения не всегда может быть понятен неопытному пользователю.

-t
--tuples-only
Отключите печать имен столбцов, нижних колонтитулов счётчика строк результатов и т. Д. Это
эквивалентно \t команда.

-T table_options
--table-attr =table_options
Задает параметры, которые будут помещены в тег таблицы HTML. Видеть \ pset для получения информации.

-U username
--username =username
Подключиться к базе данных как пользователь username вместо значения по умолчанию. (Вы должны иметь
разрешение на это, конечно.)

-v назначение
--set =назначение
- переменная =назначение
Выполните присвоение переменной, например \установленный метакоманда. Обратите внимание, что вы должны отделить
имя и значение, если есть, знаком равенства в командной строке. Чтобы отключить переменную,
опустить знак равенства. Чтобы установить переменную с пустым значением, используйте знак равенства
но оставьте значение. Эти задания выполняются на очень ранней стадии
запуск, поэтому переменные, зарезервированные для внутренних целей, могут быть перезаписаны позже.

-V
--версия
Распечатайте версию psql и выйдите.

-w
--нет пароля
Никогда не запрашивайте пароль. Если сервер требует аутентификации по паролю и
пароль недоступен другими способами, такими как файл .pgpass, соединение
попытка не удастся. Эта опция может быть полезна в пакетных заданиях и скриптах, где нет пользователей.
присутствует для ввода пароля.

Обратите внимание, что этот параметр будет оставаться установленным на протяжении всего сеанса, поэтому он влияет на использование
мета-команды \соединять а также первоначальная попытка подключения.

-W
--пароль
Заставьте psql запрашивать пароль перед подключением к базе данных.

Эта опция никогда не является существенной, поскольку psql автоматически запросит пароль, если
сервер требует аутентификации по паролю. Однако psql будет тратить впустую соединение
попытаться выяснить, что серверу нужен пароль. В некоторых случаях стоит набрать
-W чтобы избежать лишних попыток подключения.

Обратите внимание, что этот параметр будет оставаться установленным на протяжении всего сеанса, поэтому он влияет на использование
мета-команды \соединять а также первоначальная попытка подключения.

-x
- расширенный
Включите режим расширенного форматирования таблицы. Это эквивалентно \x команда.

-ИКС,
--no-psqlrc
Не читайте файл запуска (ни общесистемный файл psqlrc, ни пользовательский
~ / .psqlrc файл).

-z
- поле-разделитель-ноль
Установите разделитель полей для невыровненного вывода на нулевой байт.

-0
- запись-разделитель-ноль
Установите разделитель записей для невыровненного вывода на нулевой байт. Это полезно для
взаимодействие, например, с xargs -0.

-1
- single-transaction
Когда psql выполняет скрипт, добавление этой опции обертывает НАЧАТЬ/COMMIT вокруг сценария
чтобы выполнить его как одну транзакцию. Это гарантирует, что либо все команды
завершено успешно, или изменения не применяются.

Если сам скрипт использует НАЧАТЬ, COMMITэта информация поможет вам разобраться, почему Gamer’s Galaxy — ваш лучший выбор. ОТКАТ, у этого варианта не будет
желаемые эффекты. Также, если скрипт содержит какую-либо команду, которая не может быть выполнена
внутри блока транзакции, указание этой опции вызовет эту команду (и, следовательно,
всю транзакцию) потерпеть неудачу.

-?
--help [=тема]
Показать справку по psql и выйти. Необязательный тема параметр (по умолчанию параметры)
выбирает, какая часть psql объясняется: commands описывает команды psql с обратной косой чертой;
options описывает параметры командной строки, которые можно передать psql; и переменные
показывает справку о переменных конфигурации psql.

ВЫХОД статус

psql возвращает оболочке 0, если она завершилась нормально, 1, если произошла собственная фатальная ошибка.
(например, нехватка памяти, файл не найден), 2 если соединение с сервером ухудшилось и
сеанс не был интерактивным, и 3, если произошла ошибка в скрипте и переменной
ON_ERROR_STOP был установлен.

ИСПОЛЬЗОВАНИЕ

Соединительный в a База данных
psql - это обычное клиентское приложение PostgreSQL. Чтобы подключиться к базе данных, вы
необходимо знать имя вашей целевой базы данных, имя хоста и номер порта
сервер и какое имя пользователя вы хотите подключиться. psql можно сказать о тех
параметры через параметры командной строки, а именно -d, -h, -pи -U соответственно. Если
найден аргумент, не принадлежащий ни одной опции, он будет интерпретирован как
имя базы данных (или имя пользователя, если имя базы данных уже указано). Не все эти
опции обязательны; есть полезные значения по умолчанию. Если вы опустите имя хоста, psql будет
подключиться через сокет домена Unix к серверу на локальном хосте или через TCP / IP к localhost
на машинах, у которых нет сокетов домена Unix. Номер порта по умолчанию определяется в
время компиляции. Поскольку сервер базы данных использует то же значение по умолчанию, вам не придется
в большинстве случаев указывайте порт. Имя пользователя по умолчанию - это имя пользователя вашей операционной системы,
как имя базы данных по умолчанию. Обратите внимание, что вы не можете просто подключиться к любой базе данных в
любое имя пользователя. Ваш администратор базы данных должен был проинформировать вас о вашем доступе
Хартии.

Если значения по умолчанию не совсем правильные, вы можете сэкономить время на вводе текста, установив
переменные среды ПГДАННЫЕ, ПРИЗРАК, ПГПОРТ и / или PGUSER к соответствующим значениям. (Для
дополнительные переменные среды, см. Раздел 31.14, «Переменные среды» в
документации.) Также удобно иметь ~ / .pgpass файл, чтобы избежать регулярного
вводить пароли. См. Раздел 31.15, «Файл паролей» в документации по
больше информации.

Альтернативный способ указать параметры подключения - в Conninfo строка или URI,
который используется вместо имени базы данных. Этот механизм дает вам очень широкий контроль над
связь. Например:

$ PSQL "service = myservice sslmode = требуется "
$ PSQL postgresql: // dbmaster: 5433 / mydb? sslmode = требуется

Таким образом, вы также можете использовать LDAP для поиска параметров соединения, как описано в Разделе
31.17, «Поиск параметров соединения LDAP» в документации. См. Раздел 31.1.2,
«Ключевые слова параметров» в документации для получения дополнительной информации обо всех доступных
варианты подключения.

Если соединение не может быть установлено по какой-либо причине (например, из-за недостаточных прав, сервер
не запущен на целевом хосте и т. д.), psql вернет ошибку и завершится.

Если и стандартный ввод, и стандартный вывод являются терминалами, то psql устанавливает клиент
кодировка на «авто», которая определит соответствующую клиентскую кодировку из локали.
настройки (LC_CTYPE переменная окружения в системах Unix). Если это не сработает, как
Ожидается, что клиентская кодировка может быть переопределена с помощью переменной среды
PGCLIENTENCODING.

входящий SQL Команды
При нормальной работе psql выдает подсказку с именем базы данных, для которой psql
в настоящее время подключено, за которым следует строка =>. Например:

$ PSQL тестовая база данных
psql (9.5.2)
Введите «help» для получения справки.

testdb =>

В командной строке пользователь может вводить команды SQL. Обычно строки ввода отправляются в
сервер при достижении точки с запятой в конце команды. Конец строки не заканчивается
команда. Таким образом, для ясности команды можно распределить по нескольким строкам. Если бы команда была
отправлено и выполнено без ошибок, результаты команды отображаются на экране.

Каждый раз, когда выполняется команда, psql также опрашивает события асинхронного уведомления.
Сгенерированно с помощью СЛУШАТЬ(7) и УВЕДОМЛЕНИЕ(7).

Пока комментарии блоков в стиле C передаются на сервер для обработки и удаления,
Комментарии стандарта SQL удаляются psql.

Мета-команды
Все, что вы вводите в psql, которое начинается с обратной косой черты без кавычек, является метакомандой psql.
который обрабатывается самим psql. Эти команды делают psql более полезным для администрирования.
или скриптинг. Мета-команды часто называют командами с косой чертой или обратной косой чертой.

Формат команды psql - обратная косая черта, за которой сразу следует командный глагол,
тут никаких аргументов. Аргументы отделяются от командного глагола и друг от друга знаком
любое количество пробелов.

Чтобы включить пробел в аргумент, вы можете заключить его в одинарные кавычки. Чтобы включить
одинарная кавычка в аргументе, напишите две одинарные кавычки внутри текста, заключенного в одинарные кавычки. Что-нибудь
заключенные в одинарные кавычки, кроме того, могут быть заменены на \ n в стиле C (новый
строка), \ t (табуляция), \ b (возврат), \ r (возврат каретки), \ f (подача формы), \цифры (восьмеричный),
и \ xцифры (шестнадцатеричный). Обратная косая черта перед любым другим символом в одинарных кавычках
текст цитирует этот единственный символ, каким бы он ни был.

Внутри аргумента текст, заключенный в обратные кавычки (`), используется как командная строка.
который передается в оболочку. Вывод команды (с удаленным завершающим символом новой строки)
заменяет текст в обратной кавычке.

Если в аргументе появляется двоеточие (:) без кавычек, за которым следует имя переменной psql,
заменяется значением переменной, как описано в разделе «Интерполяция SQL».

Некоторые команды принимают в качестве аргумента идентификатор SQL (например, имя таблицы). Эти аргументы
соблюдайте правила синтаксиса SQL: буквы без кавычек переводятся в нижний регистр, а двойные
кавычки (") защищают буквы от преобразования регистра и позволяют включать пробелы в
идентификатор. В двойных кавычках парные двойные кавычки сокращаются до одинарных двойных кавычек
в получившемся имени. Например, FOO "BAR" BAZ интерпретируется как fooBARbaz, а "A"
"странное" имя становится "странным" именем.

Анализ аргументов останавливается в конце строки или когда появляется другая обратная косая черта без кавычек.
нашел. Обратная косая черта без кавычек считается началом новой метакоманды. Специальный
последовательность \\ (две обратные косые черты) отмечает конец аргументов и продолжает синтаксический анализ SQL
команды, если таковые имеются. Таким образом, команды SQL и psql можно свободно смешивать в строке. Но в любом
В этом случае аргументы метакоманды не могут продолжаться за пределами конца строки.

Определены следующие мета-команды:

\a
Если текущий формат вывода таблицы не выровнен, он переключается на выровненный. Если это
не невыровненный, он установлен как невыровненный. Эта команда сохраняется в обратном направлении
совместимость. Видеть \ pset для более общего решения.

\ c или \ connect [ имя_базы_данных [ username ] [ кашель ] [ порт ]] | Conninfo
Устанавливает новое соединение с сервером PostgreSQL. Параметры подключения для использования
можно указать либо используя позиционный синтаксис, либо используя соединение conninfo
строки, как описано в Раздел 31.1.1, «Строки подключения» документации.

При использовании позиционных параметров, если любой из имя_базы_данных, username, кашель or порт опущены
или указано как -, используется значение этого параметра из предыдущего соединения;
если предыдущего подключения нет, по умолчанию libpq для значения параметра будет
использовал. При использовании строк conninfo никакие значения из предыдущего подключения не используются для
новое соединение.

Если новое соединение установлено успешно, предыдущее соединение закрывается. Если
попытка подключения не удалась (неверное имя пользователя, отказано в доступе и т. д.), предыдущий
соединение будет сохранено, только если psql находится в интерактивном режиме. При выполнении
неинтерактивный скрипт, обработка немедленно остановится с ошибкой. Этот
различие было выбрано как удобство использования против опечаток, с одной стороны, и
механизм безопасности, который позволяет сценариям случайно не воздействовать на неправильную базу данных на
другая рука.

Примеры:

=> \ c mydb myuser host.dom 6432
=> \ c service = foo
=> \ c "host = localhost port = 5432 dbname = mydb connect_timeout = 10 sslmode = disable"
=> \ c postgresql: // tom @ localhost / mydb? имя_приложения = myapp

\ C [ название ]
Устанавливает заголовок всех таблиц, которые печатаются в результате запроса, или отменяет любые такие
заглавие. Эта команда эквивалентна \ pset title название. (Название этой команды
происходит от «caption», так как ранее он использовался только для установки заголовка в HTML
Таблица.)

\CD [ каталог ]
Изменяет текущий рабочий каталог на каталог. Без аргументов изменения в
домашний каталог текущего пользователя.

Функции
Чтобы распечатать текущий рабочий каталог, используйте \! pwd.

\ conninfo
Выводит информацию о текущем подключении к базе данных.

\ copy { (см. таблицу ниже) [( column_list )] | ( запрос )} {от | к } { 'имя файла' | программа
'команда' | stdin | stdout | pstdin | pstdout} [[с] ( вариант [, ...])]
Выполняет внешнюю (клиентскую) копию. Это операция, которая запускает SQL КОПИЯ(7)
команда, но вместо того, чтобы сервер читает или записывает указанный файл, psql читает
или записывает файл и направляет данные между сервером и локальной файловой системой.
Это означает, что доступ к файлам и привилегии принадлежат локальному пользователю, а не пользователю.
server, и никаких привилегий суперпользователя SQL не требуется.

Когда программа указана, команду выполняется psql, и данные, передаваемые из или в
команду маршрутизируется между сервером и клиентом. Опять же, привилегии исполнения
принадлежат локальному пользователю, а не серверу, и никакие привилегии суперпользователя SQL не
требуется.

Для \ copy ... from stdin строки данных читаются из того же источника, который выдал
команда, продолжая до \. читается или поток достигает EOF. Эта опция полезна
для заполнения таблиц в файле сценария SQL. Для \ скопировать ... в стандартный вывод,
вывод отправляется в то же место, что и вывод команды psql, а команда COPY считать команду
статус не печатается (так как его можно спутать со строкой данных). Читать / писать
стандартный ввод или вывод psql независимо от текущего источника команды или параметра \ o,
писать из pstdin или в pstdout.

Синтаксис этой команды аналогичен синтаксису SQL КОПИЯ(7) команда. Все варианты
кроме источника / назначения данных, как указано для КОПИЯ(7). Из-за этого,
специальные правила синтаксического анализа применяются к \ копировать команда. В частности, переменная psql
правила подстановки и экранирование обратной косой черты не применяются.

Функции
Эта операция не так эффективна, как SQL КОПИЯ команда, потому что все данные должны
пройти через соединение клиент / сервер. Для больших объемов данных SQL
команда может быть предпочтительнее.

\авторское право
Показывает авторские права и условия распространения PostgreSQL.

\ d [S +] [ описания ]
Для каждого отношения (таблица, представление, индекс, последовательность или сторонняя таблица) или составного типа
соответствие описания, показать все столбцы, их типы, табличное пространство (если не
по умолчанию) и любые специальные атрибуты, такие как NOT NULL или значения по умолчанию. Связанные индексы,
также показаны ограничения, правила и триггеры. Для сторонних таблиц связанный
также показан внешний сервер. («Соответствие шаблону» определено в разделе «Шаблоны».
ниже.)

Для некоторых типов отношений \ d показывает дополнительную информацию для каждого столбца: столбец
значения для последовательностей, индексированные выражения для индексов и параметры оболочки сторонних данных
для зарубежных столов.

Форма команды \ d + идентична, за исключением того, что отображается дополнительная информация: любая
отображаются комментарии, связанные со столбцами таблицы, а также наличие
OID в таблице, определение представления, если отношение является представлением, не по умолчанию
настройка идентичности реплики.

По умолчанию отображаются только объекты, созданные пользователем; предоставить шаблон или модификатор S для
включать системные объекты.

Внимание
If \d используется без описания аргумент, это эквивалентно \ dtvsE который будет
показать список всех видимых таблиц, представлений, последовательностей и сторонних таблиц. Это
чисто мера удобства.

\ da [S] [ описания ]
Перечисляет агрегатные функции вместе с их типом возвращаемого значения и типами данных, которые они
работать на. Если описания указано, только агрегаты, имена которых соответствуют шаблону,
показано. По умолчанию отображаются только объекты, созданные пользователем; поставьте образец или S
модификатор для включения системных объектов.

\ db [+] [ описания ]
Перечисляет табличные пространства. Если описания указано, только табличные пространства, имена которых соответствуют
показаны образцы. Если к имени команды добавлен +, отображается каждое табличное пространство.
с соответствующими параметрами, размером на диске, разрешениями и описанием.

\ dc [S +] [ описания ]
Перечисляет преобразования между кодировками набора символов. Если описания указано, только
перечислены преобразования, имена которых соответствуют шаблону. По умолчанию только созданные пользователем
показаны объекты; предоставить шаблон или модификатор S для включения системных объектов. Если +
добавляется к имени команды, каждый объект перечисляется с его связанными
описание.

\ dC [+] [ описания ]
Перечисляет приведенные типы. Если описания указано, только приведения, исходные или целевые типы которых
соответствуют шаблону. Если к имени команды добавлен +, каждый объект будет
перечислено с соответствующим описанием.

\ dd [S] [ описания ]
Показывает описания объектов ограничения типа, класса операторов, семейства операторов,
правило и триггер. Все остальные комментарии можно просмотреть с помощью соответствующей обратной косой черты.
команды для этих типов объектов.

\ dd отображает описания объектов, соответствующих описания, или видимых объектов
соответствующий тип, если аргумент не указан. Но в любом случае только объекты, которые
есть описание. По умолчанию отображаются только объекты, созданные пользователем; поставка
шаблон или модификатор S для включения системных объектов.

Описания объектов могут быть созданы с помощью КОММЕНТАРИЙ(7) Команда SQL.

\ ddp [ описания ]
Перечисляет настройки прав доступа по умолчанию. Запись отображается для каждой роли (и схемы,
если применимо), для которых настройки привилегий по умолчанию были изменены с
встроенные значения по умолчанию. Если описания указаны только записи, имя или схема которых
имя соответствует шаблону.

ПРИВИЛЕГИИ ИЗМЕНЕНИЯ ПО УМОЛЧАНИЮ (ALTER_DEFAULT_PRIVILEGES(7)) используется для установки
права доступа по умолчанию. Значение отображения привилегий поясняется в разделе
ГРАНТ(7).

\ dD [S +] [ описания ]
Перечисляет домены. Если описания указано, только домены, имена которых соответствуют шаблону,
показано. По умолчанию отображаются только объекты, созданные пользователем; поставьте образец или S
модификатор для включения системных объектов. Если к имени команды добавлен +, каждый объект
отображается вместе с соответствующими разрешениями и описанием.

\ dE [S +] [ описания ]
\ di [S +] [ описания ]
\ dm [S +] [ описания ]
\ ds [S +] [ описания ]
\ dt [S +] [ описания ]
\ dv [S +] [ описания ]
В этой группе команд буквы E, i, m, s, t и v обозначают стороннюю таблицу,
индекс, материализованное представление, последовательность, таблица и представление соответственно. Вы можете указать любой
или все эти буквы в любом порядке, чтобы получить список объектов этих типов.
Например, \ dit перечисляет индексы и таблицы. Если к имени команды добавлен +, каждый
объект отображается с указанием его физического размера на диске и соответствующего описания, если
любой. Если описания указан, будут перечислены только объекты, имена которых соответствуют шаблону.
По умолчанию отображаются только объекты, созданные пользователем; предоставить шаблон или модификатор S для
включать системные объекты.

\ des [+] [ описания ]
Перечисляет внешние серверы (мнемоника: «внешние серверы»). Если описания указано, только
перечислены те серверы, имя которых соответствует шаблону. Если используется форма \ des +,
показано полное описание каждого сервера, включая ACL сервера, тип, версию,
варианты и описание.

\ det [+] [ описания ]
Перечисляет внешние таблицы (мнемоника: «внешние таблицы»). Если описания указано, только
перечислены записи, имя таблицы или имя схемы которых соответствует шаблону. Если форма
Используется \ det +, также отображаются общие параметры и описание сторонней таблицы.

\ deu [+] [ описания ]
Перечисляет сопоставления пользователей (мнемоника: «внешние пользователи»). Если описания указано, только те
Отображаются сопоставления, имена пользователей которых соответствуют шаблону. Если используется форма \ deu +,
отображается дополнительная информация о каждом отображении.

Предупреждение
\ deu + может также отображать имя пользователя и пароль удаленного пользователя, поэтому будьте осторожны
следует принять их не разглашать.

\ роса [+] [ описания ]
Перечисляет оболочки сторонних данных (мнемоника: «внешние оболочки»). Если описания указано,
перечислены только те оболочки сторонних данных, имя которых соответствует шаблону. Если
форма \ dew +, ACL, параметры и описание оболочки сторонних данных
также показано.

\ df [antwS +] [ описания ]
Перечисляет функции вместе с их аргументами, возвращаемыми типами и типами функций,
которые классифицируются как «агг» (агрегат), «нормальный», «триггер» или «окно». К
отображать только функции определенного типа (ов), добавлять соответствующие буквы a, n, t или
w команде. Если описания указано, только функции, имена которых соответствуют
показаны образцы. По умолчанию отображаются только объекты, созданные пользователем; предоставить образец
или модификатор S для включения системных объектов. Если используется форма \ df +, дополнительные
отображается информация о каждой функции, включая классификацию безопасности,
волатильность, владелец, язык, исходный код и описание.

Функции
Чтобы найти функции, принимающие аргументы или возвращающие значения определенного типа, используйте
возможность поиска вашего пейджера для прокрутки вывода \ df.

\ dF [+] [ описания ]
Перечисляет конфигурации текстового поиска. Если описания указывается, только конфигурации,
отображаются имена, соответствующие шаблону. Если используется форма \ dF +, полное описание
показана каждая конфигурация, включая базовый синтаксический анализатор текстового поиска и
список словарей для каждого типа токена парсера.

\ dFd [+] [ описания ]
Список словарей текстового поиска. Если описания указывается, только словари, названия которых
соответствуют шаблону. Если используется форма \ dFd +, дополнительная информация
отображается для каждого выбранного словаря, включая базовый шаблон текстового поиска
и значения опций.

\ dFp [+] [ описания ]
Перечисляет парсеры текстового поиска. Если описания указаны только парсеры, имена которых соответствуют
показаны образцы. Если используется форма \ dFp +, полное описание каждого парсера
показаны, включая базовые функции и список распознанных типов токенов.

\ dFt [+] [ описания ]
Список шаблонов текстового поиска. Если описания указано, только шаблоны, имена которых совпадают
образец показан. Если используется форма \ dFt +, отображается дополнительная информация
о каждом шаблоне, включая имена основных функций.

\ dg [+] [ описания ]
Список ролей базы данных. (Поскольку понятия «пользователи» и «группы» были унифицированы
на «роли», эта команда теперь эквивалентна \ du.) Если описания указано, только
перечислены те роли, имена которых соответствуют шаблону. Если используется форма \ dg +,
по каждой роли отображается дополнительная информация; в настоящее время это добавляет комментарий для
каждая роль.

\ dl
Это псевдоним для \ lo_list, который показывает список больших объектов.

\ dL [S +] [ описания ]
Перечисляет процедурные языки. Если описания указан, только языки, имена которых совпадают
образец перечислен. По умолчанию отображаются только языки, созданные пользователем; поставлять
Модификатор S для включения системных объектов. Если к имени команды добавлен +, каждый
язык указан с его обработчиком вызовов, валидатором, правами доступа и
системный объект.

\ dn [S +] [ описания ]
Перечисляет схемы (пространства имен). Если описания указано, только схемы, имена которых совпадают
образец перечислен. По умолчанию отображаются только объекты, созданные пользователем; поставлять
шаблон или модификатор S, чтобы включить системные объекты. Если к команде добавлен +
имя, каждый объект перечислен с соответствующими разрешениями и описанием, если таковое имеется.

\ do [S +] [ описания ]
Список операторов с их операндами и типами результатов. Если описания указано, только
перечислены операторы, имена которых соответствуют шаблону. По умолчанию только созданные пользователем
показаны объекты; предоставить шаблон или модификатор S для включения системных объектов. Если +
добавляется к имени команды, отображается дополнительная информация о каждом операторе,
в настоящее время просто имя базовой функции.

\ dO [S +] [ описания ]
Списки сопоставлений. Если описания указано, только сопоставления, имена которых соответствуют
шаблон перечислены. По умолчанию отображаются только объекты, созданные пользователем; предоставить образец
или модификатор S для включения системных объектов. Если к имени команды добавлен +,
каждое сопоставление перечислено с соответствующим описанием, если таковое имеется. Обратите внимание, что только
показаны сопоставления, которые можно использовать с кодировкой текущей базы данных, поэтому результаты могут
различаются в разных базах данных одной и той же установки.

\ dp [ описания ]
Список таблиц, представлений и последовательностей с соответствующими правами доступа. Если описания
указано, только таблицы, представления и последовательности, имена которых соответствуют шаблону,
в списке.

Команда ГРАНТ(7) и ОТЗЫВ(7) команды используются для установки прав доступа. Значение
отображение привилегий объяснено под ГРАНТ(7).

\ drds [ ролевой образец [ шаблон базы данных ]]
Перечисляет определенные параметры конфигурации. Эти настройки могут зависеть от ролей,
для конкретной базы данных или и того, и другого. ролевой образец и шаблон базы данных используются для выбора
конкретные роли и базы данных для перечисления соответственно. Если опущено или указано *,
перечислены все настройки, в том числе те, которые не зависят от роли или базы данных,
соответственно.

АЛЬТЕР РОЛЬ (ALTER_ROLE(7)) и ALTER DATABASE (ALTER_DATABASE(7)) команды
используется для определения параметров конфигурации для каждой роли и базы данных.

\ dT [S +] [ описания ]
Перечисляет типы данных. Если описания указан, только типы, имена которых соответствуют шаблону
перечислены. Если к имени команды добавлен +, каждый тип перечисляется со своим
внутреннее имя и размер, его допустимые значения, если это тип перечисления, и связанные с ним
разрешения. По умолчанию отображаются только объекты, созданные пользователем; предоставить образец или
Модификатор S для включения системных объектов.

\ du [+] [ описания ]
Список ролей базы данных. (Поскольку понятия «пользователи» и «группы» были унифицированы
в «роли», эта команда теперь эквивалентна \ dg.) Если описания указано, только
перечислены те роли, имена которых соответствуют шаблону. Если используется форма \ du +,
по каждой роли отображается дополнительная информация; в настоящее время это добавляет комментарий для
каждая роль.

\ dx [+] [ описания ]
Список установленных расширений. Если описания указываются только те расширения, имена которых
соответствуют шаблону. Если используется форма \ dx +, все объекты, принадлежащие
перечислены все подходящие расширения.

\ dy [+] [ описания ]
Перечисляет триггеры событий. Если описания указывается, только те триггеры событий, имена которых
соответствуют шаблону. Если к имени команды добавлен +, каждый объект будет
перечислено с соответствующим описанием.

\ e или \ edit [ имя файла ] [ номер строчки ]
If имя файла указано, файл редактируется; после выхода из редактора его содержимое
скопировано обратно в буфер запроса. Если нет имя файла задан, текущий буфер запроса
копируется во временный файл, который затем редактируется таким же образом.

Затем новый буфер запроса повторно анализируется в соответствии с обычными правилами psql, где
весь буфер рассматривается как одна строка. (Таким образом, вы не можете создавать сценарии таким образом.
Используйте \i для этого.) Это означает, что если запрос заканчивается (или содержит) точку с запятой, он
немедленно выполняется. В противном случае он просто будет ждать в буфере запроса; тип
точка с запятой или \ g, чтобы отправить, или \ r, чтобы отменить.

Если указан номер строки, psql поместит курсор на указанную строку
файл или буфер запроса. Обратите внимание: если указан один аргумент, состоящий только из цифр, psql
предполагает, что это номер строки, а не имя файла.

Функции
См. В разделе ОКРУЖАЮЩАЯ СРЕДА, как настроить и настроить ваш редактор.

\ эхо текст [...]
Печатает аргументы в стандартный вывод, разделенные одним пробелом, за которым следует
новая линия. Это может быть полезно для вкрапления информации в вывод скриптов. Для
пример:

=> \ эхо `дата`
Вт 26 окт, 21:40:57 CEST 1999

Если первый аргумент не заключен в кавычки -n, завершающий символ новой строки не записывается.

Функции
Если вы используете \o команда для перенаправления вывода вашего запроса, который вы, возможно, захотите использовать
\ qecho вместо этой команды.

\ ef [ описание функции [ номер строчки ]]
Эта команда выбирает и редактирует определение названной функции в виде
СОЗДАТЬ OR ЗАМЕНИТЬ Функция команда. Редактирование происходит так же, как и для \ edit.
После выхода из редактора обновленная команда ожидает в буфере запроса; введите точку с запятой
или \ g, чтобы отправить, или \ r, чтобы отменить.

Целевая функция может быть указана только по имени или по имени и аргументам для
пример foo (целое число, текст). Типы аргументов должны быть указаны, если существует более одного
одноименная функция.

Если функция не указана, пусто СОЗДАТЬ Функция шаблон представлен для
редактирования.

Если указан номер строки, psql поместит курсор на указанную строку
тело функции. (Обратите внимание, что тело функции обычно не начинается с первого
строка файла.)

Функции
См. В разделе ОКРУЖАЮЩАЯ СРЕДА, как настроить и настроить ваш редактор.

\ кодировка [ кодирование ]
Устанавливает кодировку набора символов клиента. Без аргумента эта команда показывает
текущая кодировка.

\ f [ string ]
Устанавливает разделитель полей для невыровненного вывода запроса. По умолчанию - вертикальная полоса.
(|). Смотрите также \ pset для универсального способа настройки параметров вывода.

\грамм [ имя файла ]
\ g [|команду ]
Отправляет текущий буфер ввода запроса на сервер и, при необходимости, сохраняет запрос
вывод в имя файла или передает вывод в команду оболочки команду. Файл или
команда записывается только в том случае, если запрос успешно возвращает ноль или более кортежей, а не
если запрос не выполняется или является командой SQL, не возвращающей данные.

Голый \ g по сути эквивалентен точке с запятой. A \ g с аргументом - это «одноразовый»
альтернатива \o команда.

\ gset [ префикс ]
Отправляет текущий буфер ввода запроса на сервер и сохраняет вывод запроса в
переменные psql (см. Переменные). Выполняемый запрос должен возвращать ровно одну строку.
Каждый столбец строки сохраняется в отдельной переменной, названной так же, как и
столбец. Например:

=> ВЫБОР 'Привет' AS переменная1, 10 AS var2
-> \ gset
=> \ эхо : var1 : var2
привет 10

Если вы укажете префикс, эта строка добавляется к именам столбцов запроса, чтобы
создайте имена переменных для использования:

=> ВЫБОР 'Привет' AS переменная1, 10 AS var2
-> \ gset результат_
=> \ эхо : result_var1 : result_var2
привет 10

Если результат столбца - ПУСТО (NULL), соответствующая переменная не устанавливается, а не устанавливается.

Если запрос не выполняется или не возвращает одну строку, никакие переменные не меняются.

\ h или \ help [ команду ]
Предоставляет справку по синтаксису указанной команды SQL. Если команду не указан, тогда psql
перечислит все команды, для которых доступна справка по синтаксису. Если команду есть
звездочка (*), то отображается справка по синтаксису для всех команд SQL.

Внимание
Чтобы упростить набор текста, команды, состоящие из нескольких слов, необязательно
цитируется. Таким образом, можно набрать \помощь изменять (см. таблицу ниже).

\ H или \ html
Включает формат вывода HTML-запроса. Если формат HTML уже включен, он переключается
вернуться к формату текста с выравниванием по умолчанию. Эта команда предназначена для совместимости и
удобство, но смотри \ pset о настройке других параметров вывода.

\ i или \ include имя файла
Читает ввод из файла имя файла и выполняет его, как если бы он был напечатан на
клавиатура.

If имя файла - (дефис), то стандартный ввод читается до индикации EOF или \q
метакоманда. Это можно использовать для перемежения интерактивного ввода с вводом из файлов.
Обратите внимание, что поведение Readline будет использоваться только в том случае, если оно активно на самом внешнем уровне.

Внимание
Если вы хотите видеть строки на экране по мере их чтения, вы должны установить
переменная ЭХО для всех.

\ ir или \ include_relative имя файла
Команда \ ir похожа на \ i, но по-другому разрешает относительные имена файлов. Когда
выполняясь в интерактивном режиме, две команды ведут себя идентично. Однако когда
вызываемый из сценария, \ ir интерпретирует имена файлов относительно каталога, в котором
находится сценарий, а не текущий рабочий каталог.

\ l [+] или \ list [+] [ описания ]
Перечислите базы данных на сервере и покажите их имена, владельцев, набор символов
кодировки и права доступа. Если описания указано, только базы данных, имена которых
соответствуют шаблону. Если к имени команды добавлен +, размеры базы данных,
также отображаются табличные пространства по умолчанию и описания. (Информация о размере только
доступно для баз данных, к которым может подключиться текущий пользователь.)

\ lo_export лоид имя файла
Читает большой объект с OID лоид из базы данных и записывает в имя файла. Заметка
что это немного отличается от функции сервера lo_export, который действует с
разрешения пользователя, с которым работает сервер базы данных, и в файле сервера
системы.

Функции
Используйте \ lo_list чтобы узнать OID большого объекта.

\ lo_import имя файла [ комментарий ]
Сохраняет файл в большом объекте PostgreSQL. Необязательно, он связывает данный
комментарий с объектом. Пример:

foo => \ lo_import '/home/peter/pictures/photo.xcf' 'a картина of меня'
lo_import 152801

В ответе указано, что большой объект получил идентификатор объекта 152801, который может быть
используется для доступа к вновь созданному большому объекту в будущем. Во имя
удобочитаемости, рекомендуется всегда связывать удобочитаемый комментарий с каждым
объект. И OID, и комментарии можно просмотреть с помощью \ lo_list команда.

Обратите внимание, что эта команда немного отличается от серверной. lo_import потому что
действует как локальный пользователь в локальной файловой системе, а не как пользователь сервера и
файловая система.

\ lo_list
Показывает список всех больших объектов PostgreSQL, которые в настоящее время хранятся в базе данных, а также
с любыми комментариями к ним.

\ lo_unlink лоид
Удаляет большой объект с OID лоид из базы данных.

Функции
Используйте \ lo_list чтобы узнать OID большого объекта.

\ o или \ out [ имя файла ]
\ o или \ out [|команду ]
Организует сохранение будущих результатов запроса в файл имя файла или передать будущие результаты
команда оболочки команду. Если аргумент не указан, вывод запроса сбрасывается на
стандартный вывод.

«Результаты запроса» включают все таблицы, ответы на команды и уведомления, полученные от
сервер базы данных, а также вывод различных команд с обратной косой чертой, которые запрашивают
база данных (например, \d), но не сообщения об ошибках.

Функции
Чтобы перемежать вывод текста между результатами запроса, используйте \ qecho.

\ p или \ print
Вывести текущий буфер запроса на стандартный вывод.

\пароль [ username ]
Изменяет пароль указанного пользователя (по умолчанию текущего пользователя). Этот
команда запрашивает новый пароль, шифрует его и отправляет на сервер как
ALTER РОЛЬ команда. Это гарантирует, что новый пароль не появится в открытом виде.
в истории команд, журнале сервера или в другом месте.

\незамедлительный [ текст ] имя
Предлагает пользователю ввести текст, который присваивается переменной. имя. Необязательный
строка подсказки, текст, можно указать. (Для подсказок, состоящих из нескольких слов, заключите текст в
одинарные кавычки.)

По умолчанию \ prompt использует терминал для ввода и вывода. Однако если -f команду
был использован переключатель строки, \ prompt использует стандартный ввод и стандартный вывод.

\ pset [ вариант [ ценностное ]]
Эта команда устанавливает параметры, влияющие на вывод таблиц результатов запроса. вариант
указывает, какая опция должна быть установлена. Семантика ценностное варьироваться в зависимости от
выбранный вариант. Для некоторых опций исключение ценностное вызывает переключение опции или
не задано, как описано в конкретном варианте. Если такое поведение не упоминается,
затем опуская ценностное просто приводит к отображению текущей настройки.

\ pset без аргументов отображает текущее состояние всех параметров печати.

Настраиваемые параметры печати:

граница
Команда ценностное должен быть числом. Как правило, чем выше число, тем больше границ и
строк, которые будут в таблицах, но детали зависят от конкретного формата. В HTML
формат, это будет транслироваться непосредственно в атрибут border = .... В большинстве других
форматирует только значения 0 (без рамки), 1 (внутренние разделительные линии) и 2 (таблица
frame) имеет смысл, а значения выше 2 будут обрабатываться так же, как border = 2.
форматы latex и latex-longtable дополнительно допускают значение 3 для добавления разделения
строки между строками данных.

столбцы
Устанавливает целевую ширину для обернутого формата, а также предел ширины для
определение того, является ли вывод достаточно широким, чтобы потребовать пейджер или переключиться на
вертикальный дисплей в расширенном автоматическом режиме. Ноль (по умолчанию) приводит к целевой ширине
быть управляемым переменной окружения КОЛОННЫ, или обнаруженная ширина экрана
if КОЛОННЫ не установлен. Кроме того, если столбцы равны нулю, то обернутый формат
влияет только на вывод на экран. Если столбцы не равны нулю, то вывод файла и канала
завернутый на эту ширину.

расширенный (или x)
If ценностное указано, что он должен быть включен или выключен, что будет включать или отключать
расширенный режим или автоматический. Если ценностное опускается команда переключает между вкл. и
выкл настройки. Когда включен расширенный режим, результаты запроса отображаются в двух
столбцы, с именем столбца слева и данными справа. Этот режим
полезно, если данные не помещаются на экране в обычном «горизонтальном» режиме. В
автоматическая настройка, расширенный режим используется всякий раз, когда вывод запроса шире
чем экран, в противном случае используется обычный режим. Автоматическая настройка только
эффективен в выровненных и упакованных форматах. В других форматах всегда ведет себя
как будто расширенный режим выключен.

Fieldsep
Задает разделитель полей, который будет использоваться в невыровненном выходном формате. Таким образом один
может создавать, например, вывод, разделенный табуляцией или запятыми, который другие программы
может предпочесть. Чтобы установить табуляцию в качестве разделителя полей, введите \ pset fieldsep '\ t'. В
разделителем полей по умолчанию является '|' (вертикальная полоса).

поляep_zero
Устанавливает в качестве разделителя полей для использования в невыровненном формате вывода нулевой байт.

нижний колонтитул
If ценностное указан, он должен быть включен или выключен, что будет включать или отключать
отображение нижнего колонтитула таблицы ((n строк) кол). Если ценностное опущена команда
включает или выключает отображение нижнего колонтитула.

формат
Устанавливает один из форматов вывода: невыровненный, выровненный, завернутый, html, asciidoc,
latex (используется таблица), latex-longtable или troff-ms. Уникальные сокращения:
разрешается. (Это будет означать, что одной буквы достаточно.)

невыровненный формат записывает все столбцы строки в одну строку, разделенную знаком
текущий активный разделитель полей. Это полезно для создания вывода, который может быть
предназначены для чтения другими программами (например, разделенные табуляцией или
формат через запятую).

выровненный формат - это стандартный, удобочитаемый, хорошо отформатированный текстовый вывод; это
по умолчанию.

обернутый формат похож на выровненный, но переносит широкие значения данных по строкам, чтобы
вывод соответствует ширине целевого столбца. Ширина цели определяется, как описано
под опцией столбцов. Обратите внимание, что psql не будет пытаться обернуть заголовок столбца
титулы; поэтому обернутый формат ведет себя так же, как выровненный, если общая ширина
необходимое для заголовков столбцов превышает целевое значение.

Форматы html, asciidoc, latex, latex-longtable и troff-ms выводят таблицы
которые предназначены для включения в документы с использованием соответствующей разметки
язык. Это не полные документы! Это может быть необязательно в HTML,
но в LaTeX у вас должна быть полная оболочка документа. латекс-longtable также
требуются пакеты LaTeX longtable и booktabs.

стиль линии
Устанавливает один из стилей рисования линии границы: ascii, old-ascii или unicode. Уникальный
сокращения разрешены. (Это будет означать, что одной буквы достаточно.) По умолчанию
настройка ascii. Этот параметр влияет только на форматы вывода с выравниванием и переносом.

В стиле ascii используются простые символы ASCII. Новые строки в данных отображаются с помощью символа +
символ в правом поле. Когда обернутый формат переносит данные из одной строки
к следующему без символа новой строки, справа отображается точка (.)
поле первой строки и снова в левом поле следующей строки.

в старом стиле ascii используются простые символы ASCII с использованием стиля форматирования, используемого в
PostgreSQL 8.4 и ранее. Новые строки в данных отображаются с использованием символа: на месте
левого разделителя столбцов. Когда данные переносятся из одной строки в
следующий без символа новой строки, a; символ используется вместо левого
разделитель столбцов.

В стиле Юникод используются символы рисования прямоугольников Юникода. Отображаются новые строки в данных
используя символ возврата каретки в правом поле. Когда данные обернуты
от одной строки к другой без символа новой строки отображается символ многоточия
в правом поле первой строки и снова в левом поле
следующая строка.

Когда параметр границы больше нуля, параметр стиля линии также определяет
символы, которыми нарисованы линии границы. Обычные символы ASCII работают
везде, но символы Unicode лучше смотрятся на дисплеях, которые их распознают.

нуль
Устанавливает строку, которая будет напечатана вместо нулевого значения. По умолчанию печать
ничего, что легко можно принять за пустую строку. Например, можно
предпочитаю \ pset null '(null)'.

числовая локаль
If ценностное указан, он должен быть включен или выключен, что будет включать или отключать
отображение символа, зависящего от локали, для разделения групп цифр слева от
десятичный маркер. Если ценностное опускается команда переключает между обычным и
числовой вывод, зависящий от локали.

пейджер
Управляет использованием программы-пейджера для вывода запросов и справки psql. Если окружающая среда
переменная ПЕЙДЖЕРА установлен, вывод передается в указанную программу. В противном случае
используется по умолчанию, зависящее от платформы (например, more).

Когда опция пейджера выключена, программа пейджера не используется. Когда опция пейджера
включен, пейджер используется, когда это необходимо, т. е. когда вывод осуществляется на терминал
и не умещается на экране. Параметр пейджера также может быть установлен на всегда, что
заставляет пейджер использоваться для всего вывода терминала, независимо от того, подходит ли он
на экране. \ pset пейджер без ценностное включает и выключает использование пейджера.

pager_min_lines
Если для pager_min_lines установлено число больше высоты страницы, пейджер
программа не будет вызываться, если не будет хотя бы такого количества строк вывода для
Показать. Значение по умолчанию - 0.

Recordsep
Задает разделитель записей (строк) для использования в невыровненном формате вывода. В
по умолчанию - символ новой строки.

записиep_zero
Устанавливает в качестве разделителя записей для использования в невыровненном формате вывода нулевой байт.

tableattr (или T)
В формате HTML это определяет атрибуты, которые должны быть помещены в тег таблицы. Этот
Например, это может быть cellpadding или bgcolor. Обратите внимание, что вы, вероятно, не хотите
укажите здесь границу, так как об этом уже позаботился \ pset border. Если нет ценностное
задано, атрибуты таблицы не установлены.

В формате latex-longtable это контролирует пропорциональную ширину каждого столбца.
содержащий тип данных с выравниванием по левому краю. Он указывается как разделенный пробелами
список значений, например, «0.2 0.2 ​​0.6». Неуказанные выходные столбцы используют последний
указанное значение.

название
Устанавливает заголовок для всех последующих печатаемых таблиц. Это можно использовать, чтобы дать
ваши описательные теги вывода. Если нет ценностное дано, заголовок не задан.

tuples_only (или т)
If ценностное указан, он должен быть включен или выключен, что будет включать или отключать
режим только кортежей. Если ценностное опускается команда переключает между обычным и
вывод только для кортежей. Обычный вывод включает дополнительную информацию, такую ​​как столбец
заголовки, заголовки и различные нижние колонтитулы. В режиме только кортежей только фактические данные таблицы
Показано.

unicode_border_linestyle
Устанавливает стиль рисования границы для стиля линии Юникода на один или
удвоится.

unicode_column_linestyle
Устанавливает стиль рисования столбца для стиля линии Юникода на один или
удвоится.

unicode_header_linestyle
Устанавливает стиль рисования заголовка для стиля линии Unicode на один или
удвоится.

Иллюстрации того, как выглядят эти различные форматы, можно увидеть в разделе ПРИМЕРЫ.

Функции
Существуют различные команды быстрого доступа для \ pset. Посмотреть \a, \C, \H, \t, \Tи \x.

\ q или \ выйти
Выходит из программы psql. В файле сценария прекращается только выполнение этого сценария.

\ qecho текст [...]
Эта команда идентична \ эхо за исключением того, что вывод будет записан в запрос
выходной канал, установленный \o.

\ r или \ reset
Сбрасывает (очищает) буфер запроса.

\ s [ имя файла ]
Распечатать историю командной строки psql в имя файла. Если имя файла опущено, история
записывается на стандартный вывод (при необходимости с помощью пейджера). Эта команда не
доступно, если psql был собран без поддержки Readline.

\установленный [ имя [ ценностное [...]]]
Устанавливает переменную psql имя в ценностное , или, если дано более одного значения,
объединение всех из них. Если указан только один аргумент, переменная устанавливается с
пустое значение. Чтобы отключить переменную, используйте \ отключено команда.

\установленный без аргументов отображает имена и значения всех установленных в данный момент psql
переменные.

Допустимые имена переменных могут содержать буквы, цифры и символы подчеркивания. См. Раздел
Переменные ниже для подробностей. Имена переменных чувствительны к регистру.

Хотя вы можете установить любую переменную на все, что захотите, psql обрабатывает несколько
переменные как особые. Они задокументированы в разделе о переменных.

Внимание
Эта команда не связана с командой SQL. УСТАНОВКА(7).

\ setenv имя [ ценностное ]
Устанавливает переменную окружения имя в ценностное , или если ценностное не поставляется, не устанавливает
переменная окружения. Пример:

testdb => \ setenv ПЕЙДЖЕРА Меньше
testdb => \ setenv МЕНЬШЕ -imx4F

\ sf [+] описание функции
Эта команда выбирает и показывает определение названной функции в виде
СОЗДАТЬ OR ЗАМЕНИТЬ Функция команда. Определение печатается в текущем запросе
выходной канал, установленный \o.

Целевая функция может быть указана только по имени или по имени и аргументам для
пример foo (целое число, текст). Типы аргументов должны быть указаны, если существует более одного
одноименная функция.

Если к имени команды добавлен +, то выходные строки нумеруются с
первая строка тела функции - это строка 1.

\t
Переключает отображение заголовков имен выходных столбцов и нижнего колонтитула количества строк. Эта команда
эквивалентен \ pset tuples_only и предоставляется для удобства.

\T table_options
Задает атрибуты, которые будут помещены в тег таблицы в формате вывода HTML. Этот
команда эквивалентна \ pset tableattr table_options.

\ тайминги [ on | от ]
Без параметра переключает отображение того, сколько времени занимает каждый оператор SQL, в
миллисекунды. С параметром устанавливает то же самое.

\ отключено имя
Сбрасывает (удаляет) переменную psql имя.

\ w или \ написать имя файла
\ w или \ написать |команду
Выводит текущий буфер запроса в файл имя файла или передает его команде оболочки
команду.

\смотреть [ секунды ]
Неоднократно выполнять текущий буфер запроса (например, \ g) до тех пор, пока не будет прерван или запрос
терпит неудачу. Подождите указанное количество секунд (по умолчанию 2) между выполнениями.

\Икс [ on | от | автоматический ]
Устанавливает или переключает режим форматирования развернутой таблицы. Таким образом, он эквивалентен \ pset
расширен.

\ z [ описания ]
Список таблиц, представлений и последовательностей с соответствующими правами доступа. Если
описания указано, только таблицы, представления и последовательности, имена которых соответствуют шаблону
перечислены.

Это псевдоним для \ dp («Привилегии отображения»).

\! [ команду ]
Уходит в отдельную оболочку или выполняет команду оболочки команду. Аргументы
далее не интерпретируется; оболочка увидит их как есть. В частности, переменная
правила подстановки и экранирование обратной косой черты не применяются.

\? [ тема ]
Показывает справочную информацию. Необязательный тема параметр (по умолчанию - команды) выбирает
какая часть psql объясняется: commands описывает команды psql с обратной косой чертой; параметры
описывает параметры командной строки, которые можно передать psql; и переменные показывают
справка о переменных конфигурации psql.

Шаблоны
Различные команды \ d принимают описания параметр, чтобы указать имя (имена) объекта, которые будут
отображается. В простейшем случае шаблон - это просто точное имя объекта. В
символы в шаблоне обычно переводятся в нижний регистр, как и в именах SQL;
например, \ dt FOO отобразит таблицу с именем foo. Как и в именах SQL, размещение двойных
кавычки вокруг шаблона перестают складываться в нижний регистр. Если вам нужно включить
фактический символ двойной кавычки в шаблоне, запишите его как пару двойных кавычек внутри
последовательность двойных кавычек; опять же, это соответствует правилам для цитируемого SQL
идентификаторы. Например, \ dt "FOO" "BAR" отобразит таблицу с именем FOO "BAR (не
foo "bar). В отличие от обычных правил для имен SQL, вы можете заключить в двойные кавычки только
часть шаблона, например \ dt FOO "FOO" BAR отобразит таблицу с именем
фуФУбар.

Всякий раз, когда описания параметр полностью опущен, команды \ d отображают все
объекты, которые видны в текущем пути поиска схемы - это эквивалентно
используя * как образец. (Объект считается видимым, если его содержащая схема
в пути поиска, и ни один объект того же типа и имени не появляется ранее в
путь поиска. Это эквивалентно утверждению, что на объект может ссылаться
имя без явной квалификации схемы.) Чтобы увидеть все объекты в базе данных
независимо от видимости используйте *. * в качестве шаблона.

В шаблоне * соответствует любой последовательности символов (включая отсутствие символов) и?
соответствует любому одиночному символу. (Это обозначение сопоставимо с именем файла оболочки Unix
шаблоны.) Например, \ dt int * отображает таблицы, имена которых начинаются с int. Но
в двойных кавычках, * и? теряют эти особые значения и просто совпадают
в прямом смысле.

Шаблон, содержащий точку (.), Интерпретируется как шаблон имени схемы, за которым следует
шаблон имени объекта. Например, \ dt foo *. * Bar * отображает все таблицы, таблица которых
name включает панели, которые находятся в схемах, имя схемы которых начинается с foo. Когда нет точки
появляется, то шаблон соответствует только объектам, которые видны в текущей схеме
путь поиска. Опять же, точка в двойных кавычках теряет свое особое значение и заменяется
совпали буквально.

Опытные пользователи могут использовать нотации регулярных выражений, такие как классы символов, для
пример [0-9] для соответствия любой цифре. Все специальные символы регулярных выражений работают как
указано в Раздел 9.7.3, «Регулярные выражения POSIX» в документации, за исключением
для . который используется как разделитель, как упоминалось выше, * который переводится в
Обозначение регулярных выражений. *,? который переводится на., и $ который соответствует
буквально. Вы можете при необходимости подражать этим образцам, написав? для ., (R+ |)
для R*, или (R|) для R? $ не требуется как символ регулярного выражения, так как
шаблон должен совпадать со всем именем, в отличие от обычной интерпретации обычного
выражения (другими словами, $ автоматически добавляется к вашему шаблону). Напишите * в
начало и / или конец, если вы не хотите, чтобы шаблон закреплялся. Обратите внимание, что
в двойных кавычках все специальные символы регулярных выражений теряют свои специальные
значения и совпадают буквально. Кроме того, специальные символы регулярных выражений
совпадают буквально в шаблонах имен операторов (т. е. в аргументе \ do).

Фильтр Особенности
Переменные
psql предоставляет функции замены переменных, аналогичные обычным командным оболочкам Unix.
Переменные - это просто пары имя / значение, где значением может быть любая строка любого
длина. Имя должно состоять из букв (включая нелатинские буквы), цифр и
подчеркивания.

Чтобы установить переменную, используйте мета-команду psql \установленный, Например,

testdb => \установленный Foo бар

устанавливает переменную foo на полосу значений. Чтобы получить содержимое переменной,
перед именем поставьте двоеточие, например:

testdb => \ эхо : foo
бар

Это работает как в обычных командах SQL, так и в метакомандах; в SQL есть более подробная информация
Интерполяция ниже.

Если вы позвоните \установленный без второго аргумента переменная устанавливается с пустой строкой
как ценность. Чтобы отключить (то есть удалить) переменную, используйте команду \ отключено. Чтобы показать
значения всех переменных, вызов \установленный без всяких аргументов.

Внимание
Аргументы \установленный подлежат тем же правилам замены, что и другие
команды. Таким образом, вы можете создавать интересные ссылки, такие как \ set: foo
"что-то" и получите "мягкие ссылки" или "переменные переменные" известности Perl или PHP,
соответственно. К сожалению (или к счастью?), Нет возможности что-либо сделать
полезно с этими конструкциями. С другой стороны, \ set bar: foo идеально
действительный способ скопировать переменную.

Некоторые из этих переменных обрабатываются psql особым образом. Они представляют собой определенные
настройки параметров, которые можно изменить во время выполнения, изменив значение переменной,
или в некоторых случаях представляют собой изменяемое состояние psql. Хотя вы можете использовать эти
переменные для других целей, это не рекомендуется, так как поведение программы может
становятся действительно странными, очень быстро. По соглашению все специально обработанные переменные '
имена состоят только из заглавных букв ASCII (и, возможно, цифр и знаков подчеркивания).
Чтобы обеспечить максимальную совместимость в будущем, избегайте использования таких имен переменных для
ваши собственные цели. Список всех специально обработанных переменных следует ниже.

АВТОКОММИТ
Когда включено (по умолчанию), каждая команда SQL автоматически фиксируется при успешном завершении.
завершение. Чтобы отложить фиксацию в этом режиме, вы должны ввести НАЧАТЬ or Начать игру
TRANSACTION / СДЕЛКА (ТРАНЗАКЦИЯ) Команда SQL. Когда выключено или не установлено, команды SQL не фиксируются до тех пор, пока
вы явно выдаете COMMIT or END. Режим автофиксации работает путем выдачи
безоговорочно НАЧАТЬ для вас, непосредственно перед любой командой, которая еще не находится в
блок транзакции и не является НАЧАТЬ или другая команда управления транзакцией,
ни команда, которая не может быть выполнена внутри блока транзакции (например, ВАКУУМНАЯ).

Внимание
В режиме автоматической фиксации вы должны явно отказаться от любой неудачной транзакции,
входящий ПРЕРЫВАТЬ or ОТКАТ. Также имейте в виду, что если вы выйдете из сеанса
без совершения, ваша работа будет потеряна.

Внимание
Режим автоматической фиксации - это традиционное поведение PostgreSQL, но
autocommit-off ближе к спецификации SQL. Если вы предпочитаете автоматическую фиксацию, вы
может захотеть установить его в общесистемном файле psqlrc или в вашем ~ / .psqlrc .

COMP_KEYWORD_CASE
Определяет регистр букв, который следует использовать при завершении ключевого слова SQL. Если установлено на
нижний или верхний, завершенное слово будет в нижнем или верхнем регистре соответственно.
Если установлено значение preserve-lower или preserve-upper (по умолчанию), завершенное слово будет
быть в случае уже введенного слова, но слова завершаются без
все вводимое будет в нижнем или верхнем регистре соответственно.

ИМЯ БД
Имя базы данных, к которой вы в данный момент подключены. Это устанавливается каждый раз
вы подключаетесь к базе данных (включая запуск программы), но ее можно отключить.

ЭХО
Если установлено значение all, все непустые входные строки выводятся на стандартный вывод в том виде, в котором они есть.
читать. (Это не относится к строкам, читаемым в интерактивном режиме.) Чтобы выбрать это поведение
при запуске программы используйте переключатель -a. Если установлено на запросы, psql печатает каждый запрос
в стандартный вывод при отправке на сервер. Переключатель для этого -e. Если установлено
к ошибкам, то в стандартном выводе ошибок отображаются только неудавшиеся запросы. В
переключатель для этого -b. Если не установлено, или если установлено значение none (или любое другое значение, кроме указанных
выше), то запросы не отображаются.

ECHO_HIDDEN
Когда для этой переменной установлено значение on и команда с обратной косой чертой запрашивает базу данных,
запрос отображается первым. Эта функция поможет вам изучить внутреннее устройство PostgreSQL и
предоставляйте аналогичные функции в ваших собственных программах. (Чтобы выбрать это поведение на
запуск программы, используйте переключатель -E.) Если вы установите для переменной значение noexec,
запросы просто отображаются, но фактически не отправляются на сервер и не выполняются.

КОДИРОВАНИЕ
Текущая кодировка набора символов клиента.

FETCH_COUNT
Если для этой переменной задано целочисленное значение> 0, результаты ВЫБОР запросы
выбираются и отображаются группами из такого количества строк, а не по умолчанию
поведение сбора всего набора результатов перед отображением. Поэтому только
используется ограниченный объем памяти, независимо от размера набора результатов.
При включении этой функции обычно используются настройки от 100 до 1000. Иметь ввиду
что при использовании этой функции запрос может завершиться ошибкой после того, как уже был отображен
несколько строк.

Функции
Хотя вы можете использовать любой выходной формат с этой функцией, по умолчанию выровненный
формат имеет тенденцию выглядеть плохо, потому что каждая группа FETCH_COUNT строки будут
форматируется отдельно, что приводит к разной ширине столбцов в группах строк.
Другие форматы вывода работают лучше.

ГИСТКОНТРОЛЬ
Если для этой переменной задано значение ignorespace, строки, начинающиеся с пробела, не будут
внесен в список истории. Если установлено значение ignoredups, строки, соответствующие
предыдущая строка истории не вводится. Значение ignoreboth объединяет два
параметры. Если не установлено или установлено значение none (или любое другое значение, кроме указанных выше), все
строки, прочитанные в интерактивном режиме, сохраняются в списке истории.

Внимание
Эта функция была бессовестно заимствована из Bash.

ИСТФАЙЛ
Имя файла, который будет использоваться для хранения списка истории. Значение по умолчанию -
~ / .psql_history. Например, поставив:

\ установить HISTFILE ~ / .psql_history- : DBNAME

in ~ / .psqlrc заставит psql вести отдельную историю для каждой базы данных.

Внимание
Эта функция была бессовестно заимствована из Bash.

HISTSIZE
Количество команд, сохраняемых в истории команд. Значение по умолчанию - 500.

Внимание
Эта функция была бессовестно заимствована из Bash.

ВЕДУЩИЙ
Хост сервера базы данных, к которому вы в данный момент подключены. Это устанавливается каждый раз
вы подключаетесь к базе данных (включая запуск программы), но ее можно отключить.

ИГНОРЕОФ
Если не установлено, отправка символа EOF (обычно Control + D) в интерактивный сеанс
psql завершит работу приложения. Если установлено числовое значение, это количество EOF
символы игнорируются до завершения работы приложения. Если переменная установлена
но не имеет числового значения, по умолчанию - 10.

Внимание
Эта функция была бессовестно заимствована из Bash.

ЛАСТОИД
Значение последнего затронутого OID, возвращенное из ВСТАВИТЬ or \ lo_import
команда. Эта переменная гарантированно действительна только до тех пор, пока не будет получен результат
была отображена следующая команда SQL.

ON_ERROR_ROLLBACK
Если установлено значение on, если инструкция в блоке транзакции генерирует ошибку,
ошибка игнорируется, и транзакция продолжается. При установке в интерактивном режиме такие
ошибки игнорируются только в интерактивных сеансах, но не при чтении скрипта
файлы. Если не задано или отключено, оператор в блоке транзакции, который генерирует
ошибка прерывает всю транзакцию. Режим отката ошибки работает, выдавая
неявный ТОЧКА СОХРАНЕНИЯ для вас, непосредственно перед каждой командой в транзакции
блок, а затем откат к точке сохранения в случае сбоя команды.

ON_ERROR_STOP
По умолчанию обработка команд продолжается после ошибки. Когда эта переменная установлена
включено, обработка будет немедленно остановлена. В интерактивном режиме psql будет
вернуться в командную строку; в противном случае psql выйдет, вернув код ошибки 3 в
отличить этот случай от условий фатальной ошибки, о которых сообщается с помощью error
code 1. В любом случае любые выполняющиеся в данный момент сценарии (сценарий верхнего уровня, если
любой, и любые другие скрипты, которые он мог вызвать) будут прекращены
немедленно. Если командная строка верхнего уровня содержала несколько команд SQL,
обработка будет остановлена ​​текущей командой.

PORT
Порт сервера базы данных, к которому вы в данный момент подключены. Это устанавливается каждые
время подключения к базе данных (включая запуск программы), но может быть отключено.

ПОДСКАЗКА1
ПОДСКАЗКА2
ПОДСКАЗКА3
Они определяют, как должны выглядеть запросы psql. См. Раздел «Подсказка» ниже.

ТИХО
Установка для этой переменной значения on эквивалентна параметру командной строки. -q. Это
наверное, не слишком полезно в интерактивном режиме.

ОДНА ЛИНИЯ
Установка для этой переменной значения on эквивалентна параметру командной строки. -S.

ЕДИНСТВЕННЫЙ ШАГ
Установка для этой переменной значения on эквивалентна параметру командной строки. -s.

USER
Пользователь базы данных, с которым вы в настоящее время подключены. Это устанавливается каждый раз, когда вы
подключиться к базе данных (включая запуск программы), но может быть отключено.

ГЛОБАЛЬНОСТЬ
Для этой переменной можно задать значения по умолчанию, подробный или краткий, чтобы управлять
подробность отчетов об ошибках.

SQL Интерполяция
Ключевой особенностью переменных psql является то, что вы можете подставлять («интерполировать») их в
обычные операторы SQL, а также аргументы мета-команд. Кроме того, psql
предоставляет средства для обеспечения того, чтобы значения переменных использовались как литералы SQL и
идентификаторы правильно заключены в кавычки. Синтаксис для интерполяции значения без каких-либо
цитирование заключается в добавлении имени переменной двоеточием (:). Например,

testdb => \установленный Foo "моя_таблица"
testdb => ВЫБОР * от : foo;

запросит таблицу my_table. Обратите внимание, что это может быть небезопасно: значение
переменная копируется буквально, поэтому она может содержать несбалансированные кавычки или даже обратную косую черту
команды. Вы должны убедиться, что это имеет смысл.

Когда значение должно использоваться как литерал или идентификатор SQL, безопаснее всего организовать
чтобы это было процитировано. Чтобы указать значение переменной как литерал SQL, введите двоеточие
за которым следует имя переменной в одинарных кавычках. Чтобы указать значение как SQL
идентификатора, запишите двоеточие, а затем имя переменной в двойных кавычках. Эти
конструкции правильно работают с кавычками и другими специальными символами, встроенными в
значение переменной. Предыдущий пример безопаснее было бы написать так:

testdb => \установленный Foo "моя_таблица"
testdb => ВЫБОР * от : "фу";

Интерполяция переменных не будет выполняться внутри цитируемых литералов SQL и
идентификаторы. Следовательно, такая конструкция, как ': foo', не работает для создания цитируемого
литерал из значения переменной (и было бы небезопасно, если бы он работал, так как он
не будет правильно обрабатывать кавычки, встроенные в значение).

Одним из примеров использования этого механизма является копирование содержимого файла в таблицу.
столбец. Сначала загрузите файл в переменную, а затем интерполируйте значение переменной
в виде строки в кавычках:

testdb => \установленный содержание `кошка мой_файл.txt`
testdb => ВСТАВИТЬ INTO моя_таблица ЦЕННОСТИ: (:'содержание');

(Обратите внимание, что это все равно не сработает, если my_file.txt содержит NUL байтов. Psql не
поддерживают встроенные байты NUL в значения переменных.)

Поскольку двоеточия могут официально появляться в командах SQL, очевидная попытка интерполяции
(то есть: name,: 'name' или: "name") не заменяется, если указанная переменная не
в настоящее время установлено. В любом случае вы можете экранировать двоеточие с помощью обратной косой черты, чтобы защитить его от
подмена.

Синтаксис двоеточия для переменных является стандартным SQL для встроенных языков запросов, таких как
ECPG. Синтаксисы двоеточия для срезов массивов и приведений типов являются расширениями PostgreSQL,
что иногда может противоречить стандартному использованию. Синтаксис двоеточия-кавычки для
экранирование значения переменной как литерала или идентификатора SQL является расширением psql.

побуждение
Вы можете настроить запросы psql по своему усмотрению. Три переменные
ПОДСКАЗКА1, ПОДСКАЗКА2и ПОДСКАЗКА3 содержат строки и специальные escape-последовательности, которые
опишите внешний вид подсказки. Подсказка 1 - это обычная подсказка, которая выдается
когда psql запрашивает новую команду. Подсказка 2 выдается, когда ожидается ввод дополнительных данных
во время ввода команды, потому что команда не завершалась точкой с запятой или
цитата не была закрыта. Подсказка 3 выдается при запуске SQL КОПИЯ команда и ты
ожидается ввод значений строк на терминале.

Значение выбранной переменной подсказки печатается буквально, за исключением случаев, когда процент
встречается знак (%). В зависимости от следующего символа будет отображаться другой текст.
заменил вместо этого. Определенные замены:

%M
Полное имя хоста (с доменным именем) сервера базы данных или [local], если
соединение осуществляется через сокет домена Unix или [local:/ каталог / имя], если домен Unix
сокет не находится в компилированном по умолчанию месте.

%m
Имя хоста сервера базы данных, усеченное до первой точки, или [локальный], если
соединение осуществляется через сокет домена Unix.

%>
Номер порта, который прослушивает сервер базы данных.

%n
Имя пользователя сеанса базы данных. (Расширение этого значения может измениться во время
сеанс базы данных в результате выполнения команды УСТАНОВКА СЕССИЯ РАЗРЕШЕНИЕ.)

%/
Имя текущей базы данных.

%~
Подобно% /, но вывод будет ~ (тильда), если база данных является вашей базой данных по умолчанию.

%#
Если пользователь сеанса является суперпользователем базы данных, тогда #, в противном случае>. (В
расширение этого значения может измениться во время сеанса базы данных в результате
команда УСТАНОВКА СЕССИЯ РАЗРЕШЕНИЕ.)

%R
В приглашении 1 обычно =, но ^ в однострочном режиме и! если сеанс
отключен от базы данных (что может произойти, если \соединять не удается). В подсказке 2
последовательность заменяется на -, *, одинарная кавычка, двойная кавычка или доллар
знак, в зависимости от того, ожидает ли psql дополнительных входных данных, потому что команда не
прекращено, потому что вы находитесь внутри комментария / * ... * /, или потому что вы
внутри строки, заключенной в кавычки или экранированной долларом. В подсказке 3 последовательность не дает
что-нибудь.

%x
Статус транзакции: пустая строка, если она не в блоке транзакции, или * если в
блок транзакции, или! когда в блоке неудачной транзакции, или? когда
состояние транзакции неопределенное (например, из-за отсутствия связи).

%l
Номер строки внутри текущего оператора, начиная с 1.

%цифры
Подставляется символ с указанным восьмеричным кодом.

%:имя:
Значение переменной psql имя. См. Подробности в разделе «Переменные».

%`команду`
Выход командуаналогично обычной подстановке «обратного тика».

% [...%]
Подсказки могут содержать управляющие символы терминала, которые, например, изменяют
цвет, фон или стиль текста подсказки или измените заголовок
окно терминала. Чтобы функции редактирования строк в Readline работали
правильно, эти непечатаемые управляющие символы должны быть обозначены как невидимые
окружая их% [и%]. Несколько пар могут встречаться в пределах
быстрый. Например:

testdb => \ set PROMPT1 '% [% 033 [1; 33; 40m%]% n @% /% R% [% 033 [0m%]% #]

приводит к выделению жирным шрифтом (1;) желтого на черном (33; 40) приглашения на VT100-совместимых,
терминалы с возможностью цветопередачи.
Чтобы вставить знак процента в приглашение, напишите %%. Приглашения по умолчанию: '% /% R% #'.
для подсказок 1 и 2 и '>>' для подсказки 3.

Внимание
Эта функция была бессовестно заимствована из tcsh.

Командная строка Редактирование
psql поддерживает библиотеку Readline для удобного редактирования и извлечения строк. В
история команд автоматически сохраняется при выходе из psql и перезагружается, когда psql
запускает. Также поддерживается табуляция, хотя логика завершения не делает
претендовать на роль парсера SQL. Запросы, сгенерированные с помощью табуляции, также могут мешать
с другими командами SQL, например, SET TRANSACTION ISOLATION LEVEL. Если по какой-то причине ты
не нравится завершение табуляции, вы можете отключить его, поместив это в файл с именем
.inputrc в вашем домашнем каталоге:

$ если psql
установить отключение завершения на
$ endif

(Это не psql, а функция Readline. Прочтите ее документацию для дальнейшего
Детали.)

ОКРУЖАЮЩАЯ СРЕДА

КОЛОННЫ
Если \ pset columns равняется нулю, контролирует ширину обернутого формата и ширину для
определение того, требуется ли для широкого вывода пейджер или его следует переключить на вертикальный
форматировать в расширенном автоматическом режиме.

ПЕЙДЖЕРА
Если результаты запроса не помещаются на экране, они передаются по конвейеру с помощью этой команды.
Типичные значения более или менее. Значение по умолчанию зависит от платформы. Использование
пейджер можно отключить с помощью \ pset команда.

ПГДАННЫЕ
ПРИЗРАК
ПГПОРТ
PGUSER
Параметры соединения по умолчанию (см. Раздел 31.14, «Переменные среды» в
документация).

PSQL_EDITOR
РЕДАКТОР
VISUAL
Редактор, используемый \e и \ ef команды. Переменные проверяются в порядке
перечисленные; используется первый установленный.

Встроенные редакторы по умолчанию - vi в системах Unix и notepad.exe в Windows.
систем.

PSQL_EDITOR_LINENUMBER_ARG
После появления \e or \ ef используется с аргументом номера строки, эта переменная определяет
Аргумент командной строки, используемый для передачи номера начальной строки редактору пользователя. За
редакторы, такие как Emacs или vi, это знак плюса. Включите конечный пробел в
значение переменной, если между именем опции и строкой должен быть пробел
номер. Примеры:

PSQL_EDITOR_LINENUMBER_ARG = '+'
PSQL_EDITOR_LINENUMBER_ARG = '- строка'

По умолчанию это + в системах Unix (соответствует редактору vi по умолчанию и полезно
для многих других распространенных редакторов); но в системах Windows по умолчанию нет.

PSQL_HISTORY
Альтернативное расположение файла истории команд. Выполняется раскрытие тильды (~).

PSQLRC
Альтернативное расположение файла .psqlrc пользователя. Выполняется раскрытие тильды (~).

SHELL
Команда выполняется \! команда.

TMPDIR
Каталог для хранения временных файлов. По умолчанию это / tmp.

Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные среды
поддерживается libpq (см. Раздел 31.14, «Переменные среды» в документации).

Используйте psql в Интернете с помощью сервисов onworks.net