Menu
CoddyTech

ورقة PostgreSQL المرجعية

آخر تحديث

أوامر 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;"
تشغيل ملف SQLpsql -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
إنشاء جدول بمفتاح identityCREATE 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;
إفراغ جدول وإعادة تعيين identityTRUNCATE 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);
إضافة قيد CHECKALTER 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 و OFFSETSELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20;
تحديد عدد الصفوف بالصيغة القياسيةSELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY;
التحويل باستخدام ::SELECT '42'::integer + 1;
قيمة بديلة عن NULLSELECT 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
جلب حقل بصيغة JSONSELECT 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;
الصفوف كمصفوفة JSONSELECT 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;
الدمج مع تخطي قيم NULLSELECT 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
تسمية استعلام فرعي باستخدام WITHWITH 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.

الوظيفةالأمر
تفريغ قاعدة بيانات إلى ملف SQLpg_dump -U postgres shop > shop.sql
التفريغ بالصيغة المخصّصة (custom)pg_dump -Fc -U postgres shop > shop.dump
تفريغ جدول واحدpg_dump -t orders shop > orders.sql
استعادة تفريغ SQLpsql -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، الذي يأتي مع جداول نموذجية.

الأسئلة الشائعة حول ورقة PostgreSQL المرجعية

ما هي أوامر psql؟
psql هو عميل PostgreSQL في الطرفية. إلى جانب SQL، يفهم أوامر وصفية تبدأ بشرطة مائلة عكسية: \l يعرض قواعد البيانات، و \c يتصل بإحداها، و \dt يعرض الجداول، و \d users يصف جدولًا، و \q يخرج. تعمل هذه الأوامر داخل psql نفسه، لذلك لا تحتاج إلى فاصلة منقوطة ولا تعمل في العملاء الآخرين.
كيف أعرض كل الجداول في PostgreSQL؟
في psql، اكتب \dt (أو \dt *.* لكل المخططات). وباستخدام SQL من أي عميل: SELECT table_name FROM information_schema.tables WHERE table_schema = 'public';
هل تختلف SQL في PostgreSQL عن MySQL؟
الأساس (SELECT و JOIN و GROUP BY) واحد. يضيف PostgreSQL كلًا من ILIKE، والتحويل بـ ::، و RETURNING، و DISTINCT ON، وعمليات upsert بـ ON CONFLICT، والمصفوفات و JSONB، ويستخدم أعمدة identity حيث يستخدم MySQL AUTO_INCREMENT.
ما الفرق بين JSON و JSONB؟
يخزّن json النص كما كُتب؛ أما jsonb فيخزّن صيغة ثنائية محلَّلة، ويحذف المفاتيح المكررة والمسافات، ويدعم الفهارس (GIN) وعوامل مثل @> و ?. استخدم jsonb ما لم تكن بحاجة إلى النص الأصلي كما هو تمامًا.
هل يمكنني التدرب على هذه الاستعلامات عبر الإنترنت؟
نعم. يشغّل playground الخاص بـ PostgreSQL أي استعلام على قاعدة بيانات PostgreSQL 17 حقيقية في متصفحك، مع جداول نموذجية يمكنك تعديلها. أما الجمل التي تحتاج إلى صلاحيات على الخادم، مثل CREATE DATABASE أو CREATE ROLE، فتحتاج إلى PostgreSQL خاص بك.
هل ورقة PostgreSQL المرجعية هذه مجانية؟

نعم. يمكنك قراءتها ونسخها وطباعتها مجانًا، دون الحاجة إلى التسجيل.

رسم توضيحي للغات البرمجة في Coddy

تعلّم PostgreSQL مع Coddy

ابدأ الآن