Convenções gerais SQL
Convenções de sintaxe e estilo para scripts SQL para os projetos em geral, dentro do escopo do Instituto AddressForAll. Principais tipos de convenção adotadas:
- Estilo sintático: dentre as várias alternativas que a linguagem SQL oferece para se escrever a mesma coisa, quais recomendamos.
- Documentação: onde e como documentar. A principal recomendação aqui é "use o comando COMMENT" do SQL. Além disso existe um parser que gera código mediawiki para postar nesta Wiki.
- Documentação e estilo: devido ao parser algumas partes da documentação podem ser expressas em
-- informal comm
- Documentação e estilo: devido ao parser algumas partes da documentação podem ser expressas em
- Testes: requisitos mínimos de teste, tipicamente usando comando ASSERT em scripts dedicados, ou gerando a partir .
- Objetos: em quais SQL-schemas definir, com qual sintaxe de nomenclatura, com qual estilo e níveis de documentação.
- UDF - User Defined Functions;
- Views e Materialized Views;
- Tables.
UDFs do schema Public
Foi convencionado que todos os projetos do Instituto devem ou criar schema próprio ou incluir novas funções Public (schema default do PostgreSQL) no projeto PubLib, atualmente na sua primeira versão: https://git.AddressForAll.org/pg_pubLib-v1