.nh .TH iodbctest 1 "3 August 2005" "3.52.16" "iODBC Driver Manager" .SH "نام (NAME)" iodbctest, iodbctestw \- برنامه‌های نمایشی iODBC .SH "خلاصه دستور (SYNOPSIS)" .B iodbctest .RB [ \(dqDSN=xxxx[;UID=xxxx][;PWD=xxxx][;OPT=value]\(dq ] .br .B iodbctestw .RB [ \(dqDSN=xxxx[;UID=xxxx][;PWD=xxxx][;OPT=value]\(dq ] .SH "توضیحات (DESCRIPTION)" برنامه‌های \fBiodbctest\fR و \fBiodbctestw\fR برنامه‌های نمونه ساده ODBC هستند که قدرت ODBC API را برای اتصال به هر پایگاه‌داده مجهز به ODBC، ارسال دستورات SQL و دریافت نتایج پرس‌وجو نشان می‌دهند. برنامه \fBiodbctest\fR از فراخوانی‌های استاندارد ODBC API برای اتصال با استفاده از هر DSN بهره می‌برد، اما تمام نتایج را در حالت ASCII دریافت می‌کند. برنامه \fBiodbctestw\fR از فراخوانی‌های ODBC Unicode API برای اتصال با استفاده از هر DSN استفاده می‌کند و تمام نتایج را در حالت یونیکد (Unicode) دریافت می‌نماید. .SH "گزینه‌ها (OPTIONS)" برنامه \fBiodbctest\fR از تابع SQLDriverConnect برای برقراری اتصال با استفاده از هر درایور سازگار با ODBC موجود استفاده می‌کند. این به کاربر اجازه می‌دهد تا هر ویژگی اتصال ODBC را در رشته DSN بازنویسی کند. رشته‌های اتصال باید با ویژگی \fIDSN=xxx\fR یا \fIDRIVER=xxxx\fR آغاز شوند که می‌توانند به صورت اختیاری با سایر ویژگی‌های DSN که با نقطه-ویرگول جدا شده‌اند دنبال شوند؛ به عنوان مثال: .nf DSN=ora9;UID=scott;PWD=tiger;DATABASE=ora9u .fi هر ویژگی مورد نیاز برای اتصال مناسب که در رشته اتصال DSN وارد نشده باشد، باید در فایل odbc.ini وجود داشته باشد. اگر رشته اتصال به عنوان آرگومان به برنامه \fBiodbctest\fR ارسال شود، رشته باید در علامت نقل‌قول قرار گیرد، زیرا اکثر پوسته‌ها از نقطه-ویرگول به عنوان جداکننده دستور استفاده می‌کنند. اگر رشته اتصال در اعلان تعاملی وارد شود، نباید از علامت نقل‌قول استفاده کرد. پس از برقراری یک اتصال موفق، از کاربر خواسته می‌شود تا یک دستور SQL را برای ارسال به پایگاه‌داده وارد کند. یک دستور SQL نمی‌تواند چند خطی باشد. اگر دستور SQL یک یا چند مجموعه نتیجه (result set) برگرداند، هر مجموعه با استفاده از بافرهای نویسه‌ای واکشی شده و در یک جدول نمایش داده می‌شود. علاوه بر این، برنامه \fBiodbctest\fR چند دستور ویژه را درک می‌کند: .TP 8 .B qualifiers .br نمایش فهرستی از تعیین‌کننده‌ها (qualifiers) با استفاده از فراخوانی کاتالوگ SQLTables. .TP 8 .B owners .br نمایش فهرستی از مالکان با استفاده از فراخوانی کاتالوگ SQLTables. .TP 8 .B tables .br نمایش فهرستی از جدول‌ها با استفاده از فراخوانی کاتالوگ SQLTables. .TP 8 .B types .br نمایش فهرستی از انواع جدول‌ها با استفاده از فراخوانی کاتالوگ SQLTables. .TP 8 .B datatypes .br نمایش فهرستی از انواع داده‌ها با استفاده از فراخوانی کاتالوگ SQLGetTypeInfo. .TP 8 .B reconnect .br انجام قطع اتصال و اتصال مجدد با اطلاعات ذخیره‌شده در اولین فراخوانی SQLDriverConnect. .TP 8 .B quit (یا exit) .br خروج از برنامه و بازگشت به پوسته. .SH "مثال‌ها (EXAMPLES)" اجرای برنامه iodbctest و دریافت فهرستی از DSNها پیش از برقراری اتصال: .nf $ 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> .fi اتصال به یک نمونه Oracle 9 که قبلاً در فایل odbc.ini پیکربندی شده است: .nf $ 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 .fi .SH "حق نشر (COPYRIGHT)" حق نشر \(co 1996-2023 OpenLink Software .SH "نویسنده (AUTHOR)" مدیر iODBC