.TH MDB_LOAD 1 "2015/09/30" "LMDB 0.9.17"
.\" Copyright 2014-2021 Howard Chu, Symas Corp. All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.SH "نام (NAME)"
mdb_load \- ابزار بارگذاری و ایمپورت داده‌ها به پایگاه‌داده LMDB
.SH "خلاصه دستور (SYNOPSIS)"
.B mdb_load
[\c
.BR \-V ]
[\c
.BR \-a ]
[\c
.BI \-f \ file\fR]
[\c
.BR \-n ]
[\c
.BI \-s \ subdb\fR]
[\c
.BR \-N ]
[\c
.BR \-Q ]
[\c
.BR \-T ]
.BR \ envpath
.SH "توضیحات (DESCRIPTION)"
ابزار
.B mdb_load
داده‌ها را از ورودی استاندارد خوانده و آن‌ها را در محیط پایگاه‌داده LMDB به آدرس
.BR envpath
بارگذاری می‌کند.
.PP
ورودی
.B mdb_load
باید در قالب خروجی تعیین‌شده توسط ابزار
.BR mdb_dump (1)
یا طبق مشخصات گزینه
.B \-T
در زیر باشد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-V
شماره نسخه کتابخانه را در خروجی استاندارد چاپ کرده و خارج می‌شود.
.TP
.BR \-a
تمام رکوردها را به همان ترتیبی که در ورودی ظاهر می‌شوند ضمیمه می‌کند. فرض می‌شود که ورودی از قبل به‌درستی مرتب شده است و هیچ مرتب‌سازی یا بررسی مقادیر تکراری انجام نخواهد شد. این گزینه باید برای بارگذاری مجدد داده‌هایی استفاده شود که با اجرای
.B mdb_dump
روی پایگاه‌داده‌ای با توابع مقایسه سفارشی ایجاد شده‌اند.
.TP
.BR \-f \ file
داده‌ها را به‌جای ورودی استاندارد، از فایل مشخص‌شده می‌خواند.
.TP
.BR \-n
یک پایگاه‌داده LMDB را بارگذاری می‌کند که از زیردایرکتوری‌ها استفاده نمی‌کند.
.TP
.BR \-s \ subdb
یک زیرپایگاه‌داده مشخص را بارگذاری می‌کند. اگر هیچ پایگاه‌داده‌ای مشخص نشود، داده‌ها در پایگاه‌داده اصلی بارگذاری می‌شوند.
.TP
.BR \-N
هنگام بارگذاری در پایگاه‌داده‌ای که از قبل وجود دارد، رکوردهای موجود را بازنویسی نمی‌کند؛ صرفاً آن‌ها را نادیده می‌گیرد.
.TP
.BR \-Q
حالت سریع؛ از MDB_NOSYNC برای بارگذاری سریع‌تر استفاده می‌کند. پیش از خروج، همگام‌سازی را با ()mdb_env_sync اجبار می‌کند.
.TP
.BR \-T
بارگذاری داده‌ها از فایل‌های متنی ساده. ورودی باید جفت‌خط‌هایی از متن باشد که در آن خط اول هر جفت، کلید و خط دوم جفت، داده متناظر با آن است.
.PP
یک سازوکار ساده گریز (escape) که در آن نویسه‌های خط جدید و بک‌اسلش (\\) نویسه‌های ویژه محسوب می‌شوند، روی ورودی متنی اعمال می‌شود. نویسه‌های خط جدید به عنوان جداکننده رکورد تفسیر می‌شوند. نویسه‌های بک‌اسلش در متن به یکی از دو روش تفسیر خواهند شد: اگر نویسه بک‌اسلش پیش از یک نویسه بک‌اسلش دیگر بیاید، این جفت به عنوان یک بک‌اسلش واقعی تفسیر می‌شود. اگر نویسه بک‌اسلش پیش از هر نویسه دیگری بیاید، دو نویسه بعد از بک‌اسلش به عنوان مشخصه هگزادسیمال یک نویسه تکی تفسیر خواهند شد؛ برای مثال، \\0a یک نویسه خط جدید در مجموعه نویسه‌های ASCII است.
.PP
به همین دلیل، هرگونه نویسه بک‌اسلش یا خط جدید که به‌طور طبیعی در ورودی متن وجود دارد باید اسکیپ شود تا از تفسیر نادرست آن توسط
.B mdb_load
جلوگیری شود.
.SH "عیب‌یابی (DIAGNOSTICS)"
در صورت عدم وقوع خطا، وضعیت خروج صفر است.
خطاها منجر به وضعیت خروج غیرصفر و
نوشته شدن پیام عیب‌یابی در خروجی خطای استاندارد می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR mdb_dump (1)
.SH "نویسنده (AUTHOR)"
هاوارد چو از شرکت سایماس <http://www.symas.com>