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

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

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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

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

<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.** انقر على بطاقة **Amazon S3**. يمكنك أيضًا استخدام هذه البطاقة للاتصال بخدمات أخرى متوافقة مع S3 وغير مُدرجة في واجهة مستخدم ClickPipes.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/object-storage/amazon-s3/cp_step1.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=5df9a6650380fcad80cc09d0324fff66" alt="اختر عمليات الاستيراد" width="3016" height="954" data-path="images/integrations/data-ingestion/clickpipes/object-storage/amazon-s3/cp_step1.webp" />
    </Frame>

    <Tip>
      نظرًا للاختلافات في تنسيقات عناوين URL وآليات تنفيذ واجهة برمجة التطبيقات بين موفري خدمات تخزين الكائنات، ليست كل الخدمات المتوافقة مع S3 مدعومة تلقائيًا. إذا واجهت مشكلات مع خدمة غير مُدرجة ضمن [مصادر البيانات المدعومة](/docs/ar/integrations/clickpipes/object-storage/amazon-s3/overview#supported-data-sources)، يُرجى [التواصل مع فريقنا](https://clickhouse.com/company/contact?loc=clickpipes).
    </Tip>
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/object-storage/amazon-s3/cp_step2.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=4b560decaf2b046c1ecd43fc4ace8902" alt="املأ تفاصيل الاتصال" width="3014" height="1402" data-path="images/integrations/data-ingestion/clickpipes/object-storage/amazon-s3/cp_step2.webp" />
    </Frame>

    * **طريقة المصادقة**: يدعم S3 ClickPipe [بيانات اعتماد IAM](/docs/ar/integrations/clickpipes/object-storage/amazon-s3/overview#iam-credentials) (`Credentials`) و[المصادقة المستندة إلى دور IAM](/docs/ar/integrations/clickpipes/object-storage/amazon-s3/overview#iam-role) (`IAM role`). راجع [الوثائق المرجعية](/docs/ar/integrations/clickpipes/object-storage/amazon-s3/overview#access-control) للحصول على إرشادات حول المصادقة والأذونات.

      * **مسار ملف S3**: يتوقع S3 ClickPipe [URI بأسلوب الاستضافة الافتراضية](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access).

        ```bash theme={null}
        https://bucket-name.s3.region-code.amazonaws.com/key-name
        ```

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

    **2.** انقر على **Incoming data**. سيجلب 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>