> ## 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 على BigQuery.

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

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>;
};

export const PrivatePreviewBadge = () => {
  return <div className="privatePreviewBadge">
            <div className="privatePreviewIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5.33301 6.66667V4.66667V4.66667C5.33301 3.194 6.52701 2 7.99967 2V2C9.47234 2 10.6663 3.194 10.6663 4.66667V4.66667V6.66667" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path d="M8.00033 9.33337V11.3334" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path fillRule="evenodd" clipRule="evenodd" d="M11.333 14H4.66634C3.92967 14 3.33301 13.4033 3.33301 12.6666V7.99996C3.33301 7.26329 3.92967 6.66663 4.66634 6.66663H11.333C12.0697 6.66663 12.6663 7.26329 12.6663 7.99996V12.6666C12.6663 13.4033 12.0697 14 11.333 14Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'معاينة خاصة في ClickHouse Cloud'}
        </div>;
};

<PrivatePreviewBadge />

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

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

يمكن نشر BigQuery ClickPipes وإدارتها يدويًا باستخدام واجهة ClickPipes UI، وكذلك برمجيًا باستخدام [OpenAPI](/docs/ar/integrations/clickpipes/programmatic-access/openapi) و[Terraform](/docs/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 الخاص بك، أو الاستعانة بمسؤول. نوصي بإنشاء حساب خدمة مخصص بأقل مجموعة مطلوبة من [الأذونات](/docs/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 title="اختر مصدر البيانات" id="1-select-the-data-source">
    **1.** في ClickHouse Cloud، اختر **Data sources** من قائمة التنقل الرئيسية، ثم انقر على **Create ClickPipe**.

    <Image img="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="اختر عمليات الاستيراد" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.webp" />

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

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

  <Step title="أعدّ اتصال ClickPipe الخاص بك" id="2-setup-your-clickpipe-connection">
    لإعداد ClickPipe جديد، يجب تقديم تفاصيل الاتصال بمخزن بيانات BigQuery والمصادقة عليه، بالإضافة إلى حاوية GCS مرحلية.

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

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

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

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

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

  <Step title="اضبط ClickPipe الخاص بك" id="3-configure-your-clickpipe">
    استنادًا إلى حجم مجموعة بيانات BigQuery لديك، أو الحجم الإجمالي للجداول التي تريد مزامنتها، قد تحتاج إلى تعديل إعدادات الاستيعاب الافتراضية لـ ClickPipe.
  </Step>

  <Step title="اضبط الجداول" id="4-configure-tables">
    **1.** اختر قاعدة بيانات ClickHouse التي تريد نسخ جداول BigQuery إليها. يمكنك اختيار قاعدة بيانات موجودة أو إنشاء قاعدة جديدة.

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

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

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

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

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

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

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

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

  <Step title="أكمل الإعداد" id="7-complete-setup">
    انقر على **Create ClickPipe** لإكمال الإعداد. ستتم إعادة توجيهك إلى صفحة النظرة العامة، حيث يمكنك متابعة تقدم التحميل الأولي والنقر للاطلاع على تفاصيل BigQuery ClickPipes الخاصة بك.

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