Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.datasnap.cloud/llms.txt

Use this file to discover all available pages before exploring further.

O DataSnap Bridge é o utilitário oficial de linha de comando (CLI) projetado para simplificar a ingestão de dados na plataforma DataSnap. Ele atua como uma ponte segura entre seus servidores locais e a infraestrutura DataSnap na nuvem.

​
✨ Principais Recursos

  • Configuração Zero-Code: Conecte bancos de dados e logs sem escrever scripts de integração.
  • Segurança Máxima: Criptografia AES-GCM 256-bit para todas as credenciais sensíveis armazenadas localmente.
  • Conectores Nativos: Suporte para MySQL, PostgreSQL e logs do framework Laravel.
  • Sincronização Incremental: Detecta automaticamente novos registros (Deltas) via Chave Primária ou Timestamps.
  • Modo Dry-Run: Teste suas migrações e veja exatamente o que será enviado antes do upload real.
  • Automatizável: Pronto para ser executado via Cron Jobs ou pipelines de CI/CD.

​
🚀 Início Rápido

​
Instalação

O Bridge requer Python 3.9+ e pode ser instalado rapidamente: 
# Clone o repositório ou instale via pip (em breve)
git clone https://github.com/datasnap-cloud/datasnap-bridge
cd datasnap-bridge
pip install -r requirements.txt

​
Configuração Interativa

O comando setup fornece uma interface de terminal (TUI) para configurar tudo o que você precisa: 
python cli.py setup
No menu, você poderá:
  1. Cadastrar sua API Key da DataSnap.
  2. Adicionar suas Fontes de Dados (Bancos de dados).
  3. Vincular Tabelas aos seus Schemas da DataSnap.

​
Executando a Sincronização

Após configurar os mapeamentos, você pode sincronizar tudo com um único comando: 
# Sincronizar todos os mapeamentos configurados
python cli.py sync --all

# Sincronizar um mapeamento específico
python cli.py sync --mapping meu_banco.usuarios

​
🔒 Segurança e Privacidade

A segurança é o pilar central do Bridge. Ao contrário de outras ferramentas que exigem que você envie suas senhas de banco de dados para a nuvem, o Bridge as mantém apenas no seu servidor.
  • Criptografia Local: Suas API Keys e senhas de banco são criptografadas com uma chave derivada do seu ambiente.
  • Zero-Knowledge: A DataSnap Cloud nunca tem acesso às suas credenciais de banco de dados original.
  • Trânsito Seguro: Todos os dados são enviados via HTTPS com TLS 1.2+.

​
📊 Fontes de Dados Suportadas

FonteDescrição
MySQLSuporte total para InnoDB e MyISAM, incluindo réplicas de leitura.
PostgreSQLConectividade robusta com suporte a schemas complexos.
Laravel LogsParser inteligente para arquivos laravel.log, transformando logs textuais em JSON estruturado.
S3 (Roadmap)Sincronização direta de buckets S3 e compatíveis.

​
⏰ Automação

Para manter seus dados sempre atualizados, recomendamos configurar um agendamento simples: 
# Exemplo de Cron (a cada 15 minutos)
*/15 * * * * cd /caminho/para/bridge && python cli.py sync --all >> sync.log 2>&1
Dica: Use o comando python cli.py status a qualquer momento para verificar a saúde da sua conexão com a DataSnap API.