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

> كيفية ربط كتالوج بيانات لجداول Iceberg أو Delta في ClickHouse Cloud عبر واجهة مصادر البيانات.

# ربط كتالوج بيانات في ClickHouse Cloud

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>ميزة Beta</span>
        </a>;
};

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

<BetaBadge />

اربط ClickHouse Cloud بكتالوجات البيانات لديك للوصول إلى جداولك بتنسيق الجداول المفتوح. يمكنك إعداد الاتصالات من واجهة **مصادر البيانات**. وللإعداد باستخدام SQL، استخدم محرك قاعدة البيانات [`DataLakeCatalog`](/docs/ar/reference/engines/database-engines/datalake) في محرر SQL الذي تفضّله.

<Image img="https://mintcdn.com/private-7c7dfe99/NMEuR4JBQvfvT5BG/images/cloud/features/data-catalogs-ui.png?fit=max&auto=format&n=NMEuR4JBQvfvT5BG&q=85&s=23c85c7480fa5f37a9ab95aa2943fb10" size="md" alt="واجهة ClickHouse Cloud مع تكاملات كتالوجات البيانات" width="4944" height="2610" data-path="images/cloud/features/data-catalogs-ui.png" />

بعد الاتصال، تظهر جداول الكتالوج في وحدة تحكم SQL ضمن اسم قاعدة البيانات الذي تختاره. يمكنك الاستعلام عنها باستخدام ClickHouse SQL القياسي، وربطها بجداول [MergeTree](/docs/ar/reference/engines/table-engines/mergetree-family/mergetree)، واستخدامها كمصادر [للعروض المادية](/docs/ar/concepts/features/materialized-views).

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

قبل ربط كتالوج، تأكد مما يلي:

* **أذونات الخدمة.** تحتاج إلى الإذن `control-plane:service:manage` للوصول إلى صفحة **مصادر البيانات** وإضافة الكتالوجات.
* **خدمة قيد التشغيل.** إذا كانت الخدمة خاملة، فأيقظها من صفحة **مصادر البيانات** أو صفحة إعدادات الخدمة قبل ربط الكتالوجات أو عرض الكتالوجات المرتبطة.
* **بيانات اعتماد الكتالوج.** اجمع تفاصيل الاتصال الخاصة بنوع الكتالوج قبل فتح اللوحة المنبثقة. يستخدم كل كتالوج حقولًا وأساليب مصادقة مختلفة — راجع [إضافة اتصال الكتالوج](#add-your-catalog-connection) أدناه.

<div id="connect-your-catalog">
  ## الاتصال بالكتالوج
</div>

<Steps>
  <Step title="افتح اللوحة المنبثقة لكتالوج البيانات" id="open-data-catalog-flyout">
    1. اختر **مصادر البيانات** من شريط التنقل الأيسر.
    2. انقر على **+ إضافة كتالوج** إذا لم تكن قد أعددت أي مصادر بيانات بعد. وإلا، فانقر على **إضافة مصدر بيانات** > **إضافة كتالوج لبحيرة البيانات**.
    3. في اللوحة المنبثقة **ربط كتالوج البيانات**، اختر الكتالوج من القائمة المنسدلة **اختيار كتالوج**. إذا كان الكتالوج يدعم عدة تنسيقات جداول مفتوحة، فاختر التنسيق من **تنسيق الجدول المفتوح**.

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-flyout-select.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=d9db0300502c5a3504848e707b5030bd" alt="اللوحة المنبثقة «ربط كتالوج البيانات» مع القائمة المنسدلة «اختيار كتالوج» التي تعرض AWS Glue وBigLake Metastore وMicrosoft OneLake وPolaris وREST Catalog وUnity Catalog" size="lg" width="4490" height="2842" data-path="images/integrations/data-catalogs/catalog-flyout-select.png" />
  </Step>

  <Step title="أضف اتصالاً بالكتالوج الخاص بك" id="add-your-catalog-connection">
    حدّد الـ catalog الخاص بك أدناه للحصول على الإرشادات والمتطلبات المسبقة، ثم أدخل معاملات الـ connection، إلى جانب **Database name** — وهي قاعدة بيانات ClickHouse التي تعرض جداول الـ catalog الخاصة بك في SQL console.

    <Tabs>
      <Tab title="AWS Glue" id="aws-glue">
        [كتالوج AWS Glue](/docs/ar/guides/use-cases/data-warehousing/glue-catalog) يعرض جداول [Iceberg](/docs/ar/reference/engines/table-engines/integrations/iceberg) المسجَّلة في Glue Data Catalog.

        قبل الاتصال، تأكد مما يلي:

        * استخدام الإصدار 25.12 أو أحدث من ClickHouse.
        * أن جداول Iceberg مسجَّلة في AWS Glue Data Catalog ضمن المنطقة الهدف.
        * للمصادقة بمفتاح الوصول، أن لديك مفتاح وصول لمستخدم IAM يمتلك أذونات لقراءة بيانات Glue الوصفية وكائنات S3 الأساسية.
        * للمصادقة بدور IAM ‏(26.2+)، أن لديك دور IAM يثق بدور خدمة ClickHouse لديك. أدرج ARN دور الخدمة من **Settings → Network security information** في سياسة الثقة للدور. راجع [الوصول الآمن إلى بيانات Iceberg](/docs/ar/products/cloud/guides/data-sources/accessing-iceberg-data-securely) للاطلاع على أمثلة لسياسات IAM.

        في اللوحة المنبثقة، أدخل **Region** الخاصة بـ AWS (مثل `us-west-2`)، ثم اختر طريقة المصادقة:

        **المصادقة بمفتاح الوصول**

        1. اختر **AWS Access Key** كـ **Authentication method**.
        2. أدخل **Access Key ID** و**Secret Access Key**.
        3. أدخل **Database name** لقاعدة بيانات ClickHouse التي تعرض جداول Glue لديك.

        **المصادقة بدور IAM ‏(26.2+)**

        1. اختر **AWS IAM Role** كـ **Authentication method**.
        2. انسخ **Service role ID (IAM)** من اللوحة المنبثقة وأضِفه إلى سياسة الثقة الخاصة بدور IAM.
        3. أدخل **AWS Role ARN**، وأدخل **AWS Role Session Name** اختياريًا.
        4. أدخل **Database name** لقاعدة بيانات ClickHouse التي تعرض جداول Glue لديك.

        <Note>
          يدعم Glue تنسيقات جداول متعددة، لكن ClickHouse لا يقرأ من Glue سوى جداول **Iceberg**.
        </Note>
      </Tab>

      <Tab title="Unity Catalog ‏(Iceberg)" id="unity-iceberg">
        استعلم عن جداول [Iceberg](/docs/ar/reference/engines/table-engines/integrations/iceberg) في Unity Catalog التي تستخدم مواقع تخزين خارجية، باستخدام بيانات اعتماد عميل OAuth الخاصة بـ service principal في Databricks. راجع [دليل Unity Catalog](/docs/ar/guides/use-cases/data-warehousing/unity-catalog#read-iceberg) للاطلاع على الإعداد الكامل.

        قبل الاتصال، تأكد من الآتي:

        * استخدام ClickHouse بالإصدار 25.12 أو أحدث.
        * [تكوين Unity Catalog للوصول إلى البيانات الخارجية](https://docs.databricks.com/aws/en/external-access/admin).
        * وجود [service principal](https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m) في Databricks لديه معرّف عميل OAuth وsecret. ويجب أن يمتلك service principal امتيازات `USE CATALOG` و`USE SCHEMA` و`USE EXTERNAL SCHEMA` و`SELECT` على الجداول التي تريد الاستعلام عنها.

        في flyout:

        1. أدخل **Workspace URL** الخاص بـ Databricks (مثل `dbc-1234567a-cbde.cloud.databricks.com`).
        2. أدخل **اسم catalog في Databricks** الذي تريد الاتصال به (مثل `icebench`).
        3. أدخل **Client ID** و**Client secret** الخاصين بـ OAuth لـ service principal لديك.
        4. أدخل **Database name** لقاعدة بيانات ClickHouse التي تتيح الوصول إلى جداول Unity Catalog.
      </Tab>

      <Tab title="Unity Catalog (دلتا)" id="unity-delta">
        استعلم عن جداول Unity Catalog بتنسيق [Delta Lake](/docs/ar/reference/engines/table-engines/integrations/deltalake) التي تستخدم مواقع تخزين خارجية، باستخدام رمز وصول شخصي (PAT) من Databricks. راجع [دليل Unity Catalog](/docs/ar/guides/use-cases/data-warehousing/unity-catalog#read-delta) للاطلاع على خطوات الإعداد الكاملة.

        قبل الاتصال، تأكد مما يلي:

        * استخدام ClickHouse بالإصدار 25.12 أو أحدث.
        * [تهيئة Unity Catalog للوصول إلى البيانات الخارجية](https://docs.databricks.com/aws/en/external-access/admin).
        * توفر [رمز وصول شخصي](https://docs.databricks.com/aws/en/dev-tools/auth/pat) من Databricks يتضمن، كحد أدنى، أذونات `EXTERNAL USE SCHEMA` و`USE CATALOG` و`USE SCHEMA` و`SELECT` على الجداول الهدف.

        في اللوحة المنبثقة:

        1. أدخل **URL مساحة العمل** في Databricks (مثل: `dbc-1234567a-cbde.azuredatabricks.net`).
        2. أدخل **اسم كتالوج Databricks** الذي تريد الاتصال به.
        3. أدخل **رمز الوصول الشخصي**.
        4. أدخل **اسم قاعدة بيانات** لقاعدة بيانات ClickHouse التي تعرض جداول Delta.

        <Note>
          يستخدم Iceberg وDelta أساليب مصادقة مختلفة في واجهة المستخدم. لذلك، ستحتاج إلى قاعدتي بيانات منفصلتين في ClickHouse للوصول إلى كلا نوعَي الجداول.
        </Note>
      </Tab>

      <Tab title="كتالوج REST" id="rest">
        اتصل بأي كتالوج يطبّق مواصفة [Iceberg REST Catalog](https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml). راجع [دليل REST catalog](/docs/ar/guides/use-cases/data-warehousing/rest-catalog) للاطلاع على خطوات الإعداد الكاملة.

        قبل الاتصال، تأكد مما يلي:

        * استخدام الإصدار 25.12+ من ClickHouse.
        * إمكانية الوصول إلى نقطة نهاية REST catalog من ClickHouse Cloud.
        * توفّر بيانات اعتماد عميل OAuth أو رمز حامل، وفقًا لإعدادات الكتالوج.
        * توفّر عنوان URI لـ **Storage Endpoint** خاص بـ S3 أو متوافق معه لبيانات الجداول (مثل `s3://my-bucket/path`).

        في اللوحة المنبثقة:

        1. أدخل **Catalog URL** (مثل `https://catalog.example.com/v1`).
        2. أدخل **Warehouse** أو مساحة أسماء الكتالوج (مثل `demo`).
        3. أدخل بادئة عنوان URI لـ **Storage Endpoint** لتخزين الجداول.
        4. اختر **Authentication method**: **OAuth Client Credentials** أو **Bearer Token**، ثم أدخل بيانات الاعتماد المناسبة.
        5. أدخل **Database name** لقاعدة بيانات ClickHouse التي تعرض جداول REST catalog الخاصة بك.
      </Tab>

      <Tab title="Microsoft OneLake" id="onelake">
        استعلم عن جداول [Iceberg](/docs/ar/reference/engines/table-engines/integrations/iceberg) في Microsoft Fabric OneLake باستخدام بيانات اعتماد تطبيق Azure AD. راجع [دليل Fabric OneLake](/docs/ar/guides/use-cases/data-warehousing/onelake-catalog) لإتمام الإعداد بالكامل.

        قبل الاتصال، تأكد مما يلي:

        * استخدام الإصدار 25.12 أو أحدث من ClickHouse.
        * وجود جداول Iceberg في مساحة عمل Fabric.
        * وجود تطبيق Entra ID ‏(Azure AD) لديك، مع معرّف العميل والسر.
        * توفّر معرّف المستأجر ومعرّف مساحة العمل ومعرّف عنصر البيانات لديك. استخدم **معرّف Lakehouse** الوارد في URL صفحة Lakehouse. راجع [المتطلبات المسبقة لـ Microsoft OneLake](https://learn.microsoft.com/en-us/fabric/onelake/table-apis/table-apis-overview#prerequisites) للمساعدة في العثور على هذه القيم.

        في اللوحة المنبثقة:

        1. أدخل **معرّف مساحة عمل** Fabric.
        2. أدخل **معرّف عنصر البيانات** — استخدم معرّف Lakehouse الخاص بك. لا تُدعم معرّفات Warehouse.
        3. أدخل **معرّف المستأجر** في Entra ID، و**معرّف التطبيق (العميل)**، و**سر العميل**.
        4. أدخل **اسم قاعدة بيانات** لقاعدة بيانات ClickHouse التي تتيح الوصول إلى جداول OneLake.
      </Tab>

      <Tab title="Polaris" id="polaris">
        اتصل بتوزيع Snowflake Open Catalog ‏(Polaris) لجداول [Iceberg](/docs/ar/reference/engines/table-engines/integrations/iceberg). راجع [دليل Polaris catalog](/docs/ar/guides/use-cases/data-warehousing/polaris-catalog) لإتمام الإعداد.

        قبل الاتصال، تأكد من الآتي:

        * إصدار ClickHouse ‏26.2+.
        * لديك Polaris catalog وبيانات اعتماد عميل OAuth.
        * لديك عنوان URI لنقطة نهاية التخزين لبيانات جدول Iceberg (مثلًا `s3://company-iceberg-prod/warehouse/`).

        في اللوحة المنبثقة:

        1. أدخل **معرّف حساب Catalog** (مثلًا `ab12345.snowflakecomputing.com`).
        2. أدخل **اسم Catalog** (مثلًا `snowflake_open_catalog`).
        3. أدخل **معرّف عميل OAuth** و**سر العميل**.
        4. أدخل بادئة عنوان URI لـ **نقطة نهاية التخزين** الخاصة بتخزين الجداول.
        5. أدخل **اسم قاعدة بيانات** لقاعدة بيانات ClickHouse التي تتيح الوصول إلى جداول Polaris الخاصة بك.
      </Tab>

      <Tab title="BigLake Metastore" id="biglake">
        اتصل بـ Google Cloud BigLake Metastore (المعروف أيضًا باسم Lakehouse runtime catalog) لجداول [Iceberg](/docs/ar/reference/engines/table-engines/integrations/iceberg) في GCS. راجع [دليل BigLake Metastore](/docs/ar/guides/use-cases/data-warehousing/biglake-catalog) للاطلاع على خطوات الإعداد الكاملة.

        قبل الاتصال، تأكد مما يلي:

        * استخدام الإصدار 26.2+ من ClickHouse.
        * وجود مثيل BigLake Metastore يتضمن جداول Iceberg في GCS.
        * توفّر بيانات اعتماد Google Application Default Credentials ‏(ADC)، بما في ذلك معرّف العميل وسر العميل ورمز التحديث ومعرّف مشروع الحصة.

        في اللوحة المنبثقة:

        1. أدخل **Google ADC Client ID** و**Client Secret** و**Refresh Token** و**Quota Project ID**.
        2. أدخل عنوان URI لـ **Cloud Storage Bucket** الذي يحتوي على بيانات الجدول (مثل `gs://biglake-public-nyc-taxi-iceberg`).
        3. أدخل **Database name** لقاعدة بيانات ClickHouse التي تتيح الوصول إلى جداول BigLake الخاصة بك.
      </Tab>
    </Tabs>
  </Step>

  <Step title="احفظ الاتصال" id="save-connection">
    بعد ملء الحقول:

    1. انقر على **Add catalog**. يتحقق ClickHouse من الاتصال وبيانات الاعتماد عند الحفظ.
    2. عند نجاح العملية، يظهر إشعار تأكيد يتضمن رابط **View in SQL console**. يُدرج الكتالوج في جدول **Linked catalogs** مع حالة اتصاله وعدد الجداول فيه.

    من قائمة **Actions** في صف كتالوج مرتبط، يمكنك حذف اتصال الكتالوج. يؤدي الحذف إلى إزالة قاعدة بيانات الكتالوج من ClickHouse، لكنه لا يحذف أي بيانات من الكتالوج الخارجي.
  </Step>
</Steps>

<div id="query-data">
  ## الاستعلام عن بياناتك
</div>

<Steps>
  <Step title="عرض جداول الكتالوج" id="view-tables">
    في صفحة **مصادر البيانات**، ابحث عن الكتالوج الخاص بك في جدول **الكتالوجات المرتبطة**، ثم انقر على **عرض الجداول**.

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/linked-catalogs-table.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=0a1cc4e94f2ef096d9db5e5edf8699b6" alt="جدول الكتالوجات المرتبطة مع إجراء عرض الجداول" size="lg" width="3510" height="868" data-path="images/integrations/data-catalogs/linked-catalogs-table.png" />

    يفتح ClickHouse وحدة تحكم SQL مع تحديد قاعدة بيانات الكتالوج، ويعرض الجداول المتاحة.

    <Note>
      قد لا تظهر الجداول فورًا بعد الاتصال بكتالوج. وقد يستغرق إدراج جميع الجداول، حسب الكتالوج، ما يصل إلى 3 دقائق.
    </Note>

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-tables-browser.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=659600c739c761d3154018e338596fa6" alt="مستعرض الجداول في وحدة تحكم SQL يعرض جداول الكتالوج" size="lg" width="3560" height="1578" data-path="images/integrations/data-catalogs/catalog-tables-browser.png" />
  </Step>

  <Step title="تشغيل استعلام" id="run-a-query">
    اكتب استعلامًا في محرر SQL وانقر على **تشغيل**. ضع اسم الجدول الكامل بين علامتَي الاقتباس العكسيتين:

    ```sql theme={null}
    SELECT * FROM `identity_profiles.identity_profiles_iceberg`
    ```

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-sql-query.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=79bfd73f1b475795f1fd0e3c18950b50" alt="استعلام SQL مع نتائج يستخدم علامات الاقتباس العكسية لاسم جدول يحتوي على نقاط" size="lg" width="2810" height="1172" data-path="images/integrations/data-catalogs/catalog-sql-query.png" />
  </Step>
</Steps>

<div id="troubleshooting">
  ## استكشاف الأخطاء وإصلاحها
</div>

* إذا لم تظهر جداولك في وحدة تحكم SQL، فتحقّق من بيانات الاعتماد وإمكانية الوصول إلى الشبكة وأنواع الجداول في الكتالوج. وتأكد من أن الجداول التي تتوقع ظهورها تستخدم تنسيقات الملفات والجداول المدعومة.

<div id="see-also">
  ## راجع أيضًا
</div>

* [تسريع التحليلات على بيانات lakehouse](/docs/ar/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) — تحميل جداول كتالوج إلى MergeTree للاستعلامات المتكررة
* [الوصول الآمن إلى بيانات Iceberg](/docs/ar/products/cloud/guides/data-sources/accessing-iceberg-data-securely) — إعداد IAM role للوصول إلى Iceberg وGlue على AWS