> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Embeddable هي مجموعة أدوات للمطورين لإنشاء تجارب تحليلات سريعة وتفاعلية ومخصصة بالكامل مباشرةً داخل تطبيقك.
# ربط Embeddable بـ ClickHouse
export const CommunityMaintainedBadge = () => {
return
تتم صيانته من قِبل المجتمع
;
};
في [Embeddable](https://embeddable.com/) يمكنك تعريف [نماذج البيانات](https://docs.embeddable.com/data-modeling/introduction) و[المكوّنات](https://docs.embeddable.com/development/introduction) في الشيفرة (المخزّنة في مستودع الشيفرة الخاص بك) واستخدام **SDK** لدينا لإتاحتها لفريقك في **أداة الإنشاء دون شيفرة** القوية من Embeddable.
والنتيجة النهائية هي القدرة على تقديم تحليلات سريعة وتفاعلية موجّهة للعملاء مباشرةً داخل منتجك؛ يصمّمها فريق المنتج لديك؛ ويبنيها فريق الهندسة لديك؛ وتتولّى صيانتها الفرق المواجهة للعملاء وفرق البيانات لديك. تمامًا كما ينبغي أن تكون.
يعني الأمان المضمّن على مستوى الصفوف أن كل مستخدم لا يرى إلا البيانات المسموح له برؤيتها بالضبط. كما أن وجود مستويين من التخزين المؤقت القابل للتهيئة بالكامل يعني أنه يمكنك تقديم تحليلات سريعة وفي الوقت الفعلي وعلى نطاق واسع.
للاتصال بـ 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 لديك تفاصيل الاتصال.
يمكنك إضافة اتصال لقاعدة بيانات باستخدام Embeddable API. يُستخدم هذا اتصال للاتصال بخدمة ClickHouse الخاصة بك. يمكنك إضافة اتصال باستخدام استدعاء API التالي:
```javascript title="Query" theme={null}
// 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: '*****',
},
}),
});
```
```text title="Response" theme={null}
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](https://docs.embeddable.com/data/environments)).
