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

> Looker هي منصة مؤسسية لذكاء الأعمال (BI) وتطبيقات البيانات والتحليلات المضمّنة، وتساعدك على استكشاف الرؤى ومشاركتها في الوقت الفعلي.

# Looker

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            تكامل شريك
        </div>;
};

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

يمكن لـ Looker الاتصال بـ ClickHouse Cloud أو بنشر داخل البنية التحتية المحلية عبر مصدر بيانات ClickHouse الرسمي.

<div id="1-gather-your-connection-details">
  ## 1. اجمع تفاصيل الاتصال الخاصة بك
</div>

للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية:

| المعلمات                  | الوصف                                                                                         |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS.                       |
| `DATABASE NAME`           | افتراضيًا، توجد قاعدة بيانات باسم `default`. استخدم اسم قاعدة البيانات التي تريد الاتصال بها. |
| `USERNAME` and `PASSWORD` | افتراضيًا، يكون اسم المستخدم `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك.     |

تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
حدِّد خدمة ثم انقر على **Connect**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" size="md" alt="زر Connect لخدمة ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

اختر **HTTPS**. ستظهر تفاصيل الاتصال في مثال لأمر `curl`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" size="md" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال.

<div id="2-create-a-clickhouse-data-source">
  ## 2. أنشئ مصدر بيانات ClickHouse
</div>

انتقل إلى Admin -> Database -> Connections وانقر على زر "Add Connection" في الزاوية العلوية اليمنى.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/m3SFJgFQv2eos7Pa/images/integrations/data-visualization/looker_01.png?fit=max&auto=format&n=m3SFJgFQv2eos7Pa&q=85&s=2cb9055da33c237421990fa5e6d50599" alt="إضافة اتصال جديد في واجهة Looker لإدارة قواعد البيانات" border width="1401" height="963" data-path="images/integrations/data-visualization/looker_01.png" />

<br />

اختر اسمًا لمصدر البيانات، وحدد `ClickHouse` من القائمة المنسدلة الخاصة بلهجة SQL. ثم أدخل بيانات الاعتماد في النموذج.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/m3SFJgFQv2eos7Pa/images/integrations/data-visualization/looker_02.png?fit=max&auto=format&n=m3SFJgFQv2eos7Pa&q=85&s=c0278cb656af4e695d75e32ae48de844" alt="تحديد بيانات اعتماد ClickHouse في نموذج اتصال Looker" border width="1454" height="1115" data-path="images/integrations/data-visualization/looker_02.png" />

<br />

إذا كنت تستخدم ClickHouse Cloud أو كان إعداد النشر لديك يتطلب SSL، فتأكد من تمكين SSL ضمن الإعدادات الإضافية.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/m3SFJgFQv2eos7Pa/images/integrations/data-visualization/looker_03.png?fit=max&auto=format&n=m3SFJgFQv2eos7Pa&q=85&s=481af23d9cb722e2e747b50b28ee9056" alt="تمكين SSL لاتصال ClickHouse في إعدادات Looker" border width="1443" height="1116" data-path="images/integrations/data-visualization/looker_03.png" />

<br />

اختبر الاتصال أولًا، ثم بعد اكتمال الاختبار اتصل بمصدر بيانات ClickHouse الجديد.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/m3SFJgFQv2eos7Pa/images/integrations/data-visualization/looker_04.png?fit=max&auto=format&n=m3SFJgFQv2eos7Pa&q=85&s=e9d3e2f6e06870a6b7b9f1cf71e8074b" alt="اختبار الاتصال والاتصال بمصدر بيانات ClickHouse" border width="1728" height="1210" data-path="images/integrations/data-visualization/looker_04.png" />

<br />

يمكنك الآن ربط مصدر بيانات ClickHouse بمشروع Looker الخاص بك.

<div id="3-known-limitations">
  ## 3. القيود المعروفة
</div>

1. تُعامَل أنواع البيانات التالية كسلاسل نصية افتراضيًا:
   * Array - لا يعمل التسلسل كما هو متوقع بسبب قيود JDBC مشغّل
   * Decimal\* - يمكن تغييره إلى number في النموذج
   * LowCardinality(...) - يمكن تغييره إلى نوع مناسب في النموذج
   * Enum8, Enum16
   * UUID
   * Tuple
   * Map
   * JSON
   * Nested
   * FixedString
   * أنواع Geo
     * MultiPolygon
     * Polygon
     * Point
     * Ring
2. [ميزة التجميع المتماثل](https://cloud.google.com/looker/docs/reference/param-explore-symmetric-aggregates) غير مدعومة
3. [الربط الخارجي الكامل](https://cloud.google.com/looker/docs/reference/param-explore-join-type#full_outer) غير مُنفَّذ بعد في المشغّل