.TH SQLITE_TABLE 5
.ad
.fi
.SH "نام (NAME)"
sqlite_table \- پیکربندی SQLite در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap \-q "\fIstring\fB" sqlite:/etc/postfix/\fIfilename\fR

\fBpostmap \-q \- sqlite:/etc/postfix/\fIfilename\fB <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
سیستم ایمیل Postfix از جدول‌های اختیاری برای بازنویسی نشانی یا مسیریابی ایمیل استفاده می‌کند. این جدول‌ها معمولاً در قالب‌های \fBlmdb:\fR، \fBcdb:\fR، \fBhash:\fR یا \fBdbm:\fR هستند.

به‌عنوان روش جایگزین، جدول‌های جستجو می‌توانند به‌صورت پایگاه‌های داده SQLite مشخص شوند. برای اطلاع از اینکه سیستم Postfix شما از چه نوع جدول‌های جستجویی پشتیبانی می‌کند، از دستور "\fBpostconf \-m\fR" استفاده کنید.

به‌منظور استفاده از جستجوهای SQLite، یک منبع SQLite را به‌صورت جدول جستجو در main.cf تعریف کنید، برای نمونه:
.nf
    alias_maps = sqlite:/etc/postfix/sqlite\-aliases.cf
.fi

فایل /etc/postfix/sqlite\-aliases.cf همان قالبی را دارد که فایل main.cf در Postfix داراست، و می‌تواند پارامترهای شرح‌داده‌شده در زیر را مشخص کند.
.SH "عضویت در فهرست (LIST MEMBERSHIP)"
.na
.nf
.ad
.fi
هنگام استفاده از SQL برای ذخیره فهرست‌هایی نظیر $mynetworks، $mydestination، $relay_domains، $local_recipient_maps و غیره، درک این نکته اهمیت دارد که جدول باید هر عضو فهرست را به‌صورت یک کلید جداگانه ذخیره کند. جستجوی جدول *وجود داشتن* کلید را اعتبارسنجی می‌کند. برای بحث بیشتر، به بخش "Postfix lists versus tables" در سند DATABASE_README مراجعه کنید.

جدول‌هایی ایجاد \fBنکنید\fR که فهرست کامل دامنه‌ها را در $mydestination یا $relay_domains و غیره، یا نشانی‌های IP را در $mynetworks بازگردانند.

جدول‌ها را با قرار دادن هر مورد منطبق به‌صورت یک کلید و با یک مقدار دلخواه ایجاد \fBکنید\fR. در پایگاه‌های داده SQL غیرمعمول نیست که خود کلید یا یک مقدار ثابت بازگردانده شود.
.SH "پارامترهای SQLITE (SQLITE PARAMETERS)"
.na
.nf
.ad
.fi
.IP "\fBdbpath\fR"
مکان فایل پایگاه داده SQLite. نمونه:
.nf
    dbpath = customer_database
.fi
.IP "\fBquery\fR"
الگوی پرس‌وجوی SQL مورداستفاده برای جستجو در پایگاه داده، که در آن \fB%s\fR جایگزینی برای نشانی‌ای است که Postfix در تلاش برای تحلیل آن است، برای نمونه:
.nf
    query = SELECT replacement FROM aliases WHERE mailbox = '%s'
.fi

این پارامتر از بسط‌های '%' زیر پشتیبانی می‌کند:
.RS
.IP "\fB%%\fR"
این مورد با یک نویسه پیش‌پاافتاده '%' جایگزین می‌شود.
.IP "\fB%s\fR"
این مورد با کلید ورودی جایگزین می‌شود. نقل‌قول‌گذاری SQL (SQL quoting) استفاده می‌شود تا اطمینان حاصل گردد که کلید ورودی نویسه‌های متا (metacharacters) غیرمنتظره اضافه نمی‌کند.
.IP "\fB%u\fR"
هنگامی که کلید ورودی یک نشانی به شکل user@domain باشد، \fB%u\fR با بخش محلی (local part) نشانی که نقل‌قول‌گذاری SQL شده جایگزین می‌شود. در غیر این صورت، \fB%u\fR با کل رشته جستجو جایگزین می‌شود. اگر بخش محلی خالی باشد، پرس‌وجو متوقف شده و هیچ نتیجه‌ای برنمی‌گرداند.
.IP "\fB%d\fR"
هنگامی که کلید ورودی یک نشانی به شکل user@domain باشد، \fB%d\fR با بخش دامنه نشانی که نقل‌قول‌گذاری SQL شده جایگزین می‌شود. در غیر این صورت، پرس‌وجو متوقف شده و هیچ نتیجه‌ای برنمی‌گرداند.
.IP "\fB%[SUD]\fR"
معادل‌های با حروف بزرگ بسط‌های بالا در پارامتر \fBquery\fR رفتاری کاملاً همسان با همتایان حروف کوچک خود دارند. با پارامتر \fBresult_format\fR (زیر را ببینید)، آن‌ها به‌جای مقدار نتیجه، کلید ورودی را بسط می‌دهند.
.IP "\fB%[1\-9]\fR"
الگوهای %1، %2، ... %9 با مؤلفه متناظر با بیشترین اهمیت از دامنه کلید ورودی جایگزین می‌شوند. اگر کلید ورودی \fIuser@mail.example.com\fR باشد، آنگاه %1 برابر با \fBcom\fR، %2 برابر با \fBexample\fR و %3 برابر با \fBmail\fR است. اگر کلید ورودی بدون صلاحیت (unqualified) باشد یا مؤلفه‌های دامنه کافی برای برآورده کردن تمام الگوهای مشخص‌شده نداشته باشد، پرس‌وجو متوقف شده و هیچ نتیجه‌ای برنمی‌گرداند.
.RE
.IP
پارامتر \fBdomain\fR شرح داده شده در زیر، کلیدهای ورودی را به نشانی‌های دامنه‌های منطبق محدود می‌کند. هنگامی که پارامتر \fBdomain\fR خالی نباشد، پرس‌وجوهای SQL برای نشانی‌های فاقد صلاحیت یا نشانی‌های موجود در دامنه‌های غیرمنطبق متوقف شده و هیچ نتیجه‌ای بازنمی‌گردانند.

این پارامتر در Postfix نسخه 2.2 و بالاتر در دسترس است. در انتشار‌های پیشین، پرس‌وجوی SQL از پارامترهای جداگانه ساخته می‌شد: \fBselect_field\fR، \fBtable\fR، \fBwhere_field\fR و \fBadditional_conditions\fR. نگاشت از پارامترهای قدیمی به پرس‌وجوی معادل عبارت است از:

.nf
    SELECT [\fBselect_field\fR]
    FROM [\fBtable\fR]
    WHERE [\fBwhere_field\fR] = '%s'
          [\fBadditional_conditions\fR]
.fi

عبارت '%s' در بند \fBWHERE\fR به رشته جستجوی اسکیپ‌شده بسط می‌یابد. با Postfix نسخه 2.2، اگر پارامتر \fBquery\fR مشخص نشده باشد، از این پارامترهای موروثی استفاده می‌شود.

نکته: دور پارامتر \fBquery\fR علامت نقل‌قول قرار ندهید.
.IP "\fBresult_format (پیش‌فرض: \fB%s\fR)\fR"
الگوی قالب اعمال‌شده بر ویژگی‌های نتیجه. معمولاً برای افزودن متن به انتها (یا ابتدا) نتیجه استفاده می‌شود. این پارامتر از بسط‌های '%' زیر پشتیبانی می‌کند:
.RS
.IP "\fB%%\fR"
این مورد با یک نویسه پیش‌پاافتاده '%' جایگزین می‌شود.
.IP "\fB%s\fR"
این مورد با مقدار ویژگی نتیجه جایگزین می‌شود. هنگامی که نتیجه خالی باشد، از آن صرف‌نظر می‌شود.
.IP "\fB%u\fR"
هنگامی که مقدار ویژگی نتیجه نشانی‌ای به شکل user@domain باشد، \fB%u\fR با بخش محلی نشانی جایگزین می‌شود. هنگامی که نتیجه دارای بخش محلی خالی باشد، از آن صرف‌نظر می‌شود.
.IP "\fB%d\fR"
هنگامی که مقدار ویژگی نتیجه نشانی‌ای به شکل user@domain باشد، \fB%d\fR با بخش دامنه مقدار ویژگی جایگزین می‌شود. هنگامی که نتیجه فاقد صلاحیت باشد، از آن صرف‌نظر می‌شود.
.IP "\fB%[SUD1\-9]\fR"
بسط‌های حروف بزرگ و ارقام ده‌دهی به‌جای نتیجه، بخش‌هایی از کلید ورودی را درج می‌کنند. رفتار آن‌ها مشابه همان است که در مورد \fBquery\fR شرح داده شد، و در واقع از آنجا که کلید ورودی از قبل مشخص است، پرس‌وجوهایی که کلید آن‌ها شامل تمام اطلاعات مشخص‌شده در الگوی نتیجه نباشد متوقف شده و هیچ نتیجه‌ای برنمی‌گردانند.
.RE
.IP
برای نمونه، استفاده از "result_format = smtp:[%s]" امکان استفاده از ویژگی mailHost را به‌عنوان مبنایی برای جدول transport(5) فراهم می‌کند. پس از اعمال قالب نتیجه، مقادیر چندگانه به‌صورت رشته‌های جداشده با کاما به هم متصل می‌شوند. پارامتر expansion_limit که در ادامه توضیح داده شده است، اجازه می‌دهد تعداد مقادیر در نتیجه محدود شود، که به‌ویژه برای نگاشت‌هایی که باید حداکثر یک مقدار بازگردانند مفید است.

مقدار پیش‌فرض \fB%s\fR مشخص می‌کند که هر مقدار نتیجه باید همان‌گونه که هست استفاده شود.

این پارامتر در Postfix نسخه 2.2 و بالاتر در دسترس است.

نکته: دور قالب نتیجه (result format) نقل‌قول قرار ندهید!
.IP "\fBdomain (پیش‌فرض: بدون فهرست دامنه)\fR"
این گزینه‌ای است شامل فهرستی از نام‌های دامنه، مسیرهای فایل‌ها، یا پایگاه‌های داده "type:table". در صورت تعیین، تنها کلیدهای جستجوی واجد شرایط کامل با بخش محلی *غیرخالی* و دامنه منطبق، واجد شرایط جستجو هستند: جستجوهای 'user'، جستجوهای صرفاً دامنه و جستجوهای "@domain" انجام نمی‌شوند. این امر می‌تواند بار پرس‌وجو روی سرور SQLite را به‌طور چشمگیری کاهش دهد.
.nf
    domain = postfix.org, hash:/etc/postfix/searchdomains
.fi

بهتر است از SQL برای ذخیره دامنه‌های واجد شرایط جستجوهای SQL استفاده نشود.

این پارامتر در Postfix نسخه 2.2 و بالاتر در دسترس است.

نکته: این پارامتر را برای نام‌های مستعار local(8) تعریف \fBنکنید\fR، زیرا کلیدهای ورودی همیشه فاقد صلاحیت (unqualified) هستند.
.IP "\fBexpansion_limit (پیش‌فرض: 0)\fR"
محدودیتی برای تعداد کل عناصر نتیجه بازگردانده‌شده (به‌صورت یک فهرست جداشده با کاما) توسط یک جستجو در نگاشت. مقدار صفر محدودیت را غیرفعال می‌کند. در صورت فراتر رفتن از حد مجاز، جستجوها با یک خطای موقت مواجه می‌شوند. تنظیم این محدودیت روی 1 تضمین می‌کند که جستجوها مقادیر چندگانه بازنگردانند.
.SH "پارامترهای منسوخ MAIN.CF (OBSOLETE MAIN.CF PARAMETERS)"
.na
.nf
.ad
.fi
برای سازگاری با سایر جدول‌های جستجوی Postfix، پارامترهای SQLite را می‌توان در main.cf نیز تعریف کرد. برای این کار، به‌عنوان منبع SQLite نامی را مشخص کنید که با یک اسلش یا نقطه شروع نشود. سپس پارامترهای SQLite با نامی که برای منبع در تعریف آن تعیین کرده‌اید، یک زیرخط (_) و نام پارامتر در دسترس خواهند بود. برای نمونه، اگر نگاشت به‌صورت "sqlite:\fIsqlitename\fR" مشخص شود، پارامتر "query" در main.cf به‌صورت "\fIsqlitename\fR_query" تعریف خواهد شد.
.SH "رابط کاربری منسوخ پرس‌وجو (OBSOLETE QUERY INTERFACE)"
.na
.nf
.ad
.fi
این بخش رابطی را شرح می‌دهد که از نسخه 2.2 نرم‌افزار Postfix منسوخ شده است. این رابط با رابط عمومی‌تر \fBquery\fR که در بالا شرح داده شد جایگزین گردیده است. اگر پارامتر \fBquery\fR تعریف شده باشد، پارامترهای موروثی شرح‌داده‌شده در اینجا نادیده گرفته می‌شوند. لطفاً به رابط جدید مهاجرت کنید زیرا رابط موروثی ممکن است در انتشار‌های آینده حذف شود.

پارامترهای زیر می‌توانند برای پر کردن یک عبارت الگوی SELECT به شکل زیر استفاده شوند:

.nf
    SELECT [\fBselect_field\fR]
    FROM [\fBtable\fR]
    WHERE [\fBwhere_field\fR] = '%s'
          [\fBadditional_conditions\fR]
.fi

مشخص‌کننده %s با رشته جستجو جایگزین می‌شود و اسکیپ می‌شود تا در صورتی که شامل علامت نقل‌قول تکی یا سایر نویسه‌های غیرمعمول باشد، باعث بروز خطای تجزیه و بدتر از آن، مشکل امنیتی نگردد.
.IP "\fBselect_field\fR"
پارامتر "select" در SQL. نمونه:
.nf
    \fBselect_field\fR = forw_addr
.fi
.IP "\fBtable\fR"
نام جدول "select .. from" در SQL. نمونه:
.nf
    \fBtable\fR = mxaliases
.fi
.IP "\fBwhere_field\fR"
پارامتر "select .. where" در SQL. نمونه:
.nf
    \fBwhere_field\fR = alias
.fi
.IP "\fBadditional_conditions\fR"
شرایط اضافی برای پرس‌وجوی SQL. نمونه:
.nf
    \fBadditional_conditions\fR = AND status = 'paid'
.fi
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postmap(1)، نگهداری جدول جستجوی Postfix
postconf(5)، پارامترهای پیکربندی
ldap_table(5)، جدول‌های جستجوی LDAP
mysql_table(5)، جدول‌های جستجوی MySQL
pgsql_table(5)، جدول‌های جستجوی PostgreSQL
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
از "\fBpostconf readme_directory\fR" یا "\fBpostconf html_directory\fR" برای یافتن مکان این اطلاعات استفاده کنید.
.na
.nf
DATABASE_README، نمای کلی جدول جستجوی Postfix
SQLITE_README، راهنمای SQLite در Postfix
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز ایمیل‌رسان امن (Secure Mailer license) باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
پشتیبانی از SQLite در نسخه 2.8 نرم‌افزار Postfix معرفی شد.
.SH "نویسندگان (AUTHORS)"
.na
.nf
پیاده‌سازی اولیه توسط:
Axel Steiner