`postgresql`

postgresql conecta PostgreSQL, inspeciona tabelas e linhas, faz alterações pontuais, exporta dados, executa SQL nativo e cria backups lógicos.

Banco de dadosVersão 1.1.4Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/postgresqlExemplo didático — sem conexão real A connection is required; the status view names the server and selected database.postgresql -lExemplo didático — sem conexão real postgres shoppostgresql -tExemplo didático — sem conexão real products BASE TABLE

Visão geral

Use postgresql com um fluxo consistente: senha oculta, inspeção de esquema e linhas, alterações pontuais, exportação, SQL nativo e backups lógicos sem ferramentas de shell.

PostgreSQL sem achatar seu modelo

PostgreSQL é um banco relacional cliente-servidor com tipagem forte, transações e uma linguagem SQL nativa muito rica. Um banco pode conter schemas, e estes contêm tabelas e outros objetos; portanto “schema” aqui também é um namespace. A superfície curta cobre tarefas comuns, e recursos específicos do PostgreSQL continuam disponíveis por :.

Sintaxe

lil-terminal

postgresql [options] · postgresql : <sql>

Referência

postgresql

mostrar a conexão PostgreSQL atual

postgresql -c <host> <user> [database] [-p <port>] [-n] [-m [name]]

conectar; a senha é solicitada separadamente, exceto com -n

-use <database>

selecionar outro banco reconectando

-l

listar bancos

-t

listar tabelas e views públicas

-s <table>

mostrar colunas e tipos de dados

-n <table> [rows]

pré-visualizar linhas

-f <table> <text> [rows]

pesquisar texto nas colunas da tabela

-o <table> [-j|-csv] [file] [-f]

exportar linhas da tabela

-a <table> : <json>

inserir uma linha a partir de um objeto JSON

-w <table> <field> <value> : <json>

atualizar linhas correspondentes a partir de um objeto JSON

-d <table> <field> <value>

excluir linhas correspondentes

-m [name]

salvar a conexão atual em .lil.key; usar por padrão o nome do banco

-M <name>

remover uma conexão salva

-k [name]

listar conexões salvas ou inspecionar uma sem mostrar a senha

-K <name>

conectar usando uma conexão salva

-e

desconectar e limpar os dados da conexão

postgresql : <sql>

executar SQL nativo

postgresql load <file.sql|file.json>

executar SQL ou restaurar um dump JSON lógico do lil

postgresql dump [file.json] [-f]

criar dump JSON lógico das tabelas públicas

Comece com uma verificação segura

Conecte-se com postgresql -c localhost demo shop e informe a senha separadamente. -t lista tabelas, -s products mostra colunas, -n products 2 exibe linhas, e -f products shoe 2 pesquisa. Depois de :, é possível usar SQL; -o products -csv tmp/products.csv exporta CSV.

Antes de alterar dados

-w e -d afetam todas as linhas correspondentes: confira o filtro e faça backup. dump cria um JSON lil com dados, não esquemas, índices ou funções do servidor; não substitui pg_dump. É preciso ter PostgreSQL e a extensão PHP pgsql.

Modelo de trabalho

As formas comuns aparecem na referência local. Os atalhos cobrem inspeção e alterações pontuais; a sintaxe nativa continua disponível para operações avançadas.

Backup e restauração

dump/load seguem o formato do driver. Para backups completos de todos os recursos do motor, use as ferramentas nativas do servidor.

Segurança

As senhas são digitadas em campo oculto e não entram no histórico. Sempre que possível, use contas com privilégios limitados.

O dump JSON do lil contém apenas dados e não recria objetos de esquema nem índices. A restauração JSON é transacional; exportação ou dump de uma tabela acima de 100000 linhas é recusado.

Conexões salvas

Sem -m, os dados de conexão ficam restritos à sessão PHP atual. -m [name] salva explicitamente o perfil no arquivo protegido .lil.key (0600), -K <name> reconecta por ele, -k lista ou inspeciona perfis sem expor uma senha salva e -M <name> remove um perfil. kill remove .lil.key junto com o restante do estado do núcleo. Trate o arquivo como sensível, pois um perfil salvo de forma voluntária pode conter credenciais de banco de dados.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Inspecionar uma tabela PostgreSQL

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install postgresql

Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install postgresql -m

Versão pública exata

Instalar exatamente esta versão publicada.

install postgresql -v 1.1.4

Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade postgresql

Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install postgresql -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Inspecionar uma tabela PostgreSQL

postgresql

Exemplo didático — sem conexão real
A connection is required; the status view names the server and selected database.

Postgresql · localhost

postgresql -c localhost demo shop -n

Exemplo didático — sem conexão real
Connection example: server and database will be shown after a successful connection.

Postgresql · localhost

postgresql -c localhost demo shop

Exemplo didático — sem conexão real
Password is requested separately; selected database: shop.

Postgresql · localhost

postgresql -c localhost demo shop -p 5433 -n

Exemplo didático — sem conexão real
Connection example: server and database will be shown after a successful connection.

Selecionar outro banco reconectando

postgresql -use shop

Exemplo didático — sem conexão real
Selected database: shop (requires an active connection)

Listar bancos

postgresql -l

Exemplo didático — sem conexão real
postgres
shop

Listar tabelas e views públicas

postgresql -t

Exemplo didático — sem conexão real
products  BASE TABLE

Mostrar colunas e tipos de dados

postgresql -s products

Exemplo didático — sem conexão real
column_name  data_type
id  bigint
sku  text
name  text
category  text
price  numeric
active  boolean

Pré-visualizar linhas

postgresql -n products 2

Exemplo didático — sem conexão real
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

Pesquisar texto nas colunas da tabela

postgresql -f products shoe 2

Exemplo didático — sem conexão real
sku=SHOE-1  name=City shoe  category=shoes  price=79.9  active=True

Exportar linhas da tabela

postgresql -o products -j

Exemplo didático — sem conexão real
[
  {
    "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
  }
]

Postgresql · products

postgresql -o products -csv tmp/products.csv

Exemplo didático — sem conexão real
Saved  sandbox/tmp/products.csv (if the destination does not exist)

Postgresql · products

postgresql -o products -j tmp/products.json -f

Exemplo didático — sem conexão real
Saved  sandbox/tmp/products.json (replace existing file only with -f)

Tratar uma tabela ausente

postgresql -a products : {"sku":"NEW-1","name":"Sample","category":"test","price":5,"active":true}

Exemplo didático — sem conexão real
Inserted  1 (example with a fresh, isolated copy)

Atualizar linhas correspondentes a partir de um objeto JSON

postgresql -w products sku SHOE-1 : {"price":75}

Exemplo didático — sem conexão real
Updated  1 (illustrative single matching row)

Excluir linhas correspondentes

postgresql -d products sku SHOE-1

Exemplo didático — sem conexão real
Deleted  1 (example only; all matches would be affected)

Executar SQL nativo

postgresql : SELECT COUNT(*) AS total FROM products

Exemplo didático — sem conexão real
total
2

Criar dump JSON lógico das tabelas públicas

postgresql dump tmp/shop-pg.json

Exemplo didático — sem conexão real
Saved  sandbox/tmp/shop-pg.json
Format  lil-postgresql-json (logical data export, not server backup)

Postgresql · dump

postgresql dump tmp/shop-pg.json -f

Exemplo didático — sem conexão real
Saved  sandbox/tmp/shop-pg.json
Format  lil-postgresql-json (logical data export, not server backup)

Executar SQL ou restaurar um dump JSON lógico do lil

postgresql load db/postgresql.sql

Exemplo didático — sem conexão real
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.

Executar SQL ou restaurar um dump JSON lógico do lil

postgresql load tmp/shop-pg.json

Exemplo didático — sem conexão real
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.

Salvar a conexão atual em .lil.key; usar por padrão o nome do banco

postgresql -m shop-demo

Exemplo didático — sem conexão real
Saved  shop-demo (stores a sensitive profile in .lil.key)

Listar conexões salvas ou inspecionar uma sem mostrar a senha

postgresql -k

Exemplo didático — sem conexão real
No saved connections (unless a profile has already been saved)

Listar conexões salvas ou inspecionar uma sem mostrar a senha

postgresql -k shop-demo

Exemplo didático — sem conexão real
Saved connection not found: shop-demo (unless saved earlier)

Conectar usando uma conexão salva

postgresql -K unknown

Exemplo didático — sem conexão real
Saved connection not found: unknown

Remover uma conexão salva

postgresql -M unknown

Exemplo didático — sem conexão real
Saved connection not found: unknown

Desconectar e limpar os dados da conexão

postgresql -e

Exemplo didático — sem conexão real
+

Postgresql · localhost

postgresql -c localhost demo shop -p 99999 -n

Exemplo didático — sem conexão real
Invalid database port

Mostrar colunas e tipos de dados

postgresql -s missing_table

Exemplo didático — sem conexão real
Table not found: missing_table

Arquivo usado neste exemplo: `sandbox/db/postgresql.sql`

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

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);

Documentação relacionada

Com quais bancos de dados posso trabalhar pelo terminal? →É seguro manter o lil-terminal em um site de produção? →

Versão pública atual

v1.1.42026-11-01

Refinamento de produção

Versão estável atual de postgresql. postgresql conecta PostgreSQL, inspeciona tabelas e linhas, faz alterações pontuais, exporta dados, executa SQL nativo e cria backups lógicos.

# Histórico de versões

postgresql

Visão geral

PostgreSQL sem achatar seu modelo

Sintaxe

Referência

Comece com uma verificação segura

Antes de alterar dados

Modelo de trabalho

Backup e restauração

Segurança

Conexões salvas

Prévia interativa do sandbox

Instalar e gerenciar

Exemplos

Arquivo usado neste exemplo: sandbox/db/postgresql.sql

Documentação relacionada

Versão pública atual

Refinamento de produção

`postgresql`

Arquivo usado neste exemplo: `sandbox/db/postgresql.sql`