Menu
CoddyTech

PostgreSQL Cheat Sheet: דף עזר לפקודות psql

עודכן לאחרונה

פקודות psql

פקודות מטא רצות בתוך 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
יצירת מסד נתונים מה-shellcreatedb shop
מחיקת מסד נתונים מה-shelldropdb shop

מסדי נתונים וסכמות

מה זה עושהSQL
יצירת מסד נתוניםCREATE DATABASE shop;
מחיקת מסד נתוניםDROP DATABASE shop;
הצגת מסד הנתונים הנוכחיSELECT current_database();
יצירת סכמה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();
טיפוס enumCREATE 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 cheat sheet; כאן מופיעות הצורות הייחודיות ל-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
הוספת שורה וקבלת ה-id החדש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;
join לתת-שאילתה של כל שורה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()));
עדכון הסטטיסטיקות של ה-plannerANALYZE orders;
פינוי שורות מתותVACUUM orders;
כתיבה מחדש של טבלה לגודל המינימלי (נועל אותה)VACUUM FULL orders;
הצגת הגדרהSHOW work_mem;
שינוי הגדרה לסשן הנוכחיSET work_mem = '64MB';

גיבוי ושחזור

פקודות shell מכלי הלקוח של PostgreSQL.

מה זה עושהפקודה
dump של מסד נתונים לקובץ SQLpg_dump -U postgres shop > shop.sql
dump בפורמט custompg_dump -Fc -U postgres shop > shop.dump
dump של טבלה אחתpg_dump -t orders shop > orders.sql
שחזור dump של SQLpsql -d shop -f shop.sql
שחזור dump בפורמט custompg_restore -d shop shop.dump
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; כדי לנסות אחד מהם, הדביקו אותו בעורך האונליין של PostgreSQL, שמגיע עם טבלאות לדוגמה.

שאלות נפוצות על ה-PostgreSQL cheat sheet

מה הן פקודות 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 אלא אם אתם צריכים את הטקסט המקורי בדיוק כפי שנכתב.
אפשר לתרגל את השאילתות האלה אונליין?
כן. עורך האונליין של PostgreSQL מריץ כל שאילתה על מסד נתונים אמיתי של PostgreSQL 17 בדפדפן שלכם, עם טבלאות לדוגמה שאפשר לערוך. משפטים שדורשים הרשאות שרת, כמו CREATE DATABASE או CREATE ROLE, צריכים PostgreSQL משלכם.
האם ה-PostgreSQL cheat sheet הזה חינמי?

כן. הוא חינמי לקריאה, להעתקה ולהדפסה, בלי צורך בהרשמה.

איור של שפות התכנות ב-Coddy

ללמוד PostgreSQL עם Coddy

להתחיל