> ## 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.
# البدء السريع مع ClickHouse Cloud
> دليل البدء السريع لـ ClickHouse Cloud
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> أسرع وأسهل طريقة لبدء استخدام ClickHouse وتشغيله هي إنشاء
> خدمة جديدة في [ClickHouse Cloud](https://console.clickhouse.cloud). في دليل البدء السريع هذا، سنُعِدّك
> للانطلاق في ثلاث خطوات سهلة.
لإنشاء خدمة ClickHouse مجانية في [ClickHouse Cloud](https://console.clickhouse.cloud)، ما عليك سوى التسجيل باتباع الخطوات التالية:
* أنشئ حسابًا على [صفحة التسجيل](https://console.clickhouse.cloud/signUp)
* يمكنك اختيار التسجيل باستخدام بريدك الإلكتروني أو عبر Google SSO أو Microsoft SSO أو AWS Marketplace أو Google Cloud أو Microsoft Azure
* إذا سجّلت باستخدام بريد إلكتروني وكلمة مرور، فتذكّر تأكيد عنوان بريدك الإلكتروني خلال الـ24 ساعة التالية عبر الرابط الذي يصلك في بريدك الإلكتروني
* سجّل الدخول باستخدام اسم المستخدم وكلمة المرور اللذين أنشأتهما للتو
بمجرد تسجيل الدخول، يبدأ ClickHouse Cloud معالج الإعداد الذي يرشدك خلال إنشاء خدمة ClickHouse جديدة. حدّد المنطقة التي تريد نشر الخدمة فيها، وامنح خدمتك الجديدة اسمًا:
بشكل افتراضي، تُوضَع المؤسسات الجديدة على فئة Scale، ويتم إنشاء 3 نُسخ متماثلة، لكل منها 4 وحدات vCPU و16 GiB من RAM. سيكون [التحجيم التلقائي الرأسي](/docs/ar/products/cloud/features/autoscaling/vertical) مفعّلًا افتراضيًا في فئة Scale. يمكنك تغيير فئة مؤسستك لاحقًا من صفحة 'Plans'.
خصّص موارد الخدمة عند الحاجة من خلال تحديد الحد الأدنى والحد الأقصى للحجم الذي يمكن أن تتوسع النُسخ المتماثلة ضمنه. وعندما تصبح جاهزًا، حدّد `Create service`.
تهانينا! أصبحت خدمة ClickHouse Cloud الخاصة بك قيد التشغيل واكتمل الإعداد. تابع القراءة لمعرفة كيفية البدء في إدخال بياناتك والاستعلام عنها.
هناك طريقتان للاتصال بـ ClickHouse:
* الاتصال باستخدام SQL Console عبر الويب
* الاتصال من خلال تطبيقك
### الاتصال باستخدام SQL Console
للبدء سريعًا، يوفّر ClickHouse واجهة SQL Console عبر الويب، وسيُعاد توجيهك إليها بعد إكمال خطوات الإعداد الأولي.
أنشئ علامة تبويب query وأدخل query بسيطًا للتحقق من أن الاتصال يعمل:
```sql theme={null}
SHOW databases
```
يجب أن ترى 4 قواعد بيانات في القائمة، بالإضافة إلى أي قواعد بيانات أخرى ربما أضفتها.
هذا كل ما في الأمر — أنت الآن جاهز لبدء استخدام خدمة ClickHouse الجديدة!
### الاتصال بتطبيقك
اضغط على زر Connect من قائمة التنقل. ستُفتح نافذة منبثقة تعرض بيانات الاعتماد الخاصة بخدمتك، وتوفر لك مجموعة من الإرشادات حول كيفية الاتصال عبر الواجهة أو مكتبات العملاء للغات البرمجة.
إذا لم تتمكن من العثور على مكتبة العملاء للغات البرمجة الخاصة بك، فقد ترغب في الاطلاع على قائمة [Integrations](/docs/ar/integrations/home).
ClickHouse أفضل مع البيانات! ثمة طرق متعددة لإضافة البيانات، ومعظمها متاح في صفحة مصادر البيانات التي يمكن الوصول إليها من قائمة التنقل.
يمكنك رفع البيانات باستخدام الطرق التالية:
* أعِدّ ClickPipe لبدء إدخال البيانات من مصادر بيانات مثل S3 وPostgres وKafka وGCS
* استخدم SQL Console
* استخدم عميل ClickHouse
* ارفع ملفًا - تشمل التنسيقات المقبولة JSON وCSV وTSV
* ارفع البيانات من عنوان URL للملف
### ClickPipes
[ClickPipes](http://clickhouse.com/docs/integrations/clickpipes) هي منصة تكامل مُدارة تجعل استيعاب البيانات من مجموعة متنوعة من المصادر بسيطاً كالنقر على بضعة أزرار. صُمِّمت لتلبية أشد أحمال العمل تطلباً، وتضمن معمارية ClickPipes المتينة والقابلة للتوسع أداءً ثابتاً وموثوقية عالية. ويمكن استخدام ClickPipes لتلبية احتياجات البث على المدى الطويل أو لمهام تحميل البيانات لمرة واحدة.
### إضافة البيانات باستخدام SQL Console
كما هو الحال في معظم أنظمة إدارة قواعد البيانات، يُنظّم ClickHouse الجداول منطقيًا ضمن **قواعد بيانات**. استخدم الأمر [`CREATE DATABASE`](/docs/ar/reference/statements/create/database) لإنشاء قاعدة بيانات جديدة في ClickHouse:
```sql theme={null}
CREATE DATABASE IF NOT EXISTS helloworld
```
نفِّذ الأمر التالي لإنشاء جدول باسم `my_first_table` في قاعدة البيانات `helloworld`:
```sql theme={null}
CREATE TABLE helloworld.my_first_table
(
user_id UInt32,
message String,
timestamp DateTime,
metric Float32
)
ENGINE = MergeTree()
PRIMARY KEY (user_id, timestamp)
```
في المثال أعلاه، `my_first_table` جدول من نوع [`MergeTree`](/docs/ar/reference/engines/table-engines/mergetree-family/mergetree) يحتوي على أربعة أعمدة:
* `user_id`: عدد صحيح غير موقّع بطول 32 بت ([UInt32](/docs/ar/reference/data-types/int-uint))
* `message`: نوع البيانات [String](/docs/ar/reference/data-types/string)، ويحلّ محل أنواع مثل `VARCHAR` و`BLOB` و`CLOB` وغيرها في أنظمة قواعد البيانات الأخرى
* `timestamp`: قيمة [DateTime](/docs/ar/reference/data-types/datetime) تمثّل نقطة زمنية محددة
* `metric`: عدد عشري عائم بطول 32 بت ([Float32](/docs/ar/reference/data-types/float))
**محركات الجداول**
تحدد محركات الجداول ما يلي:
* كيفية تخزين البيانات وأين تُخَّزن
* الاستعلامات التي يدعمها
* ما إذا كانت البيانات مكررة أم لا
هناك العديد من محركات الجداول للاختيار من بينها، ولكن بالنسبة إلى جدول بسيط على خادم ClickHouse أحادي العقدة، فمن المرجح أن يكون [`MergeTree`](/docs/ar/reference/engines/table-engines/mergetree-family/mergetree) هو الخيار الأنسب.
#### مقدمة موجزة عن المفاتيح الأولية
قبل المتابعة، من المهم أن تفهم كيفية عمل المفاتيح الأساسية في ClickHouse (قد تبدو آلية تنفيذ المفاتيح الأساسية مفاجئة!):
* المفاتيح الأساسية في ClickHouse ***ليست فريدة*** لكل صف في الجدول
يحدد المفتاح الأساسي لجدول ClickHouse كيفية ترتيب البيانات عند كتابتها على القرص. كل 8,192 صفًا أو 10 ميغابايت من
البيانات (يُشار إليها بـ **حبيبية الفهرس**) تُنشئ إدخالًا في ملف فهرس المفتاح الأساسي. يُولّد هذا المفهوم المتعلق بالحبيبية
**فهرسًا متفرقًا** يمكن تخزينه بسهولة في الذاكرة، وتمثل الحُبيبات شريطًا يضم أصغر قدر من بيانات الأعمدة التي تُعالَج أثناء استعلامات `SELECT`.
يمكن تعريف المفتاح الأساسي باستخدام المعامل `PRIMARY KEY`. إذا عرّفت جدولاً دون تحديد `PRIMARY KEY`،
فإن المفتاح يصبح الصف المحدد في عبارة `ORDER BY`. وإذا حددت كلاً من `PRIMARY KEY` و`ORDER BY`، فيجب أن يكون المفتاح الأساسي مجموعة فرعية من ترتيب الفرز.
المفتاح الأساسي هو أيضاً مفتاح الفرز، وهو Tuple من `(user_id, timestamp)`. لذا، ستكون البيانات المخزنة في كل ملف عمود مرتبةً وفق `user_id` أولاً، ثم `timestamp`.
للتعمق في مفاهيم ClickHouse الأساسية، راجع ["المفاهيم الأساسية"](/docs/ar/concepts/core-concepts/index).
#### إدراج البيانات في جدولك
يمكنك استخدام الأمر المألوف [`INSERT INTO TABLE`](/docs/ar/reference/statements/insert-into) مع ClickHouse، غير أنه من المهم أن تدرك أن كل عملية إدراج في جدول [`MergeTree`](/docs/ar/reference/engines/table-engines/mergetree-family/mergetree) تؤدي إلى إنشاء **جزء** في التخزين.
**أفضل ممارسات ClickHouse**
أدرِج عددًا كبيرًا من الصفوف في كل دفعة — عشرات الآلاف أو حتى ملايين
الصفوف دفعةً واحدة. لا تقلق — يمكن لـ ClickHouse التعامل بسهولة مع هذا الكم — بل إنه [سيوفر لك المال](/docs/ar/concepts/best-practices/selecting-an-insert-strategy#batch-inserts-if-synchronous) من خلال إرسال عدد أقل من طلبات الكتابة إلى خدمتك.
حتى في هذا المثال البسيط، لنُدرج أكثر من صف واحد في المرة الواحدة:
```sql theme={null}
INSERT INTO helloworld.my_first_table (user_id, message, timestamp, metric) VALUES
(101, 'Hello, ClickHouse!', now(), -1.0 ),
(102, 'Insert a lot of rows per batch', yesterday(), 1.41421 ),
(102, 'Sort your data based on your commonly-used queries', today(), 2.718 ),
(101, 'Granules are the smallest chunks of data read', now() + 5, 3.14159 )
```
لاحظ أن العمود `timestamp` يُعبَّأ باستخدام دوال [**Date**](/docs/ar/reference/data-types/date) و[**DateTime**](/docs/ar/reference/data-types/datetime) المختلفة. يوفّر ClickHouse مئات الدوال المفيدة التي يمكنك [استعراضها في قسم **الدوال**](/docs/ar/reference/functions/index).
لنتحقق من نجاح العملية:
```sql theme={null}
SELECT * FROM helloworld.my_first_table
```
### إضافة البيانات باستخدام ClickHouse Client
يمكنك أيضًا الاتصال بخدمة ClickHouse Cloud الخاصة بك باستخدام أداة سطر الأوامر [**clickhouse client**](/docs/ar/concepts/features/interfaces/cli). انقر على `Connect` في القائمة اليسرى للاطلاع على هذه التفاصيل. من مربع الحوار، اختر `Native` من القائمة المنسدلة:
1. ثبّت [ClickHouse](/docs/ar/concepts/features/interfaces/cli).
2. نفّذ الأمر، مع استبدال اسم المضيف واسم المستخدم وكلمة المرور بالقيم الخاصة بك:
```bash theme={null}
./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password
```
إذا ظهر لك رمز الوجه المبتسم، فأنت جاهز لتشغيل الاستعلامات!
```response theme={null}
:)
```
3. جرّب ذلك بتشغيل الاستعلام التالي:
```sql theme={null}
SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
```
لاحظ أن الاستجابة تظهر بتنسيق جدول أنيق:
```response theme={null}
┌─user_id─┬─message────────────────────────────────────────────┬───────────timestamp─┬──metric─┐
│ 102 │ Insert a lot of rows per batch │ 2022-03-21 00:00:00 │ 1.41421 │
│ 102 │ Sort your data based on your commonly-used queries │ 2022-03-22 00:00:00 │ 2.718 │
│ 101 │ Hello, ClickHouse! │ 2022-03-22 14:04:09 │ -1 │
│ 101 │ Granules are the smallest chunks of data read │ 2022-03-22 14:04:14 │ 3.14159 │
└─────────┴────────────────────────────────────────────────────┴─────────────────────┴─────────┘
4 rows in set. Elapsed: 0.008 sec.
```
4. أضِف عبارة [`FORMAT`](/docs/ar/reference/statements/select/format) لتحديد أحد [تنسيقات الإخراج العديدة التي يدعمها ClickHouse](/docs/ar/reference/formats/index):
```sql theme={null}
SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
FORMAT TabSeparated
```
في الاستعلام أعلاه، يُعاد الإخراج بتنسيق مفصول بعلامات الجدولة:
```response theme={null}
Query id: 3604df1c-acfd-4117-9c56-f86c69721121
102 Insert a lot of rows per batch 2022-03-21 00:00:00 1.41421
102 Sort your data based on your commonly-used queries 2022-03-22 00:00:00 2.718
101 Hello, ClickHouse! 2022-03-22 14:04:09 -1
101 Granules are the smallest chunks of data read 2022-03-22 14:04:14 3.14159
4 rows in set. Elapsed: 0.005 sec.
```
5. للخروج من `clickhouse client`، اكتب الأمر **exit**:
```bash theme={null}
exit
```
### رفع ملف
من المهام الشائعة عند البدء باستخدام قاعدة البيانات إدراج بيانات موجودة لديك في ملفات. لدينا بعض
بيانات نموذجية متاحة على الإنترنت يمكنك إدراجها، وهي تمثل بيانات تدفق النقرات - تتضمن معرّف المستخدم، وURL الذي جرت زيارته،
والطابع الزمني للحدث.
لنفترض أن لدينا النص التالي في ملف CSV يُسمى `data.csv`:
```bash title="data.csv" theme={null}
102,This is data in a file,2022-02-22 10:43:28,123.45
101,It is comma-separated,2022-02-23 00:00:00,456.78
103,Use FORMAT to specify the format,2022-02-21 10:43:30,678.90
```
1. يُدرِج الأمر التالي البيانات في `my_first_table`:
```bash theme={null}
./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password \
--query='INSERT INTO helloworld.my_first_table FORMAT CSV' < data.csv
```
2. لاحظ أن الصفوف الجديدة تظهر الآن في الجدول عند الاستعلام من SQL Console:
**تصفية قائمة الوصول لعناوين IP**
قبل المتابعة، نوصي بإعداد تصفية قائمة الوصول لعناوين IP.
راجع ["إعداد عوامل تصفية IP"](/docs/ar/products/cloud/guides/security/connectivity/setting-ip-filters) لمزيد من التفاصيل.
## ما التالي؟
* يوضّح لك [الدليل العملي](/docs/get-started/quickstarts/tutorial) كيفية إدراج مليوني صف في جدول وكتابة بعض الاستعلامات التحليلية
* لدينا قائمة من [مجموعات البيانات التجريبية](/docs/ar/get-started/sample-datasets/index) مع إرشادات حول كيفية إدراجها
* اطّلع على الفيديو الخاص بنا ومدته 12 دقيقة حول [البدء باستخدام ClickHouse](https://clickhouse.com/company/events/getting-started-with-clickhouse/)
* إذا كانت بياناتك تأتي من مصدر خارجي، فاطّلع على [مجموعة أدلة التكامل](/docs/ar/integrations/home) الخاصة بنا للاتصال بطوابير الرسائل وقواعد البيانات وخطوط المعالجة وغير ذلك
* إذا كنت تستخدم أداة تصور UI/BI، فاطّلع على [أدلة المستخدم لتوصيل واجهة مستخدم بـ ClickHouse](/docs/ar/integrations/connectors/data-visualization/index)
* يقدّم دليل المستخدم حول [المفاتيح الأساسية](/docs/ar/guides/clickhouse/data-modelling/sparse-primary-indexes) كل ما تحتاج إلى معرفته عن المفاتيح الأساسية وكيفية تعريفها