Файлы

Примечания

Примечания для пользователей Windows

psql собрано как «консольное приложение». Поскольку в окнах консоли Windows используется кодировка, отличная от кодировки остальной части системы, необходимо соблюдать особую осторожность при использовании 8-битных символов в psql. Если psql обнаруживает проблемную кодовую страницу консоли, при запуске выдается предупреждение. Для изменения кодовой страницы консоли необходимо выполнение двух условий:

Примеры

В первом примере показано, как распределить команду на несколько строк ввода. Обратите внимание на изменение вида приглашения:

testdb=> CREATE TABLE my_table (
testdb(>  first integer not null default 0,
testdb(>  second text)
testdb-> ;
CREATE TABLE

Теперь снова рассмотрим определение таблицы:

testdb=> \d my_table
              Таблица "public.my_table"
 Столбец |  Тип   | Сопоставление | Допустимость NULL | По умолчанию
--------+---------+-----------+----------+---------
 first  | integer |           | not null | 0
 second | text    |           |          |

Теперь изменим приглашение на более информативное:

testdb=> \set PROMPT1 '%n@%m %~%R%# '
peter@localhost testdb=>

Предположим, что таблица заполнена данными и их необходимо просмотреть:

peter@localhost testdb=> SELECT * FROM my_table;
 first | second
-------+--------
     1 | one
     2 | two
     3 | three
     4 | four
(4 строки)

Выводить таблицы можно различными способами, используя \pset команду:

peter@localhost testdb=> \pset border 2
Стиль границ: 2.
peter@localhost testdb=> SELECT * FROM my_table;
+-------+--------+
| first | second |
+-------+--------+
|     1 | one    |
|     2 | two    |
|     3 | three  |
|     4 | four   |
+-------+--------+
(4 строки)

peter@localhost testdb=> \pset border 0
Стиль границ: 0.
peter@localhost testdb=> SELECT * FROM my_table;
first second
----- ------
    1 one
    2 two
    3 three
    4 four
(4 строки)

peter@localhost testdb=> \pset border 1
Стиль границ: 1.
peter@localhost testdb=> \pset format csv
Формат вывода: csv.
peter@localhost testdb=> \pset tuples_only
Вывод только строк включён.
peter@localhost testdb=> SELECT second, first FROM my_table;
one,1
two,2
three,3
four,4
peter@localhost testdb=> \pset format unaligned
Формат вывода — невыровненный.
peter@localhost testdb=> \pset fieldsep '\t'
Разделитель полей — "    ".
peter@localhost testdb=> SELECT second, first FROM my_table;
one     1
two     2
three   3
four    4

Кроме того, можно использовать сокращённые команды:

peter@localhost testdb=> \a \t \x
Формат вывода — выровненный.
Режим вывода только кортежей (tuples only) выключен.
Расширенный режим вывода (expanded display) включён.
peter@localhost testdb=> SELECT * FROM my_table;
-[ RECORD 1 ]-
first  | 1
second | one
-[ RECORD 2 ]-
first  | 2
second | two
-[ RECORD 3 ]-
first  | 3
second | three
-[ RECORD 4 ]-
first  | 4
second | four

Кроме того, эти параметры формата вывода можно установить для одного запроса с помощью \g:

peter@localhost testdb=> SELECT * FROM my_table
peter@localhost testdb-> \g (format=aligned tuples_only=off expanded=on)
-[ RECORD 1 ]-
first  | 1
second | one
-[ RECORD 2 ]-
first  | 2
second | two
-[ RECORD 3 ]-
first  | 3
second | three
-[ RECORD 4 ]-
first  | 4
second | four

Ниже приведен пример использования \df команды для поиска только тех функций, имена которых соответствуют шаблону int*pl и второй аргумент которых имеет тип bigint:

testdb=> \df int*pl * bigint
                          Список функций
   Schema   |  Name   | Result data type | Argument data types | Type
------------+---------+------------------+---------------------+------
 pg_catalog | int28pl | bigint           | smallint, bigint    | func
 pg_catalog | int48pl | bigint           | integer, bigint     | func
 pg_catalog | int8pl  | bigint           | bigint, bigint      | func
(3 строки)

При необходимости результаты запроса могут быть представлены в виде сводной таблицы с помощью команды \crosstabview команду:

testdb=> SELECT first, second, first > 2 AS gt2 FROM my_table;
 first | second | gt2
-------+--------+-----
     1 | one    | f
     2 | two    | f
     3 | three  | t
     4 | four   | t
(4 строки)

testdb=> \crosstabview first second
 first | one | two | three | four
-------+-----+-----+-------+------
     1 | f   |     |       |
     2 |     | f   |       |
     3 |     |     | t     |
     4 |     |     |       | t
(4 строки)

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

testdb=> SELECT t1.first as "A", t2.first+100 AS "B", t1.first*(t2.first+100) as "AxB",
testdb-> row_number() over(order by t2.first) AS ord
testdb-> FROM my_table t1 CROSS JOIN my_table t2 ORDER BY 1 DESC
testdb-> \crosstabview "A" "B" "AxB" ord
 A | 101 | 102 | 103 | 104
---+-----+-----+-----+-----
 4 | 404 | 408 | 412 | 416
 3 | 303 | 306 | 309 | 312
 2 | 202 | 204 | 206 | 208
 1 | 101 | 102 | 103 | 104
(4 строки)