نام (NAME)

bsqlodbc — پردازشگر دسته‌ای اسکریپت‌های SQL با استفاده از ODBC

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

bsqlodbc [-hqv] [-U username] [-P password] [-S server] [-D database] [-i input_file] [-o output_file] [-e error_file] [-t field_term] [-V odbc_version]

توضیحات (DESCRIPTION)

bsqlodbc یک برنامه کاربردی توزیع‌شده همراه با FreeTDS است.

bsqlodbc معادل غیرتعاملی برنامه‌های ابزاری ‘isql’ توزیع‌شده توسط Sybase و Microsoft است. مانند آن‌ها، bsqlodbc از دستور ‘go’ در یک خط به تنهایی به عنوان جداکننده بین دسته‌ها (batches) استفاده می‌کند. الزامی نیست که پس از آخرین دسته حتماً ‘go’ بیاید.

bsqlodbc از API مربوط به ODBC ارائه‌شده توسط FreeTDS بهره می‌گیرد. این API طبیعتاً در دسترس توسعه‌دهندگان برنامه‌ها نیز قرار دارد.

گزینه‌ها (OPTIONS)

-U username

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

-P password

رمز عبور سرور پایگاه‌داده.

-S server

سرور پایگاه‌داده جهت اتصال به آن.

-D database

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

-i input_file

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

-o output_file

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

-e error_file

نام فایل مخصوص خطاها.

-t field_term

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

-h

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

-q

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

-v

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

-V odbc_version

مشخص کردن نسخه ODBC (2 یا 3).

نکات (NOTES)

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

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

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

تاریخچه (HISTORY)

bsqlodbc اولین بار در FreeTDS 0.65 ارائه شد.

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

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