وثائق كيوبت English

SAP HANA

اربط SAP HANA أو SAP HANA Cloud ليقرأ كيوبت الجداول والعروض الموجودة في مخطط واحد. يمكنك نسخ البيانات إلى كيوبت وفق جدول زمني (وضع المزامنة) أو الاستعلام من HANA مباشرة (الوضع المباشر). ويمكن الوصول إلى الخوادم الموجودة داخل شبكة خاصة مرورًا بخادم وسيط SSH.

قبل البدء

  • أنشئ مستخدمًا تقنيًا مخصصًا لكيوبت، وامنحه صلاحية SELECT على المخطط الذي تريد استخدامه، مثل GRANT SELECT ON SCHEMA "SALES" TO QUBIT_READER. ولا يرى كيوبت إلا الجداول والعروض التي يستطيع هذا المستخدم قراءتها.
  • أنشئ المستخدم مع الخيار NO FORCE_FIRST_PASSWORD_CHANGE، أو سجّل الدخول به مرة لتعيين كلمة مروره؛ إذ يرفض HANA المستخدم الذي لم يغيّر كلمة مروره الأولى بعد.
  • دوّن المضيف والمنفذ:
    • SAP HANA Cloud: عنوان SQL الظاهر في SAP HANA Cloud Central، على المنفذ 443. واسمح بعناوين IP الخاصة بكيوبت في إعدادات الاتصال بالمثيل.
    • الخادم المحلي: اسم الخادم ومنفذ SQL الخاص بالمستأجر، وهو 3NN15 إذ NN رقم المثيل، مثل 30015 للمثيل 00.
  • يحتاج المخطط الذي يضم أكثر من 1000 جدول، كمخطط ABAP في S/4HANA (SAPHANADB أو SAPABAP1)، إلى قائمة بالجداول المراد استخدامها. والأفضل غالبًا ربط كيوبت بمخطط يضم عروض التقارير.

ربط SAP HANA

  1. افتح البيانات من الشريط الجانبي، وانقر على إضافة بيانات، ثم اختر ربط قاعدة بيانات.
  2. في صفحة مصدر بيانات جديد، انقر على SAP HANA ضمن فئة قواعد البيانات.
  3. أدخل اسم الاتصال.
  4. املأ بيانات الاتصال:
    • المضيف: اسم الخادم دون المنفذ.
    • المنفذ: القيمة الافتراضية 443، وهو منفذ SAP HANA Cloud.
    • قاعدة بيانات المستأجر: فقط إذا كان المنفذ لقاعدة بيانات النظام. اتركها فارغة في SAP HANA Cloud وعند الاتصال بمنفذ المستأجر نفسه.
    • المخطط (Schema): المخطط المراد قراءته. تميّز أسماء المخططات بين الأحرف الكبيرة والصغيرة، وتُكتب عادةً بأحرف كبيرة.
    • المستخدم وكلمة المرور: بيانات المستخدم الذي أنشأته.
    • الجداول: اختياري. أسماء الجداول والعروض مفصولة بفواصل، و* لمطابقة أي نص، مثل VBAK, VBAP, KNA1, Z_SALES*.
    • استخدام TLS: مفعّل افتراضيًا، ويشترطه SAP HANA Cloud. ويتحقق كيوبت دائمًا من شهادة الخادم.
  5. في وضع الاتصال، اختر وضع المزامنة لنسخ البيانات إلى كيوبت، أو الوضع المباشر للاستعلام من HANA مباشرة.
  6. للوصول إلى HANA مرورًا بخادم وسيط، فعّل الاتصال بنفق SSH وأدخل مضيف SSH ومنفذ SSH واسم مستخدم SSH ومفتاح SSH الخاص (PEM)، وعبارة مرور المفتاح إن وُجدت. ويعمل النفق دائمًا بالوضع المباشر، فلا تُنسخ بيانات إلى كيوبت. ومع تفعيل TLS يظل التحقق من الشهادة قائمًا على اسم مضيف HANA.
  7. في وضع المزامنة، اختر جدول المزامنة. الخيار الافتراضي يوميًا.
  8. انقر على إنشاء.

يختبر كيوبت الاتصال قبل حفظه، ثم ينقلك إلى كتالوج البيانات. ولا يمكن تغيير وضع الاتصال أو نفق SSH بعد إنشاء الاتصال.

كيف تصل البيانات

في الوضع المباشر يُنفَّذ كل سؤال على HANA نفسه، فتُحسب عوامل التصفية والربط والمجاميع هناك ولا يعود إلا الجواب. ولبعض العمليات الحسابية مقابل غير مطابق في HANA، فيقرأ كيوبت لها مليون صف على الأكثر من كل جدول معني، ثم يكمل الحساب بنفسه.

وفي الوضعين تحتفظ الأعمدة بأنواعها في HANA، باستثناء ما يلي:

  • تحمل أعمدة BOOLEAN القيمتين 1 و0 في الوضع المباشر.
  • تصل أعمدة TIME نصًا، والأعمدة المكانية نصًا بصيغة WKT، وأعمدة VARBINARY نصًا ست عشريًا.
  • لا تُنقل أعمدة BLOB.

إذا لم ينجح الاختبار

يعرض النموذج رسالة الخطأ بالإنجليزية:

  • «Authentication failed»: تحقق من المستخدم وكلمة المرور.
  • «This user must change its password before it can connect»: سجّل الدخول بالمستخدم مرة لتعيين كلمة مرور جديدة.
  • «Could not reach» أو «timed out»: تحقق من المضيف والمنفذ، ومن أن HANA يقبل الاتصالات من كيوبت. وفي SAP HANA Cloud تحقق من الاتصالات المسموح بها للمثيل، وللخادم الخاص استخدم نفق SSH.
  • «The server's TLS certificate could not be validated»: أدخل اسم المضيف الذي صدرت له الشهادة.
  • «Tenant database was not found»: تحقق من اسم المستأجر، أو اترك الحقل فارغًا عند الاتصال بمنفذ المستأجر نفسه.
  • «Schema does not exist or this user cannot read it»: تحقق من اسم المخطط وحالة أحرفه، ومن صلاحيات المستخدم.
  • «List the ones Qubit should read under Tables»: يضم المخطط أكثر من 1000 جدول وعرض، فاذكر الجداول المراد استخدامها في حقل الجداول.