Instalando o PostgreSQL

Execute o instalador em modo Administrador:

Clique em Next para iniciar o assistente:

Especifique o local de instalação do PostgreSQL:

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

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

Defina a senha para o usuário postgres:

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

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

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

Clique em Next para iniciar a instalação:

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

Instalando o driver ODBC

É necessária 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.

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

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

Clique em Next para iniciar: 

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

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

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

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

Criando uma database PostgreSQL

É necessário preparar a instância para poder criar uma database. Para isso será utilizado o aplicativo pgAdmin, que é instalado junto com o produto.

Localize o aplicativo e execute-o:

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

Criando um usuário

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, é necessário definir uma senha também; somente com este conjunto de informações será possível acessar a instância PostgreSQL e gerenciar a database.

Uma tablespace é 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.

Expanda o ícone de Servers, e clique em PostgreSQL 12. Este 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:

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

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

Defina um nome para a conexão. Na aba Definition, defina a senha da nova conexão. Lembre-se de salvar esta senha em um local seguro.

Na aba Privileges, marque as opções:

• Can login = Yes
• Super User = Yes
• Create roles = Yes
• Create databases = Yes
• Inherit rights from the parent roles = Yes

Os privilégios do usuário serão fundamentais para que o acesso e uso da instância ocorram normalmente. Após realizar as definições, clique em Save para criar o usuário.

Criando uma Tablespace

Agora é preciso definir o local onde os arquivos de dados serão armazenados. Para isso teremos que criar uma tablespace. Clique com o botão direito no item Tablespaces. No menu suspenso selecione Create > Tablespace. Surgirá uma nova janela:

Na aba General, defina um nome para a sua tablespace e selecione o usuário criado anteriormente para o owner.

Na aba Definition, defina o local (pasta/diretório) de armazenamento dos arquivos da database.

Após realizar as definições clique em Save para criar a tablespace.

Criando a database

Clique com o botão direito do mouse sobre Databases. No menu suspenso selecione Create > Database. Surgirá uma nova janela:

Na aba General, preencha o nome da database e defina o owner como o usuário recém-criado:

Na aba Definition, selecione o Encoding WIN1252, o Template template0, a tablespace criada, a collation C, e o character type C. 

Clique em Save para criar a database. Clique com o botão direito do mouse no item Databases, e clique em Refresh. Verifique se sua database está relacionada no item Databases.

Agora é necessário configurar uma conexão ODBC.

Criando uma conexão ODBC com o banco de dados

Execute o utilitário do Windows ODBC Data Sources, de acordo com a sua arquitetura (32 ou 64 bits). 

A interface será similar a esta:

Para criar uma nova conexão devemos utilizar a aba System DSN (DSN de Sistema). Dentro desta aba clique no botão Add/Adicionar. Surgirá uma nova janela:

Note que podem existir inúmeros drivers instalados. Cada um possibilita a conectividade com um tipo de banco diferente, por exemplo SQL Server, Oracle etc. As informações nesta janela podem variar, de acordo com o que já foi instalado previamente no equipamento. Fique atento para selecionar o tipo de driver corretamente.

Se o ODBC instalado foi o de ambas as arquiteturas, as opções serão similares à imagem: 

- PostgreSQL ANSI

- PostgreSQL ANSI(x64)

- PostgreSQL Unicode

- PostgreSQL Unicode(x64)

Se apenas o ODBC x64 foi instalado, haverão duas opções disponíveis para PostgreSQL:

- PostgreSQL ANSI(x64)

- PostgreSQL Unicode(x64)

Selecione o padrão PostgreSQL ANSI, caso sua arquitetura seja de 32 bits, ou PostgreSQL ANSI(x64), caso seja de 64 bits, e clique em Finish/Concluir.

Surgirá uma nova janela. É nela onde informaremos os dados para a conexão com o PostgreSQL:

Utilize as seguintes definições para a conexão ODBC:

Data Source = defina um nome para esta conexão ODBC. Aqui vale a mesma regra de nomenclatura usada para o PostgreSQL. Não use caracteres acentuados, especiais nem espaço.

Description = fique à vontade para acrescentar um breve comentário neste campo. É meramente descritivo e não é obrigatório.

Database = especifique o nome da database criada no PostgreSQL anteriormente. É muito importante colocar o nome da mesma forma como ele está dentro da instância, pois como foi descrito anteriormente, o PostgreSQL é case sensitive e diferencia letras maiúsculas de minúsculas.

SSL Mode = por padrão já vem desabilitado (disable). Não modifique este valor.

Server = deve ser informado o endereço IP ou o nome do computador onde a instância PostgreSQL está instalada. Como o escopo deste documento trata de ambiente local, pode-se utilizar a palavra localhost. Se a instância estiver localizada em um outro computador, especifique o IP ou nome do computador remoto.

Port = é a porta de comunicação com a instância PostgreSQL. Lembre-se que no momento da instalação do produto esta informação foi solicitada. A porta padrão é 5432.

User Name = é o nome do usuário criado na instância PostgreSQL. É com este usuário que o acesso à database será realizado. É o mesmo usuário usado na criação da database (veja os passos descritos na seção Como criar uma database PostgreSQL).

Password = é a senha do usuário da database. É a mesma senha usada na criação do usuário dentro da instância PostgreSQL.

Após fornecer todos os campos, clique em Test para verificar se a comunicação com a database será realizada ou não. Se os dados fornecidos estiverem corretos, será exibida a seguinte janela:

Se houver algum problema de comunicação, verifique os dados e tente novamente.

Após realizar o teste com sucesso, clique em Save para salvar a conexão ODBC.

Configurando o DBAccess para acesso ao banco de dados

Para concluir o processo de comunicação com a database PostgreSQL, será necessário definir uma conexão dentro do DBAccess.

Acesse o utilitário DBMonitor:

Selecione a aba Configurações e acesse a aba PostgreSQL:

Clique no botão Novo. Surgirá uma janela solicitando um nome para a conexão:

Forneça um nome e clique em OK.

A janela anterior será reapresentada com a aba Ambiente preenchida. Em Nome e Senha, utilize o nome de usuário (user name) e senha (password) utilizados na conexão ODBC.

Clique em Salvar. 

Sempre que uma conexão é criada, ela deve ser testada para a validação de seu acesso. Selecione a aba Assistentes e clique em Validação de Conexão:

No assistente de conexão, clique em Avançar. Na tela seguinte, selecione o banco de dados Postgres:

Clique em Avançar. Na próxima tela, insira o nome do ambiente (informado ao criar o ambiente no DBAccess):

Clique em Finalizar. Se tudo estiver configurado corretamente, a mensagem exibida será "Conexão Ok!":

Ao realizar o teste pela primeira vez em uma database vazia, o próprio DBAccess fará a criação de algumas tabelas, comprovando que a database está acessível e pronta para uso. A partir deste momento, basta configurar corretamente seu ambiente no arquivo de configuração appserver.ini para que o Protheus possa utilizá-la.