O que é o SQLite Manager

O SQLite Manager abre, consulta, edita e salva bancos de dados SQLite usando apenas o navegador. Ele é um único arquivo HTML: não há instalação, servidor nem conta. ^[1] O motor do banco é o próprio SQLite, compilado para WebAssembly e embutido no arquivo. ^[2]

Abrir o SQLite Manager →

Este manual serve para quem quer gerenciar um banco sem instalar nada. As tarefas do dia a dia não exigem SQL; a aba SQL atende quem já conhece a linguagem.

O que você precisa

• Um navegador atual. Chrome e Edge são os recomendados, porque gravam direto no arquivo original.
• O arquivo sqlite-manager.html. Use o link acima ou salve a página e abra a cópia, que funciona sem internet.

Como o app trata os seus dados

• Nada sai do seu computador. O banco é processado dentro do navegador, e o arquivo HTML bloqueia conexões de rede.
• O banco é editado na memória. O arquivo em disco só muda quando você salva.
• O navegador guarda poucas coisas. Tema, tamanho de página, texto do editor SQL e histórico de consultas ficam no armazenamento local. O conteúdo do banco não fica, mas valores escritos em consultas ficam no histórico.

Primeiros passos

Em cerca de dez minutos, este roteiro passa pelas principais funções usando o banco de exemplo, sem risco para dados reais. O exemplo tem clientes, produtos, pedidos e itens de pedido.

1. Abra o exemplo

1. Abra o SQLite Manager.
2. Clique em Banco de exemplo. A tabela clientes aparece na aba Dados.

2. Encontre um registro

1. Na linha de filtros, abaixo do título da coluna cidade, digite recife. Sobra apenas Carla Nunes.
2. Apague o filtro para ver as cinco linhas de novo.
3. Clique no título da coluna nome para ordenar. Clique de novo para inverter e uma terceira vez para desfazer.

3. Edite e insira dados

1. Dê um duplo clique na cidade de Ana Ribeiro, digite Campinas e pressione Enter. O aviso ● não salvo aparece na barra superior.
2. Clique em + Linha, preencha nome e clique em Inserir. As demais colunas recebem o valor padrão.

4. Siga uma referência

1. Na lista à esquerda, clique em pedidos.
2. Na coluna cliente_id, clique na seta ↗ ao lado de um valor. O app abre clientes filtrada nesse cliente.

5. Execute SQL

1. Abra a aba SQL, escreva a consulta abaixo e pressione Ctrl+Enter. O resultado mostra o total por cliente.

   SELECT * FROM vw_total_por_cliente;

2. Troque o texto pelo comando abaixo e execute. A mensagem informa 2 linhas alteradas: o item inserido e o estoque baixado pelo trigger trg_baixa_estoque.

   INSERT INTO itens_pedido VALUES (4, 1, 1, 349.9);

3. Clique em produtos. A aba Dados abre, e o estoque do teclado caiu de 39 para 38.

6. Desfaça ou salve

1. Para desfazer tudo, clique em Reverter e confirme. O exemplo volta ao estado inicial.
2. Para guardar uma cópia, clique em Salvar e escolha onde gravar.

A interface

A tela tem quatro áreas fixas, e as quatro abas mudam apenas a área central. Depois de aberto um banco, a tela fica assim:

Barra superior

Arquivo (Novo, Abrir…, Salvar, Salvar como…, Reverter), Importar CSV…, Exportar .sql e o botão ◐, que alterna entre tema claro e escuro.

Lista de objetos

Tabelas, views, índices, triggers e tabelas do sistema, com o número de linhas de cada tabela. O campo acima filtra a lista, e + Tabela cria uma tabela.

Abas

Dados mostra as linhas, Estrutura mostra e altera o esquema, SQL executa comandos e Banco traz informações e manutenção.

Barra de status

Versão do SQLite, tamanho do banco, aviso de transação aberta e a opção Chaves estrangeiras.

Abrir, salvar e reverter

Tudo o que você faz altera uma cópia na memória; o arquivo em disco só muda quando você salva. Esse é o conceito mais importante do app:

Abrir ou criar um banco

Se o banco atual tiver alterações não salvas, o app pede confirmação antes de trocar. Arquivos que não são SQLite, ou que estão criptografados, são recusados, e o banco atual continua aberto.

Salvar

O indicador ● não salvo mostra que há alterações só na memória. O app também avisa se você tentar fechar a aba nessa situação.

No Chrome e no Edge, se outro programa tiver alterado o arquivo depois da abertura, o app pede confirmação antes de substituir. Para manter as duas versões, cancele e use Salvar como….

Reverter

Reverter descarta tudo o que foi feito desde a abertura ou o último salvamento. É o único “desfazer” do app: não há desfazer passo a passo. Antes de uma alteração arriscada, salve; assim, o ponto de retorno fica logo antes dela.

Bancos em modo WAL

Alguns programas usam o modo WAL, que mantém alterações recentes em um arquivo -wal ao lado do banco. ^[5] O navegador recebe apenas o arquivo principal, então o app avisa ao abrir e toma duas medidas:

• Abre o banco sem o conteúdo do -wal. Para ver os dados mais recentes, feche antes o programa que usa o banco.
• Não grava sobre o original. Salvar pede um arquivo novo, e a sugestão de nome termina em -copia. Não sobrescreva o original, porque um -wal antigo ao lado dele pode corromper os dados.

Aba Dados

A aba Dados mostra as linhas da tabela ou view selecionada, e nela você busca, edita, insere e exclui sem escrever SQL.

Navegar e ordenar

• Os controles abaixo da grade trocam de página. Escolha 50, 100, 500 ou 1000 linhas por página.
• Clique no título de uma coluna para ordenar: crescente, decrescente e sem ordem. A ordenação usa uma coluna por vez.
• O marcador PK identifica colunas da chave primária.
• Valores nulos aparecem como NULL em itálico, e dados binários como BLOB com o tamanho.

Filtrar e buscar

Cada coluna tem um campo de filtro, e filtros em colunas diferentes valem juntos. O campo Buscar em todas as colunas procura o texto em qualquer coluna. Limpar filtros remove tudo.

Editar uma célula

Dê um duplo clique na célula. Com o teclado, clique uma vez, mova-se com as setas e pressione Enter ou F2.

A diferença entre NULL e texto vazio importa. Numa célula NULL, confirmar sem digitar mantém o NULL. Para gravar texto vazio nela, use a aba SQL. Numa célula com valor, apagar o texto e salvar grava texto vazio.

O SQLite converte o valor conforme o tipo da coluna: 42 vira número numa coluna INTEGER. ^[3] Um texto como abc pode ser aceito na mesma coluna, a menos que a tabela seja STRICT.

Trabalhar com BLOBs

Dados binários não são editados como texto. O editor mostra o conteúdo em hexadecimal ou, em imagens PNG, JPEG, GIF e WebP, uma prévia. Use Baixar para extrair o arquivo e Arquivo… para substituí-lo.

Inserir linhas

Clique em + Linha. Cada coluna tem um modo, e digitar muda o modo para valor automaticamente:

• valor grava o que foi digitado, mesmo vazio.
• NULL grava nulo.
• padrão deixa o SQLite decidir: gera o número da chave automática, aplica o DEFAULT ou grava NULL.

Marque Continuar adicionando para inserir várias linhas em sequência. Colunas geradas não aparecem no formulário. Para gravar um BLOB, insira a linha e depois edite a célula.

Excluir linhas

1. Marque as caixas das linhas desejadas. A caixa do cabeçalho marca toda a página.
2. Clique em Excluir e confirme.

A exclusão é tudo ou nada: se uma linha falhar, nenhuma é excluída. A seleção vale só para a página atual e é limpa ao mudar de página, filtrar, ordenar ou editar.

Seguir chaves estrangeiras

Colunas com chave estrangeira mostram ↗ ao lado do valor. O clique abre a tabela referenciada, filtrada no registro correspondente.

Quando a grade é somente leitura

Views nunca são editáveis nesta aba. Colunas geradas também não. Uma tabela fica somente leitura quando não há como identificar suas linhas: sem chave primária e com colunas chamadas rowid, _rowid_ e oid. Nesse caso, use a aba SQL.

Aba Estrutura

A aba Estrutura mostra o esquema do objeto selecionado e altera tabelas, colunas e índices sem escrever SQL.

Criar uma tabela

1. Clique em + Tabela e dê um nome à tabela.
2. Preencha uma linha por coluna. A primeira já vem como id INTEGER com chave primária.
3. Confira o comando em SQL que será executado e clique em Criar tabela.

PK

Chave primária. Marque em mais de uma coluna para criar uma chave composta.

Auto

Acrescenta AUTOINCREMENT. Exige uma única coluna PK do tipo INTEGER.

Not null

A coluna não aceita NULL.

Único

Não permite valores repetidos.

Padrão

Valor usado quando nada é informado. Números, NULL, CURRENT_TIMESTAMP, textos entre aspas simples e expressões entre parênteses são usados como estão; o restante vira texto.

Referência

Chave estrangeira, no formato tabela(coluna).

Alterar uma tabela existente

Mudar o tipo de uma coluna

O SQLite não altera o tipo de uma coluna diretamente. ^[6] Recrie a tabela na aba SQL, dentro de uma transação. O botão Abrir no editor SQL copia o DDL atual para servir de ponto de partida.

-- Exemplo: a coluna idade de contatos passa de TEXT para INTEGER
BEGIN;
CREATE TABLE contatos_novo (id INTEGER PRIMARY KEY, nome TEXT, idade INTEGER);
INSERT INTO contatos_novo SELECT id, nome, idade FROM contatos;
DROP TABLE contatos;
ALTER TABLE contatos_novo RENAME TO contatos;
COMMIT;

Recrie depois os índices e triggers da tabela, porque DROP TABLE os remove. Se outras tabelas a referenciarem, desligue Chaves estrangeiras antes do BEGIN; ligue de novo ao terminar e rode Verificar chaves estrangeiras.

Views e triggers

Crie views e triggers na aba SQL. Depois, eles aparecem na lista de objetos, onde a aba Estrutura mostra o DDL e permite excluí-los.

Aba SQL

A aba SQL executa qualquer comando que o SQLite aceite, um ou vários de cada vez, e mostra os resultados abaixo do editor.

Executar comandos

• Ctrl+Enter ou ▶ Executar rodam todo o texto. Com um trecho selecionado, roda só o trecho.
• Separe vários comandos com ;. Cada consulta gera uma aba de resultado.
• Se um comando falhar, a execução para ali e o erro indica qual foi. Os comandos anteriores continuam aplicados; para evitar isso, use uma transação.
• A contagem de linhas alteradas inclui as mudanças feitas por triggers.

Escrever mais rápido

• As sugestões aparecem a partir de duas letras, ou logo após um ponto, como em c., e reconhecem apelidos de tabela.
• Ctrl+Espaço abre as sugestões. ↑ e ↓ escolhem, Tab ou Enter aceitam e Esc fecha.
• Fora das sugestões, Tab insere dois espaços.
• O texto do editor continua lá quando você reabre o app.

Resultados

Os resultados são paginados de 200 em 200 linhas, e os botões CSV e JSON exportam o conjunto todo. Cada consulta guarda até 100.000 linhas e avisa quando o limite é atingido. Para resultados maiores, refine a consulta ou use LIMIT.

Plano de execução

Plano de execução mostra como o SQLite resolveria o primeiro comando, sem executá-lo. Nos planos, SCAN indica leitura da tabela inteira e SEARCH, em geral, uso de índice ou chave.

Transações

Use transações para aplicar várias mudanças como uma só. Depois de BEGIN, a barra de status mostra Transação aberta com os botões COMMIT e ROLLBACK.

BEGIN;
UPDATE produtos SET preco = preco * 1.10 WHERE categoria = 'Acessórios';
-- confira o resultado e clique em COMMIT ou ROLLBACK na barra de status

Edições feitas na aba Dados durante a transação fazem parte dela. Ao salvar com uma transação aberta, o app pergunta se deve fazer COMMIT ou ROLLBACK antes.

Histórico e arquivos

• Histórico ▾ guarda os últimos 50 comandos executados. O clique os devolve ao editor.
• Abrir .sql… carrega um script no editor sem executá-lo, e Baixar .sql salva o texto do editor.
• Limpar apaga o texto do editor.

Exemplos úteis

-- Criar uma view
CREATE VIEW vw_estoque_baixo AS
  SELECT nome, estoque FROM produtos WHERE estoque < 20;

-- Criar um trigger
CREATE TRIGGER trg_status AFTER UPDATE OF status ON pedidos
BEGIN
  UPDATE pedidos SET data = date('now') WHERE id = NEW.id;
END;

-- Encontrar valores duplicados
SELECT email, count(*) FROM clientes
GROUP BY email HAVING count(*) > 1;

-- Gravar texto vazio numa célula NULL
UPDATE clientes SET email = '' WHERE id = 5;

Importar e exportar

O app importa CSV e exporta CSV, JSON, SQL e o próprio arquivo do banco. A importação é tudo ou nada: se uma linha falhar, nada é gravado.

Importar um CSV

1. Clique em Importar CSV… e escolha o arquivo, que deve estar em UTF-8.
2. Confira o Separador, detectado automaticamente entre vírgula, ponto e vírgula, tab e barra vertical.
3. Em Destino, escolha Criar tabela nova ou Adicionar em uma tabela existente.
4. Ajuste Primeira linha é o cabeçalho e Campos vazios viram NULL, confira a prévia e clique em Importar.

Em tabela nova, o app escolhe o tipo de cada coluna entre INTEGER, REAL e TEXT, olhando os valores. Valores com zero à esquerda, como o CEP 01310, continuam como texto e não perdem o zero. Números com vírgula decimal, como 7,5, também ficam como texto.

Em tabela existente, se todos os nomes do cabeçalho existirem na tabela, as colunas são ligadas pelo nome. Caso contrário, são ligadas pela posição.

Exportar

Para fazer cópia de segurança, prefira Salvar como…, que preserva o banco por completo.

CSV

UTF-8 com marca BOM e separado por vírgula. NULL vira campo vazio e BLOB vira 0x mais hexadecimal. Se o Excel juntar tudo numa coluna, importe pelo menu de dados dele e indique a vírgula.

JSON

Lista de objetos. BLOB vira {"$hex": "..."}, e inteiros grandes demais para JavaScript viram texto, para não perder precisão.

SQL

Comandos INSERT; no banco inteiro, também o CREATE de cada objeto, dentro de uma transação.

Aba Banco

A aba Banco resume o arquivo e reúne as verificações e a manutenção. Vale consultá-la antes de um salvamento importante.

VACUUM e ANALYZE alteram o banco, então é preciso salvar depois. VACUUM não roda com uma transação aberta.

Chaves estrangeiras

A opção Chaves estrangeiras, na barra de status, vem ligada, ao contrário do padrão do SQLite. ^[4] Assim, excluir um registro referenciado por outra tabela dá erro, em vez de deixar dados órfãos. A escolha vale para o app e não fica gravada no arquivo. Ela não muda durante uma transação.

Atalhos de teclado

Limitações e solução de problemas

Limitações

• Bancos grandes: o arquivo inteiro é carregado na memória, então bancos de vários gigabytes não são adequados.
• Consultas longas: a tela fica travada até a consulta terminar.
• Acesso simultâneo: o app trabalha numa cópia e não enxerga mudanças que outro programa faça depois da abertura.
• Navegadores: o app foi testado no Chromium. O uso no Firefox e no Safari não foi testado.
• Bancos criptografados: não são suportados.

Problemas comuns

Revisão rápida

Tente responder antes de abrir cada pergunta.

Referências

1. Giovani Perotto Mesquita, “SQLite Manager”, aplicativo em um único arquivo HTML, giovanipm.github.io/sqlite-manager.html.
2. sql.js (em inglês), “sql.js: SQLite compiled to JavaScript”, acesso em 30/10/2026, github.com/sql-js/sql.js.
3. SQLite (em inglês), “Datatypes In SQLite”, documentação do SQLite, acesso em 30/10/2026, sqlite.org/datatype3.html.
4. SQLite (em inglês), “SQLite Foreign Key Support”, documentação do SQLite, acesso em 30/10/2026, sqlite.org/foreignkeys.html.
5. SQLite (em inglês), “Write-Ahead Logging”, documentação do SQLite, acesso em 30/10/2026, sqlite.org/wal.html.
6. SQLite (em inglês), “ALTER TABLE”, documentação do SQLite, acesso em 30/10/2026, sqlite.org/lang_altertable.html.
7. MDN Web Docs (em inglês), “File System API”, acesso em 30/10/2026, developer.mozilla.org/en-US/docs/Web/API/File_System_API.

What SQLite Manager is

SQLite Manager opens, queries, edits and saves SQLite databases using only your browser. It is a single HTML file: no installation, server or account. ^[1] The database engine is SQLite itself, compiled to WebAssembly and embedded in the file. ^[2]

Open SQLite Manager →

This manual is for anyone who wants to manage a database without installing anything. Everyday tasks need no SQL; the SQL tab serves those who already know the language.

What you need

• A current browser. Chrome and Edge are recommended, because they write directly to the original file.
• The file sqlite-manager.html. Use the link above, or save the page and open your copy, which works offline.

How the app handles your data

• Nothing leaves your computer. The database is processed inside the browser, and the HTML file blocks network connections.
• The database is edited in memory. The file on disk changes only when you save.
• The browser keeps a few things. Theme, page size, SQL editor text and query history stay in local storage. The database contents do not, but values written in queries do stay in the history.

Getting started

In about ten minutes, this walkthrough covers the main features using the sample database, with no risk to real data. The sample holds customers (clientes), products (produtos), orders (pedidos) and order items (itens_pedido).

1. Open the sample

1. Open SQLite Manager.
2. Click Banco de exemplo (sample database). The clientes table appears in the Dados (data) tab.

2. Find a record

1. In the filter row, under the title of the cidade (city) column, type recife. Only Carla Nunes remains.
2. Delete the filter to see all five rows again.
3. Click the title of the nome (name) column to sort. Click again to reverse and a third time to undo the sort.

3. Edit and insert data

1. Double-click Ana Ribeiro's city, type Campinas and press Enter. The ● não salvo (not saved) indicator appears in the top bar.
2. Click + Linha (add row), fill in nome and click Inserir (insert). The other columns get their default value.

4. Follow a reference

1. In the list on the left, click pedidos.
2. In the cliente_id column, click the ↗ arrow next to a value. The app opens clientes filtered on that customer.

5. Run SQL

1. Open the SQL tab, type the query below and press Ctrl+Enter. The result shows the total per customer.

   SELECT * FROM vw_total_por_cliente;

2. Replace the text with the command below and run it. The message reports 2 changed rows: the inserted item and the stock reduced by the trg_baixa_estoque trigger.

   INSERT INTO itens_pedido VALUES (4, 1, 1, 349.9);

3. Click produtos. The Dados tab opens, and the keyboard's stock (estoque) has dropped from 39 to 38.

6. Undo or save

1. To undo everything, click Reverter (revert) and confirm. The sample returns to its initial state.
2. To keep a copy, click Salvar (save) and choose where to write it.

The interface

The screen has four fixed areas, and the four tabs change only the central one. Once a database is open, the screen looks like this:

Top bar

File actions, CSV import, SQL export and the ◐ button, which switches between light and dark themes.

Object list

Tables, views, indexes, triggers and system tables, with each table's row count. The field above it filters the list, and + Tabela creates a table.

Tabs

Dados shows the rows, Estrutura shows and changes the schema, SQL runs commands and Banco holds information and maintenance.

Status bar

SQLite version, database size, open-transaction notice and the Chaves estrangeiras option.

Button names

Opening, saving and reverting

Everything you do changes a copy in memory; the file on disk changes only when you save. This is the most important idea in the app:

Opening or creating a database

If the current database has unsaved changes, the app asks for confirmation before switching. Files that are not SQLite, or that are encrypted, are refused, and the current database stays open.

Saving

The ● não salvo indicator shows that some changes exist only in memory. The app also warns you if you try to close the tab in that state.

In Chrome and Edge, if another program changed the file after it was opened, the app asks for confirmation before replacing it. To keep both versions, cancel and use Salvar como….

Reverting

Reverter discards everything done since opening or the last save. It is the app's only “undo”: there is no step-by-step undo. Save before a risky change, so that the return point sits just before it.

Databases in WAL mode

Some programs use WAL mode, which keeps recent changes in a -wal file next to the database. ^[5] The browser receives only the main file, so the app warns you on opening and takes two measures:

• It opens the database without the contents of the -wal file. To see the latest data, first close the program that uses the database.
• It does not write over the original. Salvar asks for a new file, and the suggested name ends in -copia. Do not overwrite the original, because an old -wal file next to it can corrupt the data.

The Dados (data) tab

The Dados tab shows the rows of the selected table or view, and there you search, edit, insert and delete without writing SQL.

Browsing and sorting

• The controls below the grid change pages. Choose 50, 100, 500 or 1000 rows per page.
• Click a column title to sort: ascending, descending and unsorted. Sorting uses one column at a time.
• The PK marker identifies primary-key columns.
• Null values appear as NULL in italics, and binary data as BLOB with its size.

Filtering and searching

Each column has a filter field, and filters on different columns apply together. The Buscar em todas as colunas field searches for text in any column. Limpar filtros removes them all.

Editing a cell

Double-click the cell. With the keyboard, click once, move with the arrows and press Enter or F2.

The difference between NULL and empty text matters. In a NULL cell, confirming without typing keeps the NULL. To write empty text there, use the SQL tab. In a cell with a value, deleting the text and saving writes empty text.

SQLite converts the value according to the column type: 42 becomes a number in an INTEGER column. ^[3] Text such as abc may be accepted in the same column, unless the table is STRICT.

Working with BLOBs

Binary data is not edited as text. The editor shows the contents in hexadecimal or, for PNG, JPEG, GIF and WebP images, a preview. Use Baixar (download) to extract the file and Arquivo… to replace it.

Inserting rows

Click + Linha. Each column has a mode, and typing switches it to valor automatically:

• valor (value) writes what was typed, even if empty.
• NULL writes null.
• padrão (default) lets SQLite decide: it generates the automatic key number, applies the DEFAULT or writes NULL.

Tick Continuar adicionando (keep adding) to insert several rows in a row. Generated columns do not appear in the form. To write a BLOB, insert the row and then edit the cell.

Deleting rows

1. Tick the boxes of the rows you want. The header box ticks the whole page.
2. Click Excluir (delete) and confirm.

Deletion is all or nothing: if one row fails, none is deleted. The selection applies only to the current page and is cleared when you change pages, filter, sort or edit.

Following foreign keys

Columns with a foreign key show ↗ next to the value. Clicking it opens the referenced table, filtered on the matching record.

When the grid is read-only

Views are never editable in this tab, and neither are generated columns. A table is read-only when its rows cannot be identified: it has no primary key and has columns named rowid, _rowid_ and oid. In that case, use the SQL tab.

The Estrutura (structure) tab

The Estrutura tab shows the schema of the selected object and changes tables, columns and indexes without writing SQL.

Creating a table

1. Click + Tabela and name the table.
2. Fill in one line per column. The first already comes as id INTEGER with a primary key.
3. Check the command under SQL que será executado (SQL to be run) and click Criar tabela (create table).

PK

Primary key. Tick it on more than one column to create a composite key.

Auto

Adds AUTOINCREMENT. Requires a single PK column of type INTEGER.

Not null

The column does not accept NULL.

Único (unique)

Does not allow repeated values.

Padrão (default)

Value used when none is given. Numbers, NULL, CURRENT_TIMESTAMP, text in single quotes and expressions in parentheses are used as they are; anything else becomes text.

Referência (reference)

Foreign key, in the format table(column).

Changing an existing table

Changing a column's type

SQLite does not change a column's type directly. ^[6] Recreate the table in the SQL tab, inside a transaction. The Abrir no editor SQL (open in SQL editor) button copies the current DDL as a starting point.

-- Example: the idade column of contatos changes from TEXT to INTEGER
BEGIN;
CREATE TABLE contatos_novo (id INTEGER PRIMARY KEY, nome TEXT, idade INTEGER);
INSERT INTO contatos_novo SELECT id, nome, idade FROM contatos;
DROP TABLE contatos;
ALTER TABLE contatos_novo RENAME TO contatos;
COMMIT;

Then recreate the table's indexes and triggers, because DROP TABLE removes them. If other tables reference it, turn off Chaves estrangeiras before BEGIN; turn it back on when done and run Verificar chaves estrangeiras.

Views and triggers

Create views and triggers in the SQL tab. They then appear in the object list, where the Estrutura tab shows the DDL and lets you delete them.

The SQL tab

The SQL tab runs any command SQLite accepts, one or several at a time, and shows the results below the editor.

Running commands

• Ctrl+Enter or ▶ Executar run all the text. With a passage selected, only that passage runs.
• Separate commands with ;. Each query creates a result tab.
• If a command fails, execution stops there and the error says which one. Earlier commands remain applied; to avoid that, use a transaction.
• The count of changed rows includes changes made by triggers.

Writing faster

• Suggestions appear after two letters, or right after a dot, as in c., and they recognise table aliases.
• Ctrl+Space opens the suggestions. ↑ and ↓ choose, Tab or Enter accept and Esc closes.
• Outside the suggestions, Tab inserts two spaces.
• The editor text is still there when you reopen the app.

Results

Results are paged 200 rows at a time, and the CSV and JSON buttons export the whole set. Each query keeps up to 100,000 rows and warns you when it reaches the limit. For larger results, refine the query or use LIMIT.

Query plan

Plano de execução shows how SQLite would resolve the first command, without running it. In plans, SCAN means reading the whole table and SEARCH generally means using an index or key.

Transactions

Use transactions to apply several changes as one. After BEGIN, the status bar shows Transação aberta (open transaction) with the COMMIT and ROLLBACK buttons.

BEGIN;
UPDATE produtos SET preco = preco * 1.10 WHERE categoria = 'Acessórios';
-- check the result, then click COMMIT or ROLLBACK in the status bar

Edits made in the Dados tab during the transaction are part of it. If you save with a transaction open, the app asks whether to COMMIT or ROLLBACK first.

History and files

• Histórico ▾ keeps the last 50 commands run. Clicking one returns it to the editor.
• Abrir .sql… loads a script into the editor without running it, and Baixar .sql saves the editor text.
• Limpar clears the editor text.

Useful examples

-- Create a view
CREATE VIEW vw_estoque_baixo AS
  SELECT nome, estoque FROM produtos WHERE estoque < 20;

-- Create a trigger
CREATE TRIGGER trg_status AFTER UPDATE OF status ON pedidos
BEGIN
  UPDATE pedidos SET data = date('now') WHERE id = NEW.id;
END;

-- Find duplicate values
SELECT email, count(*) FROM clientes
GROUP BY email HAVING count(*) > 1;

-- Write empty text in a NULL cell
UPDATE clientes SET email = '' WHERE id = 5;

Importing and exporting

The app imports CSV and exports CSV, JSON, SQL and the database file itself. Importing is all or nothing: if one row fails, nothing is written.

Importing a CSV

1. Click Importar CSV… and choose the file, which must be in UTF-8.
2. Check the Separador (separator), detected automatically among comma, semicolon, tab and vertical bar.
3. Under Destino (destination), choose Criar tabela nova (new table) or Adicionar em (add to) an existing table.
4. Set Primeira linha é o cabeçalho (first line is the header) and Campos vazios viram NULL (empty fields become NULL), check the preview and click Importar.

In a new table, the app chooses each column's type among INTEGER, REAL and TEXT by looking at the values. Values with a leading zero, such as the postal code 01310, stay as text and keep the zero. Numbers with a decimal comma, such as 7,5, also stay as text.

In an existing table, if all the header names exist in the table, columns are matched by name. Otherwise they are matched by position.

Exporting

For a backup, prefer Salvar como…, which preserves the database in full.

CSV

UTF-8 with a BOM, comma-separated. NULL becomes an empty field and BLOB becomes 0x plus hexadecimal. If Excel puts everything in one column, import through its data menu and specify the comma.

JSON

A list of objects. BLOB becomes {"$hex": "..."}, and integers too large for JavaScript become text, so as not to lose precision.

SQL

INSERT commands; for the whole database, also each object's CREATE, inside a transaction.

The Banco (database) tab

The Banco tab summarises the file and gathers the checks and maintenance. It is worth a look before an important save.

VACUUM and ANALYZE change the database, so you need to save afterwards. VACUUM does not run with a transaction open.

Foreign keys

The Chaves estrangeiras option in the status bar comes on, unlike SQLite's default. ^[4] So deleting a record referenced by another table gives an error, instead of leaving orphan data. The choice applies to the app and is not written to the file. It does not change during a transaction.

Keyboard shortcuts

Limitations and troubleshooting

Limitations

• Large databases: the whole file is loaded into memory, so databases of several gigabytes are not suitable.
• Long queries: the screen freezes until the query finishes.
• Concurrent access: the app works on a copy and does not see changes another program makes after opening.
• Browsers: the app was tested in Chromium. Use in Firefox and Safari has not been tested.
• Encrypted databases: not supported.

Common problems

Quick review

Try to answer before opening each question.

References

1. Giovani Perotto Mesquita, “SQLite Manager”, single-file HTML application, giovanipm.github.io/sqlite-manager.html.
2. sql.js “sql.js: SQLite compiled to JavaScript”, accessed on 30 October 2026, github.com/sql-js/sql.js.
3. SQLite “Datatypes In SQLite”, SQLite documentation, accessed on 30 October 2026, sqlite.org/datatype3.html.
4. SQLite “SQLite Foreign Key Support”, SQLite documentation, accessed on 30 October 2026, sqlite.org/foreignkeys.html.
5. SQLite “Write-Ahead Logging”, SQLite documentation, accessed on 30 October 2026, sqlite.org/wal.html.
6. SQLite “ALTER TABLE”, SQLite documentation, accessed on 30 October 2026, sqlite.org/lang_altertable.html.
7. MDN Web Docs “File System API”, accessed on 30 October 2026, developer.mozilla.org/en-US/docs/Web/API/File_System_API.

Che cos'è SQLite Manager

SQLite Manager apre, interroga, modifica e salva database SQLite usando solo il browser. È un unico file HTML: niente installazione, server o account. ^[1] Il motore del database è lo stesso SQLite, compilato in WebAssembly e incorporato nel file. ^[2]

Apri SQLite Manager →

Questo manuale è per chi vuole gestire un database senza installare nulla. Le attività quotidiane non richiedono SQL; la scheda SQL è per chi conosce già il linguaggio.

Che cosa serve

• Un browser aggiornato. Sono consigliati Chrome ed Edge, perché scrivono direttamente nel file originale.
• Il file sqlite-manager.html. Usa il link qui sopra, oppure salva la pagina e apri la copia, che funziona senza internet.

Come l'app tratta i tuoi dati

• Nulla esce dal tuo computer. Il database viene elaborato nel browser, e il file HTML blocca le connessioni di rete.
• Il database viene modificato in memoria. Il file su disco cambia solo quando salvi.
• Il browser conserva poche cose. Tema, dimensione della pagina, testo dell'editor SQL e cronologia delle query restano nella memoria locale. Il contenuto del database no, ma i valori scritti nelle query restano nella cronologia.

Primi passi

In circa dieci minuti, questo percorso mostra le funzioni principali con il database di esempio, senza rischi per i dati reali. L'esempio contiene clienti (clientes), prodotti (produtos), ordini (pedidos) e righe d'ordine (itens_pedido).

1. Apri l'esempio

1. Apri SQLite Manager.
2. Fai clic su Banco de exemplo (database di esempio). La tabella clientes compare nella scheda Dados (dati).

2. Trova un record

1. Nella riga dei filtri, sotto il titolo della colonna cidade (città), digita recife. Resta solo Carla Nunes.
2. Cancella il filtro per rivedere le cinque righe.
3. Fai clic sul titolo della colonna nome per ordinare. Fai di nuovo clic per invertire e una terza volta per annullare l'ordinamento.

3. Modifica e inserisci dati

1. Fai doppio clic sulla città di Ana Ribeiro, digita Campinas e premi Invio. L'indicatore ● não salvo (non salvato) compare nella barra superiore.
2. Fai clic su + Linha (aggiungi riga), compila nome e fai clic su Inserir (inserisci). Le altre colonne ricevono il valore predefinito.

4. Segui un riferimento

1. Nell'elenco a sinistra, fai clic su pedidos.
2. Nella colonna cliente_id, fai clic sulla freccia ↗ accanto a un valore. L'app apre clientes filtrata su quel cliente.

5. Esegui SQL

1. Apri la scheda SQL, scrivi la query qui sotto e premi Ctrl+Invio. Il risultato mostra il totale per cliente.

   SELECT * FROM vw_total_por_cliente;

2. Sostituisci il testo con il comando qui sotto ed eseguilo. Il messaggio indica 2 righe modificate: la riga inserita e la giacenza ridotta dal trigger trg_baixa_estoque.

   INSERT INTO itens_pedido VALUES (4, 1, 1, 349.9);

3. Fai clic su produtos. Si apre la scheda Dados, e la giacenza (estoque) della tastiera è scesa da 39 a 38.

6. Annulla o salva

1. Per annullare tutto, fai clic su Reverter (ripristina) e conferma. L'esempio torna allo stato iniziale.
2. Per conservare una copia, fai clic su Salvar (salva) e scegli dove scriverla.

L'interfaccia

Lo schermo ha quattro aree fisse, e le quattro schede cambiano solo quella centrale. Con un database aperto, lo schermo si presenta così:

Barra superiore

Azioni sul file, importazione CSV, esportazione SQL e il pulsante ◐, che alterna tema chiaro e scuro.

Elenco degli oggetti

Tabelle, viste, indici, trigger e tabelle di sistema, con il numero di righe di ogni tabella. Il campo in alto filtra l'elenco, e + Tabela crea una tabella.

Schede

Dados mostra le righe, Estrutura mostra e modifica lo schema, SQL esegue comandi e Banco contiene informazioni e manutenzione.

Barra di stato

Versione di SQLite, dimensione del database, avviso di transazione aperta e l'opzione Chaves estrangeiras.

Nomi dei pulsanti

Aprire, salvare e ripristinare

Tutto ciò che fai modifica una copia in memoria; il file su disco cambia solo quando salvi. Questo è il concetto più importante dell'app:

Aprire o creare un database

Se il database corrente ha modifiche non salvate, l'app chiede conferma prima di cambiare. I file che non sono SQLite, o che sono cifrati, vengono rifiutati, e il database corrente resta aperto.

Salvare

L'indicatore ● não salvo mostra che alcune modifiche esistono solo in memoria. L'app avvisa anche se provi a chiudere la scheda in questa situazione.

In Chrome ed Edge, se un altro programma ha modificato il file dopo l'apertura, l'app chiede conferma prima di sostituirlo. Per conservare entrambe le versioni, annulla e usa Salvar como….

Ripristinare

Reverter scarta tutto ciò che è stato fatto dall'apertura o dall'ultimo salvataggio. È l'unico “annulla” dell'app: non esiste un annulla passo per passo. Salva prima di una modifica rischiosa, così il punto di ritorno è subito prima di essa.

Database in modalità WAL

Alcuni programmi usano la modalità WAL, che tiene le modifiche recenti in un file -wal accanto al database. ^[5] Il browser riceve solo il file principale, quindi l'app avvisa all'apertura e prende due misure:

• Apre il database senza il contenuto del file -wal. Per vedere i dati più recenti, chiudi prima il programma che usa il database.
• Non scrive sull'originale. Salvar chiede un nuovo file, e il nome suggerito termina con -copia. Non sovrascrivere l'originale, perché un vecchio file -wal accanto a esso può corrompere i dati.

La scheda Dados (dati)

La scheda Dados mostra le righe della tabella o vista selezionata, e lì puoi cercare, modificare, inserire ed eliminare senza scrivere SQL.

Navigare e ordinare

• I controlli sotto la griglia cambiano pagina. Scegli 50, 100, 500 o 1000 righe per pagina.
• Fai clic sul titolo di una colonna per ordinare: crescente, decrescente e senza ordine. L'ordinamento usa una colonna alla volta.
• L'indicatore PK identifica le colonne della chiave primaria.
• I valori nulli appaiono come NULL in corsivo, e i dati binari come BLOB con la dimensione.

Filtrare e cercare

Ogni colonna ha un campo filtro, e i filtri su colonne diverse valgono insieme. Il campo Buscar em todas as colunas cerca il testo in qualsiasi colonna. Limpar filtros li rimuove tutti.

Modificare una cella

Fai doppio clic sulla cella. Con la tastiera, fai un clic, spostati con le frecce e premi Invio o F2.

La differenza tra NULL e testo vuoto è importante. In una cella NULL, confermare senza digitare mantiene il NULL. Per scrivervi testo vuoto, usa la scheda SQL. In una cella con un valore, cancellare il testo e salvare scrive testo vuoto.

SQLite converte il valore secondo il tipo della colonna: 42 diventa un numero in una colonna INTEGER. ^[3] Un testo come abc può essere accettato nella stessa colonna, a meno che la tabella non sia STRICT.

Lavorare con i BLOB

I dati binari non si modificano come testo. L'editor mostra il contenuto in esadecimale o, per le immagini PNG, JPEG, GIF e WebP, un'anteprima. Usa Baixar (scarica) per estrarre il file e Arquivo… per sostituirlo.

Inserire righe

Fai clic su + Linha. Ogni colonna ha una modalità, e digitare la porta automaticamente su valor:

• valor (valore) scrive ciò che è stato digitato, anche se vuoto.
• NULL scrive il valore nullo.
• padrão (predefinito) lascia decidere a SQLite: genera il numero della chiave automatica, applica il DEFAULT o scrive NULL.

Spunta Continuar adicionando (continua ad aggiungere) per inserire più righe di seguito. Le colonne generate non compaiono nel modulo. Per scrivere un BLOB, inserisci la riga e poi modifica la cella.

Eliminare righe

1. Spunta le caselle delle righe desiderate. La casella dell'intestazione seleziona tutta la pagina.
2. Fai clic su Excluir (elimina) e conferma.

L'eliminazione è tutto o niente: se una riga fallisce, non viene eliminata nessuna. La selezione vale solo per la pagina corrente e si azzera quando cambi pagina, filtri, ordini o modifichi.

Seguire le chiavi esterne

Le colonne con chiave esterna mostrano ↗ accanto al valore. Il clic apre la tabella di riferimento, filtrata sul record corrispondente.

Quando la griglia è di sola lettura

Le viste non sono mai modificabili in questa scheda, e nemmeno le colonne generate. Una tabella è di sola lettura quando le sue righe non si possono identificare: non ha chiave primaria e ha colonne chiamate rowid, _rowid_ e oid. In questo caso, usa la scheda SQL.

La scheda Estrutura (struttura)

La scheda Estrutura mostra lo schema dell'oggetto selezionato e modifica tabelle, colonne e indici senza scrivere SQL.

Creare una tabella

1. Fai clic su + Tabela e dai un nome alla tabella.
2. Compila una riga per colonna. La prima è già impostata come id INTEGER con chiave primaria.
3. Controlla il comando in SQL que será executado (SQL che verrà eseguito) e fai clic su Criar tabela (crea tabella).

PK

Chiave primaria. Spuntala su più colonne per creare una chiave composta.

Auto

Aggiunge AUTOINCREMENT. Richiede una sola colonna PK di tipo INTEGER.

Not null

La colonna non accetta NULL.

Único (unico)

Non consente valori ripetuti.

Padrão (predefinito)

Valore usato quando non ne viene indicato alcuno. Numeri, NULL, CURRENT_TIMESTAMP, testi tra apici singoli ed espressioni tra parentesi sono usati così come sono; il resto diventa testo.

Referência (riferimento)

Chiave esterna, nel formato tabella(colonna).

Modificare una tabella esistente

Cambiare il tipo di una colonna

SQLite non cambia direttamente il tipo di una colonna. ^[6] Ricrea la tabella nella scheda SQL, dentro una transazione. Il pulsante Abrir no editor SQL (apri nell'editor SQL) copia il DDL attuale come punto di partenza.

-- Esempio: la colonna idade di contatos passa da TEXT a INTEGER
BEGIN;
CREATE TABLE contatos_novo (id INTEGER PRIMARY KEY, nome TEXT, idade INTEGER);
INSERT INTO contatos_novo SELECT id, nome, idade FROM contatos;
DROP TABLE contatos;
ALTER TABLE contatos_novo RENAME TO contatos;
COMMIT;

Ricrea poi gli indici e i trigger della tabella, perché DROP TABLE li rimuove. Se altre tabelle la referenziano, disattiva Chaves estrangeiras prima di BEGIN; riattivala alla fine ed esegui Verificar chaves estrangeiras.

Viste e trigger

Crea viste e trigger nella scheda SQL. Compaiono poi nell'elenco degli oggetti, dove la scheda Estrutura mostra il DDL e permette di eliminarli.

La scheda SQL

La scheda SQL esegue qualsiasi comando accettato da SQLite, uno o più alla volta, e mostra i risultati sotto l'editor.

Eseguire comandi

• Ctrl+Invio o ▶ Executar eseguono tutto il testo. Con una parte selezionata, viene eseguita solo quella.
• Separa i comandi con ;. Ogni query crea una scheda di risultati.
• Se un comando fallisce, l'esecuzione si ferma lì e l'errore indica quale. I comandi precedenti restano applicati; per evitarlo, usa una transazione.
• Il conteggio delle righe modificate include le modifiche fatte dai trigger.

Scrivere più in fretta

• I suggerimenti compaiono dopo due lettere, o subito dopo un punto, come in c., e riconoscono gli alias delle tabelle.
• Ctrl+Spazio apre i suggerimenti. ↑ e ↓ scelgono, Tab o Invio accettano ed Esc chiude.
• Fuori dai suggerimenti, Tab inserisce due spazi.
• Il testo dell'editor è ancora lì quando riapri l'app.

Risultati

I risultati sono divisi in pagine da 200 righe, e i pulsanti CSV e JSON esportano l'intero insieme. Ogni query conserva fino a 100.000 righe e avvisa quando raggiunge il limite. Per risultati più grandi, affina la query o usa LIMIT.

Piano di esecuzione

Plano de execução mostra come SQLite risolverebbe il primo comando, senza eseguirlo. Nei piani, SCAN indica la lettura dell'intera tabella e SEARCH, in genere, l'uso di un indice o di una chiave.

Transazioni

Usa le transazioni per applicare più modifiche come una sola. Dopo BEGIN, la barra di stato mostra Transação aberta (transazione aperta) con i pulsanti COMMIT e ROLLBACK.

BEGIN;
UPDATE produtos SET preco = preco * 1.10 WHERE categoria = 'Acessórios';
-- controlla il risultato, poi fai clic su COMMIT o ROLLBACK nella barra di stato

Le modifiche fatte nella scheda Dados durante la transazione ne fanno parte. Se salvi con una transazione aperta, l'app chiede se fare prima COMMIT o ROLLBACK.

Cronologia e file

• Histórico ▾ conserva gli ultimi 50 comandi eseguiti. Il clic li riporta nell'editor.
• Abrir .sql… carica uno script nell'editor senza eseguirlo, e Baixar .sql salva il testo dell'editor.
• Limpar cancella il testo dell'editor.

Esempi utili

-- Creare una vista
CREATE VIEW vw_estoque_baixo AS
  SELECT nome, estoque FROM produtos WHERE estoque < 20;

-- Creare un trigger
CREATE TRIGGER trg_status AFTER UPDATE OF status ON pedidos
BEGIN
  UPDATE pedidos SET data = date('now') WHERE id = NEW.id;
END;

-- Trovare valori duplicati
SELECT email, count(*) FROM clientes
GROUP BY email HAVING count(*) > 1;

-- Scrivere testo vuoto in una cella NULL
UPDATE clientes SET email = '' WHERE id = 5;

Importare ed esportare

L'app importa CSV ed esporta CSV, JSON, SQL e il file stesso del database. L'importazione è tutto o niente: se una riga fallisce, non viene scritto nulla.

Importare un CSV

1. Fai clic su Importar CSV… e scegli il file, che deve essere in UTF-8.
2. Controlla il Separador (separatore), rilevato automaticamente tra virgola, punto e virgola, tab e barra verticale.
3. In Destino (destinazione), scegli Criar tabela nova (nuova tabella) o Adicionar em (aggiungi a) una tabella esistente.
4. Imposta Primeira linha é o cabeçalho (la prima riga è l'intestazione) e Campos vazios viram NULL (i campi vuoti diventano NULL), controlla l'anteprima e fai clic su Importar.

In una nuova tabella, l'app sceglie il tipo di ogni colonna tra INTEGER, REAL e TEXT osservando i valori. I valori con zero iniziale, come il codice postale 01310, restano testo e conservano lo zero. Anche i numeri con virgola decimale, come 7,5, restano testo.

In una tabella esistente, se tutti i nomi dell'intestazione esistono nella tabella, le colonne sono abbinate per nome. Altrimenti sono abbinate per posizione.

Esportare

Per un backup, preferisci Salvar como…, che conserva il database per intero.

CSV

UTF-8 con BOM, separato da virgole. NULL diventa campo vuoto e BLOB diventa 0x più esadecimale. Se Excel mette tutto in una colonna, importa dal suo menu dati e indica la virgola.

JSON

Elenco di oggetti. BLOB diventa {"$hex": "..."}, e gli interi troppo grandi per JavaScript diventano testo, per non perdere precisione.

SQL

Comandi INSERT; per l'intero database, anche il CREATE di ogni oggetto, dentro una transazione.

La scheda Banco (database)

La scheda Banco riassume il file e riunisce verifiche e manutenzione. Conviene consultarla prima di un salvataggio importante.

VACUUM e ANALYZE modificano il database, quindi poi bisogna salvare. VACUUM non viene eseguito con una transazione aperta.

Chiavi esterne

L'opzione Chaves estrangeiras, nella barra di stato, è attiva all'avvio, al contrario del comportamento predefinito di SQLite. ^[4] Così, eliminare un record referenziato da un'altra tabella dà errore, invece di lasciare dati orfani. La scelta vale per l'app e non viene scritta nel file. Non cambia durante una transazione.

Scorciatoie da tastiera

Limiti e risoluzione dei problemi

Limiti

• Database grandi: l'intero file viene caricato in memoria, quindi i database di diversi gigabyte non sono adatti.
• Query lunghe: lo schermo resta bloccato fino al termine della query.
• Accesso simultaneo: l'app lavora su una copia e non vede le modifiche fatte da altri programmi dopo l'apertura.
• Browser: l'app è stata provata in Chromium. L'uso in Firefox e Safari non è stato provato.
• Database cifrati: non sono supportati.

Problemi comuni

Ripasso rapido

Prova a rispondere prima di aprire ogni domanda.

Riferimenti

1. Giovani Perotto Mesquita, “SQLite Manager”, applicazione in un unico file HTML, giovanipm.github.io/sqlite-manager.html.
2. sql.js (in inglese), “sql.js: SQLite compiled to JavaScript”, consultato il 30/10/2026, github.com/sql-js/sql.js.
3. SQLite (in inglese), “Datatypes In SQLite”, documentazione di SQLite, consultato il 30/10/2026, sqlite.org/datatype3.html.
4. SQLite (in inglese), “SQLite Foreign Key Support”, documentazione di SQLite, consultato il 30/10/2026, sqlite.org/foreignkeys.html.
5. SQLite (in inglese), “Write-Ahead Logging”, documentazione di SQLite, consultato il 30/10/2026, sqlite.org/wal.html.
6. SQLite (in inglese), “ALTER TABLE”, documentazione di SQLite, consultato il 30/10/2026, sqlite.org/lang_altertable.html.
7. MDN Web Docs (in inglese), “File System API”, consultato il 30/10/2026, developer.mozilla.org/en-US/docs/Web/API/File_System_API.

Qué es SQLite Manager

SQLite Manager abre, consulta, edita y guarda bases de datos SQLite usando solo el navegador. Es un único archivo HTML: sin instalación, servidor ni cuenta. ^[1] El motor de la base de datos es el propio SQLite, compilado a WebAssembly e incorporado en el archivo. ^[2]

Abrir SQLite Manager →

Este manual es para quien quiere gestionar una base de datos sin instalar nada. Las tareas del día a día no requieren SQL; la pestaña SQL es para quien ya conoce el lenguaje.

Qué necesitas

• Un navegador actual. Se recomiendan Chrome y Edge, porque escriben directamente en el archivo original.
• El archivo sqlite-manager.html. Usa el enlace de arriba, o guarda la página y abre la copia, que funciona sin internet.

Cómo trata la aplicación tus datos

• Nada sale de tu ordenador. La base de datos se procesa dentro del navegador, y el archivo HTML bloquea las conexiones de red.
• La base de datos se edita en memoria. El archivo en disco solo cambia cuando guardas.
• El navegador conserva pocas cosas. Tema, tamaño de página, texto del editor SQL e historial de consultas quedan en el almacenamiento local. El contenido de la base de datos no, pero los valores escritos en consultas sí quedan en el historial.

Primeros pasos

En unos diez minutos, este recorrido muestra las funciones principales con la base de datos de ejemplo, sin riesgo para datos reales. El ejemplo tiene clientes (clientes), productos (produtos), pedidos (pedidos) y líneas de pedido (itens_pedido).

1. Abre el ejemplo

1. Abre SQLite Manager.
2. Haz clic en Banco de exemplo (base de datos de ejemplo). La tabla clientes aparece en la pestaña Dados (datos).

2. Encuentra un registro

1. En la fila de filtros, bajo el título de la columna cidade (ciudad), escribe recife. Solo queda Carla Nunes.
2. Borra el filtro para volver a ver las cinco filas.
3. Haz clic en el título de la columna nome (nombre) para ordenar. Haz clic otra vez para invertir y una tercera vez para deshacer el orden.

3. Edita e inserta datos

1. Haz doble clic en la ciudad de Ana Ribeiro, escribe Campinas y pulsa Intro. El indicador ● não salvo (sin guardar) aparece en la barra superior.
2. Haz clic en + Linha (añadir fila), rellena nome y haz clic en Inserir (insertar). Las demás columnas reciben el valor predeterminado.

4. Sigue una referencia

1. En la lista de la izquierda, haz clic en pedidos.
2. En la columna cliente_id, haz clic en la flecha ↗ junto a un valor. La aplicación abre clientes filtrada en ese cliente.

5. Ejecuta SQL

1. Abre la pestaña SQL, escribe la consulta de abajo y pulsa Ctrl+Intro. El resultado muestra el total por cliente.

   SELECT * FROM vw_total_por_cliente;

2. Sustituye el texto por el comando de abajo y ejecútalo. El mensaje indica 2 filas modificadas: la línea insertada y el stock reducido por el trigger trg_baixa_estoque.

   INSERT INTO itens_pedido VALUES (4, 1, 1, 349.9);

3. Haz clic en produtos. Se abre la pestaña Dados, y el stock (estoque) del teclado ha bajado de 39 a 38.

6. Deshaz o guarda

1. Para deshacerlo todo, haz clic en Reverter (revertir) y confirma. El ejemplo vuelve al estado inicial.
2. Para conservar una copia, haz clic en Salvar (guardar) y elige dónde escribirla.

La interfaz

La pantalla tiene cuatro áreas fijas, y las cuatro pestañas solo cambian la central. Con una base de datos abierta, la pantalla se ve así:

Barra superior

Acciones de archivo, importación de CSV, exportación de SQL y el botón ◐, que alterna entre tema claro y oscuro.

Lista de objetos

Tablas, vistas, índices, triggers y tablas del sistema, con el número de filas de cada tabla. El campo superior filtra la lista, y + Tabela crea una tabla.

Pestañas

Dados muestra las filas, Estrutura muestra y cambia el esquema, SQL ejecuta comandos y Banco reúne información y mantenimiento.

Barra de estado

Versión de SQLite, tamaño de la base de datos, aviso de transacción abierta y la opción Chaves estrangeiras.

Nombres de los botones

Abrir, guardar y revertir

Todo lo que haces cambia una copia en memoria; el archivo en disco solo cambia cuando guardas. Este es el concepto más importante de la aplicación:

Abrir o crear una base de datos

Si la base de datos actual tiene cambios sin guardar, la aplicación pide confirmación antes de cambiar. Los archivos que no son SQLite, o que están cifrados, se rechazan, y la base de datos actual sigue abierta.

Guardar

El indicador ● não salvo muestra que hay cambios solo en memoria. La aplicación también avisa si intentas cerrar la pestaña en esa situación.

En Chrome y Edge, si otro programa cambió el archivo después de abrirlo, la aplicación pide confirmación antes de sustituirlo. Para conservar las dos versiones, cancela y usa Salvar como….

Revertir

Reverter descarta todo lo hecho desde la apertura o el último guardado. Es el único “deshacer” de la aplicación: no hay deshacer paso a paso. Guarda antes de un cambio arriesgado, para que el punto de retorno quede justo antes.

Bases de datos en modo WAL

Algunos programas usan el modo WAL, que mantiene los cambios recientes en un archivo -wal junto a la base de datos. ^[5] El navegador recibe solo el archivo principal, así que la aplicación avisa al abrir y toma dos medidas:

• Abre la base de datos sin el contenido del archivo -wal. Para ver los datos más recientes, cierra antes el programa que la usa.
• No escribe sobre el original. Salvar pide un archivo nuevo, y el nombre sugerido termina en -copia. No sobrescribas el original, porque un archivo -wal antiguo junto a él puede corromper los datos.

La pestaña Dados (datos)

La pestaña Dados muestra las filas de la tabla o vista seleccionada, y en ella buscas, editas, insertas y eliminas sin escribir SQL.

Navegar y ordenar

• Los controles bajo la cuadrícula cambian de página. Elige 50, 100, 500 o 1000 filas por página.
• Haz clic en el título de una columna para ordenar: ascendente, descendente y sin orden. El orden usa una columna cada vez.
• La marca PK identifica las columnas de la clave primaria.
• Los valores nulos aparecen como NULL en cursiva, y los datos binarios como BLOB con su tamaño.

Filtrar y buscar

Cada columna tiene un campo de filtro, y los filtros en columnas distintas se aplican juntos. El campo Buscar em todas as colunas busca el texto en cualquier columna. Limpar filtros los quita todos.

Editar una celda

Haz doble clic en la celda. Con el teclado, haz un clic, muévete con las flechas y pulsa Intro o F2.

La diferencia entre NULL y texto vacío importa. En una celda NULL, confirmar sin escribir mantiene el NULL. Para escribir texto vacío en ella, usa la pestaña SQL. En una celda con valor, borrar el texto y guardar escribe texto vacío.

SQLite convierte el valor según el tipo de la columna: 42 pasa a ser un número en una columna INTEGER. ^[3] Un texto como abc puede aceptarse en la misma columna, a menos que la tabla sea STRICT.

Trabajar con BLOB

Los datos binarios no se editan como texto. El editor muestra el contenido en hexadecimal o, en imágenes PNG, JPEG, GIF y WebP, una vista previa. Usa Baixar (descargar) para extraer el archivo y Arquivo… para sustituirlo.

Insertar filas

Haz clic en + Linha. Cada columna tiene un modo, y al escribir pasa automáticamente a valor:

• valor escribe lo que se ha tecleado, aunque esté vacío.
• NULL escribe nulo.
• padrão (predeterminado) deja decidir a SQLite: genera el número de la clave automática, aplica el DEFAULT o escribe NULL.

Marca Continuar adicionando (seguir añadiendo) para insertar varias filas seguidas. Las columnas generadas no aparecen en el formulario. Para escribir un BLOB, inserta la fila y después edita la celda.

Eliminar filas

1. Marca las casillas de las filas deseadas. La casilla de la cabecera marca toda la página.
2. Haz clic en Excluir (eliminar) y confirma.

La eliminación es todo o nada: si una fila falla, no se elimina ninguna. La selección vale solo para la página actual y se borra al cambiar de página, filtrar, ordenar o editar.

Seguir claves foráneas

Las columnas con clave foránea muestran ↗ junto al valor. El clic abre la tabla referenciada, filtrada en el registro correspondiente.

Cuándo la cuadrícula es de solo lectura

Las vistas nunca se pueden editar en esta pestaña, ni tampoco las columnas generadas. Una tabla es de solo lectura cuando sus filas no se pueden identificar: no tiene clave primaria y tiene columnas llamadas rowid, _rowid_ y oid. En ese caso, usa la pestaña SQL.

La pestaña Estrutura (estructura)

La pestaña Estrutura muestra el esquema del objeto seleccionado y cambia tablas, columnas e índices sin escribir SQL.

Crear una tabla

1. Haz clic en + Tabela y da un nombre a la tabla.
2. Rellena una línea por columna. La primera ya viene como id INTEGER con clave primaria.
3. Revisa el comando en SQL que será executado (SQL que se ejecutará) y haz clic en Criar tabela (crear tabla).

PK

Clave primaria. Márcala en más de una columna para crear una clave compuesta.

Auto

Añade AUTOINCREMENT. Requiere una sola columna PK de tipo INTEGER.

Not null

La columna no acepta NULL.

Único

No permite valores repetidos.

Padrão (predeterminado)

Valor usado cuando no se indica ninguno. Los números, NULL, CURRENT_TIMESTAMP, los textos entre comillas simples y las expresiones entre paréntesis se usan tal cual; el resto pasa a ser texto.

Referência (referencia)

Clave foránea, en el formato tabla(columna).

Cambiar una tabla existente

Cambiar el tipo de una columna

SQLite no cambia directamente el tipo de una columna. ^[6] Vuelve a crear la tabla en la pestaña SQL, dentro de una transacción. El botón Abrir no editor SQL (abrir en el editor SQL) copia el DDL actual como punto de partida.

-- Ejemplo: la columna idade de contatos pasa de TEXT a INTEGER
BEGIN;
CREATE TABLE contatos_novo (id INTEGER PRIMARY KEY, nome TEXT, idade INTEGER);
INSERT INTO contatos_novo SELECT id, nome, idade FROM contatos;
DROP TABLE contatos;
ALTER TABLE contatos_novo RENAME TO contatos;
COMMIT;

Vuelve a crear después los índices y triggers de la tabla, porque DROP TABLE los elimina. Si otras tablas la referencian, desactiva Chaves estrangeiras antes de BEGIN; actívala de nuevo al terminar y ejecuta Verificar chaves estrangeiras.

Vistas y triggers

Crea vistas y triggers en la pestaña SQL. Después aparecen en la lista de objetos, donde la pestaña Estrutura muestra el DDL y permite eliminarlos.

La pestaña SQL

La pestaña SQL ejecuta cualquier comando que SQLite acepte, uno o varios a la vez, y muestra los resultados bajo el editor.

Ejecutar comandos

• Ctrl+Intro o ▶ Executar ejecutan todo el texto. Con un fragmento seleccionado, se ejecuta solo ese fragmento.
• Separa los comandos con ;. Cada consulta crea una pestaña de resultado.
• Si un comando falla, la ejecución se detiene ahí y el error indica cuál. Los comandos anteriores siguen aplicados; para evitarlo, usa una transacción.
• El recuento de filas modificadas incluye los cambios hechos por triggers.

Escribir más rápido

• Las sugerencias aparecen a partir de dos letras, o justo después de un punto, como en c., y reconocen los alias de tabla.
• Ctrl+Espacio abre las sugerencias. ↑ y ↓ eligen, Tab o Intro aceptan y Esc cierra.
• Fuera de las sugerencias, Tab inserta dos espacios.
• El texto del editor sigue ahí cuando vuelves a abrir la aplicación.

Resultados

Los resultados se paginan de 200 en 200 filas, y los botones CSV y JSON exportan el conjunto completo. Cada consulta conserva hasta 100.000 filas y avisa al alcanzar el límite. Para resultados mayores, afina la consulta o usa LIMIT.

Plan de ejecución

Plano de execução muestra cómo resolvería SQLite el primer comando, sin ejecutarlo. En los planes, SCAN indica la lectura de toda la tabla y SEARCH, en general, el uso de un índice o clave.

Transacciones

Usa transacciones para aplicar varios cambios como uno solo. Después de BEGIN, la barra de estado muestra Transação aberta (transacción abierta) con los botones COMMIT y ROLLBACK.

BEGIN;
UPDATE produtos SET preco = preco * 1.10 WHERE categoria = 'Acessórios';
-- revisa el resultado y haz clic en COMMIT o ROLLBACK en la barra de estado

Las ediciones hechas en la pestaña Dados durante la transacción forman parte de ella. Si guardas con una transacción abierta, la aplicación pregunta si hacer antes COMMIT o ROLLBACK.

Historial y archivos

• Histórico ▾ conserva los últimos 50 comandos ejecutados. El clic los devuelve al editor.
• Abrir .sql… carga un script en el editor sin ejecutarlo, y Baixar .sql guarda el texto del editor.
• Limpar borra el texto del editor.

Ejemplos útiles

-- Crear una vista
CREATE VIEW vw_estoque_baixo AS
  SELECT nome, estoque FROM produtos WHERE estoque < 20;

-- Crear un trigger
CREATE TRIGGER trg_status AFTER UPDATE OF status ON pedidos
BEGIN
  UPDATE pedidos SET data = date('now') WHERE id = NEW.id;
END;

-- Encontrar valores duplicados
SELECT email, count(*) FROM clientes
GROUP BY email HAVING count(*) > 1;

-- Escribir texto vacío en una celda NULL
UPDATE clientes SET email = '' WHERE id = 5;

Importar y exportar

La aplicación importa CSV y exporta CSV, JSON, SQL y el propio archivo de la base de datos. La importación es todo o nada: si una fila falla, no se escribe nada.

Importar un CSV

1. Haz clic en Importar CSV… y elige el archivo, que debe estar en UTF-8.
2. Revisa el Separador, detectado automáticamente entre coma, punto y coma, tabulador y barra vertical.
3. En Destino, elige Criar tabela nova (tabla nueva) o Adicionar em (añadir en) una tabla existente.
4. Ajusta Primeira linha é o cabeçalho (la primera línea es la cabecera) y Campos vazios viram NULL (los campos vacíos pasan a NULL), revisa la vista previa y haz clic en Importar.

En una tabla nueva, la aplicación elige el tipo de cada columna entre INTEGER, REAL y TEXT observando los valores. Los valores con cero a la izquierda, como el código postal 01310, siguen como texto y conservan el cero. Los números con coma decimal, como 7,5, también siguen como texto.

En una tabla existente, si todos los nombres de la cabecera existen en la tabla, las columnas se enlazan por nombre. En caso contrario, se enlazan por posición.

Exportar

Para una copia de seguridad, usa preferentemente Salvar como…, que conserva la base de datos completa.

CSV

UTF-8 con BOM, separado por comas. NULL pasa a campo vacío y BLOB a 0x más hexadecimal. Si Excel lo junta todo en una columna, importa desde su menú de datos e indica la coma.

JSON

Lista de objetos. BLOB pasa a {"$hex": "..."}, y los enteros demasiado grandes para JavaScript pasan a texto, para no perder precisión.

SQL

Comandos INSERT; en la base de datos completa, también el CREATE de cada objeto, dentro de una transacción.

La pestaña Banco (base de datos)

La pestaña Banco resume el archivo y reúne las comprobaciones y el mantenimiento. Conviene consultarla antes de un guardado importante.

VACUUM y ANALYZE cambian la base de datos, así que después hay que guardar. VACUUM no se ejecuta con una transacción abierta.

Claves foráneas

La opción Chaves estrangeiras, en la barra de estado, viene activada, al contrario que el valor predeterminado de SQLite. ^[4] Así, eliminar un registro referenciado por otra tabla da error, en lugar de dejar datos huérfanos. La elección vale para la aplicación y no se escribe en el archivo. No cambia durante una transacción.

Atajos de teclado

Limitaciones y solución de problemas

Limitaciones

• Bases de datos grandes: todo el archivo se carga en memoria, así que las bases de varios gigabytes no son adecuadas.
• Consultas largas: la pantalla se queda bloqueada hasta que termina la consulta.
• Acceso simultáneo: la aplicación trabaja en una copia y no ve los cambios que otro programa haga después de abrirla.
• Navegadores: la aplicación se ha probado en Chromium. El uso en Firefox y Safari no se ha probado.
• Bases de datos cifradas: no son compatibles.

Problemas comunes

Repaso rápido

Intenta responder antes de abrir cada pregunta.

Referencias

1. Giovani Perotto Mesquita, “SQLite Manager”, aplicación en un único archivo HTML, giovanipm.github.io/sqlite-manager.html.
2. sql.js (en inglés), “sql.js: SQLite compiled to JavaScript”, consultado el 30/10/2026, github.com/sql-js/sql.js.
3. SQLite (en inglés), “Datatypes In SQLite”, documentación de SQLite, consultado el 30/10/2026, sqlite.org/datatype3.html.
4. SQLite (en inglés), “SQLite Foreign Key Support”, documentación de SQLite, consultado el 30/10/2026, sqlite.org/foreignkeys.html.
5. SQLite (en inglés), “Write-Ahead Logging”, documentación de SQLite, consultado el 30/10/2026, sqlite.org/wal.html.
6. SQLite (en inglés), “ALTER TABLE”, documentación de SQLite, consultado el 30/10/2026, sqlite.org/lang_altertable.html.
7. MDN Web Docs (en inglés), “File System API”, consultado el 30/10/2026, developer.mozilla.org/en-US/docs/Web/API/File_System_API.