Gerenciador de bancos de dados

O que permite fazer?

O gerenciador de bancos de dados é a janela da ArduMaker para os motores PostgreSQL e MySQL que rodam dentro do VPS. Funciona igual pelo painel, pelo console interativo e via MCP: uma única implementação por motor.

• Ver motores, bancos (tamanho e codificação), tabelas e views com quantidade estimada de linhas.
• Descrever uma tabela: colunas com tipo normalizado, nulos, chave primária, chaves estrangeiras e índices.
• Ler linhas com filtros e ordem sem escrever SQL, com paginação por chave.
• Inserir, editar ou apagar uma linha pela sua chave primária completa.
• Console SQL somente leitura e EXPLAIN.
• Executar DDL (CREATE, ALTER, DROP, TRUNCATE) com confirmação por nome quando destrói dados.
• Exportar tabelas para CSV ou Excel e importar CSV ou Excel (até 32 MB) em dois passos.
• Ver o histórico de operações destrutivas: quem, quando, qual instrução e de onde.

Quando convém usar?

• Verificar dados de produção sem abrir o motor para a internet nem instalar um cliente.
• Dar a um agente de IA acesso controlado ao banco, com escritas linha por linha e auditoria.
• Carregar uma planilha em uma tabela verificando antes como vai entrar.

Como funciona na ArduMaker?

O backend chega ao motor por um túnel SSH privado até o VPS, com uma chave efêmera que só permite encaminhar para a porta do motor. A porta do banco não é publicada para isso: o PostgreSQL e o MySQL continuam escutando só dentro do VPS.

1. Permissões: a empresa, o escopo MCP do agente sobre esse VPS e as listas de membros permitidos ou excluídos do VPS.
2. Túnel e conexão: o túnel é aberto ou reutilizado e validado com SELECT 1.
3. Credencial: a guardada para esse motor (se o cliente mudou a senha à mão e a cadastrou) ou a administrativa da plataforma.
4. Operação: o SQL é montado pela camada de cada motor com listas brancas; os valores sempre viajam como parâmetros do driver, nunca colados no texto.
5. Auditoria: o que escreve ou destrói fica no histórico com sua origem (interface ou agente).

O que muda realmente?

Ler não muda nada. Escrever linhas, executar DDL e importar mudam dados do cliente dentro do motor; criar tabelas pelo formulário também, e é auditado como escrita. No VPS, o túnel usa um usuário próprio com uma chave restrita que não abre um shell.

Diferenças entre motores

• No PostgreSQL uma tabela pode ter esquema (esquema.tabela); no MySQL o esquema é o banco.
• EXPLAIN devolve o formato próprio de cada motor; não são comparáveis.
• A quantidade de linhas de listar_tablas_db_vps é a estimativa do motor; a contagem exata é contar_filas_db_vps, mais cara em tabelas grandes.

Esquema

Resultado esperado

probar_conexion_db_vps confirma que o backend chega e entra no motor. A partir daí, listar_bases_db_vps, listar_tablas_db_vps e describir_tabla_db_vps mostram a estrutura e leer_filas_db_vps os dados. Cada escrita devolve a linha como ficou, com valores padrão e autoincrementos resolvidos.

Erros e resolução

Relação com MCP

O gerenciador completo está disponível via MCP; referência em /mcp/docs e /mcp/bases-de-datos. Todas as ferramentas recebem engine (postgres ou mysql) e, exceto as de motores, a base.

• consultar_sql_db_vps recusa escritas de propósito e uma segunda instrução separada por ;. Os valores vão em params.
• ejecutar_ddl_db_vps destrutivo exige repetir com confirmacion igual a confirmacion_esperada; confirmar um nome errado é recusado.
• guardar_credencial_db_vps guarda a senha do motor criptografada e nenhuma ferramenta a devolve.
• Exportar e importar arquivos só existem no painel.

Funcionalidades relacionadas

• PostgreSQL
• MySQL
• Auditoria de agentes
• Servidor MCP
• Túneis SSH