Manual do Usuário e Documentação do SQLOZ

Info: Este manual é uma referência abrangente para o uso profissional do SQLOZ. Cada seção explora cenários reais de administração de banco de dados e orienta passo a passo pela interface.

Bem-vindo à documentação oficial do SQLOZ, o cliente SQL nativo para macOS projetado para desenvolvedores, analistas de dados e DBAs.

Arquitetura e Filosofia

O SQLOZ é desenvolvido 100% em Swift, utilizando os frameworks nativos da Apple AppKit e SwiftUI:

• Inicialização instantânea em menos de um segundo, sem o consumo excessivo do Electron.
• Consumo mínimo e constante de memória RAM, mesmo durante o streaming de milhões de registros.
• Otimização nativa para chips Apple Silicon (M1/M2/M3/M4).
• Zero telemetria, sem bibliotecas de rastreamento de terceiros e com privacidade irrestrita.

Índice dos Capítulos

1. Capítulo 1: Primeiros Passos - Instalação, requisitos do sistema e primeira conexão.
2. Capítulo 2: Conexões e Túneis - Conexões diretas, túneis SSH Jump Host, túneis HTTP PHP e Keychain do macOS.
3. Capítulo 3: Editor SQL e Execução de Consultas - Bounded Query Streaming, cancelamento não bloqueante e travas de segurança.
4. Capítulo 4: Grade de Dados e Edição - Edição de células em linha, inspetor de valores e ordenação inteligente.
5. Capítulo 5: Designer Visual de Esquemas - Engenharia reversa, modelagem ERD por arrastar e soltar e exportação PDF/PNG.
6. Capítulo 6: Comparação e Sincronização de Esquemas - Detecção de deriva de esquema (drift), matriz visual e backups de segurança.
7. Capítulo 7: Comparação e Sincronização de Dados - Comparação linha a linha, relatório pré-execução e controle de throttle.
8. Capítulo 8: Construtor Visual de Consultas - Detecção automática de JOINs, filtros visuais e saída SQL em tempo real.
9. Capítulo 9: Suite DBA e Diagnóstico do Servidor - Lista de processos em tempo real, encerramento seguro e wizard de saúde do banco.
10. Capítulo 10: Segurança, Backup e Recuperação - Safety gate com token opaco, backups automáticos e bloqueio Touch ID.
11. Capítulo 11: Migração Entre Dialetos - Transferência cruzada entre MySQL, PostgreSQL e SQLite com transpilação DDL.
12. Capítulo 12: Preferências e Configuração Avançada - Configuração SMTP central, pool de conexões e gerenciamento Pro.
13. Capítulo 13: Referências, Atalhos e Solução de Problemas - Tabela completa de atalhos do macOS e solução de falhas de conexão.
14. Capítulo 14: OzAI - Assistente SQL em Linguagem Natural - Geração de consultas e suporte a modelos locais (Ollama, LM Studio).
15. Capítulo 15: OzCharts - Visualização - Criação de gráficos de alta definição diretamente dos resultados SQL.
16. Capítulo 16: OzTeam - Troca de Perfis Criptografados - Cápsulas .sqlozprofile protegidas por criptografia AES-256-GCM.
17. Capítulo 17: OzOSC - Mudanças de Esquema sem Parada - Alterações de estrutura online sem travamento de leituras e gravações.
18. Capítulo 18: OzLockTree - Resolvedor de Bloqueios - Identificação de Root Blockers e desbloqueio de impasses transacionais.
19. Capítulo 19: OzExplain - Árvore de Execução e Orientador de Índices - Planos visuais de custo e sugestões de indexação DDL.
20. Capítulo 20: OzMask - Anonimizador de Dados Pessoais - Mascaramento automático PII para conformidade LGPD/GDPR na grade.
21. Capítulo 22: Bancos de Dados e Versões Homologadas - Matriz de compatibilidade para MySQL, MariaDB, PostgreSQL e SQLite.
22. Capítulo 23: Centro de Operações e Tarefas Agendadas - Agendamento de dumps e notificações via launchd no macOS.