PostgreSQL: كيفية تثبيت PostgreSQL وإجراء أول اتصال

# سحب وتشغيل PostgreSQL 17 في Docker
docker run --name my-postgres \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=bob \
  -e POSTGRES_DB=dev_shop \
  -p 5432:5432 \
  -d postgres:17

# التحقق من أن الحاوية قيد التشغيل
docker ps | grep my-postgres

# الخطوة 1: سحب صورة PostgreSQL 17
docker pull postgres:17

# الخطوة 2: تشغيل الحاوية بإعدادات مخصصة
docker run --name pg-dev \
  -e POSTGRES_USER=devuser \
  -e POSTGRES_PASSWORD=devpass123 \
  -e POSTGRES_DB=shopdb \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  -d postgres:17

# الخطوة 3: التحقق من أن الحاوية قيد التشغيل
docker ps

# الخطوة 4: الاتصال عبر psql داخل الحاوية
docker exec -it pg-dev psql -U devuser -d shopdb

psql (17.0)
Type "help" for help.

shopdb=>

1. نزّل المثبت من https://www.enterprisedb.com/downloads/postgres
2. شغّل postgresql-17-windows-x64.exe
3. اختر دليل التثبيت (الافتراضي: C:\Program Files\PostgreSQL\17)
4. عيّن كلمة مرور المستخدم المميز (postgres)
5. عيّن المنفذ (الافتراضي: 5432)
6. اختر اللغة المحلية (الافتراضي: [Default locale])
7. حدد "Launch Stack Builder at exit" (اختياري، لأدوات إضافية)
8. انقر Finish

# تثبيت PostgreSQL 17 عبر Homebrew
brew install postgresql@17

# بدء خدمة PostgreSQL
brew services start postgresql@17

# الاتصال بقاعدة البيانات الافتراضية
psql postgres

# التحقق من الإصدار
SELECT version();

# psql command executed successfully

# إضافة مستودع APT الرسمي لـ PostgreSQL
sudo apt update
sudo apt install -y curl ca-certificates
sudo install -d /usr/share/postgresql-common/pgdg
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc \
  --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc

sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] \
  https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" \
  > /etc/apt/sources.list.d/pgdg.list'

# تثبيت PostgreSQL 17
sudo apt update
sudo apt install -y postgresql-17

# التبديل إلى مستخدم postgres والاتصال
sudo -u postgres psql

# التحقق من التثبيت
SELECT version();

# psql command executed successfully

1. نزّل من https://www.pgadmin.org/download/
2. ثبت وشغّل pgAdmin 4
3. انقر "Add New Server"
4. علامة التبويب General: Name = "Local Dev"
5. علامة التبويب Connection:
   - Host: localhost (أو 127.0.0.1)
   - Port: 5432
   - Maintenance database: shopdb
   - Username: devuser
   - Password: devpass123
6. انقر Save

1. نزّل من https://dbeaver.io/download/ (إصدار المجتمع)
2. ثبت وشغّل DBeaver
3. انقر "New Database Connection" (أيقونة القابس)
4. اختر PostgreSQL
5. املأ إعدادات الاتصال:
   - Host: localhost
   - Port: 5432
   - Database: shopdb
   - Username: devuser
   - Password: devpass123
6. انقر "Test Connection" (يطالب بتنزيل مشغل PG JDBC)
7. انقر Finish

# الاتصال بـ PostgreSQL المحلي
psql -h localhost -p 5432 -U devuser -d shopdb

# أو استخدام URI اتصال
psql "postgresql://devuser:devpass123@localhost:5432/shopdb"

# أو عبر Docker
docker exec -it pg-dev psql -U devuser -d shopdb

CONTAINER ID   IMAGE     STATUS    
abc123         latest    Up 2 hours

-- التحقق من معلومات الاتصال
\conninfo

-- سرد قواعد البيانات
\l

-- إنشاء جدول اختبار
CREATE TABLE test_greeting (
    id SERIAL PRIMARY KEY,
    message TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

-- إدراج بيانات
INSERT INTO test_greeting (message) VALUES ('Hello, PostgreSQL!');

-- استعلام بيانات
SELECT * FROM test_greeting;

-- إسقاط جدول الاختبار
DROP TABLE test_greeting;

-- \conninfo output:
You are connected to database "shopdb" as user "devuser" on host "localhost" at port "5432".

-- SELECT output:
 id |      message       |         created_at
----+--------------------+----------------------------
  1 | Hello, PostgreSQL! | 2026-07-13 10:30:00.123456

# ============================================
# سير عمل كامل: تثبيت، اتصال، تحقق
# من الصفر إلى التشغيل في 5 أوامر
# ============================================

# 1. بدء PostgreSQL عبر Docker
docker run --name pg-dev \
  -e POSTGRES_USER=devuser \
  -e POSTGRES_PASSWORD=devpass123 \
  -e POSTGRES_DB=shopdb \
  -p 5432:5432 \
  -d postgres:17

# 2. انتظار جاهزية الحاوية (حوالي 5 ثوانٍ)
sleep 5

# 3. الاتصال عبر psql
docker exec -it pg-dev psql -U devuser -d shopdb

# 4. داخل psql: تشغيل استعلامات التحقق
# (اكتب هذه الأوامر في موجه psql)

-- عرض إصدار PostgreSQL
SELECT version();

-- عرض الاتصال الحالي
\conninfo

-- سرد الامتدادات المتاحة
SELECT name, default_version FROM pg_available_extensions LIMIT 5;

-- إنشاء جدول اختبار وإدراج بيانات
CREATE TABLE hello_pg (
    id SERIAL PRIMARY KEY,
    greeting TEXT,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

INSERT INTO hello_pg (greeting) VALUES
    ('Hello from PostgreSQL!'),
    ('Docker install works!'),
    ('Ready to learn!');

-- تحقق
SELECT * FROM hello_pg;

-- تنظيف
DROP TABLE hello_pg;

-- خروج من psql
\q

# 5. إيقاف الحاوية عند الانتهاء
docker stop pg-dev

                                                     version
-----------------------------------------------------------------------------------------------------------------
 PostgreSQL 17.0 on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit

     name      | default_version
---------------+-----------------
 plpgsql       | 1.0
 uuid-ossp     | 1.1
 pg_trgm       | 1.6

 id |       greeting        |          created_at
----+-----------------------+-------------------------------
  1 | Hello from PostgreSQL! | 2026-07-13 10:30:00+00
  2 | Docker install works!  | 2026-07-13 10:30:00+00
  3 | Ready to learn!        | 2026-07-13 10:30:00+00