Convenções gerais SQL: mudanças entre as edições
(Criou página com 'Convenções de sintaxe e estilo para ''scripts'' SQL para os projetos em geral, dentro do escopo do Instituto AddressForAll.') |
Sem resumo de edição |
||
| (5 revisões intermediárias por 2 usuários não estão sendo mostradas) | |||
| Linha 1: | Linha 1: | ||
Convenções de sintaxe e | Convenções de sintaxe, estilo e documentação para ''scripts'' [[wikipedia:SQL|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 <code>-- informal comm</code> | |||
* '''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 [[wikipedia:PostgreSQL|PostgreSQL]], por haver isolamento de cópia e de consulta, '''cada banco de dados é conceitualmente um [[wikipedia:data lake|''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 | |||
[[Categoria:Conceitos]] | |||
Edição atual tal como às 12h09min de 13 de fevereiro de 2024
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