نام (NAME)

bsqldb — پردازشگر دسته‌ای اسکریپت SQL با استفاده از DB-Library

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

bsqldb [-hqv] [-S servername] [-D database] [-U username] [-P password] [-i input_file] [-o output_file] [-e error_file] [-H hostname] [-t field_term] [-R pivot_description]

توضیحات (DESCRIPTION)

bsqldb یک برنامه کمکی است که به همراه FreeTDS عرضه می‌شود. bsqldb معادل غیرتعاملی برنامه‌های کمکی «isql» است که توسط Sybase و Microsoft منتشر شده‌اند. مانند آن‌ها، bsqldb از دستور «go» در یک خط مجزا به عنوان جداکننده بین دسته‌ها (batchها) استفاده می‌کند. نیازی نیست که پس از آخرین دسته، دستور «go» قرار گیرد. bsqldb از رابط برنامه‌نویسی DB-Library ارائه‌شده توسط FreeTDS بهره می‌برد. این API بدون شک برای توسعه‌دهندگان برنامه‌های کاربردی نیز در دسترس است.

گزینه‌ها (OPTIONS)

-D database

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

-H hostname

نام کلاینت (hostname) ارسالی به سرور را بازنویسی می‌کند.

-P password

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

-S servername

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

-U username

نام کاربری ورود به سرور پایگاه داده. اگر نام کاربری ارائه نشود، برای اتصالات TDS 7+ تلاش می‌شود تا از ورود مبتنی بر دامنه (domain login) استفاده شود.

-e error_file

نام فایل برای ثبت خطاها.

-h

چاپ سرستون‌ها به همراه داده‌ها در همان فایل.

-i input_file

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

-o output_file

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

-q

متاداده‌های ستون، وضعیت بازگشتی یا تعداد ردیف‌ها چاپ نشود. این گزینه -h را بی‌اثر می‌کند.

-t field_term

جداکننده فیلد را مشخص می‌کند. مقدار پیش‌فرض دو فاصله (' ') است. دنباله‌های گریز شناخته‌شده عبارتند از تب ('\t')، بازگشت به ابتدای سطر ('\r')، خط جدید ('\n') و بک‌اسلش ('\\').

-v

حالت پرگو (verbose)، برای ارائه اطلاعات بیشتر درباره تعاملات DB-Library. این حالت همچنین فراداده‌های مجموعه نتایج، از جمله کدهای بازگشتی را گزارش می‌دهد. تمام داده‌های این حالت در خطای استاندارد (یا -e) نوشته می‌شوند تا تداخلی با جریان داده‌ها نداشته باشند.

-R pivot_description

مشخص کردن تبدیل پیوت (pivot transformation). قالب آن به صورت ⟨down columns⟩ ⟨across columns⟩ ⟨function⟩ ⟨value⟩ است. ستون‌ها با شماره مشخص می‌شوند. قالب down columns و across columns فهرستی از ستون‌ها است که با کاما از یکدیگر جدا شده‌اند. مقدار function یکی از موارد count ،sum ،min یا max است.

محیط (ENVIRONMENT)

DSQUERY مقدار پیش‌فرض servername

نکات (NOTES)

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

کد منبع bsqldb به عنوان الگویی برای کاربران DB-Library طراحی شده است. DB-Library مجموعه غنی و کاملی از توابع دارد و گاهی ممکن است درک نحوه استفاده از آن‌ها، به‌ویژه در دفعات اول، دشوار باشد. اگر نکته‌ای در کد منبع برای شما مبهم است، تشویق می‌شوید که نظرات خود را از طریق ایمیل برای نویسنده ارسال کنید.

وضعیت خروج (EXIT STATUS)

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

برای پیام‌هایی با سطح اهمیت (severity) بیشتر از 10، bsqldb تابع exit(3) را با همان سطح اهمیت فراخوانی می‌کند. برای نمونه، اگر سطح اهمیت 16 باشد، bsqldb کد وضعیت خروج 16 را به شل برمی‌گرداند.

تاریخچه (HISTORY)

bsqldb نخستین بار در FreeTDS 0.63 ارائه شد.

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

ابزار bsqldb توسط James K. Lowden ⟨jklowden@freetds.org⟩ نوشته شده است.

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

سرورهای مایکروسافت از SQL Server 7.0 SP 3 به بعد، پارامترهای خروجی (output parameters) را برنمی‌گردانند مگر آنکه از توابع RPC استفاده شود. این بدان معناست که bsqldb نمی‌تواند پارامترهای خروجی را برای روال‌های ذخیره‌شده (stored procedures) در این سرورها برگرداند.