> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> دليل خطوة بخطوة لإنشاء أول Amazon S3 ClickPipe.

# إنشاء أول Amazon S3 ClickPipe

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const props_0 = undefined

export const provider_0 = "s3"

يوفّر S3 ClickPipe طريقة مُدارة بالكامل وموثوقة لإدخال البيانات من Amazon S3 ومخازن الكائنات المتوافقة مع S3 إلى ClickHouse Cloud. وهو يدعم كلاً من **الإدخال لمرة واحدة** و**الإدخال المستمر** مع ضمان المعالجة مرة واحدة فقط.

<Steps>
  <Step>
    ## اختر مصدر البيانات

    **1.** في ClickHouse Cloud، اختر **مصادر البيانات** من قائمة التنقل الرئيسية، ثم انقر على **Create ClickPipe**.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=3a59ce71568eecec94d17e9947e9d2ea" alt="اختر الواردات" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.png" />

    {props_0.provider_0 === 's3' && <S3DataSource />}

    {props_0.provider_0 === 'gcs' && <GCSSDataSource />}
  </Step>

  <Step>
    ## أعدّ اتصال ClickPipe الخاص بك

    **1.** لإعداد ClickPipe جديد، يجب إدخال تفاصيل الاتصال بخدمة تخزين الكائنات والمصادقة عليها.

    {props_0.provider_0 === 's3' && <S3Connection />}

    {props_0.provider_0 === 'gcs' && <GCSConnection />}

    **2.** انقر على **Incoming data**. سيجلب ClickPipes البيانات الوصفية من الـ bucket للخطوة التالية.
  </Step>

  <Step>
    ## اختر تنسيق البيانات

    ستعرض واجهة المستخدم قائمة بالملفات الموجودة في الـ bucket المحدد.
    اختر تنسيق بياناتك (ندعم حاليًا مجموعة فرعية من تنسيقات ClickHouse)، وحدد ما إذا كنت تريد تمكين الاستيعاب المستمر.
    راجع قسم "الاستيعاب المستمر" في صفحة النظرة العامة لمزيد من التفاصيل.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=254adde2855ecdbff1de4aa7229eb6a4" alt="عيّن تنسيق البيانات والموضوع" size="lg" border width="2336" height="1566" data-path="images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png" />
  </Step>

  <Step>
    ## اضبط الجدول والمخطط والإعدادات

    في الخطوة التالية، يمكنك اختيار ما إذا كنت تريد استيعاب البيانات إلى جدول ClickHouse جديد أو إعادة استخدام جدول موجود.
    اتبع الإرشادات الظاهرة على الشاشة لتعديل اسم الجدول والمخطط والإعدادات.
    يمكنك رؤية معاينة فورية لتغييراتك في جدول العينة بالأعلى.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step4a.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=3c9883ec4227355722c6ed50a7cf8095" alt="عيّن الجدول والمخطط والإعدادات" size="lg" border width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step4a3.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=fd33708945057dfc2768f048f68ed8eb" alt="عيّن عناصر التحكم المتقدمة" size="lg" border width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a3.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step4b.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=b92de2472fc055d7f67143076f4f517b" alt="استخدم جدولًا موجودًا" size="lg" border width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.png" />

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

  <Step>
    ## اضبط الأذونات

    أخيرًا، يمكنك ضبط أذونات مستخدم ClickPipes الداخلي.

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_step5.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=a3503c69f33c008da51d63de4cf65e6a" alt="الأذونات" size="lg" border width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.png" />
  </Step>

  <Step>
    ## أكمل الإعداد

    عند النقر على "Complete Setup"، سيسجل النظام ClickPipe الخاص بك، وستتمكن من رؤيته مدرجًا في جدول الملخص.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_success.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=cee5f37a4686d3c921f1d1a4d7abaa59" alt="إشعار النجاح" size="sm" border width="613" height="212" data-path="images/integrations/data-ingestion/clickpipes/cp_success.png" />

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_remove.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=511ae0199b78cc29da0ebf8af899d7d0" alt="إشعار الإزالة" size="lg" border width="2756" height="1320" data-path="images/integrations/data-ingestion/clickpipes/cp_remove.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_destination.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=82d019381204d6bb4b81f5aa8aa73040" alt="عرض الوجهة" size="lg" border width="2758" height="1316" data-path="images/integrations/data-ingestion/clickpipes/cp_destination.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_overview.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=6d487bf61a638698b1d379862e72746b" alt="عرض النظرة العامة" size="lg" border width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.png" />

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