1.4. Acesso a banco de dados #

Após o banco de dados ter sido criado, ele poderá ser acessado:

Você provavelmente vai desejar ativar o psql para executar os exemplos desse tutorial. O psql pode ser ativado para usar o banco de dados meu_bd digitando o comando:

$ psql meu_bd

Se o nome do banco de dados for omitido, então será usado o nome padrão igual ao nome da conta do usuário no sistema operacional. Você já descobriu esse mecanismo na seção anterior usando createdb.

O psql saúda o usuário com a seguinte mensagem:

psql (18.1)
Digite "help" para obter ajuda.

meu_bd=>

A última linha também pode ser:

meu_bd=#

Significando que o usuário é um superusuário do banco de dados, o que geralmente acontece quando você mesmo instalou o PostgreSQL. Ser um superusuário significa não estar sujeito a controles de acesso. Para as finalidades desse tutorial isso não tem importância.

Caso tenha problemas ao executar o psql, retorne à seção anterior. Os diagnósticos do createdb e do psql são semelhantes e, se um funciona, o outro deverá funcionar também.

A última linha exibida pelo psql é a linha de comando (prompt), indicando que o psql está lhe aguardando, e que você pode digitar comandos SQL dentro do espaço de trabalho mantido pelo psql. Tente esses comandos:

meu_bd=> SELECT version();
                                                          version
----------------------------------------------------------------------------------------------------------------------------
 PostgreSQL 18.1 (Debian 18.1-1.pgdg12+2) on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14+deb12u1) 12.2.0, 64-bit
(1 linha)

meu_bd=> SELECT current_date;
 current_date
--------------
 2025-12-23
(1 linha)

meu_bd=> SELECT 2 + 2;
 ?column?
----------
        4
(1 linha)

meu_bd=> SELECT 2 + 2 AS "Quatro";
 Quatro
--------
      4
(1 linha)

O programa psql possui vários comandos internos que não são comandos SQL. Esses comandos começam pelo caractere de contrabarra, \. Por exemplo, pode ser obtida ajuda sobre a sintaxe de vários comandos SQL do PostgreSQL digitando:

meu_bd=> \h

Para sair do psql, digite:

meu_bd=> \q

e o psql terminará retornando para o interpretador de comandos [6]. Para conhecer outros comandos internos digite \? na linha de comando (prompt) do psql. Todas as funcionalidades do psql estão documentadas em psql. Neste tutorial estas funcionalidades não são usadas explicitamente, mas você poderá usá-las por si próprio quando for útil.



[6] Também pode ser usado Ctrl+D ou exit para sair do psql. (N. T.)