مصدر البيانات تكوين مصدر بيانات ODBC برمجياً

يشرح هذا الموضوع كيف يمكنك تكوين أسماء مصادر بيانات اتصال قواعد البيانات المفتوحة (ODBC) برمجياً. يمنحك هذا مرونةً للوصول إلى البيانات أن تفرض على المستخدم استخدام مسؤول ODBC بشكل صريح أو برامج أخرى لتعيين أسماء مصادر البيانات.

بشكل عام، يقوم المستخدم بتشغيل مسؤول ODBC لإنشاء مصدر بيانات إذا كان نظام إدارة قاعدة البيانات المقترنة (DBMS) يدعم هذه العملية.

عند إنشاء مصدر بيانات Microsoft Access ODBC خلال مسؤول ODBC يتم تخييرك بين أمرين: يمكنك تحديد ملف .mdb الموجود أو يمكنك إنشاء ملف .mdb جديد . توجد طريقة برمجية لإنشاء ملف .mdb من تطبيق MFC ODBC. لذلك، إذا كان التطبيق الخاص بك يتطلب أن تضع بيانات فى مصدر بيانات Microsoft Access (ملف .mdb) , فانك غالباً تريد أن يكون لديك ملف .mdb فارغ يمكنك استخدامه أو نسخه عند الحاجة إليه.

و على كل حال، العديد من DBMSs تسمح بانشاء مصادر بيانات برمجياً . بعض مصادر البيانات تحتفظ بمواصفات الدليل لقواعد البيانات. هذا يعنى، أن الدليل هو مصدر البيانات و تم تخزين كل جدول داخل مصدر البيانات في ملف منفصل (في حالة dBASE ، كل جدول هو ملف dbf.). برامج تشغيل قواعد بيانات ODBC الأخرى مثل Microsoft Access و SQL Server تتطلب أن يتم توفير بعض معايير معينة قبل أن يتم تأسيس مصدر البيانات. على سبيل المثال، عند استخدام برنامج تشغيل SQL Server ODBC ، تحتاج إلى تأسيس كمبيوتر SQL Server.

مثال SQLConfigDataSource

يستخدم المثال التالي دالة ODBC API :: SQLConfigDataSource لإنشاء مصدر بيانات Excel جديد يسمى "New Excel Data Source":

SQLConfigDataSource(NULL,ODBC_ADD_DSN, "Excel Files (*.xls)", 
                   "DSN=New Excel Data Source\0" 
                   "Description=New Excel Data Source\0" 
                   "FileType=Excel\0" 
                   "DataDirectory=C:\\EXCELDIR\0" 
                   "MaxScanRows=20\0");

لاحظ أن مصدر البيانات هو فى الحقيقة دليل (C:\EXCELDIR) ؛ يجب أن يكون هذا الدليل موجوداً. يستخدم برنامج تشغيل Excel الدلائل كمصادر بياناته و ملفاته مثل الجداول الفردية (جدول واحد لكل ملف .xls).

للحصول على مزيد من المعلومات حول إنشاء الجداول , راجعمصدر البيانات : . إنشاء جدول فى مصدر بيانات ODBC بطريقة برمجية
.

المعلومات التالية تشرح المعلمات التي ينبغى تمريرها إلى دالة ODBC API :: SQLConfigDataSource . لاستخدام :: SQLConfigDataSource ، يجب أن يتضمن ملف الرأس Odbcinst.h و يستخدم مكتبة الاستيراد Odbcinst.lib. أيضاً، يجب أن يكون Odbccp32.dll في المسار في وقت التشغيل (أو Odbcinst.dll لـ 16 بت).

يمكنك إنشاء اسم مصدر البيانات ODBC باستخدام مسؤول ODBC أو أداة مساعدة مشابهة. ومع ذلك، يطلب في بعض الأحيان إنشاء اسم مصدر البيانات مباشرة من التطبيق الخاص بك للحصول على حق الوصول دون مطالبة المستخدم بتشغيل أداة مساعدة منفصلة.

ينشئ مسؤول ODBC (عادةً مثبت في لوحة التحكم) مصدر بيانات جديد عن طريق وضع إدخالات في سجل Windows (أو، لـ 16 بت، في ملف Odbc.ini). إدارة برامج تشغيل ODBC تستعلم عن هذا الملف للحصول على المعلومات المطلوبة حول مصدر البيانات. من المهم أن تعرف ما هي المعلومات التي يحتاج إلى أن توضع في السجل لأنك تحتاج إلى توفير ذلك مع استدعاء :: SQLConfigDataSource .

على الرغم من أنه قد تتم كتابة هذه المعلومات مباشرة فى السجل دون استخدام :: SQLConfigDataSource ، فإن أي تطبيق يقوم بذلك يعتمد على التقنية الحالية التي تستخدمها إدارة برنامج التشغيل للمحافظة على البيانات الخاصة به. إذا كانت مراجعة أحدث على إدارة برامج تشغيل ODBC تطبق سجلاً يحتوى على المعلومات حول مصدر البيانات بطريقة مختلفة , يتم قطع أي تطبيق يستخدم هذا الأسلوب . ينصح بشكل عام باستخدام دالة API إذا كانت واحدة متوفرة. على سبيل المثال، التعليمات البرمجية يمكن نقلها من 16 بت إلى 32 بت إذا كنت تستخدم الدالة :: SQLConfigDataSource , لأن الدالة تكتب إلى ملف Odbc.ini أو إلى السجل بشكل صحيح.

معلمات SQLConfigDataSource

يوضح التالي معلمات دالة :: SQLConfigDataSource . يتم أخذ الكثير من المعلومات من مرجع مبرمجي ODBC APIالموفر مع Visual C++ الإصدار 1.5 والإصدارات الأحدث.

النموذج الأولي للدالة

BOOL SQLConfigDataSource(HWND hwndParent,UINT fRequest, LPCSTR lpszDriver, LPCSTR lpszAttributes);

ملاحظات

المعلمات و الاستخدام

• hwndParent
  النافذة المحددة كمالك لأي مربعات حوار تنشئها إما إدارة برامج تشغيل ODBC أو برنامج تشغيل ODBC المحدد للحصول على معلومات إضافية من المستخدم حول مصدر البيانات الجديد . إذا كانت المعلمة lpszAttributes لا توفر معلومات كافية، يظهر مربع حوار. hwndParent قد يكون NULL .

• lpszDriver
  وصف برنامج التشغيل . هذا هو الاسم المقدم إلى المستخدمين بدلاً من اسم برنامج التشغيل الفعلي (DLL).

• lpszAttributes
  قائمة السمات في تكون فى شكل "اسم المفتاح = قيمة". يتم فصل هذه السلاسل بواسطة نهايات فارغة بإشارتي نهايات فارغة متتالية في نهاية القائمة. هذه السمات بشكل أساسي هى المدخلات الافتراضية الخاصة ببرنامج التشغيل, التي تنتقل إلى السجل الخاص بمصدر البيانات الجديد. أحد المفاتيح الهامة التى لم يرد ذكرها في مرجع ODBC API لهذه الدالة هو "DSN" (" اسم مصدر البيانات") ، الذي يحدد الاسم الجديد لمصدر البيانات. بقية الإدخالات خاصة ببرنامج تشغيل مصدر البيانات الجديد. غالباً ليس من الضروري توفير كافة الإدخالات لأن برنامج التشغيل يمكنه مطالبة المستخدم بمربعات حوار للقيم الجديدة. (عين hwndParent إلى NULL ليؤدى إلى هذا.) قد تحتاج إلى توفير القيم الافتراضية بشكل صريح بحيث لا تتم مطالبة المستخدم.

لتحديد وصف برنامج التشغيل للمعلمة lpszDriver باستخدام مسؤول ODBC

1. قم بتشغيل ODBC كمسؤول

2. انقر فوق إضافة.

يمنحك هذا قائمة من برامج التشغيل المثبتة والوصف الخاص بها. استخدم هذا الوصف كمعلمة lpszDriver . لاحظ أنه يمكنك استخدام الوصف بأكمله ، مثل ملفات Excel (*.xls) ، بما في ذلك امتداد اسم الملف والأقواس إذا كانت موجودة في الوصف.

وكبديل لذلك، يمكنك فحص السجل (أو ملف Odbcinst.ini لـ 16 بت) ، الذي يحتوي على قائمة من كافة إدخالات برنامج التشغيل و وصف ضمن مفتاح التسجيل "برامج تشغيل ODBC" (أو المقطع [برامج تشغيل ODBC] في Odbcinst.ini").

أحد طرق البحث عن أسماء المفاتيح وقيم المعلمات lpszAttributes هو فحص ملف Odbc.ini لمصدر البيانات المكون مسبقاً (ربما تم تكوين واحد بواسطة مسؤول ODBC).

للبحث عن أسماء المفاتح و قيم المعلمات lpszAttributes

1. قم بتشغيل محرر سجل Windows (أو فتح ملف Odbc.ini، لـ 16 بت).

2. البحث عن معلومات عن مصدر بيانات ODBC باستخدام واحد مما يلي:

   • للحصول على 32 بت, ابحث عن المفتاح HKEY_CURRENT_USER\Software\ODBC\ODBC.INI\مصادر بيانات ODBC في الجزء الأيسر.

     يسرد الجزء الأيسر الإدخالات في النموذج: "pub: REG_SZ: < اسم مصدر البيانات > "، حيث < اسم مصدر البيانات > هو مصدر البيانات الذى تم تكوينه مسبقاً مع الإعدادات المطلوبة لبرنامج تشغيل ترغب في استخدامها. حدد مصدر البيانات الذي تريده، على سبيل المثال، SQL Server. العناصر التالية للسلسلة "pub:" هى، بالترتيب ، اسم المفتاح و القيمة التى ينبغى استخدامها في المعلمة lpszAttributes الخاصة بك .

   • بالنسبة لـ 16 ب، ابحث عن المقطع في ملف Odbc.ini الموسوم بـ <اسم مصدر البيانات > .

     الأسطر التالية لهذا السطر هى فى شكل "اسم المفتاح = قيمة". هذه تماماً هي الإدخالات التى ينبغى استخدامها في المعلمة lpszAttributes الخاصة بك .

قد تحتاج أيضاً لتفحص الوثائق لبرنامج التشغيل المحدد الذى ستقوم باستخدامه. يمكنك البحث عن معلومات مفيدة من خلال تعليمات برنامج التشغيل على الإنترنت، والتي يمكنك الوصول إليها عن طريق تشغيل "مسؤول ODBC. ملفات المساعدة هذه عادةً يتم وضعها في الدليل WINDOWS\SYSTEM لـ Windows NT أو Windows 3.1 أو Windows 95.

للحصول على تعليمات عبر الإنترنت عن برنامج تشغيل ODBC الخاص بك.

1. قم بتشغيل ODBC كمسؤول

2. انقر فوق إضافة.

3. حدد اسم برنامج تشغيل.

4. انقر فوق موافق.

عندما يقوم مسؤول ODBC بعرض المعلومات لإنشاء مصدر بيانات جديد لبرنامج تشغيل معين ، انقر فوق تعليمات. يؤدي هذا إلى فتح ملف التعليمات المحدد هذا، و الذى يحتوي بشكل عام على معلومات هامة تتعلق استخدام برنامج التشغيل.

راجع أيضًا:

المبادئ

مصدر البيانات (ODBC)