الانتقال إلى المحتوى الرئيسي
في Embeddable يمكنك تعريف نماذج البيانات والمكوّنات برمجيًا (مع تخزينها في مستودع الشيفرة الخاص بك)، ثم استخدام SDK الخاص بنا لإتاحتها لفريقك داخل منشئ Embeddable القوي من دون كتابة تعليمات برمجية. والنتيجة هي قدرتك على تقديم تحليلات سريعة وتفاعلية موجّهة للعملاء مباشرةً داخل منتجك؛ يصمّمها فريق المنتج لديك؛ ويبنيها فريق الهندسة لديك؛ وتتولى صيانتها الفرق المعنية بالعملاء والبيانات لديك. تمامًا كما ينبغي. ويعني الأمان المدمج على مستوى الصفوف أن كل مستخدم لا يرى إلا البيانات المصرّح له برؤيتها. كما أن وجود مستويين من التخزين المؤقت القابل للتهيئة بالكامل يتيح لك تقديم تحليلات سريعة وآنية وعلى نطاق واسع.

​
1. اجمع تفاصيل الاتصال لديك

للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية:
المعلماتالوصف
HOST and PORTعادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS.
DATABASE NAMEافتراضيًا، توجد قاعدة بيانات باسم default. استخدم اسم قاعدة البيانات التي تريد الاتصال بها.
USERNAME and PASSWORDافتراضيًا، يكون اسم المستخدم default. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك.
تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console. حدِّد خدمة ثم انقر على Connect: اختر HTTPS. ستظهر تفاصيل الاتصال في مثال لأمر curl. إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال.

​
2. إنشاء نوع اتصال لـ ClickHouse

يمكنك إضافة اتصال لقاعدة بيانات باستخدام Embeddable API. يُستخدم هذا اتصال للاتصال بخدمة ClickHouse الخاصة بك. يمكنك إضافة اتصال باستخدام استدعاء API التالي:
Query
// for security reasons, this must *never* be called from your client-side
fetch('https://api.embeddable.com/api/v1/connections', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
    Authorization: `Bearer ${apiKey}` /* keep your API Key secure */,
  },
  body: JSON.stringify({
    name: 'my-clickhouse-db',
    type: 'clickhouse',
    credentials: {
      host: 'my.clickhouse.host',
      user: 'clickhouse_user',
      port: 8443,
      password: '*****',
    },
  }),
});
Response
Status 201 { errorMessage: null }
يمثّل ما سبق إجراء CREATE، ولكن جميع عمليات CRUD متاحة. يمكن العثور على apiKey بالنقر على “Publish” في إحدى لوحات معلومات Embeddable. يشير name إلى اسم فريد لتحديد هذا الاتصال.
  • بشكل افتراضي، ستبحث نماذج البيانات لديك عن اتصال باسم “default”، ولكن يمكنك تزويد نماذجك بأسماء data_source مختلفة لدعم ربط نماذج بيانات مختلفة باتصالات مختلفة (ما عليك سوى تحديد اسم data_source في النموذج)
يحدّد type لـ Embeddable برنامج التشغيل الذي يجب استخدامه.
  • هنا ستحتاج إلى استخدام clickhouse، ولكن يمكنك ربط عدة مصادر بيانات مختلفة بمساحة عمل Embeddable واحدة، لذا قد تستخدم مصادر أخرى مثل: postgres وbigquery وmongodb وما إلى ذلك.
credentials هو كائن JavaScript يحتوي على بيانات الاعتماد المطلوبة التي يتوقعها برنامج التشغيل.
  • تُشفَّر هذه البيانات بأمان، ولا تُستخدم إلا لاسترداد البيانات التي وصفتها بدقة في نماذج البيانات الخاصة بك. وتوصي Embeddable بشدة بإنشاء مستخدم قاعدة بيانات للقراءة فقط لكل اتصال (إذ لن تقوم Embeddable إلا بالقراءة من قاعدة البيانات لديك، ولن تكتب فيها).
لدعم الاتصال بقواعد بيانات مختلفة لبيئات الإنتاج وqa والاختبار وما إلى ذلك (أو لدعم قواعد بيانات مختلفة لعملاء مختلفين)، يمكنك إسناد كل اتصال إلى بيئة (راجع Environments API).
آخر تعديل في ٢٩ يونيو ٢٠٢٦