PostgreSQL Prático/Ferramentas/psql

14.1 - psql

A ferramenta básica de administração do PostgreSQL é o psql, mas é uma ferramenta de administração capaz de administrar praticamente tudo do PostgreSQL.

Para acessá-lo execute:

su – postgresql

psql –U nomeuser nomebanco (tanto no Linux quanto em outros SOs).

Geral:

psql -h host -P port -U user -W (perguntar pela senha)

Alguns comandos do PostgreSQL da linha de comando do SO:

Se num UNIX faça login como usuário do PostgreSQL, se no Windows execute passando -U nomeusuario.

Obtendo ajuda sobre um comando:

comando –help

Se num UNIX existem também as manpages (páginas do manual):

man comando

psql -l -> lista os bancos de dados

psql -U nomeusuario nomebanco -> conectar à console psql no banco de dados

psql banco -E -> (debug) mostra internamente como cada consulta é realizada

psql –version -> mostra versão do PostgreSQL

Outros comandos via linha de comando:

pg_dump, pg_dumpall, pg_restote, createdb, dropdb, createrole, droprole

Alguns Comandos do psql:

Para acessar, estando num UNIX:

su – nomeuserpg

psql -U nomeuserpg nomebanco

Estando no Windows

psql -U nomeuserpg nomebanco

O psql aceita quebra de linhas numa consulta.

O ponto e vírgula (ou <g) indica ordem de execução.

Observe atentamente o prompt e suas variações:

=# - este prompt indica um superusuário

=> - este indica um usuário comum

-# - indica comando não finalizado. Aguardando o ponto e vírgula

(# - aguardando o fecha parênteses )

'# - aguardando um fecha apóstrofo '

Obs.: Em caso de erro teclar Ctrl+C para encerrar. Lembrando que isso no Windows sai do psql.

\q - sair

\c nomebanco nomeuser – Conectar a outro banco

\i /path/script.sql -- importar script.sql

\timing -- iniciar/parar o cronômetro para atividades

\dT+ -- lista os tipos de dados do PG com detalhes

\cd -- mudar para outro diretório

\d – lista tabelas, índices, sequências ou views

\d nometabela – mostra estrutura da tabela

\dt – lista tabelas

\di – lista indices

\ds – lista sequências

\dv – lista views

\dS – lista tabelas do sistema

\dn – lista esquemas

\dp – lista privilégios

\du – lista usuários

\dg – lista grupos

\l - lista todos os bancos do servidor, juntamente com seus donos e codificações

\e - abre o editor vi com a última consulta

\o - inicia/termina a criação de arquivo. Ex.: \o arquivo.sql

\! comando_do_sistemaoperacional -- executa o arquivo do sistema operacional

\? - ajuda geral dos comandos do psql

\h * - exibe ajuda de todos os comandos

\h comandosql – ajuda específica sobre o comando SQL, ex.: \h alter table

\H – ativa/desativa saída em HTML

\encoding – exibe codificação atual

Boa sugestão:

\h CREATE DATABASE

\h CREATE ROLE

Exemplo de saída de consulta em HTML pelo PostgreSQL:

Gerando um relatório em HTML diretamente através do PostgreSQL

\o relatorio.html

SELECT * FROM cep_tabela WHERE uf='CE';

Obs.: Lembre que o PostgreSQL é case sensitive.

Com isso teremos um arquivo HTML contendo todos os registros retornados pela consulta em uma tabela HTML, como no exemplo abaixo:

cep	tipo	logradouro	bairro	municipio	uf
60420440	Rua	Vasco da Gama	Montese	Fortaleza	CE