Postgresql запуск из командной строки windows

Connecting to a Database

psql is a regular PostgreSQL client application. In order to connect to a database you need to know the name of your target database, the host name and port number of the server, and what database user name you want to connect as. psql can be told about those parameters via command line options, namely -d, -h, -p, and -U respectively. If an argument is found that does not belong to any option it will be interpreted as the database name (or the database user name, if the database name is already given). Not all of these options are required; there are useful defaults. If you omit the host name, psql will connect via a Unix-domain socket to a server on the local host, or via TCP/IP to localhost on Windows. The default port number is determined at compile time. Since the database server uses the same default, you will not have to specify the port in most cases. The default database user name is your operating-system user name. Once the database user name is determined, it is used as the default database name. Note that you cannot just connect to any database under any database user name. Your database administrator should have informed you about your access rights.

When the defaults aren’t quite right, you can save yourself some typing by setting the environment variables PGDATABASE, PGHOST, PGPORT and/or PGUSER to appropriate values. (For additional environment variables, see Section 34.15.) It is also convenient to have a ~/.pgpass file to avoid regularly having to type in passwords. See Section 34.16 for more information.

An alternative way to specify connection parameters is in a conninfo string or a URI, which is used instead of a database name. This mechanism give you very wide control over the connection. For example:

$ psql "service=myservice sslmode=require"
$ psql postgresql://dbmaster:5433/mydb?sslmode=require

This way you can also use LDAP for connection parameter lookup as described in Section 34.18. See Section 34.1.2 for more information on all the available connection options.

If the connection could not be made for any reason (e.g., insufficient privileges, server is not running on the targeted host, etc.), psql will return an error and terminate.

If both standard input and standard output are a terminal, then psql sets the client encoding to “auto”, which will detect the appropriate client encoding from the locale settings (LC_CTYPE environment variable on Unix systems). If this doesn’t work out as expected, the client encoding can be overridden using the environment variable PGCLIENTENCODING.

Entering SQL Commands

In normal operation, psql provides a prompt with the name of the database to which psql is currently connected, followed by the string =>. For example:

$ psql testdb
psql (16.0)
Type "help" for help.

testdb=>

At the prompt, the user can type in SQL commands. Ordinarily, input lines are sent to the server when a command-terminating semicolon is reached. An end of line does not terminate a command. Thus commands can be spread over several lines for clarity. If the command was sent and executed without error, the results of the command are displayed on the screen.

If untrusted users have access to a database that has not adopted a secure schema usage pattern, begin your session by removing publicly-writable schemas from search_path. One can add options=-csearch_path= to the connection string or issue SELECT pg_catalog.set_config('search_path', '', false) before other SQL commands. This consideration is not specific to psql; it applies to every interface for executing arbitrary SQL commands.

Whenever a command is executed, psql also polls for asynchronous notification events generated by LISTEN and NOTIFY.

While C-style block comments are passed to the server for processing and removal, SQL-standard comments are removed by psql.

Advanced Features

testdb=> \set foo bar

testdb=> \echo :foo
bar

testdb=> \set foo 'my_table'
testdb=> SELECT * FROM :foo;

testdb=> \set foo 'my_table'
testdb=> SELECT * FROM :"foo";

testdb=> \set content `cat my_file.txt`
testdb=> INSERT INTO my_table VALUES (:'content');

$if psql
set disable-completion on
$endif

PostgreSQL — это бесплатная объектно-реляционная СУБД с мощным функционалом, который позволяет конкурировать с платными базами данных, такими как Microsoft SQL, Oracle. PostgreSQL поддерживает пользовательские данные, функции, операции, домены и индексы. В данной статье мы рассмотрим установку и краткий обзор по управлению базой данных PostgreSQL. Мы установим СУБД PostgreSQL в Windows 10, создадим новую базу, добавим в неё таблицы и настроим доступа для пользователей. Также мы рассмотрим основы управления PostgreSQL с помощью SQL shell и визуальной системы управления PgAdmin. Надеюсь эта статья станет хорошей отправной точкой для обучения работы с PostgreSQL и использованию ее в разработке и тестовых проектах.

Установка PostgreSQL 11 в Windows 10

Для установки PostgreSQL перейдите на сайт https://www.postgresql.org и скачайте последнюю версию дистрибутива для Windows, на сегодняшний день это версия PostgreSQL 11 (в 11 версии PostgreSQL поддерживаются только 64-х битные редакции Windows). После загрузки запустите инсталлятор.

В процессе установки установите галочки на пунктах:

• PostgreSQL Server – сам сервер СУБД
• PgAdmin 4 – визуальный редактор SQL
• Stack Builder – дополнительные инструменты для разработки (возможно вам они понадобятся в будущем)
• Command Line Tools – инструменты командной строки

Установите пароль для пользователя postgres (он создается по умолчанию и имеет права суперпользователя).

По умолчание СУБД слушает на порту 5432, который нужно будет добавить в исключения в правилах фаерволла.

Нажимаете Далее, Далее, на этом установка PostgreSQL завершена.

Доступ к PostgreSQL по сети, правила файерволла

Чтобы разрешить сетевой доступ к вашему экземпляру PostgreSQL с других компьютеров, вам нужно создать правила в файерволе. Вы можете создать правило через командную строку или PowerShell.

Запустите командную строку от имени администратора. Введите команду:

netsh advfirewall firewall add rule name="Postgre Port" dir=in action=allow protocol=TCP localport=5432

• Где rule name – имя правила
• Localport – разрешенный порт

Либо вы можете создать правило, разрешающее TCP/IP доступ к экземпляру PostgreSQL на порту 5432 с помощью PowerShell:

New-NetFirewallRule -Name 'POSTGRESQL-In-TCP' -DisplayName 'PostgreSQL (TCP-In)' -Direction Inbound -Enabled True -Protocol TCP -LocalPort 5432

После применения команды в брандмауэре Windows появится новое разрешающее правило для порта Postgres.

Утилиты управления PostgreSQL через командную строку

Рассмотрим управление и основные операции, которые можно выполнять с PostgreSQL через командную строку с помощью нескольких утилит. Основные инструменты управления PostgreSQL находятся в папке bin, потому все команды будем выполнять из данного каталога.

• Запустите командную строку.

  Совет. Перед запуском СУБД, смените кодировку для нормального отображения в русской Windows 10. В командной строке выполните:
  chcp 1251

• Перейдите в каталог bin выполнив команду:
  CD C:\Program Files\PostgreSQL\11\bin

Основные команды PostgreSQL:

PgAdmin: Визуальный редактор для PostgresSQL

Редактор PgAdmin служит для упрощения управления базой данных PostgresSQL в понятном визуальном режиме.

По умолчанию все созданные базы хранятся в каталоге base по пути C:\Program Files\PostgreSQL\11\data\base.

Для каждой БД существует подкаталог внутри PGDATA/base, названный по OID базы данных в pg_database. Этот подкаталог по умолчанию является местом хранения файлов базы данных; в частности, там хранятся её системные каталоги. Каждая таблица и индекс хранятся в отдельном файле.

Для резервного копирования и восстановления лучше использовать инструмент Backup в панели инструментов Tools. Для автоматизации бэкапа PostgreSQL из командной строки используйте утилиту pg_dump.exe.

Query Tool: использование SQL запросов в PostgreSQL

Для написания SQL запросов в удобном графическом редакторе используется встроенный в pgAdmin инструмент Query Tool. Например, вы хотите создать новую таблицу в базе данных через инструмент Query Tool.

• Выберите базу данных, в панели Tools откройте Query Tool
• Создадим таблицу сотрудников:

CREATE TABLE employee
(
Id SERIAL PRIMARY KEY,
FirstName CHARACTER VARYING(30),
LastName CHARACTER VARYING(30),
Email CHARACTER VARYING(30),
Age INTEGER
);

Id — номер сотрудника, которому присвоен ключ SERIAL. Данная строка будет хранить числовое значение 1, 2, 3 и т.д., которое для каждой новой строки будет автоматически увеличиваться на единицу. В следующих строках записаны имя, фамилия сотрудника и его электронный адрес, которые имеют тип CHARACTER VARYING(30), то есть представляют строку длиной не более 30 символов. В строке — Age записан возраст, имеет тип INTEGER, т.к. хранит числа.

После того, как написали код SQL запроса в Query Tool, нажмите клавишу F5 и в базе будет создана новая таблица employee.

Для заполнения полей в свойствах таблицы выберите таблицу employee в разделе Schemas -> Tables. Откройте меню Object инструмент View/Edit Data.

Здесь вы можете заполнить данные в таблице.

После заполнения данных выполним инструментом Query простой запрос на выборку:
select Age from employee;

Как открыть PostgreSQL через консоль Windows без лишних телодвижений: шаг за шагом объясним, как запустить PostgreSQL через командную строку на Windows с помощью PGAdmin и PostgreSQL Command Prompt.

PostgreSQL — это мощная система управления реляционными базами данных, рассчитанная на большие объемы данных и широкий спектр запросов. Она может работать на многих операционных системах, включая Windows.

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

В этой статье мы рассмотрим, как открыть PostgreSQL через консоль Windows, шаг за шагом, чтобы помочь вам сделать это без проблем. Также мы расскажем, как выполнить первоначальную настройку PostgreSQL и создать базу данных в командной строке Windows.

Открытие PostgreSQL через консоль Windows

Открытие PostgreSQL через консоль Windows может быть полезно при выполнении некоторых операций в базе данных. Для этого нужно выполнить несколько простых шагов.

1. Открыть окно командной строки (нажать Win + R, ввести cmd и нажать Enter).

2. Перейти в директорию, где расположена pgsql\bin, например, используя команду cd C:\Program Files\PostgreSQL\13\bin.

3. Запустить утилиту psql, введя команду psql -U имя_пользователя -d имя_базы_данных.

4. Ввести пароль пользователя, если это необходимо.

5. Теперь открыта консоль PostgreSQL и можно выполнять нужные операции в базе данных.

Кроме того, для удобства можно создать сокращенный ярлык для вызова утилиты psql через командную строку, например, используя команду mklink C:\psql.lnk «C:\Program Files\PostgreSQL\13\bin\psql.exe» — это позволит вызывать psql через команду psql в любой директории.

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

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

Шаг 1: Установка PostgreSQL

Перед началом работы с PostgreSQL необходимо его установить на свой компьютер. Для этого можно скачать установочный файл с официального сайта PostgreSQL.

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

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

Проверить установку и работу PostgreSQL можно, запустив командную строку и введя команду psql. Если все настроено верно, откроется интерактивная консоль PostgreSQL, где можно работать с базами данных и выполнять SQL-запросы.

Шаг 2: Подготовка конфигурации

Перед тем, как запустить PostgreSQL через консоль Windows, необходимо подготовить его конфигурацию. Для этого нужно открыть файл postgresql.conf, который находится в папке с установленным PostgreSQL.

Откройте файл в любом текстовом редакторе и настройте параметры, соответствующие вашим требованиям. Здесь вы можете определить порт, на котором будет работать PostgreSQL, указать директории для хранения данных и журналов, а также изменить настройки памяти и производительности.

Также, если вы хотите запускать PostgreSQL в качестве службы Windows, то необходимо настроить файл postgresql.auto.conf. Этот файл находится в папке с установленным PostgreSQL и содержит конфигурационные параметры для службы.

После того, как вы настроили конфигурацию, сохраните файл и закройте его. Теперь вы готовы переходить к следующему шагу – запуску PostgreSQL через консоль Windows.

Шаг 3: Открытие консоли Windows

Для работы с Postgresql через консоль Windows вам необходимо открыть командную строку. Существует несколько способов это сделать.

Первый способ:

• Нажмите клавиши «Win» + «R» на вашей клавиатуре.
• В появившемся окне введите команду «cmd» и нажмите кнопку «ОК».

Второй способ:

• Откройте меню «Пуск» и найдите папку «Системные инструменты».
• В этой папке выберите «Командная строка».

Третий способ:

• Откройте меню «Пуск» и найдите папку «Windows Система».
• В этой папке выберите «Командная строка».

После того, как вы открыли командную строку, вам необходимо перейти в папку, где установлен Postgresql. Для этого используйте команду «cd». Например, для перехода в папку «C:\Program Files\Postgresql\bin» введите команду:

cd «C:\Program Files\Postgresql\bin»

После этого вы сможете выполнять различные команды для работы с Postgresql через консоль Windows.

Шаг 4: Переход в папку PostgreSQL

Шаг 1: Откройте командную строку Windows, нажав кнопку «Пуск» и введя «cmd» в поле поиска. Далее нажмите Enter.

Шаг 2: Перейдите в директорию, где установлен PostgreSQL. По умолчанию, папка находится в «C:\Program Files\PostgreSQL».

Шаг 3: Проверьте содержимое папки. В ней должны быть различные файлы и папки, связанные с PostgreSQL.

Шаг 4: Для входа в папку PostgreSQL выполните команду «cd bin» и нажмите Enter. Вы будете перемещены в папку «bin», где находятся основные исполняемые файлы PostgreSQL.

Шаг 5: Для запуска PostgreSQL введите команду «psql» и нажмите Enter. Если все выполнено правильно, вы увидите приглашение «postgres=#» и сможете начать работать с PostgreSQL через командную строку.

Следуя этим шагам, вы можете успешно перейти в папку PostgreSQL и начать использовать ее в командной строке Windows.

Шаг 5: Запуск PostgreSQL из консоли Windows

Чтобы запустить PostgreSQL из консоли Windows, необходимо открыть окно командной строки от имени администратора. Для этого нажмите на кнопку «Пуск», найдите программу «Командная строка» и нажмите на нее правой кнопкой мыши. Выберите опцию «Запуск от имени администратора».

После открытия окна командной строки введите команду «pg_ctl -D c:\postgres\data start» и нажмите клавишу «Enter». Эта команда запустит PostgreSQL и откроет доступ к базе данных.

Если вы хотите остановить работу PostgreSQL, введите команду «pg_ctl -D c:\postgres\data stop».

Также, можно запустить PostgreSQL с помощью графического интерфейса PgAdmin. Для этого запустите программу и выберите в меню «Сервер» опцию «Подключиться к серверу». В открывшемся окне введите данные для подключения к серверу и нажмите кнопку «Подключиться».

В этом шаге мы рассмотрели, как запустить PostgreSQL из консоли Windows и пользоваться графическим интерфейсом PgAdmin для управления базой данных.

Шаг 6: Вход в PostgreSQL с помощью команды «psql»

После того, как вы успешно запустили сервер PostgreSQL, вы можете войти в него с помощью команды «psql». Это позволит вам выполнять SQL-запросы и работать с базой данных из консоли.

Чтобы войти в PostgreSQL, откройте новое окно командной строки и введите следующую команду:

psql -U имя_пользователя -d имя_базы_данных

Замените «имя_пользователя» на имя пользователя, которое вы указали во время установки PostgreSQL, и «имя_базы_данных» на название базы данных, с которой вы хотите работать.

Если вы не указали пароль при установке PostgreSQL, вас попросят ввести пароль при попытке входа в базу данных. Введите пароль и нажмите Enter.

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

Вы можете использовать различные команды, такие как «SELECT», «INSERT» или «UPDATE» для работы с данными в базе данных. Для получения дополнительной информации об этих командах и других различных опциях, которые вы можете использовать в PostgreSQL, прочитайте документацию PostgreSQL.

Шаг 7: Проверка того, что PostgreSQL работает

После того, как вы успешно установили и настроили PostgreSQL через консоль Windows, проверьте, что сервер запущен и работает корректно.

Для этого запустите командную строку (cmd) и введите команду:

pg_ctl status -D «путь_к_папке_с_базой_данных»

Где «путь_к_папке_с_базой_данных» должен указывать на директорию, которую вы указали при установке PostgreSQL.

Если сервер работает корректно, вы должны увидеть сообщение о том, что сервер запущен.

Также, вы можете проверить доступность сервера из приложения с помощью команды:

psql -h localhost -U postgres

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

Если вы столкнулись с какими-либо проблемами в процессе проверки, проверьте правильность введенных команд и настройки сервера.

Шаг 8: Использование команд для работы с PostgreSQL

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

• psql — запускает интерактивную консольную среду для работы с базой данных
• createdb — создает новую базу данных
• dropdb — удаляет существующую базу данных
• createuser — создает нового пользователя
• dropuser — удаляет существующего пользователя
• pg_dump — выгружает данные из базы в файл
• pg_restore — восстанавливает данные из файла в базу данных

Кроме этого, вы можете использовать SQL-запросы для работы с данными в базе. Основные команды на SQL:

• SELECT — выборка данных из таблицы
• INSERT — добавление новых данных в таблицу
• UPDATE — обновление данных в таблице
• DELETE — удаление данных из таблицы

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

Шаг 9: Выход из PostgreSQL и закрытие консоли Windows

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

1. Выполните команду \q, чтобы выйти из PostgreSQL.
2. Наберите команду exit, чтобы закрыть консоль Windows.

Если вы работаете с несколькими окнами консоли Windows, убедитесь, что вы закрыли все окна своей сессии.

Теперь вы можете быть уверены, что правильно завершили работу с PostgreSQL и закрыли консоль Windows без повреждения вашей базы данных.

Видео по теме:

postgres

You’ve installed PostgreSQL. Now what? I assume you’ve been given a task that
uses psql and you want to learn the absolute minimum to
get the job done.

This is both a brief tutorial and a
quick reference for the absolute least you need to know about psql.
I assume you’re familiar with the command line and have a rough idea about
what database administration tasks, but aren’t familiar with how to
use psql to do the basics.

View on GitHub Pages or directly on GitHub

The PostgreSQL documentation is incredibly
well written and thorough, but frankly, I didn’t know where to start reading. This
is my answer to that problem.

If you have any complaints or suggestions please let me know by
sending your feedback to tomcampbell@gmail.com.

It shows how to do the following at the psql prompt:

• Start and quit psql
• Get help
• Get information about databases
• Create databases
• CREATE TABLEs
• INSERT, or add records to a table
• SELECT, to do simple queries
• Reference pointing to the official PostgreSQL documentation

If you don’t have access to a live PostgreSQL installation at the moment we still have your back.
You can follow through the examples and the output is shown as if you
did type everything out.

The psql command line utility

Many administrative tasks can or should be done on your local machine,
even though if database lives on the cloud.
You can do some of them through a visual user interface, but that’s not covered here.
Knowing how to perform these operations on the command line means you can script them,
and scripting means you can automate tests, check errors, and do data entry on the command line.

This section isn’t a full cheat sheet for psql.
It covers the most common operations and shows them roughly in sequence,
as you’d use them in a typical work session.

What you need to know

Before using this section, you’ll need:

• The user name and password for your PostgreSQL database
• The IP address of your remote instance

Command-line prompts on the operating system

The $ starting a command line in the examples below represents your operating system prompt.
Prompts are configurable so it may well not look like this.
On Windows it might look like C:\Program Files\PostgreSQL> but Windows prompts are also configurable.

$ psql -U sampleuser -h localhost

A line starting with # represents a comment. Same for everything to the right of a #.
If you accidentally type it or copy and paste it in, don’t worry. Nothing will happen.

This worked to connect to Postgres on DigitalOcean
# -U is the username (it will appear in the \l command)
# -h is the name of the machine where the server is running.
# -p is the port where the database listens to connections. Default is 5432.
# -d is the name of the database to connect to. I think DO generated this for me, or maybe PostgreSQL.
# Password when asked is csizllepewdypieiib
$ psql -U doadmin -h production-sfo-test1-do-user-4866002-0.db.ondigitalocean.com -p 25060 -d mydb

# Open a database in a remote location.
$ psql -U sampleuser -h production-sfo-test1-do-user-4866002-0.db.ondigitalocean.com -p 21334

Using psql

You’ll use psql (aka the PostgreSQL interactive terminal) most of all because it’s used to create databases and tables, show information about tables, and even to enter information (records) into the database.

Quitting pqsql

Before we learn anything else, here’s how to quit psql and return to the operating system prompt.
You type backslash, the letter q, and then you press the Enter or return key.

# Press enter after typing \q
# Remember this is backslash, not forward slash
postgres=# \q

This takes you back out to the operating system prompt.

Opening a connection locally

A common case during development is opening a connection to a local database (one on your own machine).
Run psql with -U (for user name) followed by the name of the database, postgres in this example:

# Log into Postgres as the user named postgres
$ psql -U postgres

Opening a connection remotely

To connect your remote PostgreSQL instance from your local machine, use psql at your operating system command line.
Here’s a typical connection.

# -U is the username (it will appear in the \l command)
# -h is the name of the machine where the server is running.
# -p is the port where the database listens to connections. Default is 5432.
# -d is the name of the database to connect to. I think DO generated this for me, or maybe PostgreSQL.
$ psql -U doadmin -h production-sfo-test1-do-user-4866002-0.db.ondigitalocean.com -p 25060 -d defaultdb

Here you’d enter the password. In case someone is peering over your shoulder, the characters are hidden. After you’ve entered your information properly you’ll get this message (truncated for clarity):

Looking at the psql prompt

A few things appear, then the psql prompt is displayed.
The name of the current database appears before the prompt.

psql (11.1, server 11.0)
Type "help" for help.

postgres=# 

At this point you’re expected to type commands and parameters into the command line.

psql vs SQL commands

psql has two different kinds of commands. Those starting with a backslash
are for psql itself, as illustrated by the use of \q to quit.

Those starting with valid SQL are of course interactive SQL used to
create and modify PostgreSQL databases.

Warning: SQL commands end with a semicolon!

One gotcha is that almost all SQL commands you enter into psql must end in a semicolon.

• For example,suppose you want to remove a table named sample_property_5. You’d enter this command:

postgres=# DROP TABLE "sample_property_5";

It’s easy to forget. If you do forget the semicolon, you’ll see this perplexing prompt.
Note that a [ has been inserted before the username portion of the prompt, and another
prompt appears below it:

[postgres=# DROP TABLE "sample_property_5"
postgres=#

When you do, just remember to finish it off with that semicolon:

[postgres=# DROP TABLE "sample_property_5"
postgres=# ;

Scrolling through the command history

• Use the up and down arrow keys to move backwards and forwards through the command history.

Getting information about databases

These aren’t SQL commands so just press Enter after them. Remember that:

• When there’s more output than fits the screen, it pauses. Press space to continue
• If you want to halt the output, press q.

\h Help

# Get help. Note it's a backslash, not a forward slash.
postgres=# \h

You’ll get a long list of commands, then output is paused:

Available help:
  ABORT                            CREATE USER
  ...
  ALTER AGGREGATE                  CREATE USER MAPPING
  ALTER PROCEDURE                  DROP INDEX
:

• Press space to continue, or q to stop the output.

You can get help on a particular item by listing it after the \h command.

• For example, to get help on DROP TABLE:

postgres=# \h drop table

You’ll get help on just that item:

Command:     DROP TABLE
Description: remove a table
Syntax:
DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

\l List databases

What most people think of as a database (say, a list of customers) is actually a table. A database is a set of tables, information about those tables, information about users and their permissions, and much more. Some of these databases (and the tables within) are updated automatically by PostgreSQL as you use them.

To get a list of all databases:

postgres=# \l
                                  List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges   
-----------+----------+----------+-------------+-------------+-----------------------
 visitor   | tom      | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 markets   | tom      | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 postgres  | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 template1 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 tom       | tom      | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 

You can get info on a single database by following the \l prompt with its name.

• For example, to view information about the template0 database:

postgres=# \l template0

The output would be:

postgres=# \l
                                  List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges   
-----------+----------+----------+-------------+-------------+-----------------------
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres

\l+ List databases with size, tablespace, and description

To get additional information on the space consumed by database tables
and comments describing those tables, use \l+:

postgres=# \l+

\x Expand/narrow table lists

Use \x (X for eXpanded listing) to control
whether table listings use a wide or narrow format.

Example: Here’s an expanded listing:

/* List all databases. */
postgres=# \l

                                  List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges   
-----------+----------+----------+-------------+-------------+-----------------------
 foo       | tom      | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 foobarino | tom      | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 postgres  | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 template1 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 tom       | tom      | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
(6 rows)

Use \x on for narrower listings:

/* Turn on narrow listings. */
postgres=# \x on
postgres=# \l


-[ RECORD 1 ]-----+----------------------
Name              | foo
Owner             | tom
Encoding          | UTF8
Collate           | en_US.UTF-8
Ctype             | en_US.UTF-8
Access privileges | 
-[ RECORD 2 ]-----+----------------------
Name              | foobarino
Owner             | tom
Encoding          | UTF8
Collate           | en_US.UTF-8
Ctype             | en_US.UTF-8
Access privileges | 
-[ RECORD 3 ]-----+----------------------
Name              | postgres
Owner             | postgres
Encoding          | UTF8
Collate           | en_US.UTF-8
Ctype             | en_US.UTF-8
Access privileges | 

\c Connect to a database

To see what’s inside a database, connect to it using \c followed by the database name.
The prompt changes to match the name of the database you’re connecting to.
(The one named postgres is always interesting.) Here we’re connecting to the one named
markets:

postgres=# \c markets
psql (11.1, server 11.0)
You are now connected to database "markets" as user "tom".
markets=# 

\dt Display tables

• Use \dt to list all the tables (technically, relations) in the database:

markets=# \dt

                    List of relations
 Schema |             Name             | Type  |  Owner   
--------+------------------------------+-------+----------
 public | addresspool                  | table | tom
 public | adlookup                     | table | tom
 public | bidactivitysummary           | table | tom
 public | bidactivitydetail            | table | tom
 public | customerpaymentsummary       | table | tom
 ...

• If you choose a database such as postgres there could be many tables.
  Remember you can pause output by pressing space or halt it by pressing q.

\d and \d+ Display columns (field names) of a table

To view the schema of a table, use \d followed by the name of the table.

• To view the schema of a table named customerpaymentsummary, enter

markets=# \d customerpaymentsummary

                            Table "public.customerpaymentsummary"
            Column            |            Type             | Collation | Nullable | Default 
------------------------------+-----------------------------+-----------+----------+--------
 usersysid                    | integer                     |           | not null |        
 paymentattemptsall           | integer                     |           |          |        
 paymentattemptsmailin        | integer                     |           |          |        
 paymentattemptspaypal        | integer                     |           |          |        
 paymentattemptscreditcard    | integer                     |           |          |        
 paymentacceptedoutagecredit  | integer                     |           |          |        
 totalmoneyin                 | numeric(12,2)               |           |          |        
 updatewhen1                  | timestamp without time zone |           |          |        
 updatewhen2                  | timestamp without time zone |           |          |        

To view more detailed information on a table, use \d+:

markets=# \d customerpaymentsummary

                            Table "public.customerpaymentsummary"
            Column            |            Type             | Collation | Nullable | Default | Storage | Stats target |
------------------------------+-----------------------------+-----------+----------+---------+---------+---------------
 usersysid                    | integer                     |           | not null |         | plain   |              |   
 paymentattemptsall           | integer                     |           |          |         | plain   |              |   
 paymentattemptsmailin        | integer                     |           |          |         | plain   |              |   
 paymentattemptspaypal        | integer                     |           |          |         | plain   |              |   
 paymentattemptscreditcard    | integer                     |           |          |         | plain   |              |   
 paymentacceptedoutagecredit  | integer                     |           |          |         | plain   |              |    
 totalmoneyin                 | numeric(12,2)               |           |          |         | main    |              |    
 updatewhen1                  | timestamp without time zone |           |          |         | plain   |              |   
 updatewhen2                  | timestamp without time zone |           |          |         | plain   |              |    

Indexes:

\du Display user roles

• To view all users and their roles, use \du:

postgres=# \du
                                    List of roles
 Role name  |                         Attributes                         | Member of 
------------+------------------------------------------------------------+-----------
 smanager   | Superuser                                                  | {}
 postgres   | Superuser, Create role, Create DB, Replication, Bypass RLS | {}
 tom        | Superuser, Create role, Create DB                          | {}

• To view the role of a specific user, pass it after the \du command.
  For example, to see the only tom role:

postgres=# \du tom
                                    List of roles
 Role name  |                         Attributes                         | Member of 
------------+------------------------------------------------------------+-----------
 tom        | Superuser, Create role, Create DB                          | {}

Creating a database

Before you add tables, you need to create a database to contain those tables.
That’s not done with psql, but instead it’s done with createdb
(a separate external command; see the PostgreSQL createdb documentation) at the operating system command line:

# Replace markets with your database name
$ createdb markets

On success, there is no visual feedback. Thanks, PostgreSQL.

Adding tables and records

Creating a table (CREATE TABLE)

To add a table schema to the database:

postgres=# create table if not exists product (
  id              SERIAL,
  name            VARCHAR(100) NOT NULL,
  sku             CHAR(8)
);

And psql responds with:

For more see CREATE TABLE in the PostgreSQL official docs.

Adding a record (INSERT INTO)

• Here’s how to add a record, populating every field:

# The id field is an automatically assigned
# when you use DEFAULT. The serial primary key means
# that number will be increased by at least
# 1 and assigned to that same field when
# a new record is created.
# Using DEFAULT is a placeholder. 
# In its place PostgreSQL automatically generates a unique integer for it.
postgres=# INSERT INTO product VALUES(DEFAULT, 'Apple, Fuji', '4131');

PostgreSQL responds with:

• Try it again and you get a simliar response.

postgres=# INSERT INTO product VALUES(DEFAULT, 'Banana', '4011');
INSERT 0 1

Adding (inserting) several records at once

• You can enter a list of records using this syntax:

postgres=# INSERT INTO product VALUES
(DEFAULT, 'Carrots', 4562),
(DEFAULT, 'Durian', 5228)
;

Adding only specific (columns) fields from a record

You can add records but specify only selected fields (also known as columns). MySQL will use common sense default values for the rest.

In this example, only the name field will be populated. The sku column is left blank, and the id column is incremented and inserted.

Two records are added:

postgres=# INSERT INTO product (name) VALUES
('Endive'),
('Figs')
;

PostgreSQL responds with the number of records inserted:

INSERT 0 2

For more on INSERT, see INSERT in the PostgreSQL official docs

Doing a simple query–get a list of records (SELECT)

Probably the most common thing you’ll do with a table is to obtain information about it
with the SELECT statement. It’s a huge topic

• Let’s list all the records in the product table:

postgres=# SELECT * FROM product;

The response:

postgres=# select * from product;
 id |    name     |   sku    
----+-------------+----------
  1 | Apple, Fuji | 4131    
  2 | Banana      | 4011    
(2 rows)

Note

If your table has mixed case objects such as column names or indexes, you’ll need to enclose them in double quotes.
For example, If a column name were Product instead of product your query would need to look like this:

For more on SELECT, see the SELECT in the PostgreSQL official docs.

Maintenance and operations issues

Timing

\t Timing SQL operations

Use \t to show timing for all SQL operations performed.

Example of \t Timing command

tom=# insert into todo values ('Retry on Android before app submission,'8.x and earlier');
INSERT 0 1
tom=# \timing on
Timing is on.
tom=# insert into todo values ('Correct footer bug','Mobile version only');
INSERT 0 1
Time: 1.067 ms
tom=# insert into todo values ('Retry on Android before app submission', '8.x and earlier');
INSERT 0 1
Time: 23.312 ms
tom=# \timing
Timing is off.

Watch

The \watch command repeats the previous command at the specified interval.
To use it, enter the SQL command you want repeated, then
use \watch followed by the number of seconds you want for
the interval between repeats, for rexample, \watch 1
to repeat it every second.

Example of the \Watch command

Here’s an example of using \watch to see if any records have been
inserted within the last 5 seconds.

tom=# select count(*);
  count 
--------
    726
(726 rows)

tom=# \watch 5
Mon Nov 16 13:50:36 2020 (every 2s)

  count 
--------
    726
(726 rows)

Mon Nov 16 13:50:38 2020 (every 2s)

  count 
--------
    726
(726 rows)

Mon Nov 16 13:50:40 2020 (every 2s)

  count 
--------
    726
(726 rows)

Locate the pg_hba.conf file

Postgres configuration is stored in a file named pg_hba.conf somewhere in the file system, but
that location varies widely. The way to find it is to use show hba_file like this:

See below for hot reloading this file while Postgres is running.

Reload the configuration file while Postgres is running

If you make changes to the pg_hba.conf Postgres configuration sometimes you need to restart.
But you may just choose to reload the pg_hba.conf configuration file like this:

Reference

• PostgreSQL offical docs: Server Administration
• psql , a.k.a the PostgreSQL interactive terminal
• createdb in the PostgreSQL offical docs
• CREATE TABLE in the PostgreSQL official docs
• INSERT in the PostgreSQL official docs