O elefante ilustrado
Ferramentas de modelagem literária e documentação automática em PostgreSQL e outros SGBDs livres
Reſumo
Uma das dificuldades de programar é manter documentação de bases de dados, principalmente em ambientes onde os esquemas são dinâmicos e não há processos para evolução do modelo de dados. Embora nada substitua a administração de dados, pode-se gerar a documentação essencial de dados para usuários e programadores automática e regularmente.
Deſcrição
Uma das dificuldades de uma equipe de desenvolvimento é manter documentação de bases de dados, principalmente em ambientes onde os esquemas são dinâmicos e há pouca definição de processos para evolução do modelo de dados. Proponentes de sistemas livres ainda enfrentam uma certa escassez de ferramentas gráficas de modelagem. Uma das possibilidades é usar o ferramental da programação literária, por exemplo com o noweb, para modelar esquemas de dados combinando SQL e LaΤεχ para gerar, automaticamente, tanto documentos quanto a própria estrutura da base de dados.
Similarmente, embora nada substitua a administração de dados, pode-se gerar a documentação essencial de modelo de dados para usuários e programadores automaticamente, mesmo quando não se tem um documento de modelagem. O ferramental de documentação automática também completa a modelagem literária acima descrita, e gera páginas (X)HTML com uma representação do modelo casando gráficos e hipertexto. Apresentaremos ferramentas como Auto Doc, Schema Spy e SQL::Fairy, com demonstração de uso desde a concepção até a geração dos documentos de uma base de dados.
Embora o PostgreSQL seja o SGBD mais aparelhado para esses métodos, também são aplicáveis a outros SGBDs livres e proprietários, principalmene o Firebird mas também, em menor grau, MySQL, Ingres e até Oracle, MS SQL Server &c…
O ferramental é todo livre e substitui ferramentas proprietárias bem dispendiosas com vantagens de integração num ambiente livre, extensibilidade, produtividade e apresentação final; e, embora as ferramentas básicas estejam maduras, há oportunidades de envolvimento de programadores de diversos níveis para correções, evolução e extensão.
Notas
Esta palestra já foi dada no PgConBR 2008 e no PgDay SP 2009, e está evoluindo com essas duas experiências. A resposta das audiências foi bastante positiva, e foi entregue com bastante participação do público.
Inclui uma chamada à colaboração dos usuários para a melhoria do ferramental já disponível.