PostgreSQL

Versão alfa

Tabela de conteúdos

Indentação
Tabelas
Colunas reservadas
Enumeradores
Chaves, índices e sequências
Funções
Gatilhos
Procedimentos armazenados
Ambiente
- Visual Studio Code
- Git
- Docker
- Projeto
Próximos passos

Indentação

-- Em breve

SELECT
    id_usuario,
    nome
FROM usuarios
WHERE
    id_usuario = 1;

Tabelas

Entidades {nome da entidade no plural}.
Relacionar duas entidades {nome da tabela pai}_{nome da tabela filha}.
Auditoria {nome da tabela}_operacoes.

Tabela	Descrição	Relacionamento
`empresas`	Empresas	n empresas
`filiais`	Filiais do grupo	n filiais para 1 grupo
`funcoes`	Funções	n funções
`grupos`	Grupos da empresa	n grupos para 1 empresa
`usuarios`	Usuários	n usuários
`usuarios_filiais`	Filiais dos usuários	n filiais para m usuários
`usuarios_funcoes`	Funções dos usuários	n funções para m usuários
`usuarios_operacoes`	Operações do usuário	n operações para 1 usuário

Colunas reservadas

Coluna	Descrição	Tipo	Nulo
`alterado`	Data de alteração do registro	`TIMESTAMP`	Não
`ativado`	Permissão lógica do registro	`BOOLEAN`	Não
`cnpj`	Cadastro nacional de pessoa jurídica	`TEXT`	Não
`cpf`	Cadastro de pessoa física	`TEXT`	Não
`criado`	Data de criação do registro	`TIMESTAMP`	Não
`deletado`	Data de deleção lógica do registro	`TIMESTAMP`	Sim
`id_{nome da entidade}`	Chave primária ou estrangeira	`SMALLINT`, `INTEGER` e `BIGINT`	Não
`id_autor`	Identificador do autor da requisição	`INTEGER`	Não
`ip`	Endereço de rede do autor da requisição	`INET`	Não
`nome`	Nome	`TEXT`	Não
`tipo`	Enumerador iniciado em 1	`SMALLINT`	Não

Enumeradores

Tabela	Coluna	Valor	Descrição
`{nome da tabela}_operacoes`	`operacao`	1	Inserir
`{nome da tabela}_operacoes`	`operacao`	2	Atualizar
`{nome da tabela}_operacoes`	`operacao`	3	Apagar
`usuarios`	`tipo`	1	Usuário
`usuarios`	`tipo`	2	Supervisor
`usuarios`	`tipo`	3	Administrador

Chaves, índices e sequências

Chaves primárias {nome da tabela}_pkey.
Chaves estrangeiras {nome da tabela}_{nome da coluna}_fkey.
Chaves de consistência {nome da tabela}_{nome da coluna}_key.
Sequências {nome da tabela}_{nome da coluna}_seq.
Índices {nome da tabela}_{nome da coluna}_idx.

Versão	Objeto	Descrição
0.0	`empresas_pkey`	Chave primária
0.0	`empresas_id_empresa_seq`	Sequência
0.0	`filiais_pkey`	Chave primária
0.0	`filiais_id_filial_seq`	Sequência
0.0	`filiais_id_grupo_fkey`	Chave estrangeira
0.0	`funcoes_pkey`	Chave primária
0.0	`funcoes_id_funcao_seq`	Sequência
0.0	`grupos_pkey`	Chave primária
0.0	`grupos_id_grupo_seq`	Sequência
0.0	`grupos_id_empresa_fkey`	Chave estrangeira
0.0	`usuarios_pkey`	Chave primária
0.0	`usuarios_id_usuario_seq`	Sequência
0.0	`usuarios_usuario_key`	Unicidade
0.0	`usuarios_filiais_pkey`	Chave primária
0.0	`usuarios_filiais_id_usuario_fkey`	Chave estrangeira
0.0	`usuarios_filiais_id_filial_fkey`	Chave estrangeira
0.0	`usuarios_funcoes_pkey`	Chave primária
0.0	`usuarios_funcoes_id_usuario_fkey`	Chave estrangeira
0.0	`usuarios_funcoes_id_funcao_fkey`	Chave estrangeira
0.0	`usuarios_operacoes_pkey`	Chave primária
0.0	`usuarios_operacoes_id_operacao_seq`	Sequência

Funções

Genéricas fn_{verbo}.
Colunas computadas fn_{nome da coluna}.

Versão	Função	Descrição
0.0	`fn_chave`	Criar chave para registro
0.0	`fn_registrar`	Registrar operação na tabela de operações
0.0	`fn_senha`	Criar senha para registro

Gatilhos

Registrar operação na tabela de operações tr_{nome da tabela}.

Versão	Gatilho	Descrição
0.0	`tr_usuarios`	Registrar operação na tabela de operações

Procedimentos armazenados

Em breve.

Ambiente

Visual Studio Code

(Recomendado) Instale a fonte de programação com ligaduras Fira Code.
Instale o Visual Studio Code.

Git

Instale o Git para Windows com as opções abaixo.

Git LFS
Associate .git* configuration files with the default text editor
Associate .sh files to be run with Bash

Use Visual Studio Code as Git's default editor

Use Git from the Windows Command Prompt

Use the OpenSSL library

Checkout Windows-style, commit Unix-style line endings

Use MinTTY

Enable file system caching
Enable GIT Credential Manager

Docker

Comando	Descrição
`docker pull {nome da imagem}`	Baixar uma imagem
`docker images -a`	Listar imagens
`docker rmi {id}`	Apagar uma imagem
`docker ps -a`	Listar recipientes
`docker run {lista de parâmetros}`	Iniciar um recipiente
`docker rm --force {id}`	Apagar um recipiente

Verifique se a virtualização está ativada no computador utilizando a aba desempenho do gerenciador de tarefas. Caso a virtualização esteja desativada é necessário ativa-lá nas configurações do processador na BIOS.
Instale o Docker para Windows.

Projeto

Abra o Visual Studio Code e a pasta para projetos.

Abra as configurações do usuário CTRL+, e altere as propriedades abaixo.

{
    "editor.fontFamily": "Fira Code",
    "editor.fontSize": 14,
    "editor.fontLigatures": true,
    "editor.tabSize": 4,
    "editor.renderWhitespace": "all",
    "editor.insertSpaces": true,
    "editor.detectIndentation": false,
    "editor.formatOnSave": true,
    "files.insertFinalNewline": true,
    "pgsql.connection": "postgres://dev:Password1@localhost:5432/dev"
}

Abra o terminal PowerShell integrado CTRL+`.
Instale a extensão PostgreSQL no Visual Studio Code.
```
code --install-extension doublefint.pgsql
```
Baixe a imagem do PostgreSQL no Docker.
```
docker pull postgres
```

Inicie um recipiente PostgreSQL no Docker.

docker run --name postgres-dev -e POSTGRES_USER=dev -e POSTGRES_PASSWORD=Password1 -p 5432:5432 -d postgres

# Verifique se o recipiente está ativo
# docker ps -a

Baixe o projeto e abra o arquivo postgre.sql.

git clone https://github.com/incompletude/bancodedados.git

Abra a paleta de comandos CTRL+SHIFT+P e execute o arquivo postgre.sql escolhendo o comando run in postgres.

Próximos passos

Escalabilidade com partições.

ramonwt/bancodedados