أوامر psql
تعمل الأوامر الوصفية (meta-commands) داخل psql (عميل PostgreSQL في الطرفية)، وليس على الخادم. تبدأ بشرطة مائلة عكسية ولا تحتاج إلى فاصلة منقوطة.
| الوظيفة | الأمر |
|---|
| عرض قواعد البيانات | \l |
| الاتصال بقاعدة بيانات أخرى | \c shop |
| عرض الجداول | \dt |
| عرض الجداول في كل المخططات | \dt *.* |
| وصف جدول (الأعمدة والفهارس والمفاتيح) | \d users |
| الوصف مع التخزين والتعليقات | \d+ users |
| عرض المخططات | \dn |
| عرض العروض (views) | \dv |
| عرض الفهارس | \di |
| عرض الدوال | \df |
| عرض الأدوار (المستخدمين) | \du |
| عرض الاتصال الحالي | \conninfo |
| تشغيل SQL من ملف | \i setup.sql |
| تشغيل قياس زمن الاستعلام أو إيقافه | \timing |
| الإخراج الموسّع (عمود واحد في كل سطر) | \x |
| تعديل آخر استعلام في محررك | \e |
| مساعدة في صياغة SQL | \h CREATE TABLE |
| عرض كل الأوامر الوصفية | \? |
| الخروج من psql | \q |
الاتصال من الطرفية
| الوظيفة | الأمر |
|---|
| الاتصال بقاعدة بيانات باسم مستخدم | psql -U postgres -d shop |
| الاتصال بخادم بعيد ومنفذ محدد | psql -h db.example.com -p 5432 -U app -d shop |
| الاتصال برابط اتصال (URL) | psql postgresql://app:secret@localhost:5432/shop |
| تشغيل استعلام واحد ثم الخروج | psql -d shop -c "SELECT count(*) FROM users;" |
| تشغيل ملف SQL | psql -d shop -f setup.sql |
| إنشاء قاعدة بيانات من الصدفة | createdb shop |
| حذف قاعدة بيانات من الصدفة | dropdb shop |
قواعد البيانات والمخططات
| الوظيفة | SQL |
|---|
| إنشاء قاعدة بيانات | CREATE DATABASE shop; |
| حذف قاعدة بيانات | DROP DATABASE shop; |
| عرض قاعدة البيانات الحالية | SELECT current_database(); |
| إنشاء مخطط (schema) | CREATE SCHEMA sales; |
| عرض ترتيب البحث في المخططات | SHOW search_path; |
| البحث في مخطط معيّن أولًا | SET search_path TO sales, public; |
| عرض إصدار الخادم | SELECT version(); |
الجداول وأنواع البيانات
| الوظيفة | SQL |
|---|
| إنشاء جدول بمفتاح identity | 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()); |
| إضافة عمود | ALTER TABLE users ADD COLUMN phone text; |
| إعادة تسمية عمود | ALTER TABLE users RENAME COLUMN country TO country_code; |
| تغيير نوع عمود | ALTER TABLE users ALTER COLUMN age TYPE smallint; |
| تعيين قيمة افتراضية | ALTER TABLE users ALTER COLUMN active SET DEFAULT false; |
| حذف عمود | ALTER TABLE users DROP COLUMN tags; |
| إفراغ جدول وإعادة تعيين identity | TRUNCATE orders, users RESTART IDENTITY; |
| حذف جدول إن وُجد | DROP TABLE IF EXISTS products; |
| رقم عشري دقيق للمبالغ المالية | numeric(10,2) |
| تاريخ ووقت مع المنطقة الزمنية | timestamptz |
| UUID عشوائي | SELECT gen_random_uuid(); |
| نوع تعداد (enum) | CREATE TYPE mood AS ENUM ('happy', 'sad'); |
القيود والمفاتيح
| الوظيفة | SQL |
|---|
| إضافة مفتاح أساسي | ALTER TABLE logs ADD PRIMARY KEY (id); |
| مفتاح أجنبي يحذف الصفوف التابعة | CREATE TABLE reviews (id integer PRIMARY KEY, user_id integer REFERENCES users(id) ON DELETE CASCADE); |
| إضافة قيد CHECK | ALTER TABLE orders ADD CONSTRAINT amount_positive CHECK (amount > 0); |
| قيد تفرّد تُعدّ فيه قيم NULL متساوية (15+) | CREATE TABLE emails (address text UNIQUE NULLS NOT DISTINCT); |
| جعل عمود إلزاميًا | ALTER TABLE users ALTER COLUMN country SET NOT NULL; |
| حذف قيد | ALTER TABLE users DROP CONSTRAINT users_email_key; |
الاستعلام (إضافات PostgreSQL)
عبارات SELECT و WHERE و JOIN القياسية موجودة في ورقة SQL المرجعية؛ وهنا الصيغ الخاصة بـ PostgreSQL.
| الوظيفة | SQL |
|---|
| مطابقة لا تميّز حالة الأحرف | SELECT * FROM users WHERE name ILIKE 'a%'; |
| مطابقة بتعبير نمطي | SELECT * FROM users WHERE email ~ '@example\.com$'; |
| أول صف في كل مجموعة | SELECT DISTINCT ON (user_id) user_id, amount FROM orders ORDER BY user_id, amount DESC; |
| LIMIT و OFFSET | SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20; |
| تحديد عدد الصفوف بالصيغة القياسية | SELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY; |
| التحويل باستخدام :: | SELECT '42'::integer + 1; |
| قيمة بديلة عن NULL | SELECT name, COALESCE(email, 'none') FROM users; |
| مقارنة تُعدّ فيها قيم NULL متساوية | SELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com'; |
| توليد سلسلة من الأرقام | SELECT * FROM generate_series(1, 5); |
| تجميع القيم في نص واحد | SELECT string_agg(name, ', ' ORDER BY name) FROM users; |
| تجميع مشروط | SELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders; |
الإدراج والتحديث والحذف و upsert
| الوظيفة | SQL |
|---|
| إدراج صف واستعادة المعرّف الجديد | INSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id; |
| إدراج عدة صفوف | INSERT INTO users (name) VALUES ('Eli'), ('Femi'); |
| Upsert (إدراج أو تحديث) | INSERT INTO users (name, email) VALUES ('Asha K', 'asha@example.com') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; |
| إدراج مع تجاهل التكرارات | INSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING; |
| تحديث ورؤية الصفوف المتغيّرة | UPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary; |
| تحديث بالاعتماد على جدول آخر | UPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN'; |
| حذف ورؤية ما حُذف | DELETE FROM orders WHERE status = 'refunded' RETURNING id; |
| حذف باستخدام جدول آخر | DELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false; |
| نسخ صفوف إلى جدول جديد | CREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid'; |
JSONB
| الوظيفة | SQL |
|---|
| جلب حقل بصيغة JSON | SELECT profile -> 'plan' FROM users; |
| جلب حقل كنص | SELECT profile ->> 'plan' FROM users; |
| جلب حقل متداخل كنص | SELECT profile #>> '{address,city}' FROM users; |
| الصفوف التي يحتوي JSON فيها على قيمة | SELECT * FROM users WHERE profile @> '{"plan": "pro"}'; |
| الصفوف التي تحتوي على مفتاح | SELECT * FROM users WHERE profile ? 'city'; |
| تعيين مفتاح | UPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2; |
| دمج الكائنات | UPDATE users SET profile = profile || '{"beta": true}'; |
| إزالة مفتاح | UPDATE users SET profile = profile - 'city'; |
| بناء JSON من الأعمدة | SELECT jsonb_build_object('id', id, 'name', name) FROM users; |
| الصفوف كمصفوفة JSON | SELECT jsonb_agg(users) FROM users; |
| فهرس لعمليات البحث بـ @> و ? | CREATE INDEX users_profile_idx ON users USING gin (profile); |
المصفوفات
| الوظيفة | SQL |
|---|
| قيمة مصفوفة حرفية | SELECT ARRAY[1, 2, 3]; |
| الصفوف التي تحتوي مصفوفتها على قيمة | SELECT * FROM users WHERE 'sql' = ANY(tags); |
| الصفوف التي تحتوي مصفوفتها على كل القيم المحددة | SELECT * FROM users WHERE tags @> ARRAY['sql', 'python']; |
| صف لكل عنصر | SELECT name, unnest(tags) FROM users; |
| إلحاق عنصر | UPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2; |
| طول المصفوفة | SELECT name, cardinality(tags) FROM users; |
التواريخ والأوقات
| الوظيفة | SQL |
|---|
| الآن، مع المنطقة الزمنية | SELECT now(); |
| اليوم | SELECT current_date; |
| إضافة فترة زمنية | SELECT current_date + INTERVAL '7 days'; |
| الصفوف من آخر 30 يومًا | SELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days'; |
| الاقتطاع إلى الشهر | SELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1; |
| استخراج جزء | SELECT EXTRACT(YEAR FROM hired_on) FROM employees; |
| الفرق بين تاريخين (بالأيام) | SELECT DATE '2026-12-25' - DATE '2026-11-17'; |
| المدة بين تاريخين | SELECT name, age(current_date, hired_on) FROM employees; |
| تنسيق تاريخ كنص | SELECT to_char(hired_on, 'DD Mon YYYY') FROM employees; |
| تحويل نص إلى تاريخ | SELECT to_date('17/11/2026', 'DD/MM/YYYY'); |
| التحويل إلى منطقة زمنية | SELECT now() AT TIME ZONE 'Asia/Kolkata'; |
الدوال النصية
| الوظيفة | SQL |
|---|
| الدمج (NULL ينتج NULL) | SELECT name || ' <' || email || '>' FROM users; |
| الدمج مع تخطي قيم NULL | SELECT concat_ws(' ', name, email) FROM users; |
| الأحرف الكبيرة والصغيرة | SELECT upper(name), lower(name) FROM users; |
| الطول | SELECT name, length(name) FROM users; |
| جزء من نص | SELECT substring(name FROM 1 FOR 2) FROM users; |
| الاستبدال | SELECT replace(email, '@example.com', '') FROM users; |
| استخراج جزء بعد التقسيم | SELECT split_part(email, '@', 2) FROM users; |
| الاستبدال بتعبير نمطي | SELECT regexp_replace('a1b22c', '[0-9]+', '', 'g'); |
| إزالة المسافات | SELECT trim(' hi '); |
CTE ودوال النوافذ
| الوظيفة | SQL |
|---|
| تسمية استعلام فرعي باستخدام WITH | 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; |
| CTE تكراري (العد حتى 5) | WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < 5) SELECT i FROM n; |
| ترقيم الصفوف في كل مجموعة | SELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees; |
| الترتيب مع التعادل | SELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees; |
| المجموع التراكمي | SELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders; |
| قيمة الصف السابق | SELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees; |
| الربط باستعلام فرعي خاص بكل صف | 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; |
الفهارس
| الوظيفة | SQL |
|---|
| فهرس B-tree (الافتراضي) | CREATE INDEX orders_user_idx ON orders (user_id); |
| فهرس فريد | CREATE UNIQUE INDEX employees_name_idx ON employees (name); |
| فهرس متعدد الأعمدة | CREATE INDEX orders_user_created_idx ON orders (user_id, created_at); |
| فهرس جزئي | CREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid'; |
| فهرس على تعبير | CREATE INDEX users_lower_email_idx ON users (lower(email)); |
| فهرس شامل (index-only scan) | CREATE INDEX orders_user_cover_idx ON orders (user_id) INCLUDE (amount); |
| البناء دون حجب عمليات الكتابة | CREATE INDEX CONCURRENTLY orders_status_idx ON orders (status); |
| حذف فهرس | DROP INDEX IF EXISTS orders_user_idx; |
| عرض خطة التنفيذ | EXPLAIN SELECT * FROM orders WHERE user_id = 1; |
| عرض خطة التنفيذ مع الأزمنة الفعلية | EXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1; |
المعاملات والأقفال
| الوظيفة | SQL |
|---|
| البدء، ثم التثبيت أو التراجع | BEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK; |
| التراجع عن جزء من معاملة | BEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT; |
| عزل أكثر صرامة | BEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT; |
| قفل الصفوف التي تقرأها | BEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT; |
| طابور المهام: تخطي الصفوف المقفلة | BEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT; |
المستخدمون والأدوار والصلاحيات
| الوظيفة | SQL |
|---|
| إنشاء دور يمكنه تسجيل الدخول | CREATE ROLE app LOGIN PASSWORD 'change-me'; |
| صلاحية قراءة فقط على جدول | GRANT SELECT ON users TO app; |
| صلاحية قراءة على كل جداول مخطط | GRANT SELECT ON ALL TABLES IN SCHEMA public TO app; |
| سحب صلاحية | REVOKE SELECT ON users FROM app; |
| تغيير كلمة المرور | ALTER ROLE app PASSWORD 'new-secret'; |
| عرض المستخدم الحالي | SELECT current_user; |
الصيانة والمراقبة
| الوظيفة | SQL |
|---|
| الاستعلامات الجارية | SELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle'; |
| إلغاء استعلام | SELECT pg_cancel_backend(12345); |
| إنهاء اتصال | SELECT pg_terminate_backend(12345); |
| حجم جدول مع فهارسه | SELECT pg_size_pretty(pg_total_relation_size('orders')); |
| حجم قاعدة البيانات | SELECT pg_size_pretty(pg_database_size(current_database())); |
| تحديث إحصاءات مخطِّط الاستعلامات | ANALYZE orders; |
| استعادة مساحة الصفوف الميتة | VACUUM orders; |
| إعادة كتابة جدول إلى أصغر حجم (يقفل الجدول) | VACUUM FULL orders; |
| عرض إعداد | SHOW work_mem; |
| تغيير إعداد لهذه الجلسة | SET work_mem = '64MB'; |
النسخ الاحتياطي والاستعادة
أوامر صدفة من أدوات عميل PostgreSQL.
| الوظيفة | الأمر |
|---|
| تفريغ قاعدة بيانات إلى ملف SQL | pg_dump -U postgres shop > shop.sql |
| التفريغ بالصيغة المخصّصة (custom) | pg_dump -Fc -U postgres shop > shop.dump |
| تفريغ جدول واحد | pg_dump -t orders shop > orders.sql |
| استعادة تفريغ SQL | psql -d shop -f shop.sql |
| استعادة تفريغ بالصيغة المخصّصة | pg_restore -d shop shop.dump |
| تفريغ كل قواعد البيانات والأدوار | pg_dumpall > cluster.sql |
| تصدير نتيجة استعلام إلى CSV (من psql) | \copy (SELECT * FROM orders) TO 'orders.csv' CSV HEADER |
| استيراد ملف CSV (من psql) | \copy orders (user_id, amount, status) FROM 'orders.csv' CSV HEADER |
كل أمر psql وكل جملة PostgreSQL قد تحتاجها، في جداول جاهزة للنسخ: الاتصال وأوامر \d أولًا، ثم الجداول و upsert و JSONB والتواريخ ودوال النوافذ والفهارس والأدوار والنسخ الاحتياطي والصيانة.
صياغة SQL هنا هي صياغة PostgreSQL 17، ومعظمها يعمل في الإصدارات الأقدم أيضًا. تم التحقق من جمل SQL على PostgreSQL 17؛ ولتجربة أي منها، الصقها في playground الخاص بـ PostgreSQL، الذي يأتي مع جداول نموذجية.