نام (NAME)

osql — ابزاری برای آزمایش اتصالات و پرس‌وجوهای FreeTDS

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

osql -S dsn -U username -P password [-I ini_directory]

توضیحات (DESCRIPTION)

osql یک ابزار عیب‌یابی است که به عنوان بخشی از FreeTDS ارائه می‌شود. این ابزار یک اسکریپت شل Bourne است که فایل‌های پیکربندی شما را بررسی کرده و درباره آن‌ها گزارش می‌دهد. اگر همه موارد درست باشند، دستور isql را فراخوانی می‌کند.

osql تنها با نسخه‌ای از isql کار می‌کند که همراه با unixODBC ارائه می‌شود.

گزینه‌ها (OPTIONS)

-S dsn

نام منبع داده (DSN) برای اتصال، همان‌طور که برای odbc.ini شناخته شده است.

-U username

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

-P password

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

-I ini_dir

تعیین دستی مکان فایل odbc.ini.

مثال‌ها (EXAMPLES)

اگر فایلی به نام odbc.ini با بخشی مشابه این دارید:

[myDSN]
servername = myserver
TDS_Version = 5.0

می‌توانید osql را به این صورت فراخوانی کنید:

osql -S myDSN [...]

فایل‌ها (FILES)

odbc.ini freetds.conf

نکات (NOTES)

اگر بتوانید با ‘osql -S servername -U user -P passwd’متصل شوید، یعنی نصب FreeTDS ODBC شما به درستی کار می‌کند.

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

اگر osql نتواند دایرکتوری odbc.ini شما را تشخیص دهد، می‌توانید با استفاده از گزینهٔ -I مسیر را اجبار کنید. با این حال، در این حالت شما به osql می‌گویید چه چیزی را آزمایش کند، نه این که unixODBC در نهایت کجا را جستجو خواهد کرد. بنابراین بازنویسی دستی شما تنها به همان اندازه‌ای مطمئن است که خودتان اطمینان دارید. پیش از اعمال تغییر دستی، خروجی خطا را با دقت بررسی کنید.

اگر پیشنهادهایی دارید تا osql را به ابزار عیب‌یابی مفیدتری تبدیل کند، لطفاً آن‌ها را به فهرست ایمیل FreeTDS ارسال فرمایید.

تاریخچه (HISTORY)

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

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

ابزار osql توسط James K. Lowdenنوشته شده است.