.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ZONE2SQL" "1" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
zone2sql \- تبدیل ناحیه‌های BIND به SQL
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBzone2sql\fP {\fB\-\-named\-conf=\fP\fIPATH\fP,\fB\-\-zone\-file=\fP\fIPATH\fP [\fB\-\-zone\-name=\fP\fINAME\fP]} [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBzone2sql\fP فایل‌های named.conf و پرونده‌های ناحیه (zonefile) در BIND را تجزیه کرده و خروجی SQL را در خروجی استاندارد تولید می‌کند، که سپس می‌توان آن را به پایگاه‌داده وارد کرد.
.sp
دستور \fBzone2sql\fP پسوند پروندهٔ اصلی BIND یعنی \fB$GENERATE\fP را درک کرده و همچنین به \fB$ORIGIN\fP و \fB$TTL\fP\& توجه و عمل می‌کند.
.sp
برای پس‌زمینه‌هایی که از عملیات ثانویه (secondary) پشتیبانی می‌کنند، گزینه‌ای نیز برای نگه‌داشتن ناحیه‌های ثانویه به‌عنوان ثانویه و عدم تبدیل آن‌ها به عملیات محلی (native) وجود دارد.
.sp
دستور \fBzone2sql\fP می‌تواند برای پس‌زمینه‌های Generic MySQL، Generic PostgreSQL و Generic SQLite3 کد SQL تولید کند.
.SH "گزینه‌ها (OPTIONS)"
.SH "گزینه‌های ورودی (INPUT OPTIONS)"
.INDENT 0.0
.TP
.BI \-\-named\-conf\fB= <PATH>
خواندن \fIPATH\fP جهت دریافت پیکربندی BIND.
.TP
.BI \-\-zone\fB= <PATH>
تنها پروندهٔ ناحیه در \fIPATH\fP تجزیه شود. با پارامتر \fB\-\-named\-conf\fP تداخل دارد.
.TP
.BI \-\-zone\-name\fB= <NAME>
هنگام تجزیهٔ یک ناحیهٔ منفرد بدون گزارهٔ $ORIGIN، مقدار \fIZONE\fP را به‌عنوان نام ناحیه تنظیم می‌کند.
.UNINDENT
.SH "پس‌زمینه‌ها (BACKENDS)"
.INDENT 0.0
.TP
.B  \-\-gmysql
تولید خروجی در قالبی مناسب برای پیکربندی پیش‌فرض پس‌زمینهٔ Generic MySQL.
.TP
.B  \-\-gpgsql
تولید خروجی در قالبی مناسب برای پیکربندی پیش‌فرض پس‌زمینهٔ Generic PostgreSQL.
.TP
.B  \-\-gsqlite
تولید خروجی در قالبی مناسب برای پیکربندی پیش‌فرض پس‌زمینهٔ Generic SQLite3.
.UNINDENT
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
.INDENT 0.0
.TP
.B  \-\-json\-comments
تجزیهٔ JSON در کامنت‌های پروندهٔ ناحیه برای تنظیم فیلدهای \(aqdisabled\(aq و \(aqcomment\(aq در پایگاه‌داده. برای اطلاعات بیشتر، بخش \fIکامنت‌های جیسون (JSON COMMENTS)\fP را ببینید.
.TP
.B  \-\-transactions
چنانچه پس‌زمینهٔ SQL مقصد از تراکنش‌ها پشتیبانی کند، برای حفظ یکپارچگی و احتمالاً سرعت بالاتر، هر دامنه را درون یک تراکنش قرار می‌دهد.
.UNINDENT
.SH "سایر گزینه‌ها (OTHER OPTIONS)"
.INDENT 0.0
.TP
.B  \-\-delete\-matching\-domains
یک دستور delete به خروجی sql اضافه می‌کند تا وارد کردن مجدد ناحیه‌ها ممکن شود. این گزینه بیشتر هنگام آزمایش مفید است. از آن‌جا که این کار فقط دامنه را حذف می‌کند و نه رکوردهای آن را، باید رابطهٔ کلید خارجی (foreign key) اختیاری را در طرحوارهٔ (schema) خود فعال کرده باشید تا از باقی ماندن رکوردهای معلق جلوگیری شود.
.TP
.B  \-\-filter\-duplicate\-soa
اگر بیش از یک رکورد SOA در ناحیه وجود داشته باشد (احتمالاً به دلیل دریافت از طریق AXFR)، آن را نادیده می‌گیرد. اگر این گزینه تنظیم نشود، تمام رکوردهای SOA موجود در ناحیه منتشر می‌شوند.
.TP
.B  \-\-help
نمایش فهرست تمام گزینه‌ها.
.TP
.B  \-\-on\-error\-resume\-next
نادیده گرفتن پرونده‌های ناحیهٔ مفقود در طول تجزیه. خطرناک است.
.TP
.B  \-\-secondary
حفظ وضعیت ثانویه برای ناحیه‌هایی که در named.conf به عنوان slave فهرست شده‌اند. رفتار پیش‌فرض تبدیل همهٔ ناحیه‌ها به عملیات بومی (native) است.
.TP
.B  \-\-verbose
نمایش اطلاعات مشروح در طول فرایند تبدیل.
.UNINDENT
.SH "کامنت‌های جیسون (JSON COMMENTS)"
.sp
پس‌زمینه‌های Generic SQL فیلدهای \(aqcomment\(aq و \(aqdisabled\(aq را در جدول \(aqrecords\(aq دارند. فیلد \(aqcomment\(aq حاوی توضیحی برای این رکورد (در صورت وجود) است و فیلد \(aqdisabled\(aq به PowerDNS اطلاع می‌دهد که آیا این رکورد می‌تواند به کلاینت‌ها ارائه شود یا خیر.
.sp
زمانی که یک zonefile شامل کامنتی مانند
\fB; json={\(dqcomment\(dq: \(dqSomething\(dq, \(dqdisabled\(dq: true}\fP
باشد و گزینهٔ \fB\-\-json\-comments\fP داده شده باشد، فیلد \(aqcomment\(aq حاوی
\(dqSomething\(dq خواهد بود و فیلد \(aqdisabled\(aq بر روی مقدار true بومی پایگاه‌داده تنظیم می‌شود.
.sp
هشدار: استفاده از کامنت‌های JSON برای غیرفعال کردن رکوردها به این معنی است که ناحیه در PowerDNS با ناحیه ارائه‌شده توسط BIND متفاوت خواهد بود، چرا که BIND وضعیت غیرفعال در کامنت را پردازش نمی‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.sp
pdns_server(1)
.SH "نویسندگان (AUTHORS)"
PowerDNS.COM BV
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.