نام (NAME)

fisql — پوسته تعاملی SQL

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

fisql [-eFgpnvXY] [-a display_charset] [-A packet_size] [-c cmdend] [-D database] [-E editor] [-h headers] [-H hostname] [-i inputfile] [-I interfaces_file] [-J client_charset] [-l login_timeout] [-m errorlevel] [-o outputfile] [-P password] [-s colseparator] [-S server] [-t timeout] [-U username] [-w width] [-y sybase_dir] [-z language]

توضیحات (DESCRIPTION)

fisql بسیار شبیه به برنامه‌های کاربردی ‘isql’ توزیع‌شده توسط Sybase و Microsoft است. همانند آن‌ها، fisql از دستور ‘go’ در یک سطر مجزا به عنوان جداکننده بین دسته‌ها (batches) استفاده می‌کند.

گزینه‌ها (OPTIONS)

-a display_charset

نام مجموعه نویسه‌های (charset) کلاینت. پیاده‌سازی نشده است.

-A packet_size

تنظیم اندازه بسته (packet size) پروتکل. نیازی به تنظیم این پارامتر نخواهید داشت.

-c cmdend

پایان‌دهنده دستور، با مقدار پیش‌فرض ‘go’.

-D

نام پایگاه داده روی سرور برای استفاده.

-e

پژواک ورودی SQL (معمولاً در outputfile).

-E editor

تعیین یک ویرایشگر برای فراخوانی. پیش‌فرض vi است.

-F

روشن کردن حالت FIPS. سرور هنگام مواجهه با یک دستور غیر استاندارد SQL پیامی بازمی‌گرداند (اما در هر صورت پرس‌وجو را پردازش می‌کند).

-g

نمایش یک پیام راهنمای کوتاه.

-h headers

تعداد سطرهایی که پس از آن‌ها سرستون‌ها تکرار می‌شوند. پیش‌فرض یک‌بار به ازای هر مجموعه نتیجه (resultset) است.

-H hostname

نام میزبان (hostname) ماشین کلاینت، آن‌گونه که به سرور اعلام می‌شود.

-I interfaces_file

نام فایل interfaces یا freetds.conf برای استفاده.

-i inputfile

نام فایل اسکریپت حاوی SQL.

-J client_charset

پیاده‌سازی نشده است.

-l login_timeout

مدت زمان انتظار برای تأیید تلاش ورود توسط سرور.

-m errorlevel

برای خطاهایی با سطح شدت (severity level) مشخص‌شده یا بالاتر، فقط شماره پیام، وضعیت و سطح خطا را چاپ می‌کند. برای سطوح پایین‌تر، چیزی چاپ نمی‌شود.

-n

حذف شماره خطوط در خروجی پژواک داده‌شده.

-o outputfile

نام فایل خروجی، برای نگهداری داده‌های نتیجه.

-p

چاپ آمار عملکرد. پیاده‌سازی نشده است.

-P password

گذرواژه سرور پایگاه داده.

-s colseparator

جداکننده ستون‌ها. پیش‌فرض فاصله (space) است. نویسه‌های ویژه پوسته (metacharacters) نیازمند قرارگیری در نقل‌قول هستند.

-S server

سرور پایگاه داده برای اتصال.

-t timeout

مهلت زمانی پرس‌وجو به ثانیه. مدت زمان انتظار برای پردازش یک پرس‌وجو. پیش‌فرض نامحدود است، یا آنچه توسط freetds.conf تعیین شده باشد.

-U username

نام کاربری برای ورود به سرور پایگاه داده.

-v

نمایش نسخه و کپی‌رایت.

-w width

عرض چاپ خروجی بر حسب تعداد نویسه‌ها. پیش‌فرض 80 است.

-X

استفاده از ورود رمزگذاری‌شده. در FreeTDS پیاده‌سازی نشده است.

-y sybase_dir

متغیر محیطی SYBASE را تنظیم می‌کند. توسط FreeTDS استفاده نمی‌شود.

-Y

استفاده از تراکنش‌های زنجیره‌ای (chained transactions).

-z language

نام زبان برای اعلان‌ها و پیام‌های fisql. ببینید: DBSETLNATLANG.

نکات (NOTES)

fisql یک فیلتر است؛ از ورودی استاندارد می‌خواند، در خروجی استاندارد می‌نویسد، و خطاها را در خطای استاندارد می‌نویسد. گزینه‌های -i، -oو -e این مقادیر پیش‌فرض را لغو می‌کنند.

fisql از API کتابخانه DB-Library ارائه‌شده توسط FreeTDS استفاده می‌کند. این ابزار ابتدا با استفاده از کتابخانه خود Sybase پیاده‌سازی شده بود و همچنان با آن کار می‌کند. قبل (و بعد) از اعمال تغییر در آن، بهتر است آن را با کتابخانه Sybase آزمایش کنید تا از سازگاری میان آن و FreeTDS اطمینان حاصل شود. وضعیت خروج (EXIT STATUS)

fisql در صورت موفقیت با 0، و اگر سرور نتواند پرس‌وجو را پردازش کند با مقدار >0 خارج می‌شود.

fisql هرگونه خطای بازگردانده‌شده از سوی سرور را گزارش خواهد کرد، اما پردازش را ادامه می‌دهد. در یک محیط عملیاتی، این رفتار ممکن است به اندازه کافی سخت‌گیرانه نباشد. برای اینکه آن را به شدت نسبت به خطاها حساس کنید، گرداننده‌های پیام و خطا (handlers) را طوری تغییر دهید که exit(3) را فراخوانی کنند.

تاریخچه (HISTORY)

fisql نخستین بار در FreeTDS 0.65 ظاهر شد.

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

ابزار fisql توسط Nicholas S. Castellano ⟨entropy@freetds.org⟩, نوشته شده است، که آن را تحت شرایط مجوز GPL به پروژه FreeTDS اهدا کرد.

گزارش باگ‌ها (BUGS)

به کتابخانه GNU readline نیاز دارد.