PostgreSQL 9.4 Primeiros Passos no Microsoft Windows

Transcrição

1 PostgreSQL 9.4 Primeiros Passos no Microsoft Windows Uma das maiores dificuldades quando se começa a trabalhar com qualquer software é dar os assim chamados primeiros passos: instalação, configuração inicial e conceitos básicos. Este documento é um tutorial passo-a-passo sobre como iniciar o uso do PostgreSQL versão 9.4 no Microsoft Windows. Antes de iniciar, por gentileza, baixe o instalador a partir de (32 ou 64 bits, conforme o seu sistema operacional). Este tutorial foi feito em um computador executando Microsoft Windows bits, em português. No entanto, as instruções são válidas a partir do Microsoft Windows Vista. Os sites e outros recursos on-line apresentados neste tutorial têm como data de acesso o dia 20/2/2015. Assumimos que o leitor tenha um conhecimento básico a respeito de projetos de bases de dados. Em particular, não procuramos ensinar, aqui, nada relacionado. Pelo contrário, os exemplos são propositalmente simples, pois o objetivo é apresentar o PostgreSQL. Por gentileza, note que, como colocamos acima, são apenas os primeiros passos, nem mais, nem menos. Para se utilizar efetivamente o produto, é necessário tempo, experiência e dedicação aos estudos (leitura, treinamentos etc.). Também não procuramos aprofundar os conceitos apresentados. Pelo contrário, damos uma cobertura propositalmente superficial, apresentando o mínimo necessário para se iniciar.

2 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 2 de 25 Sumário 1. Instalação do PostgreSQL 9.4 no Microsoft Windows O serviço do PostgreSQL O pgadmin III e o psql.exe O pgadmin III O psql.exe Exemplo passo a passo de criação de base de dados Criação de um tablespace chamado vendas Criação de uma base de dados vendas_db dentro do tablespace vendas Criação de um schema comercial dentro da base vendas_db Criação de uma tabela de dados Clientes dentro do schema comercial Acesso de usuários ao PostgreSQL Criação de um login role chamado acesso_web Edição dos arquivos pg_hba.conf e postgresql.conf Criação de um Group Role chamado vendas_pela_web Colocação de um login role (acesso_web) dentro de um group role (vendas_pela_web) Atribuição de permissão de conexão de um group role (vendas_pela_web) a uma base de dados (vendas_db) Atribuição de permissão de uso de um schemas (comercial) a um group role (vendas_pela_web) Atribuição de permissão de uso de uma tabela (comercial.clientes) a um group role (vendas_pela_web) Ajustes no arquivo postgresql.conf... 25

3 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 3 de Instalação do PostgreSQL 9.4 no Microsoft Windows Com privilégios de administrador, execute o instalador (postgresql windows.exe ou postgresql windows-x64.exe). Siga os passos abaixo. Os pontos importantes são destacados em vermelho nas figuras: 1.1. Durante a instalação, pode ser solicitada a instalação do Microsoft Visual C++ Runtime como parte do processo. Permita Tela inicial do assistente: 1.3. Tela de seleção de pasta de destino. Instale em uma pasta sem espaços e sem caracteres acentuados em seu nome, algo como C:\PostgreSQL\9.4: No restante deste material, faremos referência a esta pasta de instalação como <INSTALL_DIR>.

4 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 4 de Tela de seleção da pasta padrão de dados. Instale em uma pasta sem espaços e sem caracteres acentuados em seu nome, como C:\PostgreSQL\9.4\data. Aqui, assumiremos a pasta padrão, <INSTALL_DIR>\data: 1.5. O PostgreSQL tem uma conta de administrador chamada postgres. Dê uma senha adequada: 1.6. Escolha a porta de TCP a ser utilizada para a conexão dos clientes. A porta padrão é a 5432, e manteremos esta escolha: ATENÇÃO! Para que os aplicativos possam se comunicar com o PostgreSQL, é necessário abrir esta porta de TCP/IP no firewall do Microsoft Windows. IMPORTANTE! Após a instalação, garanta que o firewall do Microsoft Windows permite entrada e saída para os processos <INSTALL_DIR>\bin\pg_ctl.exe e <INSTALL_DIR>\bin\postgres.exe Escolha o LOCALE para exibição de moeda, classificação etc. Aqui, estamos utilizando português do Brasil: 1.8. Esta é a sua última chance para voltar e fazer alterações. Tudo ok, prossiga:

5 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 5 de Aguarde a finalização da instalação: Ao final, será solicitada a sua permissão para executar o Application Stack Builder, um utilitário que baixa, da Internet, componentes opcionais do PostgreSQL. Por enquanto, não o execute. Para executá-lo posteriormente, ative o programa <INSTALL_DIR>\bin\stackbuilder.exe (repare sua localização em relação à pasta que escolhemos no passo1.3). 2. O serviço do PostgreSQL Nos serviços do Microsoft Windows (execute services.msc para visualizar a tela abaixo), o PostgreSQL deverá aparecer como postgresql-9.4:

6 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 6 de 25 Repare que o mesmo está marcado como Em Execução e com tipo de inicialização Automático. Dê um duplo clique na linha marcada para exibir o diálogo de detalhes do serviço, guia Geral: Na guia Logon, repare que o serviço inicializa sob as credenciais de Serviço de Rede, ou Network Service no Microsoft Windows em inglês: IMPORTANTE! Esta conta deve ter direitos de leitura e de escrita nas pastas de dados do PostgreSQL, tanto as que você definir como aquela escolhida no passo 1.4 da instalação:

7 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 7 de O pgadmin III e o psql.exe pgadmin III e psql.exe são clientes para administração do PostgreSQL. Enquanto o pgadmin III é uma ferramenta gráfica, o psql.exe é um cliente em modo texto (roda no prompt de comando do shell) O pgadmin III O pgadmin III é instalado juntamente com o PostgreSQL. Execute-o a partir de <INSTALL_DIR>\bin\pgAdmin3.exe, adaptando o caminho conforme a pasta de instalação escolhida no item 1.3. Ao clicar no servidor em localhost:5432, será solicitada a senha para o login postgres. A senha é aquela fornecida no item 1.5:

8 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 8 de 25 Para adicionar novos servidores (além do localhost:5432) ao console de administração, selecione o nó Servers, vá ao menu File e escolha Add Server..: O pgadmin III pode ser instalado separadamente, sem o banco de dados. Basta baixar seu instalador a partir de Após a conexão bem sucedida, a tela ficará parecida com isso:

9 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 9 de 25 O painel da esquerda é o Object browser (Navegador de objetos). Note que há: Uma base de dados, chamada postgres, destacada no quadro vermelho. Essa base está selecionada e, com isso, seu script SQL de criação aparece no painel inferior direito, chamado de SQL pane. Uma base de dados é uma estrutura onde vão os elementos de acesso a dados relacionados: tabelas, índices, views etc. Essa é uma base de sistema. Para nossas aplicações, criamos as nossas próprias bases de dados; Dois tablespaces de sistema, chamados pg_default e pg_global, destacados no quadro verde. Um tablespace é um nome lógico para uma pasta. Quando criamos algo como uma base ou tabela, por exemplo, especificamos em qual tablespace elas vão. Isso nos permite definir exatamente qual o layout de utilização de disco desejamos; Um login, chamado postgres (aquele criado no passo 1.5 da instalação). Um login é um par nome/senha utilizado para acessar o PostgreSQL. Qualquer item que for selecionado terá seu script de criação exibido no SQL pane. Também é possível abrir a janela Query, destinada à emissão de comandos SQL. Com a base postgres selecionada, clicamos no botão SQL ( ), na barra de ferramentas do alto da tela, ou usamos a opção de menu Tools -> Query Tool. A janela Query será aberta: Na barra de título, destacamos o nome da base postgres em vermelho, o login postgres em amarelo, e o servidor/porta localhost:5432 em laranja. No painel superior, o comando SQL SELECT current_date AS Hoje; e, no inferior, seu resultado.

10 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 10 de O psql.exe O psql.exe é um cliente em modo texto localizado em <INSTALL_DIR>\bin\psql.exe. Para executá-lo, abra um prompt de comando (cmd.exe), vá para <INSTALL_DIR>\bin e execute o comando. Para ver todas as opções, execute: psql.exe --help Uma linha de comando bastante comum é: onde: psql.exe -h localhost -p U postgres -d postgres -h localhost p 5432: host e porta de conexão; -U postgres: nome do login; -d postgres: nome da base de dados desejada (os comandos serão emitidos contra ela). Note que maiúsculas e minúsculas fazem diferença nos comandos. Se a conexão tiver sucesso, você verá algo como: A primeira linha é o comando. A segunda, a solicitação da senha (item 1.5). As linhas que iniciam com postgres=# são os prompts de comando. Note o comando SELECT current_date AS Hoje;, que começa em uma linha e termina em outra. O ponto-evírgula (;) é o que indica o fim do comando. Logo na sequência, o resultado de sua execução. Por fim, o comando \q encerra o aplicativo. 4. Exemplo passo a passo de criação de base de dados Nesta seção, mostraremos como criar, passo a passo, um tablespace, uma base dedados, tabelas e permissões de acesso Criação de um tablespace chamado vendas Um tablespace é um nome lógico para uma pasta física. Vamos criar um tablespace chamado vendas, que aponta para a pasta física c:\dados_pg\vendas Crie uma pasta, como c:\dados_pg\vendas.

11 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 11 de Garanta que o usuário do serviço do PostgreSQL (item 2), normalmente chamado Serviço de Rede, tenha permissão de controle total na pasta c:\dados_pg\vendas. A partir do Windows Explorer, Botão Secundário do Mouse -> menu Propriedades -> guia Segurança -> botão Editar: Depois de clicar em Editar..., vá até Localizar agora...: Adicione o Serviço de Rede com permissão de Controle Total:

12 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 12 de Finalmente, confirme as alterações: No pgadmin III, no painel da esquerda (Object browser), selecione Tablespaces. Vá ao menu Edit -> New Object -> New Tablespace... Deixe assim:

13 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 13 de 25 Pressione OK ao final. Veja, no Object browser, o novo tablespace. Clique no mesmo e veja, no SQL pane, o comando SQL para a sua criação (CREATE TABLESPACE vendas...) Criação de uma base de dados vendas_db dentro do tablespace vendas Vamos criar uma base de dados chamada vendas_db No Object browser, selecione Databases Vá ao menu Edit -> New Object -> New Database... Deixe assim: Note o nome da base, o Encoding (codificação de caracteres), o tablespace vendas e a colação Portuguese_Brazil Uma colação diz respeito a como os campos de texto se comportam quando classificados. Pressione OK ao final Veja, no Object browser, sob Databases, a nova base de dados Criação de um schema comercial dentro da base vendas_db Um schema é um artifício organizacional dentro da base de dados. Serve para agrupar itens com finalidades relacionadas. Por exemplo, poderíamos ter um schema chamado estoque para todos os itens, como tabelas e views, relacionados ao estoque, outro chamado comercial para todos os itens relativos a vendas, e assim por diante. Vamos criar um schema chamado comercial. Note que, ao expandir, no Object browser, Databases -> vendas_db -> Schemas, já há um schema padrão chamado public.

14 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 14 de Selecione, no Object browser, Databases -> vendas_db -> Schemas Vá ao menu Edit -> New Object -> New Schema... Deixe assim: Clique OK para criar o schema comercial e observe o efeito no Object browser, que deve estar assim: Ao criarmos um item, digamos uma tabela, dentro do schema comercial, estabelecemos uma relação de hierarquia. Por exemplo, se chamarmos a tabela de Clientes, o nome real da tabela será comercial.clientes. Isso quer dizer que, na mesma base, pode haver outras tabelas chamadas Clientes, desde que estejam em outros schemas Criação de uma tabela de dados Clientes dentro do schema comercial As tabelas de dados são as estruturas dentro das quais a maior parte dos dados fica armazenada. Há outras estruturas que armazenam dados, como os índices, mas a maior parte fica nas tabelas. Neste exemplo, criaremos, dentro do schema comercial, uma tabela chamada Clientes, com três campos: Código (inteiro, chave primária, não nulo);

15 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 15 de 25 Nome (varchar(30), não nulo); Telefone (varchar(30), não nulo) Selecione, no Object browser, Databases -> vendas_db -> Schemas -> comercial -> Tables Vá ao menu Edit -> New Object -> New Table... Na guia Properties, digite o nome Clientes e certifiquese de que o schema seja o comercial, como em: Assim, nossa tabela se chamará, realmente, comercial.clientes Na guia Definition, selecione o tablespace vendas, o que significa que os dados dessa tabela serão aí armazenados (item 4.1 deste tutorial): Seleciona a guia Columns. Aqui, definiremos os campos (colunas) de nossa tabela. Clique no botão Add para adicionar a primeira coluna, Código:

16 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 16 de Após clicar OK, a janela de definição de colunas deve estar assim: Adicione mais duas colunas, Nome e Telefone, ambas do tipo (Data type) character varying (correspondente a varchar em outros bancos de dados). Devem ter tamanho (length) 30 e serem não nulas (not null). Após a sua adição, a guia Columns deverá estar assim:

17 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 17 de Vamos adicionar a chave primária tendo como único campo o Código. Selecione a guia Constraints. Certifique-se de que o tipo de constraint selecionado seja Primary Key e clique no botão Add: A janela New Primary Key... será exibida. Sob a guia Properties, dê um nome para a chave primária. Esse nome deve ser único na base de dados. No exemplo, usamos o esquema de nome pk_sss_ttt, onde SSS é o nome do schema (comercial) e TTT é o nome da tabela (Clientes): Na guia Columns, selecione a coluna Código e clique o botão Add, seguido pelo botão OK, pois não temos mais campos a adicionar na chave primária:

18 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 18 de De volta ao diálogo New Table..., temos: Clique na guia SQL. Aqui, vemos o comando SQL necessário para criar a nossa tabela: Repare que alguns nomes estão entre aspas. O uso das aspas diz ao PostgreSQL para preservar a caixa (maiúsculas/minúsculas) das letras. Sem as aspas, tudo seria convertido para minúsculas. Isso vale para todos os comandos

19 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 19 de 25 enviados ao PostgreSQL que envolvam nomes (de bases de dados, de schemas, de tabelas etc.) Para finalizar, clique OK. Veja, no Object browser, como ficou: 5. Acesso de usuários ao PostgreSQL Nesta seção veremos como criar logins, roles e permissões de acesso Criação de um login role chamado acesso_web O primeiro passo para se acessar o PostgreSQL é ter um login role. Um login role pode ser pensado como um par usuário/senha, como o do sistema operacional. Naturalmente, podemos ter diversos login roles. Para criar um login role chamado acesso_web, com senha 123, siga os seguintes passos: Execute o pgadmin III e conecte-se como postgres (passo 1.5 deste tutorial) No Object browser, selecione Login Roles (já há um login role, o postgres, que estamos usando) Vá ao menu Edit -> New Object -> New Login Role Na guia Properties, vamos criar um login role com o nome de acesso_web e senha 123. Siga os passos:

20 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 20 de 25 Repare, no Object browser, sob Login Roles, o novo, recém-criado, acesso_web. Se você selecioná-lo, verá no SQL pane seu script de criação. Perceba que a senha que demos, 123, aparece como md5.... Isso porque foi calculado o hash MD5 da palavra 123, e este foi armazenado Edição dos arquivos pg_hba.conf e postgresql.conf Após a criação desse login role, acesso_web, devemos dizer ao PostgreSQL a qual base(s) o mesmo tem acesso, e a partir de qual, ou quais, endereços de IP. Para isso, editamos primeiramente o arquivo pg_hba.conf, encontrado na pasta de dados definida no passo 1.4 deste tutorial como sendo <INSTALL_DIR>\data. Abra o pg_hba.conf com o bloco de notas e acrescente, ao final, a seguinte linha (maiúsculas e minúsculas fazem diferença): Onde: host vendas_db acesso_web /0 md5 host: significa conexão por meio de socket de TCP/IP; vendas_db: a base à qual queremos dar acesso. Para dar acesso a todas as bases, usaríamos all; acesso_web: o login role que terá acesso à base vendas_db. Para mais de um login role, separe-os com vírgulas, sem deixar espaços. Para dar acesso a todos os login roles, usaríamos all; /0: de onde acesso_web pode fazer o acesso /0 significa todos os hosts. No entanto, poderíamos ter algo como /32, significando acesso apenas a partir do IP , ou /24, significando acesso a partir de qualquer máquina na rede ; md5: significa senha md5 (veja o item 5.1.4). Na sequência, editamos o arquivo postgresql.conf, encontrado na mesma pasta do pg_hba.conf. Nesse arquivo, procure pela diretiva listen_addresses. Ela diz em qual interfaces de rede o PostgreSQL vai aceitar conexões, no host onde foi instalado. Uma diretiva como: listen_addresses = '*' significa aceitar conexões em todas as interfaces de rede. Uma diretiva como: listen_addresses = ' , , ' significa aceitar conexões nas interfaces de rede cujos endereços IP foram os fornecidos três fornecidos ( , e ). IMPORTANTE! Após qualquer alteração nos arquivos hba.conf ou postgresql.conf, o serviço do PostgreSQL (item 2 deste tutorial) deve ser reiniciado. IMPORTANTE! Garanta que o firewall do Microsoft Windows permite entrada e saída para os processos <INSTALL_DIR>\bin\pg_ctl.exe e <INSTALL_DIR>\bin\postgres.exe.

21 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 21 de Criação de um Group Role chamado vendas_pela_web Um Group Role é um agrupamento de zero ou mais login roles. Usamos os group roles para atribuir permissões em tabelas, views etc. Neste exemplo, criaremos um group role chamado vendas_pela_web, e faremos como seu membro o login role acesso_web. Siga os seguintes passos: Execute o pgadmin III e conecte-se como postgres (passo 1.5 deste tutorial) No Object browser, selecione Group Roles Vá ao menu Edit -> New Object -> New Group Role Na guia Properties, vamos criar um group role com o nome de vendas_pela_web. Siga os passos: Repare, no Object browser, o novo Group Role criado, vendas_pela_web Colocação de um login role (acesso_web) dentro de um group role (vendas_pela_web) Neste ponto, vamos colocar o login role acesso_web, criado no passo 5.1, dentro do group role vendas_pela_web, criado no passo 5.3. Após isso, todas as permissões que dermos ao group role vendas_pela_web em tabelas etc. serão herdadas por seus membros (neste exemplo, acesso_web) Execute o pgadmin III e conecte-se como postgres (passo 1.5 deste tutorial) No Object browser, expanda Login Roles e selecione acesso_web Vá ao menu Edit -> Properties Na guia Properties, vamos criar um login role com o nome de acesso_web e senha 123. Siga os passos:

22 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 22 de 25 Repare que, na caixa Not Member, aparecem todos os group roles dos quais acesso_web não é membro. Selecione vendas_pela_web. Se houvesse outros group roles, poderíamos adicionar acesso_web a mais de um. Selecione vendas_pela_web e clique o botão >> Após a seleção ter sido feita, teremos: Veja o comando SQL necessário à operação (3)(4). Clique OK para finalizar Atribuição de permissão de conexão de um group role (vendas_pela_web) a uma base de dados (vendas_db) Vamos, agora, permitir que o group role vendas_pela_web (e todos os login roles associados ao mesmo, conforme o passo 5.4) tenha direito de conexão à base vendas_db Execute o pgadmin III e conecte-se como postgres (passo 1.5 deste tutorial) No Object browser, expanda Databases e selecione vendas_db Vá ao menu Edit -> Properties Nas propriedades da base vendas_db, atribua direito de conexão a vendas_pela_web:

23 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 23 de Eis o comando SQL resultante. Confira e clique OK: 5.6. Atribuição de permissão de uso de um schemas (comercial) a um group role (vendas_pela_web) Agora, vamos permitir que o group role vendas_pela_web, e todos os login roles associados ao mesmo (neste caso, acesso_web), tenham acesso ao schema comercial Execute o pgadmin III e conecte-se como postgres (passo 1.5 deste tutorial) No Object browser, expanda Databases -> vendas_db -> schemas e selecione o schemas comercial Vá ao menu Edit -> Properties Nas propriedades do schemas comercial, atribua permissões a vendas_pela_web: Aqui, definimos os privilégios como ALL, o que significa, além de usar tabelas, views etc., também poderá criar novos itens. No entanto, USAGE seria uma escolha mais moderada, significando que pode usar os itens existentes apenas.

24 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 24 de Eis o comando SQL resultante. Confira e clique OK: 5.7. Atribuição de permissão de uso de uma tabela (comercial.clientes) a um group role (vendas_pela_web) Agora, vamos permitir que o group role vendas_pela_web, e todos os login roles associados ao mesmo (neste caso, acesso_web), tenham acesso à tabela comercial.clientes Execute o pgadmin III e conecte-se como postgres (passo 1.5 deste tutorial) No Object browser, expanda Databases -> vendas_db -> schemas -> comercial -> Tables e selecione a tabela Clientes Vá ao menu Edit -> Properties Nas propriedades da tabela comercial.clientes, atribua permissões a vendas_pela_web: Confira o comando SQL gerado e clique OK:

25 PostgreSQL Primeiros Passos no Microsoft Windows Márcio A. Siena Página 25 de Ajustes no arquivo postgresql.conf O arquivo <INSTALL_DIR>\data\postgresql.conf controla diversos aspectos importantes do PostgreSQL. Apresentamos, aqui, alguns parâmetros de configuração de uso mais imediato para iniciantes, em especial aqueles que estão utilizando o software para desenvolvimento web. IMPORTANTE! Após qualquer alteração nos arquivos hba.conf ou postgresql.conf, o serviço do PostgreSQL (item 2 deste tutorial) deve ser reiniciado. IMPORTANTE! Maiúsculas e minúsculas fazem diferença. port: a porta de TCP a ser utilizada. O padrão é max_connections: número máximo de conexões simultâneas. Especialmente importante em aplicativos web, onde muitas conexões são abertas e fechadas em curto espaço de tempo. shared_buffers: controla a quantidade de memória alocada a buffers compartilhados. Experimente com este valor (aumentar e diminuir), e veja o que funciona bem em seu ambiente. * * * Com isso, encerramos nosso breve tutorial. Obrigado, e boa sorte! Márcio A. Siena Consultoria & Treinamento em Engenharia de Sistemas e Software marcio@masiena.com.br masiena@hotmail.com