> ## 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.

> دليل خطوة بخطوة لإنشاء أول ClickPipe في Google Cloud Storage.

# إنشاء أول ClickPipe في GCS

يوفّر ClickPipe لـ GCS طريقة مُدارة بالكامل وموثوقة لإدخال البيانات من Google Cloud Storage ‏(GCS). وهو يدعم كلاً من **الإدخال لمرة واحدة** و**الإدخال المستمر** مع ضمان المعالجة مرة واحدة فقط.

<Steps>
  <Step title="اختر مصدر البيانات" id="1-select-the-data-source">
    **1.** في ClickHouse Cloud، اختر **مصادر البيانات** من قائمة التنقل الرئيسية ثم انقر على **Create ClickPipe**.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step0.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=fb04bb07245be43cb784fa68cee62287" alt="اختيار الواردات" width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.webp" />
    </Frame>

    **2.** انقر على بطاقة **Google Cloud Storage**.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=b9e0d4154a6e96f7acb595c81f988c15" alt="حدّد الواردات" width="3016" height="952" data-path="images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp" />
    </Frame>
  </Step>

  <Step title="إعداد اتصال ClickPipe" id="2-setup-your-clickpipe-connection">
    **1.** لإعداد ClickPipe جديد، يجب تقديم تفاصيل الاتصال بخدمة التخزين الكائني وكيفية المصادقة عليها.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=3da74887fe8ea9aa9c0c2b4ba67e8c7c" alt="أدخل تفاصيل الاتصال" width="3014" height="1428" data-path="images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp" />
    </Frame>

    * **مسار ملف GCS**: يستخدم ClickPipe الخاص بـ GCS [واجهة XML](https://docs.cloud.google.com/storage/docs/interoperability) في Cloud Storage لتحقيق التوافق البيني، ما يتطلب endpoint ‏`storage.googleapis.com`:

      ```bash theme={null}
      https://storage.googleapis.com/bucket-name/key-name
      ```

      يمكنك استخدام wildcards الخاصة بـ POSIX لمطابقة عدة ملفات أو بادئات. راجع [الوثائق المرجعية](/docs/ar/integrations/clickpipes/object-storage/google-cloud-storage/overview#file-pattern-matching) للاطلاع على إرشادات بشأن الأنماط المدعومة.

    **2.** انقر على **البيانات الواردة**. سيجلب ClickPipes البيانات الوصفية من الحاوية تمهيدًا للخطوة التالية.
  </Step>

  <Step title="اختر تنسيق البيانات" id="3-select-data-format">
    ستعرض واجهة المستخدم قائمة بالملفات في الـ bucket المحدد.
    اختر تنسيق البيانات (ندعم حاليًا مجموعة فرعية من تنسيقات ClickHouse)، وحدد ما إذا كنت تريد تمكين الاستيعاب المستمر.
    راجع قسم "الاستيعاب المستمر" في صفحة النظرة العامة لمزيد من التفاصيل.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=e3c03fbaec5b6db3810a4380343c42b9" alt="تعيين تنسيق البيانات والموضوع" width="2336" height="1566" data-path="images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp" />
    </Frame>
  </Step>

  <Step title="كوّن الجدول والمخطط والإعدادات" id="5-configure-table-schema-settings">
    في الخطوة التالية، يمكنك اختيار ما إذا كنت تريد استيعاب البيانات في ClickHouse table جديد أو إعادة استخدام جدول موجود.
    اتبع الإرشادات الظاهرة على الشاشة لتعديل اسم الجدول والمخطط والإعدادات.
    يمكنك رؤية معاينة فورية لتغييراتك في جدول العينة في الأعلى.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4a.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=e0cdb9469f6867e897cc77541af7f59b" alt="تعيين الجدول والمخطط والإعدادات" width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.webp" />
    </Frame>

    يمكنك أيضًا تخصيص الإعدادات المتقدمة باستخدام عناصر التحكم المتاحة.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4a3.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=db7cb839e136d26563b239937f029c7a" alt="تعيين عناصر التحكم المتقدمة" width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a3.webp" />
    </Frame>

    بدلًا من ذلك، يمكنك اختيار استيعاب بياناتك في ClickHouse table موجود.
    في هذه الحالة، ستتيح لك واجهة المستخدم تعيين الحقول من المصدر إلى حقول ClickHouse في جدول الوجهة المحدد.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4b.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=a5cb66aa9b3855c5d53b340dbd89b108" alt="استخدام جدول موجود" width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.webp" />
    </Frame>

    <Info>
      يمكنك أيضًا تعيين [الأعمدة الافتراضية](/docs/ar/reference/functions/table-functions/s3#virtual-columns)، مثل `_path` أو `_size`، إلى الحقول.
    </Info>
  </Step>

  <Step title="كوّن الأذونات" id="6-configure-permissions">
    أخيرًا، يمكنك تكوين الأذونات للمستخدم الداخلي الخاص بـ ClickPipes.

    **الأذونات:** سينشئ ClickPipes مستخدمًا مخصصًا لكتابة البيانات إلى جدول الوجهة. يمكنك اختيار دور لهذا المستخدم الداخلي باستخدام دور مخصص أو أحد الأدوار المعرفة مسبقًا:

    * `Full access`: وصول كامل إلى العنقود. وهو مطلوب إذا كنت تستخدم `materialized view` أو Dictionary مع جدول الوجهة.
    * `Only destination table`: أذونات `INSERT` على جدول الوجهة فقط.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step5.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=71ea5baaa2c38fcc83b160f4856264ab" alt="الأذونات" width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.webp" />
    </Frame>
  </Step>

  <Step title="أكمل الإعداد" id="7-complete-setup">
    بالنقر على "Complete Setup"، سيسجل النظام ClickPipe الخاص بك، وستتمكن من رؤيته مدرجًا في جدول الملخص.

    <div className="ch-image-sm">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_success.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=ce045b4a85e7f294d23c03897e9ce11f" alt="إشعار النجاح" width="613" height="212" data-path="images/integrations/data-ingestion/clickpipes/cp_success.webp" />
      </Frame>
    </div>

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_remove.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=83b452ee5d8017da1b1c0d50cf8a491d" alt="إشعار الإزالة" width="2756" height="1320" data-path="images/integrations/data-ingestion/clickpipes/cp_remove.webp" />
    </Frame>

    يوفر جدول الملخص عناصر تحكم لعرض بيانات عينة من المصدر أو من جدول الوجهة في ClickHouse.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_destination.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=cb3ebed0c324cb30c6cbf35726b3bec7" alt="عرض الوجهة" width="2758" height="1316" data-path="images/integrations/data-ingestion/clickpipes/cp_destination.webp" />
    </Frame>

    كما يوفر عناصر تحكم لإزالة ClickPipe وعرض ملخص لمهمة الاستيعاب.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_overview.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=1ce91f5079842cfc66a4c88919f2e061" alt="عرض النظرة العامة" width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.webp" />
    </Frame>

    **تهانينا!** لقد أعددت أول ClickPipe بنجاح.
    إذا كان ClickPipe هذا مُكوّنًا للاستيعاب المستمر، فسيظل قيد التشغيل باستمرار، مع استيعاب البيانات في الوقت الفعلي من مصدر البيانات البعيد.
    وإلا فسيستوعب الدفعة ثم يكتمل.
  </Step>
</Steps>