thais-sq

Consulta e altera bancos SQLite locais ou remotos a partir do n8n, com selecao de tabelas e colunas.

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.3.0
Author: Thais

Available Nodes

Documentation generating…

Thais SQ icon
Thais SQ
Consulta e altera bancos SQLite locais ou remotos. Use para ler tabelas, buscar registros e escrever dados.

Documentation

n8n-nodes-thais-sq

Node comunitario que consulta bancos SQLite a partir do n8n — tanto arquivos no proprio servidor quanto arquivos em servidores de terceiros acessados por SSH.

SQLite nao tem servidor de banco: e um arquivo em disco. Por isso o node conversa com um gateway HTTP que fica no seu servidor e executa a consulta onde o arquivo estiver. Uma unica instalacao do gateway atende varios clientes: o destino viaja em cada chamada, dentro da credencial.

Instalacao

No n8n self-hosted: Settings → Community Nodes → Install e informe n8n-nodes-thais-sq.

Gateway

O arquivo gateway/thais_sq_gateway.py acompanha o projeto. Requer Python 3 e, para destinos remotos, paramiko.

pip install paramiko
THAIS_SQ_TOKEN=seu-token python3 thais_sq_gateway.py --port 8790

Rotas: GET /health e POST /query. Toda chamada exige o header X-Thais-Token.

Credencial

Campo Descricao
Gateway URL Endereco do gateway, por exemplo http://10.0.0.5:8790
Token O mesmo valor de THAIS_SQ_TOKEN
Caminho do Banco Caminho do .db no servidor de destino
Destino Servidor do Gateway ou Outro Servidor via SSH
Host, Porta, Usuario, Senha, Chave Privada Preenchidos apenas no modo SSH

Operacoes

  • Executar Query — roda um SQL e devolve uma linha por item. Aceita parametros com ? para evitar SQL injection.
  • Listar Tabelas — tabelas e views do banco.
  • Estrutura da Tabela — colunas, tipos e chaves.

Seguranca

  • Comandos de escrita sao bloqueados por padrao; libere com Permitir Escrita, disponivel apenas quando o arquivo esta no servidor do gateway.
  • Destinos remotos sao sempre somente leitura.
  • Bancos em modo WAL guardam escritas recentes no arquivo -wal. Quando o gateway precisa copiar o banco remoto, os arquivos -wal e -shm vao junto, para que a consulta enxergue os dados atuais.

Licenca

MIT

Discussion