`postgresql`

postgresql conecta con PostgreSQL, inspecciona tablas y filas, hace cambios puntuales, exporta datos, ejecuta SQL nativo y crea copias lógicas.

Base de datosVersión 1.1.4Estable

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/postgresqlEjemplo ilustrativo — sin conexión real A connection is required; the status view names the server and selected database.postgresql -lEjemplo ilustrativo — sin conexión real postgres shoppostgresql -tEjemplo ilustrativo — sin conexión real products BASE TABLE

Resumen

Use postgresql con un flujo coherente: contraseña oculta, inspección de esquema y filas, cambios puntuales, exportación, SQL nativo y copias lógicas sin herramientas de shell.

PostgreSQL sin aplanar su modelo

PostgreSQL es una base relacional cliente-servidor con tipado fuerte, transacciones y un lenguaje SQL nativo muy rico. Una base puede contener schemas y estos contienen tablas y otros objetos, de modo que “schema” también es un espacio de nombres. La superficie corta cubre tareas habituales y : permite usar capacidades propias de PostgreSQL.

Sintaxis

lil-terminal

postgresql [options] · postgresql : <sql>

Referencia

postgresql

mostrar la conexión PostgreSQL actual

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

conectarse; la contraseña se solicita por separado salvo que se use -n

-use <database>

seleccionar otra base de datos reconectando

-l

listar bases de datos

-t

listar tablas y vistas públicas

-s <table>

mostrar columnas y tipos de datos

-n <table> [rows]

previsualizar filas de una tabla

-f <table> <text> [rows]

buscar texto en las columnas de una tabla

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

exportar filas de una tabla

-a <table> : <json>

insertar una fila desde un objeto JSON

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

actualizar las filas coincidentes desde un objeto JSON

-d <table> <field> <value>

eliminar las filas coincidentes

-m [name]

guardar la conexión actual en .lil.key; usar por defecto el nombre de la base

-M <name>

eliminar una conexión guardada

-k [name]

listar conexiones guardadas o inspeccionar una sin mostrar su contraseña

-K <name>

conectar usando una conexión guardada

-e

desconectarse y borrar los datos de conexión

postgresql : <sql>

ejecutar SQL nativo

postgresql load <file.sql|file.json>

ejecutar SQL o restaurar un volcado JSON lógico de lil

postgresql dump [file.json] [-f]

crear un volcado JSON lógico de las tablas públicas

Empieza por una consulta segura

Conecta con postgresql -c localhost demo shop e introduce la contraseña por separado. -t enumera tablas; -s products, columnas; -n products 2, filas; y -f products shoe 2, coincidencias. Tras : puedes escribir SQL; -o products -csv tmp/products.csv exporta a CSV.

Antes de modificar datos

-w y -d afectan a todas las filas coincidentes: revisa primero el filtro y crea una copia. dump guarda datos en JSON de lil, no esquemas, índices ni roles; no sustituye a pg_dump. Se necesitan el servidor PostgreSQL y la extensión PHP pgsql.

Modelo de trabajo

Las operaciones de inspección y edición puntual usan los mismos atajos que los drivers relacionales.

Copias y restauración

Sin invocar pg_dump, dump crea una instantánea JSON lógica de tablas public; para copias completas use las herramientas nativas de PostgreSQL.

Seguridad

Todo se ejecuta con los privilegios del usuario conectado.

El volcado JSON de lil contiene solo datos y no recrea objetos de esquema ni índices. La restauración JSON es transaccional; las exportaciones o volcados de una tabla con más de 100000 filas se rechazan.

Conexiones guardadas

Sin -m, los datos de conexión permanecen limitados a la sesión PHP actual. -m [name] guarda explícitamente el perfil en el archivo protegido .lil.key (0600), -K <name> vuelve a conectar con él, -k lista o inspecciona perfiles sin revelar una contraseña guardada y -M <name> elimina uno. kill elimina .lil.key junto con el resto del estado del núcleo. Trate el archivo como sensible porque un perfil guardado de forma voluntaria puede contener credenciales de base de datos.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Inspeccionar una tabla PostgreSQL

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install postgresql

Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install postgresql -m

Versión pública exacta

Instalar exactamente esta versión publicada.

install postgresql -v 1.1.4

Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade postgresql

Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install postgresql -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Inspeccionar una tabla PostgreSQL

postgresql

Ejemplo ilustrativo — sin conexión real
A connection is required; the status view names the server and selected database.

Postgresql · localhost

postgresql -c localhost demo shop -n

Ejemplo ilustrativo — sin conexión real
Connection example: server and database will be shown after a successful connection.

Postgresql · localhost

postgresql -c localhost demo shop

Ejemplo ilustrativo — sin conexión real
Password is requested separately; selected database: shop.

Postgresql · localhost

postgresql -c localhost demo shop -p 5433 -n

Ejemplo ilustrativo — sin conexión real
Connection example: server and database will be shown after a successful connection.

Seleccionar otra base de datos reconectando

postgresql -use shop

Ejemplo ilustrativo — sin conexión real
Selected database: shop (requires an active connection)

Listar bases de datos

postgresql -l

Ejemplo ilustrativo — sin conexión real
postgres
shop

Listar tablas y vistas públicas

postgresql -t

Ejemplo ilustrativo — sin conexión real
products  BASE TABLE

Mostrar columnas y tipos de datos

postgresql -s products

Ejemplo ilustrativo — sin conexión real
column_name  data_type
id  bigint
sku  text
name  text
category  text
price  numeric
active  boolean

Previsualizar filas de una tabla

postgresql -n products 2

Ejemplo ilustrativo — sin conexión 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

Buscar texto en las columnas de una tabla

postgresql -f products shoe 2

Ejemplo ilustrativo — sin conexión real
sku=SHOE-1  name=City shoe  category=shoes  price=79.9  active=True

Exportar filas de una tabla

postgresql -o products -j

Ejemplo ilustrativo — sin conexión 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

Ejemplo ilustrativo — sin conexión real
Saved  sandbox/tmp/products.csv (if the destination does not exist)

Postgresql · products

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

Ejemplo ilustrativo — sin conexión real
Saved  sandbox/tmp/products.json (replace existing file only with -f)

Gestionar una tabla ausente

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

Ejemplo ilustrativo — sin conexión real
Inserted  1 (example with a fresh, isolated copy)

Actualizar las filas coincidentes desde un objeto JSON

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

Ejemplo ilustrativo — sin conexión real
Updated  1 (illustrative single matching row)

Eliminar las filas coincidentes

postgresql -d products sku SHOE-1

Ejemplo ilustrativo — sin conexión real
Deleted  1 (example only; all matches would be affected)

Ejecutar SQL nativo

postgresql : SELECT COUNT(*) AS total FROM products

Ejemplo ilustrativo — sin conexión real
total
2

Crear un volcado JSON lógico de las tablas públicas

postgresql dump tmp/shop-pg.json

Ejemplo ilustrativo — sin conexión 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

Ejemplo ilustrativo — sin conexión real
Saved  sandbox/tmp/shop-pg.json
Format  lil-postgresql-json (logical data export, not server backup)

Ejecutar SQL o restaurar un volcado JSON lógico de lil

postgresql load db/postgresql.sql

Ejemplo ilustrativo — sin conexión real
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.

Ejecutar SQL o restaurar un volcado JSON lógico de lil

postgresql load tmp/shop-pg.json

Ejemplo ilustrativo — sin conexión real
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.

Guardar la conexión actual en .lil.key; usar por defecto el nombre de la base

postgresql -m shop-demo

Ejemplo ilustrativo — sin conexión real
Saved  shop-demo (stores a sensitive profile in .lil.key)

Listar conexiones guardadas o inspeccionar una sin mostrar su contraseña

postgresql -k

Ejemplo ilustrativo — sin conexión real
No saved connections (unless a profile has already been saved)

Listar conexiones guardadas o inspeccionar una sin mostrar su contraseña

postgresql -k shop-demo

Ejemplo ilustrativo — sin conexión real
Saved connection not found: shop-demo (unless saved earlier)

Conectar usando una conexión guardada

postgresql -K unknown

Ejemplo ilustrativo — sin conexión real
Saved connection not found: unknown

Eliminar una conexión guardada

postgresql -M unknown

Ejemplo ilustrativo — sin conexión real
Saved connection not found: unknown

Desconectarse y borrar los datos de conexión

postgresql -e

Ejemplo ilustrativo — sin conexión real
+

Postgresql · localhost

postgresql -c localhost demo shop -p 99999 -n

Ejemplo ilustrativo — sin conexión real
Invalid database port

Mostrar columnas y tipos de datos

postgresql -s missing_table

Ejemplo ilustrativo — sin conexión real
Table not found: missing_table

Archivo usado en este ejemplo: `sandbox/db/postgresql.sql`

El ejemplo usa un archivo o directorio del espacio protegido de documentación /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);

Documentación relacionada

¿Con qué bases de datos puedo trabajar desde el terminal? →¿Es seguro mantener lil-terminal en un sitio de producción? →

Versión pública actual

v1.1.42026-11-01

Refinamiento de producción

Versión estable actual de postgresql. postgresql conecta con PostgreSQL, inspecciona tablas y filas, hace cambios puntuales, exporta datos, ejecuta SQL nativo y crea copias lógicas.

# Historial de versiones

postgresql

Resumen

PostgreSQL sin aplanar su modelo

Sintaxis

Referencia

Empieza por una consulta segura

Antes de modificar datos

Modelo de trabajo

Copias y restauración

Seguridad

Conexiones guardadas

Vista interactiva del sandbox

Instalar y administrar

Ejemplos

Archivo usado en este ejemplo: sandbox/db/postgresql.sql

Documentación relacionada

Versión pública actual

Refinamiento de producción

`postgresql`

Archivo usado en este ejemplo: `sandbox/db/postgresql.sql`