نام (NAME)

iodbctest, iodbctestw - برنامه‌های نمایشی iODBC

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

iodbctest ["DSN=xxxx[;UID=xxxx][;PWD=xxxx][;OPT=value]"]
iodbctestw ["DSN=xxxx[;UID=xxxx][;PWD=xxxx][;OPT=value]"]

توضیحات (DESCRIPTION)

برنامه‌های iodbctest و iodbctestw برنامه‌های نمونه ساده ODBC هستند که قدرت ODBC API را برای اتصال به هر پایگاه‌داده مجهز به ODBC، ارسال دستورات SQL و دریافت نتایج پرس‌وجو نشان می‌دهند.

برنامه iodbctest از فراخوانی‌های استاندارد ODBC API برای اتصال با استفاده از هر DSN بهره می‌برد، اما تمام نتایج را در حالت ASCII دریافت می‌کند.

برنامه iodbctestw از فراخوانی‌های ODBC Unicode API برای اتصال با استفاده از هر DSN استفاده می‌کند و تمام نتایج را در حالت یونیکد (Unicode) دریافت می‌نماید.

گزینه‌ها (OPTIONS)

برنامه iodbctest از تابع SQLDriverConnect برای برقراری اتصال با استفاده از هر درایور سازگار با ODBC موجود استفاده می‌کند. این به کاربر اجازه می‌دهد تا هر ویژگی اتصال ODBC را در رشته DSN بازنویسی کند.

رشته‌های اتصال باید با ویژگی DSN=xxx یا DRIVER=xxxx آغاز شوند که می‌توانند به صورت اختیاری با سایر ویژگی‌های DSN که با نقطه-ویرگول جدا شده‌اند دنبال شوند؛ به عنوان مثال:

DSN=ora9;UID=scott;PWD=tiger;DATABASE=ora9u

هر ویژگی مورد نیاز برای اتصال مناسب که در رشته اتصال DSN وارد نشده باشد، باید در فایل odbc.ini وجود داشته باشد.

اگر رشته اتصال به عنوان آرگومان به برنامه iodbctest ارسال شود، رشته باید در علامت نقل‌قول قرار گیرد، زیرا اکثر پوسته‌ها از نقطه-ویرگول به عنوان جداکننده دستور استفاده می‌کنند. اگر رشته اتصال در اعلان تعاملی وارد شود، نباید از علامت نقل‌قول استفاده کرد.

پس از برقراری یک اتصال موفق، از کاربر خواسته می‌شود تا یک دستور SQL را برای ارسال به پایگاه‌داده وارد کند. یک دستور SQL نمی‌تواند چند خطی باشد.

اگر دستور SQL یک یا چند مجموعه نتیجه (result set) برگرداند، هر مجموعه با استفاده از بافرهای نویسه‌ای واکشی شده و در یک جدول نمایش داده می‌شود.

علاوه بر این، برنامه iodbctest چند دستور ویژه را درک می‌کند:

qualifiers: نمایش فهرستی از تعیین‌کننده‌ها (qualifiers) با استفاده از فراخوانی کاتالوگ SQLTables.
owners: نمایش فهرستی از مالکان با استفاده از فراخوانی کاتالوگ SQLTables.
tables: نمایش فهرستی از جدول‌ها با استفاده از فراخوانی کاتالوگ SQLTables.
types: نمایش فهرستی از انواع جدول‌ها با استفاده از فراخوانی کاتالوگ SQLTables.
datatypes: نمایش فهرستی از انواع داده‌ها با استفاده از فراخوانی کاتالوگ SQLGetTypeInfo.
reconnect: انجام قطع اتصال و اتصال مجدد با اطلاعات ذخیره‌شده در اولین فراخوانی SQLDriverConnect.
quit (یا exit): خروج از برنامه و بازگشت به پوسته.

مثال‌ها (EXAMPLES)

اجرای برنامه iodbctest و دریافت فهرستی از DSNها پیش از برقراری اتصال:

$ iodbctest
OpenLink ODBC Demonstration program
This program shows an interactive SQL processor
Enter ODBC connect string (? shows list): ?
DSN                              | Driver
-----------------------------------------------------------------
ora9                             | OpenLink Generic ODBC Driver
mysql                            | OpenLink Generic ODBC Driver
mysqllite                        | OpenLink Lite for MySQL
myodbc                           | MyODBC Driver
pgsql                            | OpenLink Generic ODBC Driver
tds                              | OpenLink Generic ODBC Driver
Enter ODBC connect string (? shows list): DSN=ora9;PWD=tiger
Driver: 05.20.0316 OpenLink Generic ODBC Driver (oplodbc.so)
SQL>

اتصال به یک نمونه Oracle 9 که قبلاً در فایل odbc.ini پیکربندی شده است:

$ iodbctest "DSN=ora9;UID=scott;PWD=tiger"
iODBC Demonstration program
This program shows an interactive SQL processor
Driver: 05.20.0316 OpenLink Generic ODBC Driver (oplodbc.so)
SQL>select * from emp
ID               |NAME
-----------------+-------------------------------------------
1                |Record 1
2                |Record 2
2                |Record 3
 result set 1 returned 3 rows.
SQL> quit

حق نشر (COPYRIGHT)

نویسنده (AUTHOR)

مدیر iODBC <iodbc@openlinksw.com>