$ dbaguide.com / cheat-sheets / postgresql

psql CLI Hızlı Referans

PostgreSQL Komut Satırı Tam Referansı

v16 / v17 uyumlu

Güncelleme: Ekim 2026 · Production-grade

Bağlantı Komutları

KOMUT	AÇIKLAMA
psql -U postgres -d mydb	Kullanıcı ve veritabanı belirterek bağlan
psql -h 192.168.1.10 -p 5432 -U app_user -d prod_db ↳ Uzak sunucuya bağlan
psql "postgresql://user:pass@host:5432/dbname" ↳ Connection string (URI) formatı
psql -U postgres -d mydb -c "SELECT version();" ↳ Tek komut çalıştır ve çık
psql -U postgres -f /path/to/script.sql ↳ SQL dosyası çalıştır
PGPASSWORD=secret psql -U user -d db	Env değişkeni ile şifre
psql -U postgres -d mydb -q	Quiet mode (mesajları bastır)

.pgpass dosyası: hostname:port:database:username:password — chmod 600 olmalı.

Değişkenler & Ayarlar

KOMUT	AÇIKLAMA
\set VAR value	Değişken tanımla
\unset VAR	Değişkeni sil
\set	Tüm değişkenleri listele
SELECT :'VAR';	Değişkeni sorguda kullan
\echo :VAR	Değişken değerini yazdır
\setenv PGTZ 'UTC'	Ortam değişkeni ayarla

ÖRNEK KULLANIM

\set schema public SELECT * FROM :'schema'.users LIMIT 10;

Yardım & Pratik Komutlar

\?	Tüm meta komutları listele
\h SELECT	SQL komutu sözdizimi yardımı
\gx	Son sorguyu expanded modda çalıştır
\watch 5	Son sorguyu 5 sn'de bir tekrarla
\errverbose	Son hatayı tüm detaylarıyla göster

Meta Komutlar (Backslash Commands)

Veritabanı & Bağlantı

\l veya \list	Tüm veritabanlarını listele
\c mydb	Veritabanı değiştir
\conninfo	Aktif bağlantı bilgilerini göster
\q	psql'den çık

Tablo & Şema

\dt	Geçerli şemadaki tabloları listele
\dt public.*	public şemasındaki tüm tablolar
\d tablename	Tablo yapısını göster
\d+ tablename	Detaylı tablo bilgisi (boyut dahil)
\dn	Şemaları listele
\dn+	Şemalar + izinler
\dv	View'ları listele
\dm	Materialized view'ları listele
\di	İndeksleri listele
\df	Fonksiyonları listele
\ds	Sequence'ları listele

Kullanıcı & Yetki

\du	Roller ve kullanıcıları listele
\dp tablename	Tablo izinlerini göster
\z tablename	\dp ile aynı

Herhangi bir meta komuta + ekleyerek (ör. \dt+, \df+) boyut, açıklama ve sahip bilgisini görebilirsiniz. \? tüm meta komutları listeler.

.psqlrc Örnek Yapılandırma

-- ~/.psqlrc (her psql oturumunda otomatik yüklenir) \set QUIET 1 \timing on \x auto \set PROMPT1 '%[%033[1;32m%]%n@%/%[%033[0m%]# ' \set HISTSIZE 10000 \set COMP_KEYWORD_CASE upper \unset QUIET

Çıktı & Format Ayarları

KOMUT	AÇIKLAMA
\x	Expanded (dikey) modu aç/kapat
\x auto	Otomatik genişletilmiş mod
\a	Aligned / unaligned mod değiştir
\t	Sadece satırları göster (tuple only)
\timing	Sorgu süresini ölç ve göster
\pset border 2	Çerçeve kalınlığı ayarla
\pset format csv	CSV formatında çıktı
\o /tmp/output.txt	Çıktıyı dosyaya yönlendir
\o	Dosyaya yönlendirmeyi kapat
\H	HTML çıktı modu

Sorgu & Script Yönetimi

KOMUT	AÇIKLAMA
\e	Sorguyu harici editörde aç ($EDITOR)
\ef function_name	Fonksiyon tanımını editörde aç
\ev view_name	View tanımını editörde aç
\g	Son sorguyu tekrar çalıştır
\g /tmp/result.csv	Son sorguyu dosyaya kaydet
\i /path/to/file.sql	SQL dosyasını çalıştır
\ir relative/path.sql	Göreli yolda SQL dosyası çalıştır
\s	Komut geçmişini göster
\s /tmp/history.sql	Geçmişi dosyaya kaydet

COPY & Veri İçe/Dışa Aktarma

KOMUT	AÇIKLAMA
\copy table TO '/tmp/out.csv' CSV HEADER ↳ Tabloyu CSV'ye aktar (istemci taraflı)
\copy table FROM '/tmp/in.csv' CSV HEADER ↳ CSV'den tabloya aktar
\copy (SELECT ...) TO '/tmp/q.csv' CSV HEADER ↳ Sorgu sonucunu CSV'ye aktar
\copy table TO STDOUT	Standart çıktıya aktar

\copy istemci taraflıdır; COPY sunucu taraflıdır. Dosya izinleri farklıdır.

Hata Ayıklama & Bilgi Sorguları

pg_stat_activity · pg_stat_user_tables · pg_locks

Aktif Bağlantılar

-- Aktif bağlantılar SELECT pid, usename, application_name, state, query FROM pg_stat_activity WHERE state != 'idle';

Tablo Boyutları

-- Tablo boyutları SELECT relname, pg_size_pretty( pg_total_relation_size(relid)) FROM pg_stat_user_tables ORDER BY pg_total_relation_size(relid) DESC;

Uzun Süren Sorgular

-- Uzun süren sorgular SELECT pid, now() - query_start AS duration, query FROM pg_stat_activity WHERE state = 'active' AND now() - query_start > interval '5 min';

Lock Bekleyenler

-- Lock bekleyenler SELECT pid, relation::regclass, mode, granted FROM pg_locks WHERE NOT granted;