وثائق كيوبت English

ربط بياناتك

يمنح الاتصالُ كيوبت صلاحية القراءة من مصدر من مصادر بياناتك. وبعد الربط تظهر جداوله في كتالوج البيانات، ويستطيع المساعد ولوحات البيانات والتقارير استخدامها.

المصادر المتاحة

تجمع صفحة مصدر بيانات جديد المصادر في الفئات التالية، وكل مصدر له دليل في هذا القسم يرتبط اسمه بدليله.

أما المصادر الموسومة بأنها قادمة قريبًا فتجدها في التكاملات المخطط لها. ولجداول البيانات والمستندات المحفوظة على جهازك، راجع رفع الملفات.

إنشاء اتصال

  1. افتح البيانات من الشريط الجانبي وانقر على إضافة بيانات.
  2. اختر ربط قاعدة بيانات، فتُفتح صفحة مصدر بيانات جديد.
  3. اختر فئة أو استخدم البحث في المصادر...، ثم انقر على المصدر.
  4. أدخل اسم الاتصال. ويجب أن يكون الاسم فريدًا في مساحة العمل.
  5. املأ حقول المصدر كما يذكرها دليله.
  6. اختر جدول المزامنة ثم انقر على إنشاء.

طرق تسجيل الدخول إلى المصادر

للمصادر طريقتان في الاتصال:

  • تسجيل الدخول لدى المزوّد: تعرض إعلانات Meta وإعلانات Google وإعلانات TikTok وإعلانات Snapchat وGoogle Analytics 4 وBigQuery وGoogle Sheets وسلة وبائع أمازون زر ربط، ويفتح هذا الزر صفحة تسجيل الدخول لدى المزوّد في علامة تبويب جديدة. وبعد موافقتك على الوصول تُغلق علامة التبويب وتختار الحساب الذي تريد مزامنته. ولا يطّلع كيوبت على كلمة مرورك أبدًا. وإذا حظر متصفحك علامة التبويب الجديدة، فاسمح بالنوافذ المنبثقة لكيوبت ثم حاول مرة أخرى.
  • بيانات الاعتماد: تطلب بقية المصادر عنوان الخادم واسم المستخدم، أو مفتاح API، أو رمز وصول. وتظهر الحقول السرية مقنّعة، فانقر أيقونة العين في الحقل لتتحقق مما لصقته.

وضع المزامنة والوضع المباشر

تنسخ معظم الاتصالات البيانات إلى مستودع كيوبت وتحدّثها وفق الجدول الذي تختاره، ويسمى ذلك وضع المزامنة.

وتوفر PostgreSQL وSupabase وMySQL وRedshift وSAP HANA أيضًا الوضع المباشر ضمن وضع الاتصال. وفيه يستعلم كيوبت من قاعدة بياناتك مباشرةً ولا ينسخ شيئًا، فلا جدول مزامنة لاتصالات الوضع المباشر.

ويمكن الوصول إلى هذه المصادر الأربعة أيضًا بنفق SSH يمر بخادم وسيط. فعّل الاتصال بنفق SSH وأدخل مضيف SSH ومنفذ SSH واسم مستخدم SSH ومفتاح SSH الخاص (PEM)، وعبارة مرور المفتاح إن وُجدت. ويعمل نفق SSH دائمًا بالوضع المباشر. وتختار وضع الاتصال ونفق SSH عند إنشاء الاتصال، ولا يمكن تغييرهما لاحقًا.

جدول المزامنة

للاتصالات المزامَنة، اختر عدد مرات تحديث كيوبت للبيانات:

  • يدوي: لا تُحدَّث البيانات إلا حين تختار مزامنة الآن في كتالوج البيانات.
  • كل ساعة: كل ساعة عند بدايتها.
  • يوميًا: كل يوم في الوقت الذي تحدده، وهو الخيار الافتراضي.
  • أسبوعيًا: في الأيام والوقت اللذين تحددهما.
  • مخصص (Cron): تعبير cron للجداول المتقدمة.

تتبع الأوقات المنطقة الزمنية في إعدادات حسابك، ويمكنك تغيير الجدول لاحقًا من تعديل.

ما يحدث عند النقر على إنشاء

في PostgreSQL وSupabase وMySQL وRedshift وSAP HANA وNetSuite يختبر كيوبت الاتصال قبل حفظه، فإذا لم ينجح الاختبار عرض النموذج الخطأ بجوار الحقل الذي يحتاج إلى تصحيح.

أما في بقية المصادر فيتحقق كيوبت من تعبئة الحقول المطلوبة، ثم يحفظ الاتصال ويتأكد من الوصول أثناء المزامنة الأولى. وبعد الحفظ يمكنك تشغيل اختبار الاتصال من قائمة الاتصال في كتالوج البيانات.

ثم يبدأ كيوبت المزامنة الأولى ويعيدك إلى كتالوج البيانات حيث يظهر الاتصال الجديد، وتظهر جداوله عند اكتمال المزامنة الأولى.

الوصول الشبكي والصلاحيات

  • يجب أن تقبل قاعدة البيانات الاتصالات الواردة من خوادم كيوبت على منفذها. وإذا كانت لا تقبل إلا الاتصالات من شبكة خاصة، فاستخدم نفق SSH (في PostgreSQL وSupabase وMySQL وRedshift وSAP HANA).
  • إذا كان جدار الحماية لديك لا يقبل إلا عناوين IP معروفة، فتواصل مع دعم كيوبت للحصول على العناوين التي ينبغي السماح بها.
  • استخدم مستخدمًا أو مفتاحًا مخصصًا للقراءة فقط متى أتاح المصدر ذلك، فكيوبت لا يفعل بمصادرك غير القراءة.

هل تحتاج إلى مصدر آخر؟

في نهاية قائمة المصادر، تفتح بطاقة هل تحتاج إلى اتصال آخر؟ رسالة بريد إلكتروني إلى [email protected] لتطلب مصدرًا غير مدرج.