| MARIADB-IMPORT(1) | MariaDB Database System | MARIADB-IMPORT(1) |
نام (NAME)
mariadb-import - ابزار وارد کردن دادهها از فایلهای متنی به پایگاه داده
خلاصه دستور (SYNOPSIS)
mariadb-import [options] db_name textfile1 ...
توضیحات (DESCRIPTION)
کلاینت 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 همچنین از گزینههای پردازش فایلهای تنظیمات پشتیبانی میکند.
نمایش پیام راهنما و خروج.
دایرکتوری محل نصب مجموعههای نویسه (character sets).
این گزینه فهرستی از نامهای ستونها را که با کاما از هم جدا شدهاند به عنوان مقدار میپذیرد. ترتیب نام ستونها نحوه تطبیق ستونهای فایل داده با ستونهای جدول را مشخص میکند.
فشردهسازی تمام اطلاعات ارسالی میان کلاینت و سرور در صورتی که هر دو از فشردهسازی پشتیبانی کنند.
نوشتن گزارش اشکالزدایی (debug log). یک رشته معمول برای debug_options عبارت است از 'd:t:o,file_name'. مقدار پیشفرض 'd:t:o' است.
چاپ برخی اطلاعات اشکالزدایی هنگام خروج برنامه.
چاپ اطلاعات اشکالزدایی و آمارهای مصرف حافظه و پردازنده هنگام خروج برنامه.
پلاگین احراز هویت پیشفرض سمت کلاینت برای استفاده.
استفاده از charset_name به عنوان مجموعه نویسه پیشفرض.
تنظیم filename به عنوان فایلی برای خواندن گزینههای پیشفرض پس از خوانده شدن فایلهای پیشفرض سراسری. باید به عنوان نخستین گزینه داده شود.
تنظیم filename به عنوان فایل خواندن گزینههای پیشفرض، که جایگزین فایلهای پیشفرض سراسری میشود. باید به عنوان نخستین گزینه داده شود.
خالی کردن جدول پیش از وارد کردن دادههای فایل متنی.
این گزینهها همان معنای بندهای متناظر در LOAD DATA INFILE را دارند.
نادیده گرفتن خطاها. برای نمونه، اگر جدولی برای یک فایل متنی وجود نداشته باشد، پردازش سایر فایلهای باقیمانده ادامه مییابد. بدون گزینه --force، در صورت عدم وجود جدول، mariadb-import متوقف و خارج میشود.
وارد کردن دادهها به سرور MariaDB روی هاست دادهشده. هاست پیشفرض localhost است.
توضیحات مربوط به گزینه --replace را مشاهده کنید.
غیرفعال کردن بررسی کلیدهای خارجی (foreign keys) هنگام وارد کردن دادهها.
نادیده گرفتن N سطر نخست از فایل داده.
ایجاد نمایههای ثانویه پس از بارگذاری دادهها که باعث افزایش سرعت بارگذاری میشود (فقط InnoDB). به طور پیشفرض فعال است؛ برای غیرفعال کردن از --skip-innodb-optimize-keys استفاده کنید.
این گزینه همان معنای بند متناظر در LOAD DATA INFILE را دارد. برای نمونه، برای وارد کردن فایلهای ویندوزی که پایان سطرهای آنها با ترکیب carriage return/linefeed است، از --lines-terminated-by="\r\n" استفاده کنید. (بسته به قواعد اسکیپ مفسر خط فرمان خود ممکن است نیاز به دو برابر کردن بکاسلشها داشته باشید).
خواندن فایلهای ورودی به صورت محلی از هاست کلاینت.
قفل کردن همه جدولها برای نوشتن پیش از پردازش هرگونه فایل متنی. این کار تضمین میکند که همه جدولها روی سرور همگام هستند.
استفاده از LOW_PRIORITY هنگام بارگذاری جدول. این گزینه فقط بر موتورهای ذخیرهسازی که تنها از قفلگذاری در سطح جدول استفاده میکنند تأثیر میگذارد (مانند MyISAM، MEMORY، و MERGE).
عدم خواندن گزینههای پیشفرض از هیچ فایل تنظیمی. این باید به عنوان نخستین آرگومان داده شود.
تعداد وظایف LOAD DATA که به طور موازی اجرا میشوند. گزینه --use-threads مترادف این گزینه است.
رمز عبور برای اتصال به سرور. در صورت استفاده از فرم کوتاه گزینه (-p)، نمیتوانید بین گزینه و رمز عبور فاصله قرار دهید. اگر مقدار password را پس از گزینه --password یا -p در خط فرمان حذف کنید، mariadb-import آن را از شما درخواست میکند.
مشخص کردن رمز عبور در خط فرمان باید ناامن تلقی شود. میتوانید از یک فایل تنظیمات برای جلوگیری از وارد کردن رمز عبور در خط فرمان استفاده کنید.
در ویندوز، اتصال به سرور از طریق named pipe. این گزینه فقط در صورتی کاربرد دارد که سرور از اتصالات named-pipe پشتیبانی کند.
دایرکتوری
پلاگینهای
سمت
کلاینت.
شماره پورت TCP/IP برای برقراری اتصال. هنگامی که بدون سایر ویژگیهای اتصال در خط فرمان مشخص شود، --protocol=tcp را اجبار میکند.
پروتکل اتصال مورد استفاده برای اتصال به سرور. زمانی کاربرد دارد که سایر پارامترهای اتصال به طور معمول باعث استفاده از پروتکلی غیر از پروتکل مورد نظر شما شوند.
چاپ فهرست آرگومانهای برنامه و خروج. این باید به عنوان نخستین آرگومان داده شود.
گزینههای --replace و --ignore نحوه مدیریت سطرهای ورودی را که روی مقادیر کلید یکتا (unique key) با سطرهای موجود تکراری هستند کنترل میکنند. اگر --replace را مشخص کنید، سطرهای جدید جایگزین سطرهای موجود با مقدار کلید یکتای مشابه میشوند. اگر --ignore را مشخص کنید، سطرهای ورودی که روی یک مقدار کلید یکتا با سطر موجود تکراری هستند نادیده گرفته میشوند. اگر هیچیک از این دو گزینه را مشخص نکنید، هنگام یافتن مقدار کلید تکراری خطا رخ داده و بقیه فایل متنی نادیده گرفته میشود.
حالت بیصدا. تولید خروجی تنها هنگام بروز خطا.
برای اتصال به localhost، فایل سوکت یونیکس مورد استفاده، یا در ویندوز، نام named pipe مورد استفاده. در صورت مشخص شدن در خط فرمان بدون سایر خصوصیات اتصال، --protocol=socket را اجبار میکند؛ در ویندوز، --protocol=pipe را اجبار میکند.
فعالسازی SSL برای اتصال (با سایر گزینهها به طور خودکار فعال میشود). غیرفعالسازی با --skip-ssl.
فایل CA در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
دایرکتوری CA (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
گواهی X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
رمزنگار SSL مورد استفاده (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
کلید X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
مسیر فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).
اعتبارسنجی «نام متداول» (Common Name) سرور در گواهی آن در برابر نام هاست استفادهشده هنگام اتصال. این گزینه به طور پیشفرض غیرفعال است.
نام کاربری MariaDB برای استفاده هنگام اتصال به سرور.
بارگذاری فایلها به صورت موازی با استفاده از N نخ (thread). مترادف -j و --parallel=num.
حالت پرگو (verbose). چاپ اطلاعات بیشتر درباره عملکرد برنامه.
نمایش اطلاعات نسخه و خروج.
در اینجا یک نشست نمونه آورده شده است که نحوه استفاده از 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)
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 مراجعه کنید.
همچنین ببینید (SEE ALSO)
برای کسب اطلاعات بیشتر، لطفاً به مستندات MariaDB مراجعه کنید که به صورت برخط در نشانی https://mariadb.com/docs در دسترس است.
نویسنده (AUTHOR)
بنیاد MariaDB (http://www.mariadb.org).
| 10 February 2025 | MariaDB 11.8 |