postgresql

postgresql si collega a PostgreSQL, ispeziona tabelle e righe, applica modifiche mirate, esporta dati, esegue SQL nativo e crea backup logici.

DatabaseVersione 1.1.4Stabile
lil-terminal

Panoramica

Usa postgresql con un flusso coerente: password nascosta, ispezione di schema e righe, modifiche mirate, esportazione, SQL nativo e backup logici senza strumenti shell.

PostgreSQL senza appiattirne il modello

PostgreSQL è un database relazionale client-server con tipizzazione forte, transazioni e un ricco linguaggio SQL nativo. Un database può contenere schemas, che contengono tabelle e altri oggetti: qui “schema” è quindi anche uno spazio dei nomi. La superficie breve copre le attività comuni, mentre : mantiene accessibili le funzioni specifiche di PostgreSQL.

Sintassi

lil-terminal
postgresql [options] · postgresql : <sql>

Riferimento

postgresql

mostrare la connessione PostgreSQL corrente

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

connettersi; la password viene richiesta separatamente salvo con -n

-use <database>

selezionare un altro database riconnettendosi

-l

elencare i database

-t

elencare tabelle e viste pubbliche

-s <table>

mostrare colonne e tipi di dati

-n <table> [rows]

mostrare un’anteprima delle righe

-f <table> <text> [rows]

cercare testo nelle colonne della tabella

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

esportare le righe della tabella

-a <table> : <json>

inserire una riga da un oggetto JSON

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

aggiornare le righe corrispondenti da un oggetto JSON

-d <table> <field> <value>

eliminare le righe corrispondenti

-m [name]

salvare la connessione corrente in .lil.key; usare per default il nome del database

-M <name>

rimuovere una connessione salvata

-k [name]

elencare le connessioni salvate o esaminarne una senza mostrare la password

-K <name>

connettersi usando una connessione salvata

-e

disconnettersi e cancellare i dati di connessione

postgresql : <sql>

eseguire SQL nativo

postgresql load <file.sql|file.json>

eseguire SQL o ripristinare un dump JSON logico lil

postgresql dump [file.json] [-f]

creare un dump JSON logico delle tabelle pubbliche

Inizia con una verifica sicura

Collegati con postgresql -c localhost demo shop e inserisci la password separatamente. -t elenca le tabelle, -s products le colonne, -n products 2 alcune righe, -f products shoe 2 effettua una ricerca. Dopo : puoi inviare SQL; -o products -csv tmp/products.csv esporta in CSV.

Prima di modificare i dati

-w e -d possono modificare tutte le righe corrispondenti: controlla i filtri ed esegui un backup. dump salva solo i dati delle tabelle public in JSON lil, non schemi, indici o ruoli; non sostituisce pg_dump. Occorrono PostgreSQL e l’estensione PHP pgsql.

Modello operativo

Le forme comuni sono riportate nella guida locale. Le scorciatoie coprono ispezione e modifiche mirate; la sintassi nativa resta disponibile per le operazioni avanzate.

Backup e ripristino

dump/load seguono il formato del driver. Per backup completi di tutte le funzioni del motore usare gli strumenti nativi del server.

Sicurezza

Le password vengono inserite in un campo nascosto e non finiscono nella cronologia. Quando possibile usare account con privilegi limitati.

Il dump JSON lil contiene solo dati e non ricrea oggetti di schema o indici. Il ripristino JSON è transazionale; export e dump rifiutano una tabella oltre 100000 righe.

Connessioni salvate

Senza -m, i dati di connessione restano limitati alla sessione PHP corrente. -m [name] salva esplicitamente il profilo nel file protetto .lil.key (0600), -K <name> si riconnette usando quel profilo, -k elenca o esamina i profili senza mostrare una password salvata e -M <name> ne rimuove uno. kill elimina .lil.key insieme al resto dello stato del core. Considera il file sensibile perché un profilo salvato volontariamente può contenere credenziali del database.

Anteprima interattiva del sandbox

Esegui gli esempi preparati direttamente nella pagina. I risultati sono predefiniti e mostrati nel browser; sul server non viene eseguito alcun comando del terminale.

Ispezionare una tabella PostgreSQL

Installa e gestisci

Installa la versione compatibile corrente. Scegli Base per tutte le funzioni o Minimum per il pacchetto ridotto; usa upgrade per aggiornare un modulo già installato.

Base e Minimum sono due pacchetti della stessa release corrente del modulo.

Pacchetto Base

Installa il pacchetto completo con riferimento locale e tutte le modalità pubblicate.

install postgresql
Pacchetto Minimum

Installa il pacchetto ridotto. Il riferimento locale è omesso; help <cmd> -i apre il riferimento server corrente.

install postgresql -m
Versione pubblica esatta

Installa esattamente questa versione pubblicata.

install postgresql -v 1.1.4
Controlla o aggiorna

upgrade controlla la compatibilità e sostituisce il blocco solo quando serve.

upgrade postgresql
Rimuovi modulo

Rimuove il blocco estensione senza toccare core e altri moduli.

install postgresql -u

Esempi

Gli esempi sono copiabili ma il sito non li esegue. Controlla percorsi, permessi e opzioni distruttive.

Ispezionare una tabella PostgreSQL
postgresql
Esempio didattico — nessuna connessione reale
A connection is required; the status view names the server and selected database.
Postgresql · localhost
postgresql -c localhost demo shop -n
Esempio didattico — nessuna connessione reale
Connection example: server and database will be shown after a successful connection.
Postgresql · localhost
postgresql -c localhost demo shop
Esempio didattico — nessuna connessione reale
Password is requested separately; selected database: shop.
Postgresql · localhost
postgresql -c localhost demo shop -p 5433 -n
Esempio didattico — nessuna connessione reale
Connection example: server and database will be shown after a successful connection.
Selezionare un altro database riconnettendosi
postgresql -use shop
Esempio didattico — nessuna connessione reale
Selected database: shop (requires an active connection)
Elencare i database
postgresql -l
Esempio didattico — nessuna connessione reale
postgres
shop
Elencare tabelle e viste pubbliche
postgresql -t
Esempio didattico — nessuna connessione reale
products  BASE TABLE
Mostrare colonne e tipi di dati
postgresql -s products
Esempio didattico — nessuna connessione reale
column_name  data_type
id  bigint
sku  text
name  text
category  text
price  numeric
active  boolean
Mostrare un’anteprima delle righe
postgresql -n products 2
Esempio didattico — nessuna connessione reale
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
Cercare testo nelle colonne della tabella
postgresql -f products shoe 2
Esempio didattico — nessuna connessione reale
sku=SHOE-1  name=City shoe  category=shoes  price=79.9  active=True
Esportare le righe della tabella
postgresql -o products -j
Esempio didattico — nessuna connessione reale
[
  {
    "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
Esempio didattico — nessuna connessione reale
Saved  sandbox/tmp/products.csv (if the destination does not exist)
Postgresql · products
postgresql -o products -j tmp/products.json -f
Esempio didattico — nessuna connessione reale
Saved  sandbox/tmp/products.json (replace existing file only with -f)
Gestire una tabella mancante
postgresql -a products : {"sku":"NEW-1","name":"Sample","category":"test","price":5,"active":true}
Esempio didattico — nessuna connessione reale
Inserted  1 (example with a fresh, isolated copy)
Aggiornare le righe corrispondenti da un oggetto JSON
postgresql -w products sku SHOE-1 : {"price":75}
Esempio didattico — nessuna connessione reale
Updated  1 (illustrative single matching row)
Eliminare le righe corrispondenti
postgresql -d products sku SHOE-1
Esempio didattico — nessuna connessione reale
Deleted  1 (example only; all matches would be affected)
Eseguire SQL nativo
postgresql : SELECT COUNT(*) AS total FROM products
Esempio didattico — nessuna connessione reale
total
2
Creare un dump JSON logico delle tabelle pubbliche
postgresql dump tmp/shop-pg.json
Esempio didattico — nessuna connessione reale
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
Esempio didattico — nessuna connessione reale
Saved  sandbox/tmp/shop-pg.json
Format  lil-postgresql-json (logical data export, not server backup)
Eseguire SQL o ripristinare un dump JSON logico lil
postgresql load db/postgresql.sql
Esempio didattico — nessuna connessione reale
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.
Eseguire SQL o ripristinare un dump JSON logico lil
postgresql load tmp/shop-pg.json
Esempio didattico — nessuna connessione reale
SQL/JSON import requires an existing schema; running the supplied CREATE TABLE twice causes a conflict.
Salvare la connessione corrente in .lil.key; usare per default il nome del database
postgresql -m shop-demo
Esempio didattico — nessuna connessione reale
Saved  shop-demo (stores a sensitive profile in .lil.key)
Elencare le connessioni salvate o esaminarne una senza mostrare la password
postgresql -k
Esempio didattico — nessuna connessione reale
No saved connections (unless a profile has already been saved)
Elencare le connessioni salvate o esaminarne una senza mostrare la password
postgresql -k shop-demo
Esempio didattico — nessuna connessione reale
Saved connection not found: shop-demo (unless saved earlier)
Connettersi usando una connessione salvata
postgresql -K unknown
Esempio didattico — nessuna connessione reale
Saved connection not found: unknown
Rimuovere una connessione salvata
postgresql -M unknown
Esempio didattico — nessuna connessione reale
Saved connection not found: unknown
Disconnettersi e cancellare i dati di connessione
postgresql -e
Esempio didattico — nessuna connessione reale
+
Postgresql · localhost
postgresql -c localhost demo shop -p 99999 -n
Esempio didattico — nessuna connessione reale
Invalid database port
Mostrare colonne e tipi di dati
postgresql -s missing_table
Esempio didattico — nessuna connessione reale
Table not found: missing_table

File usato in questo esempio: sandbox/db/postgresql.sql

L’esempio usa un file o una directory dell’area di documentazione protetta /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);

Documentazione correlata

Con quali database posso lavorare dal terminale? →È sicuro lasciare lil-terminal su un sito di produzione? →

Versione pubblica attuale

v1.1.42026-11-01

Rifinitura di produzione

Versione stabile attuale di postgresql. postgresql si collega a PostgreSQL, ispeziona tabelle e righe, applica modifiche mirate, esporta dati, esegue SQL nativo e crea backup logici.

# Cronologia versioni