Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Nota
titleAtenção

Este documento tem como objetivo auxiliar analistas na instalação e configuração básica do banco de dados PostgreSQL em ambientes locais, de desenvolvimento e/ou teste, na plataforma Windows. A instalação e configuração em ambientes de produção não é o foco deste documento.

Para cenários produtivos, utilize o PostgreSQL com Linux.

...

  • Conhecimento do Protheus;
  • Noções básicas de instalação de aplicativos em Windows;
  • Familiaridade com terminologias de banco de dados e novas tecnologias.

...

Informações
titlePré-requisitos

...

e informações adicionais

Neste manual, demonstramos a instalação do PostgreSQL 12, última versão homologada

...

até a data de publicação deste documento.

...

Aviso
titleAtenção - Ambientes de produção

Em ambientes de produção, o ideal é ter um DBA para apoiar na instalação e configuração, por conta de configurações específicas de cenário e tuning no banco de dados.

Informações
titlePreparativos para a instalação
  • Certifique-se de ter espaço em disco suficiente para a instalação. Uma pasta temporária pode ser utilizada para baixar os arquivos de instalação, que podem ser excluídos ao final do procedimento.
  • Obtenha o binário de instalação do PostgreSQL neste link.
  • Obtenha o instalador do ODBC neste link. Neste manual, utilizamos o msi. Baixe o arquivo mais recente disponibilizado.

Instalando o PostgreSQL

Execute o instalador em modo Administrador:

Image Removed

Clique em Next para iniciar o assistente:

Image Removed

Especifique o local de instalação do PostgreSQL:

Image Removed

Desmarque a opção Stack Builder. Clique em Next:

Image Removed

Nota

A opção Stack Builder permite que sejam instalados produtos adicionais ao PostgreSQL, como por exemplo o driver ODBC para uso com este banco. A instalação do driver ODBC para PostgreSQL será abordada mais a frente neste documento.

Especifique o local onde os dados da instância serão armazenados:

Image Removed

Defina a senha para o usuário postgres:

Image Removed

Informações

O usuário postgres é default da instalação, possuindo privilégios administrativos na instância. Defina uma senha para este usuário e armazene-a em um local seguro. Esta senha será necessária para qualquer operação administrativa no banco.

Dica
titleDica

O PostgreSQL é um produto case sensitive, ou seja, ele diferencia letras maiúsculas de minúsculas, portanto fique atento com este detalhe no momento de informar nomes de usuários, tablespaces, databases e senhas. Não utilize caracteres acentuados, caracteres especiais ou espaço na definição destes objetos.

Defina a porta de comunicação com a instância PostgreSQL:

Image Removed

Nota

Essa porta será usada pelo banco para prover comunicação externa, como por exemplo, com o driver ODBC; a porta padrão sugerida é 5432. Pode-se especificar qualquer outro valor desde que não esteja em conflito com outras portas já utilizadas em seu sistema. Sugerimos deixar o valor padrão. Salve esta informação em um local seguro.

Defina o padrão de idioma/caracteres da nova instância PostgreSQL. Selecione a opção C e clique em Next:

Image Removed

Será apresentado o resumo das configurações realizadas. Clique em Next para prosseguir:

Image Removed

Clique em Next para iniciar a instalação:

Image Removed

Aguarde o assistente concluir a instalação. Clique em Finish para encerrar o assistente.

Image Removed

Instalando o driver ODBC

Precisamos de uma conexão ODBC para realizar a comunicação com a database. O padrão ODBC é usado por todos os sistemas operacionais e é um método de acesso seguro.

Obtenha o instalador do ODBC neste link. Neste manual, utilizamos o msi. Baixe o arquivo mais recente disponibilizado.

Image Removed

Navegue até o final da página e selecione o binário conforme sua arquitetura (32 ou 64):

Image Removed

Informações

O último arquivo, que não especifica arquitetura, irá instalar as duas versões.

Informações
titleInformações

A instalação do driver ODBC para PostgreSQL poderá ser realizada através da opção Stack Builder presente no assistente de instalação do próprio PostgreSQL. A decisão de como instalar o driver fica à critério do usuário. A opção Stack Builder só é apresentada pelo assistente quando estamos realizando uma instalação completa do PostgreSQL, portanto, também é bom saber como instalar o driver a partir do binário obtido no site oficial da plataforma.

Descompacte o arquivo zip baixado, clique com o botão direito no arquivo .msi e clique em Instalar:

Image Removed

Clique em Next para iniciar: 

Image Removed

Leia os termos da licença antes da instalação. Após a leitura, marque a opção de aceite e clique em Next:

Image Removed

Selecione a opção ODBC Driver. Clique em Next:

Image Removed

Clique em Install para começar a instalação:

Image Removed

Caso seja solicitado, permita a instalação do ODBC. Ao final da instalação, finalize o assistente.

Image Removed

Criando uma database PostgreSQL

Vamos preparar a instância para podermos criar uma database. Para isso usaremos o aplicativo pgAdmin, que é instalado junto com o produto.
Localize o aplicativo e execute-o:

Image Removed

Informações
As versões mais recentes são aplicações web, porém possuem as mesmas funcionalidades das versões Desktop.

A interface da aplicação web será esta, ou similar a esta:

Image Removed

Criando usuários e tablespaces

Antes de criarmos uma database precisamos criar um usuário e uma tablespace para receber os arquivos físicos.

O usuário será o dono (owner) da database e todos os objetos criados dentro dela, como tabelas, stored procedures, views, etc., serão associados a ele. É através deste usuário que será feito o acesso à database. No momento em que se cria um usuário é preciso se definir uma senha também. Somente através deste conjunto de informações é que poderemos acessar a instância PostgreSQL e gerenciar nossa database.

Uma tablespace nada mais é que uma unidade lógica, associada à um local físico no disco. Esta é a forma como o PostgreSQL gerencia o armazenamento dos dados que compõem uma database. Podemos criar várias tablespaces e associar cada uma delas à um usuário diferente.

Dica
titleBoas práticas

É importante ter em mente que um usuário criado dentro da instância pode ser dono de uma ou mais databases. Considere ideal ter um usuário diferente para cada nova database que você precisar criar. Também é aconselhável utilizar uma tablespace diferente para cada database. Assim, sua instância estará organizada e a manutenção se tornará mais simples.

Expanda o ícone de Servers, e clique em PostgreSQL 12. O número pode variar conforme a versão do banco de dados instalado.

Digite a senha definida para o usuário postgres para se conectar ao servidor:

Image Removed

Clique com o botão direito em Locin/Group roles, selecione Create > Login/Group Role...

Image Removed

A janela para criação de login será similar a esta:

Image Removed

Informações

Os itens de preenchimento obrigatório são:

  • Name (nome)

...

Para prosseguir, recomendamos os seguintes conhecimentos:

  • Conhecimento do Protheus;
  • Noções básicas de instalação de aplicativos em Windows;
  • Familiaridade com terminologias de banco de dados e novas tecnologias.

Os links a seguir possuem conteúdos relevantes ao material apresentado nestas páginas:

Wiki Guia para Report de Problemas  Grupo Telegram com mais de 2mil membros mantido pelo time da timbiras • Ferramentas para o PostgreSQL  Documentação do pgdump  Link para PGTune  Link para documentação DBAccess  Home - PostgreSQL  Documentação initdb - criando um cluster do PostgreSQL

A instalação do PostgreSQL em Windows e a criação de uma base de exemplo é demonstrada nos links a seguir.

Exibir filhos

Image Removed

Informações

Para mais informações sobre os itens da tela de criação de Login/Group Role, confira a documentação do pgAdmin.

Criando uma conexão ODBC com o banco de dados

...