psql w PostgreSQL - podstawowe narzędzie administratora (komendy)

W skróciePsql to podstawowy, konsolowy klient PostgreSQL, instalowany razem z binariami serwera. Łączysz się nim do bazy, podając host, port, nazwę bazy i użytkownika, a potem przeglądasz obiekty, uruchamiasz zapytania oraz całe skrypty.

psql, najczęstsze komendy

Podstawowe komendy w psql:

\l            -- lista baz danych
\c nazwa_bazy -- polaczenie z baza
\dt           -- lista tabel
\d tabela     -- opis tabeli

Cheatsheet Cheatsheet edytowalny Ćwiczenie Rozwiązanie ćwiczenia

Uruchamianie psql i ścieżki do klienta

PSQL to podstawy client PostgreSQL. Jest to aplikacja konsolowa instalowana razem z binariami PostgreSQL. Znajduje się tam, gdzie wszystkie inne binaria odpowiednio dla Ubuntu i wersji 15 PostgreSQL:

/usr/lib/postgresql/15/bin/psql

dla CentOS i PostgreSQL w wersji 15 będzie to:

/usr/pgsql-15/bin/psql

Łączenie z bazą i przełączanie między bazami

PSQL przyjmuje przełączniki, które pozwolą wskazać adres hosta, port, bazę danych i użytkownika. - Wywołanie PSQL z parametrami w - kolejności:

psql -h localhost -p 5432 -d postgres -U postgres 

Przełączyć się między bazami w ramach tego samego hosta możemy za pomocą:

\c 

Na przykład tworzymy bazę “example” i się do niej przełączamy:

create database example;
\c example

Zobacz też: Szkolenie Administracja, replikacja i tuning baz danych PostgreSQL

Aby wyjść z PSQL, wystarczy wprowadzić i zatwierdzić:

\q

Pomoc i składnia poleceń

Dostępne komendy zobaczymy, wywołując:

\?

Możemy wyjść z pomocy, wciskając “q”. Jeśli chcemy sprawdzić składnię jakiegoś polecenia, wywołujemy:

\h polecenie

Na przykład:

\h create database

Przeglądanie obiektów bazy: tabele, indeksy, bazy, przestrzenie

Możemy też sprawdzić, jakie tabele są dostępne - w tej bazie danych:

\dt+

Możemy - sprawdzić, jak jest zbudowana tabela:

\d postgres_log

Możemy też sprawdzić jakie indeksy mamy w bazie danych:

\di

Możemy też sprawdzić jakie mamy bazy danych:

\l

Lub przestrzenie tabel wraz z informacją gdzie się znajdują:

\db

Informację o wielkości przestrzeni tabel też możemy wyświetlić, ale musimy zastosować:

\db+

Uruchamianie zapytań i skryptów

Za pomocą PSQL możemy też uruchamiać zewnętrzne skrypty. Stworzyłem skrypt “script.sql” w „/tmp/” i umieściłem w nim:

select current_timestamp;

Aby wywołać skrypt, wykorzystujemy przełącznik „-f” jako parametr psql:

psql -f /tmp/script.sql

Skrypty należy też uruchamiać po zalogowaniu do psql:

\i /tmp/script.sql

Wywołując PSQL, możemy - podać konkretną komendę do wykonania:

psql -c "select current_timestamp;"

W obu powyższych przypadkach powinniśmy zobaczyć wyświetlony aktualny czas i datę.

Informacje o połączeniu i zaawansowane wyświetlanie

Można też zweryfikować informacje o połączeniu:

psql
\conninfo

Bardzo ciekawą opcją jest komenda \gexec. Dzięki niej możemy wydrukować rząd instrukcji które następnie wykonamy. Przedstawię to na przykładzie. Załóżmy, że chcemy dodać jakieś uprawnienie do wybranych tabel użytkownikowi. Najpierw generuje sobie listę komend w oparciu o SQL:

select 'GRANT SELECT ON TABLE '||tablename||' TO EXAMPLE_GUY' from pg_tables where schemaname='public';

To polecenie wydrukuje nam serię grantów:

Teraz możemy użyć \gexec do wywołania tych wydrukowanych komend:

\gexec

Niekiedy potrzebujemy wydrukować jakieś wiersze w psql, ale wyświetlają się one poziomo i to sprawia, że są nieczytelne:

select * from postgres_log limit 1;

W takiej sytuacji dobrze jest znać komendę \x która powoduje wydruk wierszy pionowo:

\x
select * from postgres_log limit 1;

Wynik:

Warto przeczytać dalej

• Zestaw metapoleceń, które najczęściej przydają się administratorowi na co dzień, zebraliśmy w krótszym tekście psql, podstawowe narzędzie administratora.