db

db lembra um driver instalado e encaminha a ele uma interface compacta comum sem traduzir a linguagem nativa do motor.

Banco de dadosVersão 1.3.3Estável
lil-terminal

Visão geral

Use db como espelho curto e ligado à sessão de um driver instalado: escolha uma vez MySQL/MariaDB, PostgreSQL, Redis, SQLite ou MongoDB e reutilize o mesmo prefixo para inspeção, exportação, backup e comandos nativos.

Um prefixo, motores diferentes

db é um ponto de entrada comum para os drivers de banco de dados instalados, não um mecanismo próprio. Ele lembra o driver escolhido e expõe as operações compartilhadas, enquanto o texto depois de : permanece na linguagem nativa do banco. Assim, o trabalho rotineiro fica curto sem fingir que SQL, estruturas do Redis e documentos do MongoDB são o mesmo modelo.

Sintaxe

lil-terminal
db [driver] [options]

Referência

db

mostrar o driver selecionado e os drivers instalados

db <driver>

selecionar driver: mysql|postgresql|redis|sqlite|mongodb

-c ...

conectar pelo driver selecionado

-use ...

selecionar um banco pelo driver selecionado

-l

listar bancos ou namespaces pelo driver selecionado

-t

listar tabelas, coleções ou chaves pelo driver selecionado

-s <name>

mostrar a estrutura pelo driver selecionado

-n <name> [rows]

pré-visualizar registros pelo driver selecionado

-f <name> <text>

pesquisar pelo driver selecionado

-o <name> ...

exportar pelo driver selecionado

-a ...

adicionar dados pelo driver selecionado

-w ...

atualizar dados pelo driver selecionado

-d ...

excluir dados pelo driver selecionado

-m [name]

salvar a conexão atual pelo driver selecionado

-M <name>

remover uma conexão salva do driver selecionado

-k [name]

listar ou inspecionar conexões salvas do driver selecionado

-K <name>

conectar usando uma conexão salva do driver selecionado

-e

desconectar o driver selecionado

db : <native>

executar a consulta ou comando nativo do driver selecionado

db dump ...

criar um dump pelo driver selecionado

db load <file>

carregar um dump ou script pelo driver selecionado

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 espelho comum também repassa -a, -w e -d para inclusões, atualizações e exclusões pontuais; os argumentos exatos continuam específicos de cada driver.

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.

Escolher SQLite e inspecionar uma tabela

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 db
Pacote Minimum

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

install db -m
Versão pública exata

Instalar exatamente esta versão publicada.

install db -v 1.3.3
Verificar ou atualizar

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

upgrade db
Remover módulo

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

install db -u

Exemplos

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

Escolher SQLite e inspecionar uma tabela
db sqlite | db -c \sandbox\db\shop.sqlite | db -t | db -n products 5
Driver      sqlite
Status      selected

Status      connected
File        sandbox/db/shop.sqlite

products
orders

id	sku	name	category	price	active
1	SHOE-1	City shoe	shoes	79.9	1
2	SHOE-2	Trail shoe	shoes	109	1
3	BAG-1	Canvas bag	bags	44.5	1
Db · 02
db
Driver      sqlite
SQLite      installed · selected
MySQL       installed
PostgreSQL  not installed
Redis       not installed
MongoDB     not installed
Db · mysql
db mysql
Driver  mysql
Status  selected
Engine  MySQL / MariaDB
Db · mariadb
db mariadb
Driver  mysql
Status  selected
Engine  MySQL / MariaDB
Db · products
db -s products
Field     Type       Null  Key
id        INTEGER    no    PRIMARY
sku       TEXT       no    UNIQUE
name      TEXT       no
category  TEXT       no
price     REAL       no
active    INTEGER    no
Db · products
db -f products "shoe"
id	sku	name	category	price
1	SHOE-1	City shoe	shoes	79.9
2	SHOE-2	Trail shoe	shoes	109
Db · products
db -o products -j products.json
Saved  products.json
Db · products
db -a products : {"sku":"TMP-1","name":"Temporary","price":1}
Inserted  1
ID        5
Db · products
db -w products sku TMP-1 : {"price":2}
Updated  1
Db · products
db -d products sku TMP-1
Deleted  1
Db · select
db : SELECT COUNT(*) AS products FROM products
products
4
Db · dump
db dump backup.sql
Saved  backup.sql
Db · -e
db -e
+
Recusar um driver não suportado
db oracle
Driver de banco de dados desconhecido: oracle

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

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /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);

Documentação relacionada

Versão pública atual

v1.3.32026-08-08

Fachada de banco compacta

Agrupa opções comuns, repassa a memória de conexões e mostra o estado dos drivers em colunas compactas.