تكوين اتصالات ومصادر بيانات لبرامج تشغيل JDBC عامة

استخدم سير العمل هذا لتمكين Essbase من الاتصال بأي مصدر بيانات JDBC، مستخدمًا برامج التشغيل التي قمت بتحميلها في خادم Essbase.

إذا كنت مسؤول توزيع Essbase فبإمكانك تكوين Essbase بحيث يستخدم برامج التشغيل المفضلة لديك مما قمت بتحميله على جهاز خادم Essbase. قامت أوراكل باختبار اتصال Essbase JDBC باستخدام برامج تشغيل أوراكل. ولاستخدام برامج تشغيل JDBC من أي مورد آخر، عليك بمراجعة وثائق برنامج التشغيل لمعرفة متطلباته المتعلقة بتحديد عنوان URL والصلاحيات في مصدر بيانات JDBC. لمعرفة أي خطوات متعلقة بالأداء، اطلع على وثائق JDBC للمورد.

للتمكن من تكوين Essbase بحيث يستخدم برامج تشغيل JDBC عامة،

1. اتصل بالجهاز المثبت عليه خادم Essbase باستخدام SSH.

2. قم يدويًا بتكوين دليل drivers في <Essbase Product Home> بمثيل الخادم.

   تأكد أن drivers مكتوبة بحالة أحرف صغيرة، نظرًا لحساسية المسار لحالة الأحرف.

3. من خلال موقع المورد الذي تتعامل معه، قم بتنزيل ملفات JAR الخاصة ببرامج تشغيل JDBC التي تريد استخدامها.

   برنامج تشغيل JDBC الخاص بقاعدة بيانات أوراكل المدعوم من Essbase هو ojdbc8.jar.

   إذا كنت تستخدم Autonomous Data Warehouse فأنت بحاجة لتنزيل الأرشيف بأكمله (ojdbc8-full.tar.gz) المشتمل على برنامج تشغيل Oracle JDBC Thin وما يصاحبه من ملفات JAR.

4. قم بتحميل ملفات jar الخاصة ببرنامج تشغيل JDBC في الدليل drivers على مثيل Essbase.

   قم بتحميل ما لا يزيد عن إصدار واحد من كل برنامج تشغيل قاعدة بيانات في الدليل drivers. على سبيل المثال، لا تقم بتحميل كل من sqljdbc41.jar وsqljdbc42.jar، إذ سيؤدي هذا لاستخدام Essbase للإصدار الأقدم (والذي يظهر أولاً في CLASSPATH).

   في حالة استخدام Autonomous Data Warehouse قم باستخراج الأرشيف (ojdbc8-full.tar.gz) ونقل كل المحتويات مباشرة إلى الدليل drivers (ليس دليلاً فرعيًا).

5. قم بتكوين اتصالات ببرامج تشغيل JDBC.

   1. في واجهة Essbase على الويب، انقر على السيناريوهات، ثم الاتصالات.

      أو، لتعريف الاتصال ومصدر البيانات على مستوى التطبيق، وليس تعريفًا عموميًا، عليك بالبدء من صفحة "التطبيقات" بدلاً من صفحة "المصادر"، انقر على اسم التطبيق ثم على المصادر.

   2. انقر على تكوين اتصال وحدد JDBC.

      للعثور على برنامج تشغيل JDBC، يبحث Essbase في مجلد drivers. في حالة عدم العثور على ملفات jar، يقوم Essbase بإظهار خطأ Class Not Found (الطبقة غير موجودة) (أو فشل تحميل برنامج التشغيل) عند اختبار الاتصال.

   3. في شاشة تكوين اتصال،

      1. أدخل اسمًا لاتصال JDBC. على سبيل المثال، Oracle JDBC.

      2. في حقل عنوان URL، أدخل سلسلة اتصال JDBC. على سبيل المثال، jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. الحصول على سلسلة اتصال JDBC من موفر JDBC.

         لا ينطبق تنسيق الصياغة أعلاه إلا على Oracle Database. اطلع على المزيد من أمثلة الاتصالات لبرامج تشغيل JDBC العامة إذا كنت تعمل مع مزودي خدمة آخرين.

      3. في حقلي "المستخدم" و"كلمة السر" أدخل صلاحيات المستخدم المصرح له بالوصول إلى قاعدة البيانات.

      4. في حقل "برنامج التشغيل" أدخل الاسم الكامل لطبقة برنامج تشغيل JDBC. على سبيل المثال، oracle.jdbc.driver.OracleDriver.

      
      
      
      
      

      بالنسبة لبرامج تشغيل أوراكل، حدد عنوان URL مستعينًا بإرشادات الصياغة التالية:

      • إذا كانت قاعدة بيانات أوراكل مسجلة بواسطة مستمع، فيمكنك استخدام اسم الخدمة في عنوان URL بدلاً من معرف SID، وذلك باستخدام الصيغة المختصرة jdbc:oracle:thin:@<host>:<port>/<servicename>. مثال:

        jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com

      • يجري في المثال التالي استخدام اسم الخدمة في صيغة طويلة.

        jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))

      • للتمكن من استخدام معرف نظام أوراكل (SID) والذي يميز قاعدة البيانات بشكل فريد، استخدم الصيغة jdbc:oracle:thin:@<host>:<port>:<SID>. على سبيل المثال؜،

        jdbc:oracle:thin:@myhost:1521:orcl

      • إذا كنت تستخدم Autonomous Data Warehouse، ففي صيغة URL، لا بد من تضمين متغير البيئة TNS_ADMIN والذي يحدد المسار إلى الحافظة. قد تكون الحافظة في أي مكان على جهاز خادم Essbase ولكن لا بد من إدخال المسار بالكامل، باستخدام صيغة مثل jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.

        مثال لنظام Linux

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn

        مثال لنظام Windows

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"

        مثال لتوزيع OCI

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn

      لا تعمل الأمثلة أعلاه إلا مع Oracle Database. اطلع على المزيد من أمثلة الاتصالات لبرامج تشغيل JDBC العامة إذا كنت تعمل مع مزودي خدمة آخرين.

   4. انقر على اختبار للتحقق من الاتصال. فإن كان ناجحًا فانقر على تكوين.

   5. تحقق من تكوين الاتصال بنجاح ومن ظهوره في قائمة الاتصالات.

6. قم بتكوين مصادر بيانات عن طريق الاتصالات ببرنامج تشغيل JDBC عام.

   1. انقر على مصادر البيانات وانقر على تكوين مصدر بيانات.

   2. من مربع القائمة المنسدلة الاتصال، حدد اسم الاتصال الذي قمت بتكوينه للتو، على سبيل المثال، Oracle JDBC. ويلاحظ أن الاتصالات على مستوى التطبيق تكون مسبوقة باسم اتصال، بالصيغة appName.connectionName.

   3. أدخل اسمًا لمصدر البيانات، وليكن OracleDB_Datasource.

   4. يمكن بشكل اختياري إدخال وصف لمصدر البيانات، مثل SAMPLE_BASIC_TABLE في قاعدة بيانات أوراكل.

   5. في حقل "الاستعلام" أدخل استعلام SQL الملائم والذي يحدد البيانات التي تريد إتاحتها في مصدر البيانات هذا.

   6. انقر على التالي. إذا كانت جملة SQL صحيحة لإجراء استعلام في جدول، فسيتم ملء الأعمدة المستعلم عنها.

   7. قم بتغيير نوع أية أعمدة رقمية إلى مزدوج Double، وانقر على التالي.

   8. قم بتغيير أية معلمات خاصة بالمصدر، إن وجدت، واضغط على التالي. لمعرفة معلومات حول استخدام المعلمات، يرجى الاطلاع على استخدام المعلمات في مصادر البيانات.

   9. راجع لوحة المعاينة. لا بد أن تظهر لك نتائج الاستعلام الذي يسحب أعمدة بيانات من مصدر خارجي.

   10. إذا بدا كل شيء سليمًا في المعاينة، فانقر على تكوين للانتهاء من تكوين مصدر البيانات.