ما هو psql وما هي أوامره الأساسية؟

Question

Accepted Answer

**`psql`** هو عميل سطر الأوامر التفاعلي لـ PostgreSQL — يُستخدم للاتصال بقاعدة بيانات وتشغيل الاستعلامات وفحص المخطط وإدارة قاعدة البيانات. يحتوي على **أوامر تعريفية** خاصة (تبدأ بـ `\`) للملاحة والإدارة، بالإضافة إلى تشغيل SQL.

## الاتصال

```bash
psql -U username -d database_name -h host -p 5432   # connect with options
psql postgresql://user:pass@host:5432/dbname        # or a connection URL
psql mydb                                            # connect to a local database
```

## الأوامر التعريفية الأساسية (أوامر الشرطة المائلة العكسية)

```text
\l            list all databases
\c dbname     connect to a database
\dt           list TABLES in the current database
\d tablename  describe a table (columns, types, indexes, constraints)
\di           list indexes
\dn           list schemas
\du           list roles/users
\df           list functions
\dv           list views
\x            toggle expanded display (vertical — readable for wide rows)
	iming       toggle query timing
\?            help on meta-commands
\h SELECT     help on a SQL command
\q            quit
```

تسمح لك أوامر `\` التعريفية هذه باستكشاف وإدارة قاعدة البيانات بسرعة — `\dt` (عرض الجداول)، `\d tablename` (فحص بنية الجدول)، و `\l` (عرض قواعد البيانات) تُستخدم باستمرار.

## تشغيل الاستعلامات والبرامج النصية

```sql
SELECT * FROM users LIMIT 5;          -- run SQL directly (end with ;)
```

```bash
psql -d mydb -f script.sql            -- run a SQL FILE
psql -d mydb -c "SELECT count(*) FROM users"   -- run a single command and exit
\i script.sql                          -- run a file from within psql
\copy users TO 'users.csv' CSV HEADER  -- export to CSV (client-side)
```

## إعدادات مفيدة

```text
\x auto       auto-switch to vertical display for wide results
	iming on    show how long each query takes
\e            open the last query in an editor
\set, \pset   configure variables and output formatting
```

## لماذا يهم هذا

`psql` هو الأداة الأساسية والضرورية يومياً للعمل المباشر مع PostgreSQL — يستخدمها المطورون ومسؤولو قواعد البيانات باستمرار للاتصال والاستعلام والفحص وإدارة قواعد البيانات، لذا فإن معرفة أساسياتها معرفة عملية وأساسية لعمل Postgres.

بينما توجد أدوات واجهة رسومية، فإن `psql` هي الواجهة الشاملة والمتاحة دائماً (موجودة في أي مكان يكون فيه Postgres)، وأوامرها التعريفية (`\`) تجعلها قوية بشكل خاص للاستكشاف السريع لقاعدة البيانات والإدارة التي لا يمكن لـ SQL البحتة أن تقوم بها بسهولة: `\dt` (عرض الجداول)، `\d tablename` (فحص البنية الكاملة للجدول — الأعمدة والأنواع والفهارس والقيود — حاجة ثابتة)، `\l` (عرض قواعس البيانات)، `\du` (عرض المستخدمين/الأدوار)، وغيرها تتيح لك التنقل والفهم السريع لقاعدة البيانات.

معرفة كيفية الاتصال (بالخيارات أو عنوان URL)، وتشغيل الاستعلامات والبرامج النصية (`-f` للملفات، `-c` للأوامر الفردية)، واستخدام الأوامر التعريفية للفحص، والإعدادات المفيدة (`\x` لعرض الصفوف العريضة المقروءة، `	iming` لقياس وقت الاستعلام) معرفة عملية يومية لأي مطور أو مسؤول Postgres.

نظراً لأن `psql` هي واجهة سطر الأوامر القياسية والموجودة في كل مكان لـ PostgreSQL — تُستخدم للتطوير والتصحيح والإدارة والبرمجة النصية والاستكشاف — فإن فهم أوامرها الأساسية وسير عملها معرفة قيمة وتُطبق بشكل متكرر تجعل العمل مع Postgres فعالاً، وهي كفاءة أساسية متوقعة من أي شخص يعمل مباشرة مع قاعدة البيانات.