نام (NAME)

sqlcipher - رابط خط فرمان برای SQLCipher نسخه ۳

خلاصه دستور (SYNOPSIS)

sqlcipher [options] [databasefile] [SQL]

خلاصه (SUMMARY)

برنامه sqlcipher یک واسط مبتنی بر ترمینال برای کتابخانه SQLCipher است که می‌تواند پرس‌وجوها را به‌صورت تعاملی ارزیابی کرده و نتایج را در چندین قالب نمایش دهد. از sqlcipher همچنین می‌توان درون اسکریپت‌های شل و سایر برنامه‌ها برای بهره‌مندی از ویژگی‌های پردازش دسته‌ای (batch processing) استفاده کرد.

توضیحات (DESCRIPTION)

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

برای نمونه، برای ایجاد یک فایل پایگاه‌داده جدید به نام «mydata.db»، ساخت یک جدول به نام «memos» و درج دو رکورد درون آن جدول:

$ sqlcipher mydata.db
SQLCipher version 3.43.0 2023-08-11 17:45:23
Enter ".help" for usage hints.
sqlite> create table memos(text, priority INTEGER);
sqlite> insert into memos values('deliver project description', 10);
sqlite> insert into memos values('lunch with Christine', 100);
sqlite> select * from memos;
deliver project description|10
lunch with Christine|100
sqlite>

چنانچه نام پایگاه‌داده‌ای ارائه نشود، می‌توان از دستور SQL با نام ATTACH برای اتصال به پایگاه‌های داده موجود یا ساخت فایل‌های پایگاه‌داده جدید استفاده کرد. همچنین می‌توان از ATTACH برای اتصال به چندین پایگاه‌داده در یک نشست تعاملی واحد بهره برد. این قابلیت برای مهاجرت داده‌ها بین پایگاه‌های داده و احتمالاً تغییر طرح‌واره (schema) در طول مسیر مفید است.

به صورت اختیاری، می‌توان یک دستور SQL یا مجموعه‌ای از دستورهای SQL را به عنوان یک آرگومان مشخص کرد. دستورهای چندگانه باید با نقطه-ویرگول (semi-colon) از یکدیگر جدا شوند.

برای نمونه:

$ sqlcipher -line mydata.db 'select * from memos where priority > 20;'
text = lunch with Christine
priority = 100

ابردستورهای SQLITE (SQLITE META-COMMANDS)

مفسر تعاملی مجموعه‌ای از ابردستورها را ارائه می‌دهد که می‌توان از آن‌ها برای کنترل قالب خروجی، بررسی فایل‌های پایگاه‌داده متصل‌شده کنونی، یا انجام عملیات مدیریتی روی پایگاه‌های داده متصل (مانند بازسازی نمایه‌ها) استفاده کرد. ابردستورها همیشه با یک نقطه (.) آغاز می‌شوند.

فهرست ابردستورهای موجود را می‌توان در هر زمان با اجرای دستور '.help' مشاهده کرد. برای نمونه:

sqlite> .help

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

فایل راه‌اندازی (INIT FILE)

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

o پیکربندی پیش‌فرض به صورت زیر برقرار می‌شود:

mode            = LIST
separator       = "|"
main prompt     = "sqlite> "
continue prompt = "   ...> "

o اگر فایل ${XDG_CONFIG_HOME}/sqlcipher/sqliterc یا ~/.sqliterc وجود داشته باشد، نخستین فایلی که پیدا شود در حین راه‌اندازی پردازش می‌گردد. این فایل معمولاً باید تنها شامل ابردستورها باشد.

o در صورت وجود گزینهٔ -init، فایل مشخص‌شده پردازش می‌شود.

o تمام گزینه‌های دیگر خط فرمان پردازش می‌شوند.

همچنین ببینید (SEE ALSO)

https://zetetic.net/sqlcipher

بسته sqlcipher-doc.

نویسندگان (AUTHORS)

این صفحه راهنما در ابتدا توسط Andreas Rottmann <rotty@debian.org> برای سیستم گنو/لینوکس دبیان نوشته شد (اما می‌تواند توسط دیگران نیز استفاده شود). سپس توسط Bill Bumgarner <bbum@mac.com>، Laszlo Boszormenyi <gcs@debian.hu> و توسعه‌دهندگان sqlcipher بازبینی شد.