'\" t
.\"     Title: pg_createsubscriber
.\"    Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026
.\"    Manual: PostgreSQL 18.6 Documentation
.\"    Source: PostgreSQL 18.6
.\"  Language: Persian
.\"
.TH "PG_CREATESUBSCRIBER" "1" "2026" "PostgreSQL 18.6" "PostgreSQL 18.6 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
pg_createsubscriber \- تبدیل یک رپلیکای فیزیکی به یک رپلیکای منطقی جدید
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpg_createsubscriber\fR\ 'u
\fBpg_createsubscriber\fR [\fIگزینه‌ها\fR...] {\fB\-d\fR | \fB\-\-database\fR}\fIdbname\fR {\fB\-D\fR | \fB\-\-pgdata\fR}\fIdatadir\fR {\fB\-P\fR | \fB\-\-publisher\-server\fR}\fIconnstr\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
pg_createsubscriber
یک رپلیکای منطقی جدید از روی یک سرور استندبای فیزیکی ایجاد می‌کند\&. تمامی جدول‌های موجود در پایگاه‌داده مشخص‌شده در پیکربندی رپلیکیشن منطقی گنجانده می‌شوند\&. برای هر پایگاه‌داده یک جفت شیء انتشار (publication) و اشتراک (subscription) ایجاد می‌شود\&. این ابزار باید روی سرور مقصد اجرا شود\&.
.PP
پس از اجرای موفقیت‌آمیز، وضعیت سرور مقصد مشابه راه‌اندازی تازه رپلیکیشن منطقی خواهد بود\&. تفاوت اصلی بین راه‌اندازی رپلیکیشن منطقی معمولی و
pg_createsubscriber
در نحوه همگام‌سازی داده‌ها است\&.
pg_createsubscriber
داده‌های اولیه جدول‌ها را رونوشت نمی‌کند؛ بلکه تنها مرحله همگام‌سازی را انجام می‌دهد که تضمین می‌کند هر جدول به وضعیت همگام‌شده برسد\&.
.PP
ابزار
pg_createsubscriber
سیستم‌های پایگاه‌داده بزرگ را هدف قرار می‌دهد، زیرا در راه‌اندازی رپلیکیشن منطقی، بخش عمده زمان صرف رونوشت اولیه داده‌ها می‌شود\&. علاوه بر این، پیامد این زمان طولانی صرف‌شده برای همگام‌سازی داده‌ها، معمولاً حجم بالایی از تغییرات است که باید اعمال شوند (تغییراتی که در طول رونوشت اولیه داده‌ها ایجاد شده‌اند)؛ این موضوع زمان در دسترس قرار گرفتن رپلیکای منطقی را باز هم افزایش می‌دهد\&. برای پایگاه‌های داده کوچک‌تر، توصیه می‌شود رپلیکیشن منطقی با همگام‌سازی اولیه داده‌ها راه‌اندازی شود\&. برای جزئیات بیشتر، گزینه
copy_data
در
\fBCREATE SUBSCRIPTION\fR
را ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
pg_createsubscriber
آرگومان‌های خط فرمان زیر را می‌پذیرد:
.PP
\fB\-a\fR
.br
\fB\-\-all\fR
.RS 4
به ازای هر پایگاه‌داده روی سرور مقصد یک اشتراک ایجاد می‌کند\&. پایگاه‌های داده الگو (template) و پایگاه‌های داده‌ای که اتصال را مجاز نمی‌دانند مستثنی هستند\&. برای پیدا کردن فهرست تمامی پایگاه‌های داده، با استفاده از نام پایگاه‌داده مشخص‌شده در رشته اتصال
\fB\-\-publisher\-server\fR
به سرور مبدأ متصل می‌شود؛ در صورت عدم تعیین، از پایگاه‌داده
postgres
استفاده خواهد شد، و اگر وجود نداشته باشد، از
template1
استفاده می‌شود\&. در صورت تعیین این گزینه، نام‌های تولیدشده خودکار برای اشتراک‌ها، انتشارات و اسلات‌های رپلیکیشن استفاده می‌شوند\&. این گزینه را نمی‌توان همراه با گزینه‌های
\fB\-\-database\fR،
\fB\-\-publication\fR،
\fB\-\-replication\-slot\fR
یا
\fB\-\-subscription\fR
به کار برد\&.
.RE
.PP
\fB\-d \fR\fB\fIdbname\fR\fR
.br
\fB\-\-database=\fR\fB\fIdbname\fR\fR
.RS 4
نام پایگاه‌داده‌ای که باید در آن اشتراک ایجاد شود\&. با نوشتن چندین سوئیچ
\fB\-d\fR
می‌توان چندین پایگاه‌داده را انتخاب کرد\&. این گزینه را نمی‌توان همراه با
\fB\-a\fR
به کار برد\&. اگر گزینه
\fB\-d\fR
ارائه نشود، نام پایگاه‌داده از گزینه
\fB\-P\fR
گرفته خواهد شد\&. اگر نام پایگاه‌داده نه در گزینه
\fB\-d\fR
و نه در گزینه
\fB\-P\fR
مشخص نشده باشد، و گزینه
\fB\-a\fR
نیز تعیین نشده باشد، خطا گزارش خواهد شد\&.
.RE
.PP
\fB\-D \fR\fB\fIdirectory\fR\fR
.br
\fB\-\-pgdata=\fR\fB\fIdirectory\fR\fR
.RS 4
دایرکتوری مقصد که حاوی یک دایرکتوری کلاستر از رپلیکای فیزیکی است\&.
.RE
.PP
\fB\-n\fR
.br
\fB\-\-dry\-run\fR
.RS 4
تمام مراحل را به جز تغییر دادن واقعی دایرکتوری مقصد انجام می‌دهد\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-subscriber\-port=\fR\fB\fIport\fR\fR
.RS 4
شماره پورتی که سرور مقصد روی آن برای اتصالات شنود می‌کند\&. مقدار پیش‌فرض اجرای سرور مقصد پورت 50432 است تا از اتصالات ناخواسته کلاینت‌ها جلوگیری شود\&.
.RE
.PP
\fB\-P \fR\fB\fIconnstr\fR\fR
.br
\fB\-\-publisher\-server=\fR\fB\fIconnstr\fR\fR
.RS 4
رشته اتصال به ناشر (publisher)\&. برای جزئیات به بخش\ \&32.1.1 مراجعه کنید\&.
.RE
.PP
\fB\-s \fR\fB\fIdir\fR\fR
.br
\fB\-\-socketdir=\fR\fB\fIdir\fR\fR
.RS 4
دایرکتوری مورد استفاده برای سوکت‌های postmaster در سرور مقصد\&. پیش‌فرض، دایرکتوری جاری است\&.
.RE
.PP
\fB\-t \fR\fB\fIseconds\fR\fR
.br
\fB\-\-recovery\-timeout=\fR\fB\fIseconds\fR\fR
.RS 4
حداکثر زمان به ثانیه برای انتظار جهت پایان بازیابی (recovery)\&. مقدار 0 آن را غیرفعال می‌کند\&. مقدار پیش‌فرض 0 است\&.
.RE
.PP
\fB\-T\fR
.br
\fB\-\-enable\-two\-phase\fR
.RS 4
قابلیت تایید دوفازی (two_phase commit) را برای اشتراک فعال می‌کند\&. هنگامی که چندین پایگاه‌داده مشخص شده باشند، این گزینه به صورت یکنواخت برای تمام اشتراک‌های ایجادشده روی آن پایگاه‌های داده اعمال می‌شود\&. مقدار پیش‌فرض
false
است\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-subscriber\-username=\fR\fB\fIusername\fR\fR
.RS 4
نام کاربری برای اتصال به عنوان آن در سرور مقصد\&. پیش‌فرض، نام کاربری فعلی سیستم‌عامل است\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
حالت پرگویی را فعال می‌کند\&. این امر موجب می‌شود
pg_createsubscriber
پیام‌های پیشرفت و اطلاعات دقیق مربوط به هر مرحله را در خروجی خطای استاندارد بنویسد\&. تکرار این گزینه باعث نمایش پیام‌های بیشتر در سطح اشکال‌زدایی (debug) در خروجی خطای استاندارد می‌شود\&.
.RE
.PP
\fB\-\-clean=\fR\fB\fIobjtype\fR\fR
.RS 4
تمامی اشیاء از نوع مشخص‌شده را از پایگاه‌های داده معین در سرور مقصد حذف (drop) می‌کند\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
publications: انتشارات
FOR ALL TABLES
ایجادشده برای این مشترک همواره حذف می‌شوند؛ مشخص کردن این نوع شیء باعث می‌شود تمامی انتشارات دیگری نیز که از سرور مبدأ بازتکرار شده‌اند حذف شوند\&.
.RE
.sp
اشیاء انتخاب‌شده برای حذف به صورت جداگانه ثبت لاگ می‌شوند، از جمله در حین اجرای
\fB\-\-dry\-run\fR\&. هیچ امکانی برای جلوگیری یا متوقف کردن حذف اشیاء انتخاب‌شده وجود ندارد، بنابراین تهیه نسخه پشتیبان از آن‌ها با استفاده از
pg_dump
را در نظر داشته باشید\&.
.RE
.PP
\fB\-\-config\-file=\fR\fB\fIfilename\fR\fR
.RS 4
از فایل پیکربندی اصلی سرور مشخص‌شده برای دایرکتوری داده مقصد استفاده می‌کند\&.
pg_createsubscriber
در درون خود از دستور
pg_ctl
برای راه‌اندازی و توقف سرور مقصد استفاده می‌کند\&. این گزینه به شما اجازه می‌دهد در صورتی که فایل پیکربندی واقعی
postgresql\&.conf
در خارج از دایرکتوری داده قرار دارد، آن را مشخص کنید\&.
.RE
.PP
\fB\-\-publication=\fR\fB\fIname\fR\fR
.RS 4
نام انتشار برای راه‌اندازی رپلیکیشن منطقی\&. با نوشتن چندین سوئیچ
\fB\-\-publication\fR
می‌توان چندین انتشار را مشخص کرد\&. تعداد نام‌های انتشار باید با تعداد پایگاه‌های داده مشخص‌شده مطابقت داشته باشد، در غیر این صورت خطا گزارش می‌شود\&. ترتیب چندین سوئیچ نام انتشار باید با ترتیب سوئیچ‌های پایگاه‌داده مطابقت داشته باشد\&. اگر این گزینه مشخص نشود، نامی تولیدشده به انتشار اختصاص می‌یابد\&. این گزینه را نمی‌توان همراه با
\fB\-\-all\fR
استفاده کرد\&.
.RE
.PP
\fB\-\-replication\-slot=\fR\fB\fIname\fR\fR
.RS 4
نام اسلات رپلیکیشن برای راه‌اندازی رپلیکیشن منطقی\&. با نوشتن چندین سوئیچ
\fB\-\-replication\-slot\fR
می‌توان چندین اسلات رپلیکیشن را تعیین کرد\&. تعداد نام‌های اسلات رپلیکیشن باید با تعداد پایگاه‌های داده تعیین‌شده مطابقت داشته باشد، در غیر این صورت خطا گزارش خواهد شد\&. ترتیب چندین سوئیچ نام اسلات رپلیکیشن باید با ترتیب سوئیچ‌های پایگاه‌داده همخوانی داشته باشد\&. اگر این گزینه مشخص نشود، نام اشتراک به نام اسلات رپلیکیشن اختصاص داده می‌شود\&. این گزینه را نمی‌توان همراه با
\fB\-\-all\fR
به کار برد\&.
.RE
.PP
\fB\-\-subscription=\fR\fB\fIname\fR\fR
.RS 4
نام اشتراک برای راه‌اندازی رپلیکیشن منطقی\&. با نوشتن چندین سوئیچ
\fB\-\-subscription\fR
می‌توان چندین اشتراک را تعیین نمود\&. تعداد نام‌های اشتراک باید با تعداد پایگاه‌های داده مشخص‌شده مطابقت داشته باشد، در غیر این صورت خطا گزارش می‌شود\&. ترتیب چندین سوئیچ نام اشتراک باید با ترتیب سوئیچ‌های پایگاه‌داده مطابقت داشته باشد\&. اگر این گزینه مشخص نشود، یک نام تولیدشده به نام اشتراک اختصاص می‌یابد\&. این گزینه را نمی‌توان همراه با
\fB\-\-all\fR
به کار برد\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
نسخه
pg_createsubscriber
را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنما درباره آرگومان‌های خط فرمان
pg_createsubscriber
را نمایش داده و خارج می‌شود\&.
.RE
.SH "نکات (NOTES)"
.SS "پیش‌نیازها (Prerequisites)"
.PP
برای اینکه
pg_createsubscriber
سرور مقصد را به یک رپلیکای منطقی تبدیل کند، پیش‌نیازهایی وجود دارد\&. اگر این پیش‌نیازها برآورده نشوند، خطا گزارش خواهد شد\&. سرورهای مبدأ و مقصد باید دارای نسخه اصلی یکسانی با
pg_createsubscriber
باشند\&. دایرکتوری داده مقصد داده‌شده باید دارای شناسه سیستم یکسانی با دایرکتوری داده مبدأ باشد\&. کاربر پایگاه‌داده مشخص‌شده برای دایرکتوری داده مقصد باید دسترسی‌های لازم برای ایجاد
اشتراک‌ها
و استفاده از
\fBpg_replication_origin_advance()\fR
را داشته باشد\&.
.PP
سرور مقصد باید به عنوان یک استندبای فیزیکی مورد استفاده قرار گیرد\&. در سرور مقصد باید
max_active_replication_origins
و
max_logical_replication_workers
روی مقداری بزرگ‌تر یا مساوی با تعداد پایگاه‌های داده مشخص‌شده پیکربندی شده باشند\&. در سرور مقصد باید
max_worker_processes
روی مقداری بزرگ‌تر از تعداد پایگاه‌های داده مشخص‌شده پیکربندی شده باشد\&. سرور مقصد باید اتصالات محلی را بپذیرد\&. اگر قصد استفاده از سوئیچ
\fB\-\-enable\-two\-phase\fR
را دارید، باید
max_prepared_transactions
را نیز به شکل مناسب تنظیم کنید\&.
.PP
سرور مبدأ باید اتصالات از جانب سرور مقصد را بپذیرد\&. سرور مبدأ نباید در وضعیت بازیابی باشد\&. در سرور مبدأ باید
wal_level
روی
logical
تنظیم شده باشد\&. سرور مبدأ باید
max_replication_slots
را روی مقداری بزرگ‌تر یا مساوی با تعداد پایگاه‌های داده مشخص‌شده به‌علاوه اسلات‌های رپلیکیشن موجود پیکربندی کرده باشد\&. سرور مبدأ باید
max_wal_senders
را روی مقداری بزرگ‌تر یا مساوی با تعداد پایگاه‌های داده مشخص‌شده و فرآیندهای فرستنده WAL موجود تنظیم کرده باشد\&.
.SS "هشدارها (Warnings)"
.PP
اگر
pg_createsubscriber
پس از ارتقای سرور مقصد شکست بخورد، دایرکتوری داده احتمالاً در وضعیتی نخواهد بود که قابل بازیابی باشد\&. در چنین حالتی، ایجاد یک سرور استندبای جدید توصیه می‌شود\&.
.PP
دستور
pg_createsubscriber
معمولاً در طول تغییر و تبدیل، سرور مقصد را با تنظیمات اتصال متفاوتی راه‌اندازی می‌کند\&. بنابراین، اتصالات به سرور مقصد باید ناموفق باشند\&.
.PP
از آنجا که دستورات DDL توسط رپلیکیشن منطقی بازتکرار نمی‌شوند، در حین اجرای
pg_createsubscriber
از اجرای دستورات DDL که شمای پایگاه‌داده را تغییر می‌دهند خودداری کنید\&. اگر سرور مقصد قبلاً به رپلیکای منطقی تبدیل شده باشد، دستورات DDL ممکن است بازتکرار نشوند که می‌تواند موجب بروز خطا شود\&.
.PP
اگر
pg_createsubscriber
در حین پردازش با شکست مواجه شود، اشیاء (انتشارات، اسلات‌های رپلیکیشن) ایجادشده روی سرور مبدأ حذف می‌شوند\&. اگر سرور مقصد نتواند به سرور مبدأ متصل شود، ممکن است این حذف با شکست مواجه گردد\&. در چنین شرایطی، یک پیام هشدار اشیاء باقی‌مانده را اطلاع خواهد داد\&. اگر سرور مقصد در حال اجرا باشد، متوقف خواهد شد\&.
.PP
اگر رپلیکیشن از
primary_slot_name
استفاده می‌کند، پس از راه‌اندازی رپلیکیشن منطقی از روی سرور مبدأ حذف خواهد شد\&.
.PP
اگر سرور مقصد یک رپلیکای همگام باشد، تایید تراکنش‌ها در سرور اصلی ممکن است در حین اجرای
pg_createsubscriber
در انتظار رپلیکیشن بماند\&.
.PP
مگر اینکه سوئیچ
\fB\-\-enable\-two\-phase\fR
مشخص شده باشد،
pg_createsubscriber
رپلیکیشن منطقی را با غیرفعال بودن تایید دوفازی راه‌اندازی می‌کند\&. این بدان معناست که هر تراکنش آماده‌شده (prepared transaction) در زمان
\fBCOMMIT PREPARED\fR
و بدون آماده‌سازی قبلی بازتکرار خواهد شد\&. پس از اتمام راه‌اندازی، می‌توانید به صورت دستی اشتراک(ها) را حذف کرده و با فعال بودن گزینه
two_phase
دوباره ایجاد کنید\&.
.PP
دستور
pg_createsubscriber
شناسه سیستم را با استفاده از
pg_resetwal
تغییر می‌دهد\&. این کار از شرایطی که در آن سرور مقصد ممکن است از فایل‌های WAL سرور مبدأ استفاده کند جلوگیری می‌نماید\&. اگر سرور مقصد خود دارای استندبای باشد، رپلیکیشن آن مختل خواهد شد و باید یک استندبای تازه ایجاد شود\&.
.PP
در صورتی که فایل‌های WAL مورد نیاز وجود نداشته باشند، ممکن است شکست در رپلیکیشن رخ دهد\&. برای جلوگیری از این موضوع، سرور مبدأ باید
max_slot_wal_keep_size
را روی
\-1
تنظیم کند تا اطمینان حاصل شود که فایل‌های WAL مورد نیاز پیش از موعد حذف نمی‌شوند\&.
.SS "نحوه کارکرد (How It Works)"
.PP
ایده اصلی داشتن یک نقطه شروع رپلیکیشن از سرور مبدأ و راه‌اندازی رپلیکیشن منطقی برای شروع از این نقطه است:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
راه‌اندازی سرور مقصد با گزینه‌های خط فرمان مشخص‌شده\&. اگر سرور مقصد در حال حاضر در حال اجرا باشد،
pg_createsubscriber
با یک خطا متوقف خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
بررسی اینکه آیا سرور مقصد می‌تواند تبدیل شود یا خیر\&. همچنین چند بررسی روی سرور مبدأ انجام می‌شود\&. اگر هر یک از پیش‌نیازها برآورده نشوند،
pg_createsubscriber
با یک خطا متوقف خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
ایجاد یک انتشار و یک اسلات رپلیکیشن برای هر پایگاه‌داده مشخص‌شده روی سرور مبدأ\&. هر انتشار با استفاده از
FOR ALL TABLES
ایجاد می‌شود\&. اگر گزینه
\fB\-\-publication\fR
مشخص نشده باشد، انتشار دارای الگوی نام‌گذاری زیر خواهد بود:
\(lqpg_createsubscriber_%u_%x\(rq
(پارامترها: شناسه پایگاه‌داده
\fIoid\fR،
عدد تصادفی
\fIint\fR)\&.
اگر گزینه
\fB\-\-replication\-slot\fR
مشخص نشده باشد، اسلات رپلیکیشن دارای الگوی نام‌گذاری زیر خواهد بود:
\(lqpg_createsubscriber_%u_%x\(rq
(پارامترها: شناسه پایگاه‌داده
\fIoid\fR،
عدد تصادفی
\fIint\fR)\&.
این اسلات‌های رپلیکیشن در مرحله بعدی توسط اشتراک‌ها مورد استفاده قرار خواهند گرفت\&. آخرین LSN اسلات رپلیکیشن به عنوان نقطه توقف در پارامتر
recovery_target_lsn
و توسط اشتراک‌ها به عنوان نقطه شروع رپلیکیشن استفاده می‌شود\&. این کار تضمین می‌کند که هیچ تراکنشی از دست نخواهد رفت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
نوشتن پارامترهای بازیابی در دایرکتوری داده مقصد و راه‌اندازی مجدد سرور مقصد\&. این عمل، یک LSN (در recovery_target_lsn) از موقعیت گزارش ثبت وقایع قبل از نوشتن (WAL) را مشخص می‌کند که بازیابی تا آن نقطه پیش خواهد رفت\&. همچنین
promote
را به عنوان اقدامی که سرور پس از رسیدن به هدف بازیابی باید انجام دهد مشخص می‌کند\&. پارامترهای بازیابی دیگری نیز اضافه می‌شوند تا از رفتارهای غیرمنتظره در حین فرآیند بازیابی جلوگیری شود، مانند پایان بازیابی به محض رسیدن به وضعیتی پایدار (WAL باید تا موقعیت شروع رپلیکیشن اعمال شود) و اهداف بازیابی چندگانه که می‌توانند باعث شکست شوند\&. این مرحله به محض اینکه سرور از حالت استندبای خارج شده و تراکنش‌های خواندن/نوشتن را بپذیرد پایان می‌یابد\&. اگر گزینه
\fB\-\-recovery\-timeout\fR
تنظیم شده باشد، در صورتی که بازیابی تا مدت زمان تعیین‌شده به ثانیه به پایان نرسد،
pg_createsubscriber
متوقف می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
ایجاد یک اشتراک برای هر پایگاه‌داده مشخص‌شده روی سرور مقصد\&. اگر گزینه
\fB\-\-subscription\fR
مشخص نشده باشد، اشتراک دارای الگوی نام‌گذاری زیر خواهد بود:
\(lqpg_createsubscriber_%u_%x\(rq
(پارامترها: شناسه پایگاه‌داده
\fIoid\fR،
عدد تصادفی
\fIint\fR)\&.
این عمل داده‌های موجود را از سرور مبدأ رونوشت نمی‌کند\&. اسلات رپلیکیشن نیز ایجاد نمی‌کند\&. در عوض، از اسلات رپلیکیشنی که در مرحله قبلی ایجاد شده بود استفاده می‌کند\&. اشتراک ایجاد می‌شود اما هنوز فعال نیست\&. دلیل آن این است که پیشرفت رپلیکیشن باید قبل از شروع رپلیکیشن، روی نقطه شروع رپلیکیشن تنظیم شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
حذف انتشارات روی سرور مقصد که به دلیل ایجاد شدن قبل از موقعیت شروع رپلیکیشن، بازتکرار شده بودند\&. این انتشارات روی مشترک هیچ کاربردی ندارند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
تنظیم پیشرفت رپلیکیشن روی نقطه شروع رپلیکیشن برای هر اشتراک\&. هنگامی که سرور مقصد فرآیند بازیابی را آغاز می‌کند، خود را به نقطه شروع رپلیکیشن می‌رساند\&. این دقیقاً همان LSN است که باید به عنوان موقعیت رپلیکیشن اولیه برای هر اشتراک استفاده شود\&. نام مبدأ رپلیکیشن با توجه به ایجاد اشتراک به دست می‌آید\&. نام مبدأ رپلیکیشن و نقطه شروع رپلیکیشن در
\fBpg_replication_origin_advance()\fR
برای تنظیم موقعیت اولیه رپلیکیشن استفاده می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  8." 4.2
.\}
فعال کردن اشتراک برای هر پایگاه‌داده مشخص‌شده روی سرور مقصد\&. اشتراک اعمال تراکنش‌ها را از نقطه شروع رپلیکیشن آغاز می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  9." 4.2
.\}
اگر سرور استندبای از
primary_slot_name
استفاده می‌کرد، از این پس کاربردی ندارد، بنابراین حذف می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 10.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  10." 4.2
.\}
اگر سرور استندبای حاوی اسلات‌های رپلیکیشن failover باشد، دیگر امکان همگام‌سازی آن‌ها وجود ندارد، بنابراین حذف می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 11.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  11." 4.2
.\}
به‌روزرسانی شناسه سیستم در سرور مقصد\&. دستور
\fBpg_resetwal\fR(1)
برای تغییر دادن شناسه سیستم اجرا می‌شود\&. سرور مقصد به عنوان یکی از الزامات
\fBpg_resetwal\fR
متوقف می‌گردد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای ایجاد یک رپلیکای منطقی برای پایگاه‌های داده
hr
و
finance
از روی یک رپلیکای فیزیکی در
foo:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_createsubscriber \-D /usr/local/pgsql/data \-P "host=foo" \-d hr \-d finance\fR
.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
\fBpg_basebackup\fR(1)