postgresql

Обзор

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

PostgreSQL без упрощения его модели

PostgreSQL — клиент-серверная реляционная СУБД со строгими типами, транзакциями и богатым собственным SQL. Внутри базы могут существовать схемы, а уже в них таблицы и другие объекты, поэтому здесь схема означает ещё и пространство имён базы, а не только описание столбцов. Короткий набор команд удобен для просмотра и типовых изменений, а специфичные возможности PostgreSQL доступны через :.

Синтаксис

postgresql [options] · postgresql : <sql>

Справочник

Начните с безопасного просмотра

Начните с postgresql -c localhost demo shop: пароль вводится отдельно, а не в истории команд. -t покажет таблицы, -s products — столбцы, -n products 2 — две строки, -f products shoe 2 — поиск. Если простых флагов мало, после : можно выполнить SQL, например SELECT. -o products -csv tmp/products.csv сохранит таблицу в CSV.

Перед изменением данных

-a добавляет запись, -w изменяет все совпавшие строки, -d удаляет все совпадения. Сначала проверьте выборку и сделайте копию. dump создаёт JSON-снимок данных из public-таблиц, но **не заменяет** pg_dump: схемы, индексы, роли и расширения не восстанавливаются. load принимает этот JSON для уже созданных таблиц или SQL-файл. Для настоящего подключения нужны сервер PostgreSQL и расширение PHP pgsql; ответы примеров учебные.

Просмотр и изменение

-l показывает базы, -t — public-таблицы и представления, -s — определения столбцов, -n — строки, -f — текстовый поиск по одной таблице, -o — JSON/CSV. -a, -w и -d предназначены для небольших точечных изменений; сложные операции выполняйте SQL.

Дамп и восстановление

Поскольку lil принципиально не запускает системный pg_dump, dump создаёт логический JSON-снимок строк public-таблиц, а load умеет восстановить этот формат или выполнить SQL-файл. Для полного резервирования схем, расширений, ролей и кластерных объектов используйте штатные инструменты PostgreSQL на стороне сервера.

Подключение и безопасность

Пароль -c запрашивается вне истории. -use переподключает текущую сессию к другой базе. Все операции выполняются с правами подключённого пользователя PostgreSQL.

JSON-дамп lil содержит только данные и не воссоздаёт объекты схемы и индексы. JSON-восстановление выполняется транзакционно; выгрузка или дамп таблицы больше 100000 строк отклоняются.

Сохранённые подключения

Без -m данные подключения остаются только в текущей PHP-сессии. -m [name] явно сохраняет профиль в защищённом файле .lil.key (0600), -K <name> подключается через него повторно, -k показывает список или сведения о профиле без вывода сохранённого пароля, а -M <name> удаляет профиль. kill удаляет .lil.key вместе с остальным состоянием ядра. Относитесь к файлу как к чувствительному: добровольно сохранённый профиль может содержать доступы к базе данных.

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Примеры

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

Учебный пример — без подключения к серверу
A connection is required; the status view names the server and selected database.

Учебный пример — без подключения к серверу
Connection example: server and database will be shown after a successful connection.

Учебный пример — без подключения к серверу
Password is requested separately; selected database: shop.

Учебный пример — без подключения к серверу
Connection example: server and database will be shown after a successful connection.

Учебный пример — без подключения к серверу
Selected database: shop (requires an active connection)

Учебный пример — без подключения к серверу
postgres
shop

Учебный пример — без подключения к серверу
products  BASE TABLE

Учебный пример — без подключения к серверу
column_name  data_type
id  bigint
sku  text
name  text
category  text
price  numeric
active  boolean

Учебный пример — без подключения к серверу
sku=SHOE-1  name=City shoe  category=shoes  price=79.9  active=True
sku=BAG-1  name=Canvas bag  category=bags  price=44.5  active=True

Учебный пример — без подключения к серверу
sku=SHOE-1  name=City shoe  category=shoes  price=79.9  active=True

Учебный пример — без подключения к серверу
[
  {
    "sku": "SHOE-1",
    "name": "City shoe",
    "category": "shoes",
    "price": 79.9,
    "active": true
  },
  {
    "sku": "BAG-1",
    "name": "Canvas bag",
    "category": "bags",
    "price": 44.5,
    "active": true
  }
]

Учебный пример — без подключения к серверу
Saved  sandbox/tmp/products.csv (if the destination does not exist)

Учебный пример — без подключения к серверу
Saved  sandbox/tmp/products.json (replace existing file only with -f)

Учебный пример — без подключения к серверу
Inserted  1 (example with a fresh, isolated copy)

Учебный пример — без подключения к серверу
Updated  1 (illustrative single matching row)

Учебный пример — без подключения к серверу
Deleted  1 (example only; all matches would be affected)

Учебный пример — без подключения к серверу
total
2

Учебный пример — без подключения к серверу
Saved  sandbox/tmp/shop-pg.json
Format  lil-postgresql-json (logical data export, not server backup)

Учебный пример — без подключения к серверу
Saved  sandbox/tmp/shop-pg.json
Format  lil-postgresql-json (logical data export, not server backup)

Учебный пример — без подключения к серверу
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.

Учебный пример — без подключения к серверу
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.

Учебный пример — без подключения к серверу
Saved  shop-demo (stores a sensitive profile in .lil.key)

Учебный пример — без подключения к серверу
No saved connections (unless a profile has already been saved)

Учебный пример — без подключения к серверу
Saved connection not found: shop-demo (unless saved earlier)

Учебный пример — без подключения к серверу
Saved connection not found: unknown

Учебный пример — без подключения к серверу
Saved connection not found: unknown

Учебный пример — без подключения к серверу
+

Учебный пример — без подключения к серверу
Invalid database port

Учебный пример — без подключения к серверу
Table not found: missing_table

CREATE TABLE products (id BIGSERIAL PRIMARY KEY, sku text UNIQUE NOT NULL, name text NOT NULL, category text NOT NULL, price numeric(10,2) NOT NULL, active boolean NOT NULL DEFAULT true);
INSERT INTO products(sku,name,category,price,active) VALUES ('SHOE-1','City shoe','shoes',79.90,true),('BAG-1','Canvas bag','bags',44.50,true);

Связанная документация