psql komutları
Meta komutlar sunucuda değil, psql'in (PostgreSQL'in terminal istemcisi) içinde çalışır. Ters eğik çizgiyle başlar ve noktalı virgül gerektirmez.
| Ne yapar | Komut |
|---|
| Veritabanlarını listele | \l |
| Başka bir veritabanına bağlan | \c shop |
| Tabloları listele | \dt |
| Tüm şemalardaki tabloları listele | \dt *.* |
| Bir tabloyu tanımla (sütunlar, indeksler, anahtarlar) | \d users |
| Depolama ve yorumlarla tanımla | \d+ users |
| Şemaları listele | \dn |
| View'ları listele | \dv |
| İndeksleri listele | \di |
| Fonksiyonları listele | \df |
| Rolleri (kullanıcıları) listele | \du |
| Geçerli bağlantıyı göster | \conninfo |
| Bir dosyadan SQL çalıştır | \i setup.sql |
| Sorgu süresi ölçümünü aç veya kapat | \timing |
| Genişletilmiş çıktı (satır başına bir sütun) | \x |
| Son sorguyu düzenleyicinizde aç | \e |
| SQL söz dizimi yardımı | \h CREATE TABLE |
| Tüm meta komutları listele | \? |
| psql'den çık | \q |
Terminalden bağlanma
| Ne yapar | Komut |
|---|
| Bir kullanıcı olarak bir veritabanına bağlan | psql -U postgres -d shop |
| Uzak bir sunucuya ve porta bağlan | psql -h db.example.com -p 5432 -U app -d shop |
| Bağlantı URL'siyle bağlan | psql postgresql://app:secret@localhost:5432/shop |
| Tek bir sorgu çalıştır ve çık | psql -d shop -c "SELECT count(*) FROM users;" |
| Bir SQL dosyası çalıştır | psql -d shop -f setup.sql |
| Kabuktan veritabanı oluştur | createdb shop |
| Kabuktan veritabanı sil | dropdb shop |
Veritabanları ve şemalar
| Ne yapar | SQL |
|---|
| Veritabanı oluştur | CREATE DATABASE shop; |
| Veritabanı sil | DROP DATABASE shop; |
| Geçerli veritabanını göster | SELECT current_database(); |
| Şema oluştur | CREATE SCHEMA sales; |
| Şema arama sırasını göster | SHOW search_path; |
| Önce bir şemaya bak | SET search_path TO sales, public; |
| Sunucu sürümünü göster | SELECT version(); |
Tablolar ve veri tipleri
| Ne yapar | SQL |
|---|
| Identity anahtarlı bir tablo oluştur | CREATE TABLE products (id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY, name text NOT NULL, price numeric(10,2) CHECK (price >= 0), created_at timestamptz DEFAULT now()); |
| Sütun ekle | ALTER TABLE users ADD COLUMN phone text; |
| Sütunu yeniden adlandır | ALTER TABLE users RENAME COLUMN country TO country_code; |
| Sütunun tipini değiştir | ALTER TABLE users ALTER COLUMN age TYPE smallint; |
| Varsayılan değer ata | ALTER TABLE users ALTER COLUMN active SET DEFAULT false; |
| Sütunu sil | ALTER TABLE users DROP COLUMN tags; |
| Tabloyu boşalt ve identity'yi sıfırla | TRUNCATE orders, users RESTART IDENTITY; |
| Varsa tabloyu sil | DROP TABLE IF EXISTS products; |
| Para için tam ondalık sayı | numeric(10,2) |
| Saat dilimli tarih ve saat | timestamptz |
| Rastgele UUID | SELECT gen_random_uuid(); |
| Enum tipi | CREATE TYPE mood AS ENUM ('happy', 'sad'); |
Kısıtlar ve anahtarlar
| Ne yapar | SQL |
|---|
| Birincil anahtar ekle | ALTER TABLE logs ADD PRIMARY KEY (id); |
| Alt satırları da silen yabancı anahtar | CREATE TABLE reviews (id integer PRIMARY KEY, user_id integer REFERENCES users(id) ON DELETE CASCADE); |
| CHECK kısıtı ekle | ALTER TABLE orders ADD CONSTRAINT amount_positive CHECK (amount > 0); |
| NULL'ların eşit sayıldığı unique (15+) | CREATE TABLE emails (address text UNIQUE NULLS NOT DISTINCT); |
| Sütunu zorunlu yap | ALTER TABLE users ALTER COLUMN country SET NOT NULL; |
| Kısıtı kaldır | ALTER TABLE users DROP CONSTRAINT users_email_key; |
Sorgulama (PostgreSQL'e özgü)
Standart SELECT, WHERE ve JOIN SQL hile sayfasında; bunlar PostgreSQL'e özgü biçimler.
| Ne yapar | SQL |
|---|
| Büyük/küçük harf duyarsız eşleşme | SELECT * FROM users WHERE name ILIKE 'a%'; |
| Düzenli ifade eşleşmesi | SELECT * FROM users WHERE email ~ '@example\.com$'; |
| Her grubun ilk satırı | SELECT DISTINCT ON (user_id) user_id, amount FROM orders ORDER BY user_id, amount DESC; |
| Limit ve offset | SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20; |
| Standart satır sınırı | SELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY; |
| :: ile tip dönüştürme | SELECT '42'::integer + 1; |
| NULL için yedek değer | SELECT name, COALESCE(email, 'none') FROM users; |
| NULL'ları eşit sayarak karşılaştır | SELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com'; |
| Sayı serisi üret | SELECT * FROM generate_series(1, 5); |
| Değerleri tek bir metinde topla | SELECT string_agg(name, ', ' ORDER BY name) FROM users; |
| Koşullu toplama | SELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders; |
Ekleme, güncelleme, silme ve upsert
| Ne yapar | SQL |
|---|
| Ekle ve yeni id'yi geri al | INSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id; |
| Birden fazla satır ekle | INSERT INTO users (name) VALUES ('Eli'), ('Femi'); |
| Upsert (ekle ya da güncelle) | INSERT INTO users (name, email) VALUES ('Asha K', 'asha@example.com') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; |
| Ekle, kopyaları yok say | INSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING; |
| Güncelle ve değişen satırları gör | UPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary; |
| Başka bir tablodan güncelle | UPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN'; |
| Sil ve silineni gör | DELETE FROM orders WHERE status = 'refunded' RETURNING id; |
| Başka bir tabloyu kullanarak sil | DELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false; |
| Satırları yeni bir tabloya kopyala | CREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid'; |
JSONB
| Ne yapar | SQL |
|---|
| Bir alanı JSON olarak al | SELECT profile -> 'plan' FROM users; |
| Bir alanı metin olarak al | SELECT profile ->> 'plan' FROM users; |
| İç içe bir alanı metin olarak al | SELECT profile #>> '{address,city}' FROM users; |
| JSON'u bir değer içeren satırlar | SELECT * FROM users WHERE profile @> '{"plan": "pro"}'; |
| Bir anahtarı olan satırlar | SELECT * FROM users WHERE profile ? 'city'; |
| Bir anahtarı ayarla | UPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2; |
| Nesneleri birleştir | UPDATE users SET profile = profile || '{"beta": true}'; |
| Bir anahtarı kaldır | UPDATE users SET profile = profile - 'city'; |
| Sütunlardan JSON oluştur | SELECT jsonb_build_object('id', id, 'name', name) FROM users; |
| Satırları JSON dizisi olarak al | SELECT jsonb_agg(users) FROM users; |
| @> ve ? aramaları için indeks | CREATE INDEX users_profile_idx ON users USING gin (profile); |
Diziler
| Ne yapar | SQL |
|---|
| Dizi değişmezi | SELECT ARRAY[1, 2, 3]; |
| Dizisinde bir değer bulunan satırlar | SELECT * FROM users WHERE 'sql' = ANY(tags); |
| Dizisi bunların hepsini içeren satırlar | SELECT * FROM users WHERE tags @> ARRAY['sql', 'python']; |
| Her öğe için bir satır | SELECT name, unnest(tags) FROM users; |
| Sona öğe ekle | UPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2; |
| Dizi uzunluğu | SELECT name, cardinality(tags) FROM users; |
Tarihler ve saatler
| Ne yapar | SQL |
|---|
| Şu an, saat dilimiyle | SELECT now(); |
| Bugün | SELECT current_date; |
| Bir aralık ekle | SELECT current_date + INTERVAL '7 days'; |
| Son 30 günün satırları | SELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days'; |
| Aya göre kırp | SELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1; |
| Bir parçayı çıkar | SELECT EXTRACT(YEAR FROM hired_on) FROM employees; |
| Tarihler arası fark (gün) | SELECT DATE '2026-12-25' - DATE '2026-11-17'; |
| Tarihler arası yaş | SELECT name, age(current_date, hired_on) FROM employees; |
| Tarihi metin olarak biçimlendir | SELECT to_char(hired_on, 'DD Mon YYYY') FROM employees; |
| Metni tarihe dönüştür | SELECT to_date('17/11/2026', 'DD/MM/YYYY'); |
| Bir saat dilimine çevir | SELECT now() AT TIME ZONE 'Asia/Kolkata'; |
Metin fonksiyonları
| Ne yapar | SQL |
|---|
| Birleştir (NULL, sonucu NULL yapar) | SELECT name || ' <' || email || '>' FROM users; |
| NULL'ları atlayarak birleştir | SELECT concat_ws(' ', name, email) FROM users; |
| Büyük ve küçük harf | SELECT upper(name), lower(name) FROM users; |
| Uzunluk | SELECT name, length(name) FROM users; |
| Bir metnin parçası | SELECT substring(name FROM 1 FOR 2) FROM users; |
| Değiştir | SELECT replace(email, '@example.com', '') FROM users; |
| Bölüp bir parçayı al | SELECT split_part(email, '@', 2) FROM users; |
| Düzenli ifadeyle değiştir | SELECT regexp_replace('a1b22c', '[0-9]+', '', 'g'); |
| Boşlukları kırp | SELECT trim(' hi '); |
CTE'ler ve pencere fonksiyonları
| Ne yapar | SQL |
|---|
| WITH ile bir alt sorguya ad ver | WITH paid AS (SELECT user_id, sum(amount) AS total FROM orders WHERE status = 'paid' GROUP BY user_id) SELECT * FROM paid WHERE total > 50; |
| Özyinelemeli CTE (5'e kadar say) | WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < 5) SELECT i FROM n; |
| Grup başına satırları numarala | SELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees; |
| Eşitlerde aynı sırayla sırala | SELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees; |
| Kümülatif toplam | SELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders; |
| Önceki satırın değeri | SELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees; |
| Her satırı kendi alt sorgusuyla birleştir | SELECT u.name, o.amount FROM users u CROSS JOIN LATERAL (SELECT amount FROM orders WHERE user_id = u.id ORDER BY amount DESC LIMIT 1) o; |
İndeksler
| Ne yapar | SQL |
|---|
| B-tree indeks (varsayılan) | CREATE INDEX orders_user_idx ON orders (user_id); |
| Unique indeks | CREATE UNIQUE INDEX employees_name_idx ON employees (name); |
| Çok sütunlu indeks | CREATE INDEX orders_user_created_idx ON orders (user_id, created_at); |
| Kısmi indeks | CREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid'; |
| İfade indeksi | CREATE INDEX users_lower_email_idx ON users (lower(email)); |
| Kapsayan indeks (index-only scan) | CREATE INDEX orders_user_cover_idx ON orders (user_id) INCLUDE (amount); |
| Yazmaları engellemeden oluştur | CREATE INDEX CONCURRENTLY orders_status_idx ON orders (status); |
| İndeksi sil | DROP INDEX IF EXISTS orders_user_idx; |
| Planı gör | EXPLAIN SELECT * FROM orders WHERE user_id = 1; |
| Planı gerçek sürelerle gör | EXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1; |
İşlemler (transaction) ve kilitler
| Ne yapar | SQL |
|---|
| Başlat, sonra koru ya da geri al | BEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK; |
| Bir işlemin bir kısmını geri al | BEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT; |
| Daha sıkı izolasyon | BEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT; |
| Okuduğunuz satırları kilitle | BEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT; |
| İş kuyruğu: kilitli satırları atla | BEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT; |
Kullanıcılar, roller ve yetkiler
| Ne yapar | SQL |
|---|
| Giriş yapabilen bir rol oluştur | CREATE ROLE app LOGIN PASSWORD 'change-me'; |
| Bir tabloya salt okunur erişim | GRANT SELECT ON users TO app; |
| Bir şemadaki tüm tablolara okuma erişimi | GRANT SELECT ON ALL TABLES IN SCHEMA public TO app; |
| Bir yetkiyi geri al | REVOKE SELECT ON users FROM app; |
| Parola değiştir | ALTER ROLE app PASSWORD 'new-secret'; |
| Geçerli kullanıcıyı göster | SELECT current_user; |
Bakım ve izleme
| Ne yapar | SQL |
|---|
| Çalışan sorgular | SELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle'; |
| Bir sorguyu iptal et | SELECT pg_cancel_backend(12345); |
| Bir bağlantıyı sonlandır | SELECT pg_terminate_backend(12345); |
| İndeksleriyle birlikte tablo boyutu | SELECT pg_size_pretty(pg_total_relation_size('orders')); |
| Veritabanı boyutu | SELECT pg_size_pretty(pg_database_size(current_database())); |
| Planlayıcı istatistiklerini güncelle | ANALYZE orders; |
| Ölü satırları geri kazan | VACUUM orders; |
| Tabloyu en küçük boyutuna yeniden yaz (tabloyu kilitler) | VACUUM FULL orders; |
| Bir ayarı göster | SHOW work_mem; |
| Bu oturum için bir ayarı değiştir | SET work_mem = '64MB'; |
Yedekleme ve geri yükleme
PostgreSQL istemci araçlarından kabuk komutları.
| Ne yapar | Komut |
|---|
| Veritabanını bir SQL dosyasına dök | pg_dump -U postgres shop > shop.sql |
| Özel biçimde dök | pg_dump -Fc -U postgres shop > shop.dump |
| Tek bir tabloyu dök | pg_dump -t orders shop > orders.sql |
| SQL dökümünü geri yükle | psql -d shop -f shop.sql |
| Özel biçimli dökümü geri yükle | pg_restore -d shop shop.dump |
| Tüm veritabanlarını ve rolleri dök | pg_dumpall > cluster.sql |
| Bir sorguyu CSV'ye aktar (psql'den) | \copy (SELECT * FROM orders) TO 'orders.csv' CSV HEADER |
| CSV içe aktar (psql'den) | \copy orders (user_id, amount, status) FROM 'orders.csv' CSV HEADER |
Başvurduğunuz her psql komutu ve PostgreSQL ifadesi, kopyala-yapıştır tablolarda: önce bağlanma ve \d komutları, ardından tablolar, upsert'ler, JSONB, tarihler, pencere fonksiyonları, indeksler, roller, yedekleme ve bakım.
Buradaki SQL, PostgreSQL 17 söz dizimidir ve çoğu önceki sürümlerde de çalışır. SQL ifadeleri PostgreSQL 17 üzerinde denendi; birini denemek için örnek tablolarla gelen PostgreSQL playground'a yapıştırın.