.TH "SQLITE3" "1" "مه ۲۰۲۵" "sqlite" "دستورات کاربر" .SH "نام (NAME)" sqlite3 \- واسط خط فرمان برای پایگاهداده رابطهای SQLite 3 .SH "خلاصه دستور (SYNOPSIS)" .B sqlite3 .RI [ گزینه‌ها ] .RI [ فایل_پایگاه‌داده ] .RI [ SQL ] .SH "چکیده (SUMMARY)" .PP .B sqlite3 یک رابط مبتنی بر ترمینال برای کتابخانه SQLite است که می‌تواند پرس‌وجوها را به صورت تعاملی ارزیابی کرده و نتایج را در چندین قالب نمایش دهد. همچنین می‌توان از .B sqlite3 درون اسکریپت‌های شل و سایر برنامه‌ها برای ارائه قابلیت‌های پردازش دسته‌ای استفاده کرد. .SH "توضیحات (DESCRIPTION)" دستور \fBsqlite3\fR یک واسط تعاملی خط فرمان برای اجرای دستورات SQL و مدیریت پایگاههای داده SQLite نگارش ۳ است. برای شروع یک نشست تعاملی .BR sqlite3 ، دستور .B sqlite3 را اجرا کرده و به دلخواه نام یک فایل پایگاه‌داده را وارد کنید. اگر فایل پایگاه‌داده وجود نداشته باشد، ایجاد خواهد شد. اگر فایل پایگاه‌داده موجود باشد، باز می‌شود. به عنوان مثال، برای ایجاد یک فایل پایگاه‌داده جدید به نام "mydata.db"، ایجاد جدولی به نام "memos" و درج چند رکورد درون آن جدول: .sp $ .B sqlite3 mydata.db .br SQLite version 3.8.8 .br Enter ".help" for instructions .br sqlite> .B create table memos(text, priority INTEGER); .br sqlite> .B insert into memos values('deliver project description', 10); .br sqlite> .B insert into memos values('lunch with Christine', 100); .br sqlite> .B select * from memos; .br deliver project description|10 .br lunch with Christine|100 .br sqlite> .sp اگر نام پایگاه‌داده‌ای مشخص نشود، می‌توان از دستور SQL با عنوان ATTACH برای پیوستن به پایگاه‌های داده موجود یا ایجاد فایل‌های پایگاه‌داده جدید استفاده کرد. همچنین از ATTACH می‌توان برای پیوستن به چندین پایگاه‌داده در یک نشست تعاملی واحد استفاده نمود. این کار برای انتقال داده‌ها میان پایگاه‌های داده و احتمالاً تغییر طرحواره (اسکیما) در این مسیر مفید است. به صورت اختیاری، یک دستور SQL یا مجموعه‌ای از دستورات SQL می‌توانند به عنوان یک تک آرگومان ارسال شوند. دستورات چندگانه باید با نقطه-ویرگول (;) از هم جدا شوند. برای مثال: .sp $ .B sqlite3 -line mydata.db 'select * from memos where priority > 20;' .br text = lunch with Christine .br priority = 100 .br .sp .SS "دستورات ویژه SQLITE (SQLITE META-COMMANDS)" .PP مفسر تعاملی مجموعه‌ای از دستورات ویژه (meta-commands) را ارائه می‌دهد که می‌توان برای کنترل قالب خروجی، بررسی فایل‌های پایگاه‌داده متصل‌شده یا انجام عملیات مدیریتی روی پایگاه‌های داده پیوست‌شده (مانند بازسازی شاخص‌ها) از آن‌ها استفاده کرد. این دستورات همواره با یک نقطه (.) آغاز می‌شوند. فهرستی از دستورات ویژه موجود در هر زمان با اجرای دستور '.help' قابل مشاهده است. برای مثال: .sp sqlite> .B .help .nf .tr %. %backup ?DB? FILE پشتیبان‌گیری از DB (پیش‌فرض "main") در FILE %bail on|off توقف پس از برخورد به خطا. پیش‌فرض OFF %clone NEWDB کلون داده‌ها به NEWDB از پایگاه‌داده موجود %databases فهرست نام‌ها و فایل‌های پایگاه‌های داده پیوست‌شده %dump ?TABLE? ... تخلیه پایگاه‌داده در قالب متنی SQL در صورت مشخص شدن TABLE، فقط جدول‌های منطبق با الگوی LIKE تخلیه می‌شوند. %echo on|off روشن یا خاموش کردن پژواک دستورات %eqp on|off فعال یا غیرفعال کردن خودکار EXPLAIN QUERY PLAN %exit خروج از این برنامه %explain ?on|off? روشن یا خاموش کردن حالت خروجی مناسب برای EXPLAIN. بدون آرگومان، EXPLAIN را روشن می‌کند. %fullschema نمایش اسکیما و محتوای جدول‌های sqlite_stat %headers on|off روشن یا خاموش کردن نمایش سرآیندها %help نمایش این پیام %import FILE TABLE وارد کردن داده از FILE به TABLE %indices ?TABLE? نمایش نام‌های همه شاخص‌ها در صورت تعیین TABLE، فقط شاخص‌های جدول‌های منطبق با الگوی LIKE نمایش داده می‌شوند. %load FILE ?ENTRY? بارگذاری یک کتابخانه افزونه %log FILE|off روشن یا خاموش کردن ثبت وقایع. FILE می‌تواند stderr/stdout باشد %mode MODE ?TABLE? تنظیم حالت خروجی که در آن MODE یکی از موارد زیر است: csv مقادیر جدا شده با کاما column ستون‌های چپ‌چین (به .width مراجعه کنید) html کد جدول HTML insert دستورات درج SQL برای TABLE line یک مقدار در هر خط list مقادیر جدا شده با رشته .separator tabs مقادیر جدا شده با تب tcl عناصر فهرست TCL %nullvalue STRING استفاده از STRING به جای مقادیر NULL %once FILENAME ارسال خروجی فقط دستور SQL بعدی به FILENAME %open ?FILENAME? بستن پایگاه‌داده موجود و باز کردن مجدد FILENAME %output ?FILENAME? ارسال خروجی به FILENAME یا stdout %print STRING... چاپ مستقیم STRING %prompt MAIN CONTINUE جایگزینی اعلان‌های استاندارد ورودی %quit خروج از این برنامه %read FILENAME اجرای SQL درون FILENAME %restore ?DB? FILE بازیابی محتوای DB (پیش‌فرض "main") از FILE %save FILE نوشتن پایگاه‌داده درون‌حافظه در FILE %schema ?TABLE? نمایش دستورات CREATE در صورت تعیین TABLE، فقط جدول‌های منطبق با الگوی LIKE نمایش داده می‌شوند. %separator STRING ?NL? تغییر جداکننده مورد استفاده حالت خروجی و .import شناسه NL نشانه پایان خط برای CSV است %shell CMD ARGS... اجرای CMD ARGS... در شل سیستم %show نمایش مقادیر کنونی برای تنظیمات گوناگون %stats on|off روشن یا خاموش کردن آمار %system CMD ARGS... اجرای CMD ARGS... در شل سیستم %tables ?TABLE? فهرست کردن نام‌های جدول‌ها در صورت تعیین TABLE، فقط جدول‌های منطبق با الگوی LIKE فهرست می‌شوند. %timeout MS تلاش برای باز کردن جدول‌های قفل‌شده به مدت MS میلی‌ثانیه %timer on|off روشن یا خاموش کردن زمان‌سنج SQL %trace FILE|off نمایش هر دستور SQL هم‌زمان با اجرای آن %vfsname ?AUX? چاپ نام پشته VFS %width NUM1 NUM2 ... تنظیم عرض ستون‌ها برای حالت "column" مقادیر منفی راست‌چین می‌کنند sqlite> .sp .fi .SH "گزینه‌ها (OPTIONS)" .B sqlite3 دارای گزینه‌های زیر است: .TP .B \-bail توقف پس از برخورد با خطا. .TP .B \-batch اجبار به ورودی/خروجی دسته‌ای. .TP .B \-column نتایج پرس‌وجو در قالبی شبیه به جدول نمایش داده می‌شوند و از نویسه‌های فاصله برای جداسازی ستون‌ها و تراز کردن خروجی استفاده می‌شود. .TP .BI \-cmd\ command اجرای .I command پیش از خواندن ورودی استاندارد (stdin). .TP .B \-csv تنظیم حالت خروجی به CSV (مقادیر جدا شده با کاما). .TP .B \-echo چاپ دستورات پیش از اجرا. .TP .BI \-init\ file خواندن و اجرای دستورات از .I file که می‌تواند شامل ترکیبی از دستورات SQL و متادستورها باشد. .TP .B \-[no]header روشن یا خاموش کردن سرآیندها. .TP .B \-help نمایش راهنمای گزینه‌ها و خروج. .TP .B \-html نتایج پرس‌وجو به صورت جدول‌های ساده HTML خروجی داده می‌شوند. .TP .B \-interactive اجبار به ورودی/خروجی تعاملی. .TP .B \-line نتایج پرس‌وجو با یک مقدار در هر خط نمایش می‌یابند و سطرها با یک خط خالی از هم جدا می‌شوند. طراحی‌شده برای تجزیه آسان توسط اسکریپت‌ها یا سایر برنامه‌ها. .TP .B \-list نتایج پرس‌وجو با نویسه جداکننده (به طور پیش‌فرض |) میان هر مقدار فیلد نمایش داده می‌شوند. این حالت پیش‌فرض است. .TP .BI \-mmap\ N تنظیم اندازه پیش‌فرض mmap به .IR N . .TP .BI \-nullvalue\ string تنظیم رشته مورد استفاده برای نمایش مقادیر NULL. پیش‌فرض '' (رشته خالی) است. .TP .BI \-separator\ separator تنظیم جداکننده فیلدهای خروجی. پیش‌فرض '|' است. .TP .B \-stats چاپ آمار حافظه پیش از هر آزادسازی پایانی (finalize). .TP .B \-version نمایش نگارش SQLite. .TP .BI \-vfs\ name استفاده از .I name به عنوان سامانه فایل مجازی (VFS) پیش‌فرض. .SH "فایل پیکربندی (INIT FILE)" .B sqlite3 یک فایل راه‌اندازی را برای اعمال پیکربندی محیط تعاملی می‌خواند. در طول مقداردهی اولیه، هر تنظیم قبلی می‌تواند بازنویسی شود. توالی مقداردهی اولیه به شرح زیر است: o پیکربندی پیش‌فرض به صورت زیر برقرار می‌شود: .sp .nf .cc | mode = LIST separator = "|" main prompt = "sqlite> " continue prompt = " ...> " |cc . .sp .fi o اگر فایل .B ~/.sqliterc در دایرکتوری خانگی کاربر موجود باشد، خوانده شده و پردازش می‌شود. این فایل معمولاً فقط باید حاوی متادستورها باشد. o در صورت وجود گزینه \-init، فایل مشخص‌شده پردازش می‌شود. o تمام گزینه‌های دیگر خط فرمان پردازش می‌شوند. .SH "همچنین ببینید (SEE ALSO)" http://www.sqlite.org/cli.html .br بسته sqlite3-doc. .SH "نویسندگان (AUTHORS)" این صفحه راهنما در ابتدا توسط Andreas Rottmann برای سیستم گنو/لینوکس دبیان نوشته شد (اما ممکن است توسط دیگران نیز استفاده شود). متعاقباً توسط Bill Bumgarner بازبینی شد و بعداً توسط Laszlo Boszormenyi به‌روزرسانی گردید.