sqlite

sqlite abre directamente un archivo de base de datos, inspecciona esquema y filas, modifica datos, exporta tablas, ejecuta SQL nativo y crea volcados SQL.

Base de datosVersión 1.1.5Estable
lil-terminal

Resumen

Use sqlite directamente sobre archivos de base de datos: abrir, revisar tablas y columnas, consultar o modificar filas, exportar, ejecutar SQL nativo y crear copias SQL sin servidor aparte.

Una base de datos dentro de un archivo

SQLite es una base SQL relacional guardada en un archivo normal e integrada en el proceso que la abre. No necesita un servidor separado ni un login de red, por lo que resulta excelente para aprender, herramientas locales y muchas aplicaciones pequeñas o medianas. Aun así importan las transacciones, índices, restricciones, permisos del archivo y escrituras concurrentes.

Sintaxis

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

Referencia

sqlite

mostrar el archivo SQLite actual

sqlite -c <file> [-f] [-m [name]]

abrir una base SQLite; -f crea el archivo si no existe

-use <file>

abrir otra base SQLite existente

-l

mostrar los archivos de base adjuntos

-t

listar tablas y vistas

-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 base actual en .lil.key; usar por defecto el nombre del archivo

-M <name>

eliminar una base guardada

-k [name]

listar bases guardadas o inspeccionar una

-K <name>

abrir una base guardada

-e

cerrar el archivo de base seleccionado

sqlite : <sql>

ejecutar SQL nativo

sqlite load <file.sql>

ejecutar SQL desde un archivo

sqlite dump [file.sql] [-f]

crear un volcado de esquema y datos

Para qué sirve

sqlite trabaja con una base de datos en un archivo, sin servidor separado. Necesita la extensión PHP SQLite3 y permisos de archivo.

Pasos prácticos

sqlite -c db/shop.sqlite abre un archivo existente; -f puede crear uno nuevo. -t/-s/-n/-f muestran tablas, columnas, filas y búsquedas. -o exporta JSON/CSV; sqlite : ejecuta SQL y dump/load administran scripts.

Límites y seguridad

Sin -f no se crea un archivo ausente y se rechazan enlaces simbólicos. Guarda una copia antes de modificar datos o usar load. -m guarda opcionalmente la ruta en .lil.key, administrada por -k/-K/-M. La exportación se limita a 100.000 filas.

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.

Abrir un archivo SQLite e inspeccionar datos

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 sqlite
Paquete Minimum

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

install sqlite -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install sqlite -v 1.1.5
Comprobar o actualizar

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

upgrade sqlite
Eliminar módulo

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

install sqlite -u

Ejemplos

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

Abrir un archivo SQLite e inspeccionar datos
sqlite -c db/shop.sqlite
Status  connected
File    sandbox/db/shop.sqlite
SQLite  (version depends on the host)
Mostrar el archivo SQLite actual
sqlite
Status  connected
File    sandbox/db/shop.sqlite
SQLite  (version depends on the host)
Abrir una base SQLite; -f crea el archivo si no existe
sqlite -c db/new-shop.sqlite -f
Status  connected
File    sandbox/db/new-shop.sqlite
SQLite  (version depends on the host)
Abrir una base SQLite; -f crea el archivo si no existe
sqlite -c db/shop.sqlite -m shop-demo
Status  connected
File    sandbox/db/shop.sqlite
SQLite  (version depends on the host)
Saved   shop-demo
Abrir otra base SQLite existente
sqlite -use db/shop.sqlite
Status  connected
File    sandbox/db/shop.sqlite
Mostrar los archivos de base adjuntos
sqlite -l
seq	name	file
0	main	sandbox/db/shop.sqlite
Listar tablas y vistas
sqlite -t
name	type
orders	table
products	table
Mostrar columnas y tipos de datos
sqlite -s products
cid	name	type	notnull	dflt_value	pk
0	id	INTEGER	0	NULL	1
1	sku	TEXT	1	NULL	0
2	name	TEXT	1	NULL	0
3	category	TEXT	1	NULL	0
4	price	REAL	1	NULL	0
5	active	INTEGER	1	1	0
Previsualizar filas de una tabla
sqlite -n products 3
id	sku	name	category	price	active
1	SHOE-1	City shoe	shoes	79.9	1
2	SHOE-2	Trail shoe	shoes	109.0	1
3	BAG-1	Canvas bag	bags	44.5	1
Buscar texto en las columnas de una tabla
sqlite -f products "shoe" 3
id	sku	name	category	price	active
1	SHOE-1	City shoe	shoes	79.9	1
2	SHOE-2	Trail shoe	shoes	109.0	1
Exportar filas de una tabla
sqlite -o products -j
[
  {
    "id": 1,
    "sku": "SHOE-1",
    "name": "City shoe",
    "category": "shoes",
    "price": 79.9,
    "active": 1
  },
  {
    "id": 2,
    "sku": "SHOE-2",
    "name": "Trail shoe",
    "category": "shoes",
    "price": 109.0,
    "active": 1
  },
  {
    "id": 3,
    "sku": "BAG-1",
    "name": "Canvas bag",
    "category": "bags",
    "price": 44.5,
    "active": 1
  },
  {
    "id": 4,
    "sku": "HAT-1",
    "name": "Summer hat",
    "category": "accessories",
    "price": 25.0,
    "active": 0
  }
]
Exportar filas de una tabla
sqlite -o products -csv tmp/products.csv
Saved  sandbox/tmp/products.csv
Gestionar un archivo de base ausente
sqlite -o products -csv tmp/products.csv -f
Saved  sandbox/tmp/products.csv
Insertar una fila desde un objeto JSON
sqlite -a products : {"sku":"NEW-1","name":"Sample","category":"test","price":5,"active":1}
Inserted  1
ID        5
Actualizar las filas coincidentes desde un objeto JSON
sqlite -w products sku HAT-1 : {"price":24}
Updated  1
Eliminar las filas coincidentes
sqlite -d products sku HAT-1
Deleted  1
Ejecutar SQL nativo
sqlite : SELECT category, COUNT(*) AS total FROM products GROUP BY category
category	total
accessories	1
bags	1
shoes	2
Time  (varies) ms
Crear un volcado de esquema y datos
sqlite dump tmp/shop-backup.sql
Saved  sandbox/tmp/shop-backup.sql
Ejecutar SQL desde un archivo
sqlite load db/sqlite.sql
SQLite error: table products already exists
Guardar la base actual en .lil.key; usar por defecto el nombre del archivo
sqlite -m shop-demo
Saved  shop-demo
Listar bases guardadas o inspeccionar una
sqlite -k
No saved connections
Abrir una base guardada
sqlite -K missing
Saved connection not found: missing
Eliminar una base guardada
sqlite -M missing
Saved connection not found: missing
Cerrar el archivo de base seleccionado
sqlite -e
+
Abrir una base SQLite; -f crea el archivo si no existe
sqlite -c db/missing.sqlite
Database file not found
Abrir otra base SQLite existente
sqlite -c db/shop.sqlite -use db/missing.sqlite
Database file not found
Mostrar columnas y tipos de datos
sqlite -s missing_table
Table not found: missing_table

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

El ejemplo usa un archivo o directorio del espacio protegido de documentación /sandbox/.

CREATE TABLE products (
  id INTEGER PRIMARY KEY,
  sku TEXT UNIQUE NOT NULL,
  name TEXT NOT NULL,
  category TEXT NOT NULL,
  price REAL NOT NULL,
  active INTEGER NOT NULL DEFAULT 1
);
INSERT INTO products (sku,name,category,price,active) VALUES
('SHOE-1','City shoe','shoes',79.90,1),
('SHOE-2','Trail shoe','shoes',109.00,1),
('BAG-1','Canvas bag','bags',44.50,1);

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.52026-11-01

Refinamiento de producción

Versión estable actual de sqlite. sqlite abre directamente un archivo de base de datos, inspecciona esquema y filas, modifica datos, exporta tablas, ejecuta SQL nativo y crea volcados SQL.

# Historial de versiones