mirror/sqlstyle.guide
1
0
Fork 0
mirror of https://github.com/treffynnon/sqlstyle.guide.git synced 2025-03-09 12:49:51 -05:00
Code Activity

Translating Reserved Words / White space

Browse source
This commit is contained in:
Unknown 2017-04-17 01:15:03 -03:00
parent 393c4cbec6
commit 29151390fa
1 changed files with 23 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
_includes/sqlstyle.guide.pt-br.md
View file

@ -154,18 +154,19 @@ onde for apropriado.
* `_size`—o tamanho de algo, como o tamanho de um arquivo ou de uma roupa. * `_size`—o tamanho de algo, como o tamanho de um arquivo ou de uma roupa.
* `_addr`—um endereço. Pode ser físico ou intangível, como por exemplo `ip_addr`. * `_addr`—um endereço. Pode ser físico ou intangível, como por exemplo `ip_addr`.
## Query syntax ## Sintaxe de Queries
### Reserved words ### Palavras reservadas
Always use uppercase for the [reserved keywords][reserved-keywords] Sempre utilize caixa alta para as [palavras-chave reservadas][reserved-keywords]
like `SELECT` and `WHERE`. como `SELECT` e `WHERE`
It is best to avoid the abbreviated keywords and use the full length ones where É melhor evitar palaras reservadas abreviadas e utilizar as que tem o nome
available (prefer `ABSOLUTE` to `ABS`). completo (prefira `ABSOLUTE` ao invés de `ABS`).
Do not use database server specific keywords where an ANSI SQL keyword already Não utilize palavras-chave específicas do servidor de banco de dados onde uma
exists performing the same function. This helps to make code more portable. palavra-chave ANSI SQL já existe performando a mesma função. Isso ajuda a manter
o código mais portátil.
```sql ```sql
SELECT model_num SELECT model_num
@ -173,17 +174,20 @@ SELECT model_num
WHERE p.release_date > '2014-09-30'; WHERE p.release_date > '2014-09-30';
``` ```
### White space ### Espaços em branco
To make the code easier to read it is important that the correct compliment of Para tornar o código mais fácil de ler, é importante que o cumprimento correto
spacing is used. Do not crowd code or remove natural language spaces. de espaçamento esteja sendo utilizado. Não coloque código ou remova espaços
naturais da linguagem.
#### Spaces #### Espaços
Espaços devem ser utilizados para alinhar o código, de forma que as palavras-chaves
raíz terminem sempre no mesmo limite de caracteres. Isso forma um rio no meio,
tornando fácil para os leitores baterem o olho, visualizar o código e separar as
palavras-chave dos detalhes de implementação. Rios são [ruins na tipografia][rivers],
mas úteis aqui.
Spaces should be used to line up the code so that the root keywords all end on
the same character boundary. This forms a river down the middle making it easy for
the readers eye to scan over the code and separate the keywords from the
implementation detail. Rivers are [bad in typography][rivers], but helpful here.
```sql ```sql
(SELECT f.species_name, (SELECT f.species_name,
@ -205,8 +209,9 @@ implementation detail. Rivers are [bad in typography][rivers], but helpful here.
GROUP BY b.species_name, b.observation_date) GROUP BY b.species_name, b.observation_date)
``` ```
Notice that `SELECT`, `FROM`, etc. are all right aligned while the actual column Notuqe que o `SELECT`, `FROM`, etc. estão todos a direita, alinhados, enquanto
names and implementation specific details are left aligned. os nomes das colunas em si e os detalhes específicos de implementação estão
alinhados à esquerda.
Although not exhaustive always include spaces: Although not exhaustive always include spaces: