نام (NAME)

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

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

tsql {-S servername [-I interface] | -H hostname [-L] [-p port]} [-D dbname] [-U username] [-P password] [-o options] tsql -C

توضیحات (DESCRIPTION)

tsql یک ابزار عیب‌یابی FreeTDS است. این ابزار از پروتکل TDS برای اتصال به Sybase یا Microsoft SQL Server استفاده می‌کند و به کاربر اجازه می‌دهد پرس‌وجوها را اجرا نماید. tsql از کتابخانه‌های کلاینت FreeTDS استفاده نمی‌کند؛ بلکه در عوض، تنها از پایین‌ترین سطح کتابخانه، یعنی libtds، برای آزمایش پیاده‌سازی پروتکل بهره می‌برد.

tsql می‌تواند به دو روش اجرا شود: روشی که از freetds.conf استفاده می‌کند و روشی که مستقیماً با استفاده از hostname و port سرور متصل می‌شود. پارامترهای -H و -p برای این منظور ارائه شده‌اند که کاربر بتواند بررسی کند آیا سرور روی میزبان و درگاه نام‌برده در حال شنود است یا خیر. این پارامترها بر تمام فایل‌های پیکربندی و متغیرهای محیطی اولویت دارند. از پارامتر -S می‌توان برای آزمایش پیکربندی محلی استفاده کرد. FreeTDS از freetds.conf (یا معادل آن) و متغیرهای محیطی به روش معمول برای تعیین آدرس IP و پورت سرور استفاده خواهد کرد. می‌توانید از -I برای مشخص کردن نام فایل استفاده کنید که الگوریتم جستجوی فایل پیکربندی FreeTDS را نادیده می‌گیرد.

گزینه‌ها (OPTIONS)

-S servername

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

-D dbname

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

-I interface

فایل freetds.conf یا interfaces که servername را توصیف می‌کند.

-H hostname

نام میزبان DNS سرور.

-p port

درگاهی که SQL Server روی آن شنود می‌کند.

-U username

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

-P password

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

-L

فهرست کردن نمونه‌های سرور مایکروسافت (همراه با -H).

-C

چاپ برخی از پارامترهای پیکربندی زمان کامپایل.

-o options

اعمال گزینه‌های مشخص‌شده روی هر دستور.

-f

بدون پاورقی [تعداد نتایج]

-h

بدون سرآیند [عناوین]

-t

چاپ زمان

-v

چاپ نسخه

-q

حالت بی‌صدا

-a appname

نام برنامه.

-t colterm

پایان‌دهنده ستون.

-r rowterm

پایان‌دهنده سطر.

-r rowterm

پایان‌دهنده سطر.

-J charset

مجموعه نویسه‌ها.

-v

حالت پرگو (verbose).

نکات (NOTES)

اگر بتوانید با ‘tsql -S servername’ متصل شوید، پیکربندی پایه FreeTDS شما کار می‌کند.

تایپ کردن ‘exit،’ ‘quit،’ یا ‘bye’ (یا ^D) از tsql خارج می‌شود.

تایپ کردن ‘version’ نسخه پروتکل TDS را نمایش می‌دهد.

دسته‌های دستورات را می‌توان با ‘go’ یا ‘GO’ از یکدیگر جدا کرد. در صورت استفاده از ‘GO،’ رشته نسخه پیش از اجرای دسته گزارش داده می‌شود.

پس از درخواست گذرواژه (اگر با -P ارائه نشده باشد)، tsql تلاش خواهد کرد به سرور راه دور متصل شود. tsql شمارنده‌ای را نشان می‌دهد که تعداد ثانیه‌های سپری‌شده در طول تلاش برای برقراری اتصال را نمایش می‌دهد. معمولاً، tsql بلافاصله با اعلان ‘1>’ پاسخ می‌دهد. اگر شمارنده (1، 2، 3، ...) را مشاهده کردید، به احتمال زیاد tsql قادر به اتصال به سرور مشخص‌شده نیست.

tsql جایگزینی برای یک isql کامل مانند sqsh (www.sqsh.org) نیست. اگر پیشنهادهایی برای کاربردی‌تر کردن tsql به عنوان یک ابزار عیب‌یابی دارید، لطفاً آن‌ها را برای بررسی به فهرست پستی FreeTDS ارسال کنید.

تاریخچه (HISTORY)

tsql نخستین بار در FreeTDS 0.60 ظاهر شد.

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

ابزار tsql توسط Brian Bruns نوشته شده است.

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

مسلماً چندین مورد، حال که مستند شده است. :)