⚡ إعداد PostgreSQL 18 Streaming Replication على Windows

دليل مفصل خطوة بخطوة - مماثلة كاملة (Full Replication)

الخطوة 1: التجهيز على السيرفر الرئيسي (Master)

افتح SQL Shell (psql) كمسؤول وسجل دخولك:

-- إنشاء دور خاص بالنسخ
CREATE ROLE replicator WITH LOGIN PASSWORD 'StrongPassword123' REPLICATION;
\q

المسار: C:\Program Files\PostgreSQL\18\data\postgresql.conf

افتح الملف باستخدام Notepad بصلاحية المسؤول (Run as Administrator) وعدّل الإعدادات التالية:

# مستوى سجل الكتابة المسبقة (يجب أن يكون replica)
wal_level = replica

# الحد الأقصى لعدد عمليات الإرسال المتزامنة
max_wal_senders = 10

# الحد الأقصى لفتحات النسخ (Slots)
max_replication_slots = 10

# المساحة المحتفظ بها من WAL (10 جيجابايت)
wal_keep_size = 10240

# السماح بالاتصالات من جميع العناوين
listen_addresses = '*'

# اختياري: ضغط البيانات المرسلة
# wal_compression = on

المسار: C:\Program Files\PostgreSQL\18\data\pg_hba.conf

أضف السطر التالي في نهاية الملف:

# TYPE  DATABASE     USER        ADDRESS          METHOD
host    replication  replicator  192.168.1.101/32 scram-sha-256

افتح PowerShell كمسؤول ونفذ:

# إيقاف الخدمة
Stop-Service -Name postgresql-x64-18

# تشغيل الخدمة
Start-Service -Name postgresql-x64-18

# التحقق من الحالة
Get-Service postgresql-x64-18

أو عبر موجه الأوامر (CMD):

net stop postgresql-x64-18
net start postgresql-x64-18

الخطوة 2: إعداد السيرفر التابع (Standby)

Stop-Service -Name postgresql-x64-18

# الانتقال لمجلد PostgreSQL
cd "C:\Program Files\PostgreSQL\18\"

# حذف محتويات مجلد data (تأكد أن الخدمة متوقفة)
Remove-Item -Path ".\data\*" -Recurse -Force

نفذ الأمر التالي في PowerShell كمسؤول. يجب تنفيذه كمستخدم postgres:

runas /user:postgres "C:\Program Files\PostgreSQL\18\bin\pg_basebackup.exe -h 192.168.1.100 -p 5432 -U replicator -D \"C:\Program Files\PostgreSQL\18\data\" -Fp -Xs -P -R -C"

سيُطلب منك:

1. كلمة سر مستخدم postgres في Windows.
2. كلمة سر مستخدم replicator في PostgreSQL (StrongPassword123).

الخطوة 3: تكوين التابع للعمل في وضع Standby

إذا لم ينشئ الملف تلقائياً، أنشئه يدوياً:

New-Item -Path "C:\Program Files\PostgreSQL\18\data\standby.signal" -ItemType File

يسمح بتنفيذ استعلامات القراءة فقط على التابع. أضف في ملف postgresql.conf للتابع:

hot_standby = on

Start-Service -Name postgresql-x64-18

الخطوة 4: اختبار المماثلة (Replication)

افتح SQL Shell على التابع ونفذ:

SELECT pg_is_in_recovery();

يجب أن تكون النتيجة t (true) - أي أن التابع في وضع الاسترداد.

على السيرفر الرئيسي (Master):

CREATE DATABASE test_repl;
\c test_repl
CREATE TABLE orders (id SERIAL PRIMARY KEY, product TEXT);
INSERT INTO orders (product) VALUES ('Laptop from Windows Master');

على السيرفر التابع (Standby):

\c test_repl
SELECT * FROM orders;

يجب أن ترى الصف الجديد يظهر فوراً.

أوامر مراقبة حالة النسخ

على الرئيسي - لمعرفة حالة التابع:

SELECT 
    application_name, 
    state, 
    sync_state, 
    pg_wal_lsn_diff(sent_lsn, write_lsn) AS write_lag_bytes,
    pg_wal_lsn_diff(write_lsn, flush_lsn) AS flush_lag_bytes
FROM pg_stat_replication;

على التابع - لمعرفة آخر تغيير مستلم:

SELECT 
    pg_last_wal_receive_lsn() AS last_received,
    pg_last_wal_replay_lsn() AS last_replayed;

ملاحظات هامة لنظام Windows

New-NetFirewallRule -DisplayName "PostgreSQL 18" -Direction Inbound -Protocol TCP -LocalPort 5432 -Action Allow

netsh advfirewall firewall add rule name="PostgreSQL 18" dir=in action=allow protocol=TCP localport=5432