iodbctest(1) iODBC Driver Manager iodbctest(1) نام (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) حق نشر © 1996-2023 OpenLink Software نویسنده (AUTHOR) مدیر iODBC 3.52.16 3 August 2005 iodbctest(1)