ODBC.INI(5) فایلهای پیکربندی ODBC.INI(5)

odbc.ini - پرونده پیکربندی منابع داده ODBC (DSN)

پروندههای /etc/odbc.ini و ~/.odbc.ini منابع داده (Data Source Names - DSN) و پارامترهای اتصال درایورهای ODBC را تعریف میکنند.

/etc/odbc.ini یک پرونده پیکربندی سراسری در سطح سیستم برای نام‌های منابع داده (DSN) در ODBC است.

$HOME/.odbc.ini یک پرونده پیکربندی مختص هر کاربر برای نام‌های منابع داده (DSN) در ODBC است.

مسیرهای هر دو پرونده پیکربندی می‌توانند با گزینه‌های زمان ساخت unixODBC بازنویسی شوند. برای تعیین مسیرهای پیش‌فرض پرونده‌های پیکربندی در سیستم خود، دستور odbcinst -j را اجرا کنید.

بسیاری از درایورهای ODBC به همراه قالب‌های پرونده .ini ارائه می‌شوند. استفاده از odbcinst برای نصب این قالب‌ها توصیه می‌شود.

پرونده odbc.ini از شیوه مرسوم شبه‌استاندارد پرونده‌های ini پیروی می‌کند که شامل یک یا چند [سربرگ بخش] است و در پی هر کدام صفر یا چند ویژگی به‌صورت key = value (کلید = مقدار) قرار می‌گیرد.

بخش [ODBC Data Sources]
این بخش اجباری، هر نام منبع داده (DSN) را به‌صورت یک کلید فهرست می‌کند. مقادیر متناظر با آن‌ها به عنوان توضیحات عمل می‌کنند. هر ورودی باید با یک [بخش] متناظر در پرونده ini که آن منبع داده را توصیف می‌کند همخوانی داشته باشد.
[بخش] نام منبع داده (Data Source Name)
هر منبع داده با یک [سربرگ بخش] شناسایی می‌شود که همان نام DSN مورد استفاده توسط برنامه‌ها است. هر بخش تعریف DSN می‌تواند حاوی مقادیری برای کلیدهای زیر باشد:
• Driver (اجباری)
نام درایور ODBC جهت استفاده برای این DSN. این نام باید دقیقاً با [نام بخش] تعریف درایور که در odbcinst.ini ذخیره شده (و توسط odbcinst -q -d فهرست می‌شود) مطابقت داشته باشد.
• Description
توضیحات خوانا برای انسان درباره منبع داده.
• Database
نام یا شناسه پایگاه داده. معنای آن وابسته به درایور است و می‌تواند مسیر یک پرونده، مسیر سوکت یونیکس، شناسه‌ای مرتبط با نام سرور و غیره را مشخص کند.
• Servername
نام کارساز (سرور). معنای آن وابسته به درایور است اما معمولاً یک نام DNS، آدرس شبکه IP یا شناسه اکتشاف ویژه درایور را مشخص می‌کند.
برای مشاهده فهرست کامل پارامترهای پشتیبانی‌شده، به راهنمای مدیر سیستم با قالب HTML ارائه شده با unixODBC، مستندات درایور ODBC خود و هر قالب منبع داده ارائه‌شده توسط درایور مراجعه کنید.

یک نمونه پرونده پیکربندی odbc.ini در "Administrator Manual" همراه با unixODBC نشان داده شده است.

unixODBC(7), odbcinst(1), isql(1), iusql(1), odbcinst.ini(5)

"The unixODBC Administrator Manual (HTML)"

نویسندگان unixODBC عبارتند از: Peter Harvey <pharvey@codebydesign.com> و Nick Gorham <nick@lurcher.org>.

برای مشاهده فهرست کامل مشارکت‌کنندگان، به پرونده AUTHORS مراجعه کنید.

پروژه unixODBC تحت مجوز GNU Lesser General Public License منتشر شده است. برای جزئیات مربوط به مجوز، به پرونده COPYING مراجعه فرمایید.

مه ۲۰۲۵ unixodbc