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

> دليل إرشادي خطوة بخطوة لإنشاء أول ClickPipe على BigQuery.

# إنشاء أول ClickPipe على BigQuery

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

<PrivatePreviewBadge />

<Note>
  يمكنك التسجيل في قائمة انتظار المعاينة الخاصة من [هنا](https://clickhouse.com/cloud/clickpipes/bigquery-connector).
</Note>

يوفّر BigQuery ClickPipe طريقة مُدارة بالكامل وموثوقة لإدخال البيانات من BigQuery إلى ClickHouse Cloud. وفي المعاينة الخاصة، يدعم أسلوب النسخ المتماثل عبر **التحميل الأولي** لمساعدتك على إجراء **تحميل مجمّع** لمجموعات بيانات BigQuery بهدف الاستكشاف وبناء النماذج الأولية. وسيجري دعم **CDC** في المستقبل — وحتى ذلك الحين، نوصي باستخدام [Google Cloud Storage ClickPipe](/ar/integrations/clickpipes/object-storage/google-cloud-storage/overview) لمزامنة بيانات BigQuery المُصدَّرة إلى ClickHouse Cloud بشكل مستمر بعد اكتمال **التحميل الأولي**.

يمكن نشر BigQuery ClickPipes وإدارتها يدويًا باستخدام واجهة ClickPipes UI، وكذلك برمجيًا باستخدام [OpenAPI](/ar/integrations/clickpipes/programmatic-access/openapi) و[Terraform](/ar/integrations/clickpipes/programmatic-access/terraform).

<div id="pre-requisites">
  ## المتطلبات المسبقة
</div>

* يجب أن تكون لديك امتيازات إدارة [حسابات الخدمة](https://docs.cloud.google.com/iam/docs/service-account-overview) و[أدوار IAM](https://docs.cloud.google.com/iam/docs/roles-overview) في مشروع GCP الخاص بك، أو الاستعانة بمسؤول. نوصي بإنشاء حساب خدمة مخصص بأقل مجموعة مطلوبة من [الأذونات](/ar/integrations/clickpipes/bigquery/overview#permissions)، وفقًا لـ[الوثائق الرسمية](https://docs.cloud.google.com/iam/docs/service-accounts-create).

* تتطلب عملية التحميل الأولي حاوية Google Cloud Storage ‏(GCS) يوفّرها المستخدم لأغراض التخزين المرحلي. نوصي بإنشاء حاوية مخصصة لـ ClickPipe الخاص بك وفقًا لـ[الوثائق الرسمية](https://docs.cloud.google.com/storage/docs/creating-buckets). مستقبلاً، ستُوفَّر الحاوية الوسيطة وتُدار بواسطة ClickPipes.

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

    **1.** في ClickHouse Cloud، اختر **Data sources** من قائمة التنقل الرئيسية، ثم انقر على **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" />

    **2.** انقر على لوحة **BigQuery**.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/bigquery/cp_step1.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=26a146fbc2fa0f74325dec0a36d42820" alt="اختر لوحة BigQuery" size="lg" border width="2680" height="1070" data-path="images/integrations/data-ingestion/clickpipes/bigquery/cp_step1.png" />
  </Step>

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

    لإعداد ClickPipe جديد، يجب تقديم تفاصيل الاتصال بمخزن بيانات BigQuery والمصادقة عليه، بالإضافة إلى حاوية GCS مرحلية.

    **1.** ارفع مفتاح `.json` الخاص بحساب الخدمة الذي أنشأته لـ ClickPipes. تأكد من أن حساب الخدمة يمتلك الحد الأدنى المطلوب من [الأذونات](/ar/integrations/clickpipes/bigquery/overview#permissions).

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/bigquery/cp_step2.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=033187eacbc1eba8ee770b064018b444" alt="ارفع مفتاح حساب الخدمة" size="lg" border width="2684" height="926" data-path="images/integrations/data-ingestion/clickpipes/bigquery/cp_step2.png" />

    **2.** اختر **Replication method**. في مرحلة Private Preview، الخيار المدعوم الوحيد هو [**Initial load only**](/ar/integrations/clickpipes/bigquery/overview#initial-load).

    **3.** أدخل مسار حاوية GCS لاستخدامها في تخزين البيانات مرحليًا أثناء التحميل الأولي.

    **4.** انقر على **Next** للتحقق.
  </Step>

  <Step>
    ## اضبط ClickPipe الخاص بك

    استنادًا إلى حجم مجموعة بيانات BigQuery لديك، أو الحجم الإجمالي للجداول التي تريد مزامنتها، قد تحتاج إلى تعديل إعدادات الاستيعاب الافتراضية لـ ClickPipe.
  </Step>

  <Step>
    ## اضبط الجداول

    **1.** اختر قاعدة بيانات ClickHouse التي تريد نسخ جداول BigQuery إليها. يمكنك اختيار قاعدة بيانات موجودة أو إنشاء قاعدة جديدة.

    **2.** اختر الجداول، وعند الحاجة الأعمدة، التي تريد نسخها. لن تظهر إلا مجموعات البيانات التي يملك حساب الخدمة المقدم صلاحية الوصول إليها.

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

    **3.** لكل جدول محدد، احرص على تحديد مفتاح فرز مخصص ضمن **Advanced settings** > **Use a custom sorting key**. مستقبلًا، سيُستدل على مفتاح الفرز تلقائيًا استنادًا إلى مفاتيح التجميع العنقودي أو مفاتيح التقسيم الموجودة في قاعدة البيانات الأصلية.

    <Warning>
      **يجب** تحديد [مفتاح فرز](/ar/concepts/best-practices/choosing-a-primary-key) للجداول المنسوخة لتحسين أداء الاستعلامات في ClickHouse. وإلا فسيُضبط مفتاح الفرز على `tuple()`، ما يعني عدم إنشاء فهرس أساسي، وسيُجري ClickHouse فحصًا كاملًا للجدول في جميع الاستعلامات عليه.
    </Warning>

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

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

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

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

    * `Full access`: وصول كامل إلى العنقود. مطلوب إذا كنت تستخدم العروض المادية أو القواميس مع الجدول الوجهة.
    * `Only destination`: أذونات إدراج إلى الجدول الوجهة فقط.
  </Step>

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

    انقر على **Create ClickPipe** لإكمال الإعداد. ستتم إعادة توجيهك إلى صفحة النظرة العامة، حيث يمكنك متابعة تقدم التحميل الأولي والنقر للاطلاع على تفاصيل BigQuery ClickPipes الخاصة بك.

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