MARIADB-IMPORT(1) MariaDB Database System MARIADB-IMPORT(1)

mariadb-import - ابزار وارد کردن داده‌ها از فایل‌های متنی به پایگاه داده

mariadb-import [options] db_name textfile1 ...

کلاینت mariadb-import یک رابط خط فرمانی برای دستور SQL LOAD DATA INFILE فراهم می‌کند. بیشتر گزینه‌های mariadb-import مستقیماً با بندهای ساختار دستوری LOAD DATA INFILE مطابقت دارند.

اجرای mariadb-import به صورت زیر است:

shell> mariadb-import [options] db_name textfile1 [textfile2 ...]

برای هر فایل متنی مشخص‌شده در خط فرمان، mariadb-import هرگونه پسوند را از نام فایل حذف کرده و از نتیجه برای تعیین نام جدولی که محتویات فایل باید درون آن وارد شود استفاده می‌کند. برای نمونه، فایل‌هایی با نام‌های patient.txt, patient.text, و patient همگی درون جدولی به نام patient وارد خواهند شد.

mariadb-import از گزینه‌های زیر پشتیبانی می‌کند که می‌توان آن‌ها را در خط فرمان یا در گروه‌های [mariadb-import] و [client] از فایل‌های تنظیمات مشخص کرد. mariadb-import همچنین از گزینه‌های پردازش فایل‌های تنظیمات پشتیبانی می‌کند.

•--help, -?

نمایش پیام راهنما و خروج.

•--character-sets-dir=path

دایرکتوری محل نصب مجموعه‌های نویسه (character sets).

•--columns=column_list, -c column_list

این گزینه فهرستی از نام‌های ستون‌ها را که با کاما از هم جدا شده‌اند به عنوان مقدار می‌پذیرد. ترتیب نام ستون‌ها نحوه تطبیق ستون‌های فایل داده با ستون‌های جدول را مشخص می‌کند.

•--compress, -C

فشرده‌سازی تمام اطلاعات ارسالی میان کلاینت و سرور در صورتی که هر دو از فشرده‌سازی پشتیبانی کنند.

•--debug[=debug_options], -# [debug_options]

نوشتن گزارش اشکال‌زدایی (debug log). یک رشته معمول برای debug_options عبارت است از 'd:t:o,file_name'. مقدار پیش‌فرض 'd:t:o' است.

•--debug-check

چاپ برخی اطلاعات اشکال‌زدایی هنگام خروج برنامه.

•--debug-info

چاپ اطلاعات اشکال‌زدایی و آمارهای مصرف حافظه و پردازنده هنگام خروج برنامه.

•--default-auth=plugin_name

پلاگین احراز هویت پیش‌فرض سمت کلاینت برای استفاده.

•--default-character-set=charset_name

استفاده از charset_name به عنوان مجموعه نویسه پیش‌فرض.

•--defaults-extra-file=filename

تنظیم filename به عنوان فایلی برای خواندن گزینه‌های پیش‌فرض پس از خوانده شدن فایل‌های پیش‌فرض سراسری. باید به عنوان نخستین گزینه داده شود.

•--defaults-file=filename

تنظیم filename به عنوان فایل خواندن گزینه‌های پیش‌فرض، که جایگزین فایل‌های پیش‌فرض سراسری می‌شود. باید به عنوان نخستین گزینه داده شود.

•--delete, -d

خالی کردن جدول پیش از وارد کردن داده‌های فایل متنی.

•--fields-terminated-by=..., --fields-enclosed-by=..., --fields-optionally-enclosed-by=..., --fields-escaped-by=...

این گزینه‌ها همان معنای بندهای متناظر در LOAD DATA INFILE را دارند.

•--force, -f

نادیده گرفتن خطاها. برای نمونه، اگر جدولی برای یک فایل متنی وجود نداشته باشد، پردازش سایر فایل‌های باقی‌مانده ادامه می‌یابد. بدون گزینه --force، در صورت عدم وجود جدول، mariadb-import متوقف و خارج می‌شود.

•--host=host_name, -h host_name

وارد کردن داده‌ها به سرور MariaDB روی هاست داده‌شده. هاست پیش‌فرض localhost است.

•--ignore, -i

توضیحات مربوط به گزینه --replace را مشاهده کنید.

•--ignore-foreign-keys, -k

غیرفعال کردن بررسی کلیدهای خارجی (foreign keys) هنگام وارد کردن داده‌ها.

•--ignore-lines=N

نادیده گرفتن N سطر نخست از فایل داده.

•--innodb-optimize-keys

ایجاد نمایه‌های ثانویه پس از بارگذاری داده‌ها که باعث افزایش سرعت بارگذاری می‌شود (فقط InnoDB). به طور پیش‌فرض فعال است؛ برای غیرفعال کردن از --skip-innodb-optimize-keys استفاده کنید.

•--lines-terminated-by=...

این گزینه همان معنای بند متناظر در LOAD DATA INFILE را دارد. برای نمونه، برای وارد کردن فایل‌های ویندوزی که پایان سطرهای آن‌ها با ترکیب carriage return/linefeed است، از --lines-terminated-by="\r\n" استفاده کنید. (بسته به قواعد اسکیپ مفسر خط فرمان خود ممکن است نیاز به دو برابر کردن بک‌اسلش‌ها داشته باشید).

•--local, -L

خواندن فایل‌های ورودی به صورت محلی از هاست کلاینت.

•--lock-tables, -l

قفل کردن همه جدول‌ها برای نوشتن پیش از پردازش هرگونه فایل متنی. این کار تضمین می‌کند که همه جدول‌ها روی سرور همگام هستند.

•--low-priority

استفاده از LOW_PRIORITY هنگام بارگذاری جدول. این گزینه فقط بر موتورهای ذخیره‌سازی که تنها از قفل‌گذاری در سطح جدول استفاده می‌کنند تأثیر می‌گذارد (مانند MyISAM، MEMORY، و MERGE).

•--no-defaults

عدم خواندن گزینه‌های پیش‌فرض از هیچ فایل تنظیمی. این باید به عنوان نخستین آرگومان داده شود.

•--parallel=N, -j N

تعداد وظایف LOAD DATA که به طور موازی اجرا می‌شوند. گزینه --use-threads مترادف این گزینه است.

•--password[=password], -p[password]

رمز عبور برای اتصال به سرور. در صورت استفاده از فرم کوتاه گزینه (-p)، نمی‌توانید بین گزینه و رمز عبور فاصله قرار دهید. اگر مقدار password را پس از گزینه --password یا -p در خط فرمان حذف کنید، mariadb-import آن را از شما درخواست می‌کند.

مشخص کردن رمز عبور در خط فرمان باید ناامن تلقی شود. می‌توانید از یک فایل تنظیمات برای جلوگیری از وارد کردن رمز عبور در خط فرمان استفاده کنید.

•--pipe, -W

در ویندوز، اتصال به سرور از طریق named pipe. این گزینه فقط در صورتی کاربرد دارد که سرور از اتصالات named-pipe پشتیبانی کند.

•--plugin-dir=name


دایرکتوری پلاگین‌های سمت کلاینت.

•--port=port_num, -P port_num

شماره پورت TCP/IP برای برقراری اتصال. هنگامی که بدون سایر ویژگی‌های اتصال در خط فرمان مشخص شود، --protocol=tcp را اجبار می‌کند.

•--protocol={TCP|SOCKET|PIPE|MEMORY}

پروتکل اتصال مورد استفاده برای اتصال به سرور. زمانی کاربرد دارد که سایر پارامترهای اتصال به طور معمول باعث استفاده از پروتکلی غیر از پروتکل مورد نظر شما شوند.

•--print-defaults

چاپ فهرست آرگومان‌های برنامه و خروج. این باید به عنوان نخستین آرگومان داده شود.

•--replace, -r

گزینه‌های --replace و --ignore نحوه مدیریت سطرهای ورودی را که روی مقادیر کلید یکتا (unique key) با سطرهای موجود تکراری هستند کنترل می‌کنند. اگر --replace را مشخص کنید، سطرهای جدید جایگزین سطرهای موجود با مقدار کلید یکتای مشابه می‌شوند. اگر --ignore را مشخص کنید، سطرهای ورودی که روی یک مقدار کلید یکتا با سطر موجود تکراری هستند نادیده گرفته می‌شوند. اگر هیچ‌یک از این دو گزینه را مشخص نکنید، هنگام یافتن مقدار کلید تکراری خطا رخ داده و بقیه فایل متنی نادیده گرفته می‌شود.

•--silent, -s

حالت بی‌صدا. تولید خروجی تنها هنگام بروز خطا.

•--socket=path, -S path

برای اتصال به localhost، فایل سوکت یونیکس مورد استفاده، یا در ویندوز، نام named pipe مورد استفاده. در صورت مشخص شدن در خط فرمان بدون سایر خصوصیات اتصال، --protocol=socket را اجبار می‌کند؛ در ویندوز، --protocol=pipe را اجبار می‌کند.

•--ssl

فعال‌سازی SSL برای اتصال (با سایر گزینه‌ها به طور خودکار فعال می‌شود). غیرفعال‌سازی با --skip-ssl.

•--ssl-ca=name

فایل CA در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-capath=name

دایرکتوری CA (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-cert=name

گواهی X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-cipher=name

رمزنگار SSL مورد استفاده (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-key=name

کلید X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-crl=name

فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-crlpath=name

مسیر فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-verify-server-cert

اعتبارسنجی «نام متداول» (Common Name) سرور در گواهی آن در برابر نام هاست استفاده‌شده هنگام اتصال. این گزینه به طور پیش‌فرض غیرفعال است.

•--user=user_name, -u user_name

نام کاربری MariaDB برای استفاده هنگام اتصال به سرور.

•--use-threads=N

بارگذاری فایل‌ها به صورت موازی با استفاده از N نخ (thread). مترادف -j و --parallel=num.

•--verbose, -v

حالت پرگو (verbose). چاپ اطلاعات بیشتر درباره عملکرد برنامه.

•--version, -V

نمایش اطلاعات نسخه و خروج.

در اینجا یک نشست نمونه آورده شده است که نحوه استفاده از mariadb-import را نشان می‌دهد:

shell> mariadb -e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test
shell> ed
a
100     Max Sydow
101     Count Dracula
.
w imptest.txt
32
q
shell> od -c imptest.txt
0000000   1   0   0  \t   M   a   x       S   y   d   o   w  \n   1   0
0000020   1  \t   C   o   u   n   t       D   r   a   c   u   l   a  \n
0000040
shell> mariadb-import --local test imptest.txt
test.imptest: Records: 2  Deleted: 0  Skipped: 0  Warnings: 0
shell> mariadb -e 'SELECT * FROM imptest' test
+------+---------------+
| id   | n             |
+------+---------------+
|  100 | Max Sydow     |
|  101 | Count Dracula |
+------+---------------+

Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2025 MariaDB Foundation

این مستندات یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) نسخه ۲ منتشر شده توسط بنیاد نرم‌افزار آزاد، بازتوزیع کرده و/یا تغییر دهید.

این مستندات با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید همراه با برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به نشانی Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA نامه بنویسید یا به پیوند http://www.gnu.org/licenses مراجعه کنید.

برای کسب اطلاعات بیشتر، لطفاً به مستندات MariaDB مراجعه کنید که به صورت برخط در نشانی https://mariadb.com/docs در دسترس است.

بنیاد MariaDB (http://www.mariadb.org).

10 February 2025 MariaDB 11.8