Convenções gerais SQL
Convenções de sintaxe, estilo e documentação para scripts SQL, para os projetos em geral 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.
Documentação dos objetos SQL
- Tabelas e Views: ver a4a:Convenções/Dados/SQL, ...
- Funções: ver ...
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
Nomes de Database
Consideramos que, no caso do PostgreSQL, por haver isolamento de cópia e de consulta, cada banco de dados é conceitualmente um data lake.
, no a de dados são organizados em data lakes (DL) As convenções de abreviação de nome de projeto seguem para os diversos