> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > يمكن لـ Tableau استخدام قواعد بيانات وجداول ClickHouse كمصدر بيانات. # ربط Tableau بـ ClickHouse export const ClickHouseSupportedBadge = () => { return
متوافق مع ClickHouse
; }; export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; يوفّر ClickHouse موصل Tableau رسميًا، وهو مُدرج في [Tableau Exchange](https://exchange.tableau.com/products/1064). ويعتمد هذا الموصل على [برنامج تشغيل JDBC](/ar/integrations/language-clients/java/jdbc) المتقدّم الخاص بـ ClickHouse. باستخدام هذا الموصل، يتيح Tableau استخدام قواعد بيانات ClickHouse وجداولها كمصادر بيانات. لتمكين هذه الإمكانية، اتبع دليل الإعداد أدناه.
## الإعداد المطلوب قبل الاستخدام
1. اجمع تفاصيل الاتصال الخاصة بك للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية: | المعلمات | الوصف | | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | `HOST` and `PORT` | عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS. | | `DATABASE NAME` | افتراضيًا، توجد قاعدة بيانات باسم `default`. استخدم اسم قاعدة البيانات التي تريد الاتصال بها. | | `USERNAME` and `PASSWORD` | افتراضيًا، يكون اسم المستخدم `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك. | | تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console. | | | حدِّد خدمة ثم انقر على **Connect**: | | زر Connect لخدمة ClickHouse Cloud اختر **HTTPS**. ستظهر تفاصيل الاتصال في مثال لأمر `curl`. تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال. 2. نزّل وثبّت Tableau Desktop. 3. اتبع تعليمات `clickhouse-tableau-connector-jdbc` لتنزيل الإصدار المتوافق من ClickHouse برنامج تشغيل JDBC. تأكد من تنزيل ملف JAR ‏[clickhouse-jdbc-X.X.X-all-dependencies.jar](https://github.com/ClickHouse/clickhouse-java/releases). هذه الحزمة متاحة بدءًا من الإصدار `0.9.2`. 4. احفظ برنامج تشغيل JDBC في المجلد التالي (بحسب نظام التشغيل لديك، وإذا لم يكن المجلد موجودًا، يمكنك إنشاؤه): * macOS: `~/Library/Tableau/Drivers` * Windows: `C:\Program Files\Tableau\Drivers` 5. قم بتهيئة مصدر بيانات ClickHouse في Tableau وابدأ في إنشاء مرئيات البيانات!
## تكوين مصدر بيانات ClickHouse في Tableau
بعد تثبيت برنامج التشغيل `clickhouse-jdbc` وإعداده، لنرَ كيفية تعريف مصدر بيانات في Tableau يتصل بقاعدة البيانات **TPCD** في ClickHouse. 1. شغّل Tableau. (إذا كان قيد التشغيل بالفعل، فأعد تشغيله.) 2. من القائمة الجانبية اليسرى، انقر على **More** ضمن قسم **To a Server**. ابحث عن **ClickHouse by ClickHouse** في قائمة الموصّلات المتاحة: شاشة الاتصال في Tableau تعرض قائمة اختيار الموصّل مع تمييز خيار ClickHouse by ClickHouse
ألا ترى موصّل **ClickHouse by ClickHouse** في قائمة الموصّلات لديك؟ قد يكون ذلك مرتبطًا بإصدار قديم من Tableau Desktop. لحل هذه المشكلة، فكّر في ترقية تطبيق Tableau Desktop، أو [تثبيت الموصّل يدويًا](#install-the-connector-manually). 3. انقر على **ClickHouse by ClickHouse** وستظهر النافذة التالية: نافذة تثبيت موصّل Tableau تعرض تفاصيل موصّل ClickHouse JDBC وزر التثبيت
4. انقر على **Install and Restart Tableau**. ثم أعد تشغيل التطبيق. 5. بعد إعادة التشغيل، سيظهر الاسم الكامل للموصّل: `ClickHouse JDBC by ClickHouse, Inc.`. وعند النقر عليه، ستظهر النافذة التالية: نافذة اتصال ClickHouse في Tableau تعرض حقول الخادم والمنفذ وقاعدة البيانات واسم المستخدم وكلمة المرور
6. أدخل تفاصيل الاتصال الخاصة بك: | الإعداد | القيمة | | -------------- | -------------------------------------------------------- | | الخادم | **مضيف ClickHouse الخاص بك (من دون أي بادئات أو لواحق)** | | المنفذ | **8443** | | قاعدة البيانات | **default** | | اسم المستخدم | **default** | | كلمة المرور | \*\*\*\*\*\* | عند العمل مع ClickHouse Cloud، يجب تفعيل مربع اختيار SSL لإجراء اتصالات آمنة.
اسم قاعدة بيانات ClickHouse لدينا هو **TPCD**، لكن يجب ضبط **Database** على **default** في النافذة أعلاه، ثم اختيار **TPCD** في **Schema** في الخطوة التالية. (يرجّح أن يكون هذا بسبب خطأ في الموصّل، لذا قد يتغير هذا السلوك، ولكن في الوقت الحالي يجب عليك استخدام **default** كقاعدة بيانات.) 7. انقر على زر **Sign In** ويُفترض أن ترى مصنف Tableau جديدًا: مصنف Tableau جديد يعرض شاشة الاتصال الأولية مع خيارات اختيار قاعدة البيانات
8. اختر **TPCD** من القائمة المنسدلة **Schema** ويُفترض أن ترى قائمة الجداول في **TPCD**: اختيار المخطط في Tableau يعرض جداول قاعدة بيانات TPCD بما في ذلك CUSTOMER وLINEITEM وNATION وORDERS وغيرها
أصبحت الآن جاهزًا لإنشاء بعض المرئيات في Tableau!
## إنشاء المرئيات في Tableau
الآن بعد أن أصبح لدينا مصدر بيانات ClickHouse مُعَدًّا في Tableau، لنبدأ بتصور البيانات... 1. اسحب جدول **CUSTOMER** إلى المصنف. لاحظ أن الأعمدة تظهر، لكن جدول البيانات فارغ: مصنف Tableau مع سحب جدول CUSTOMER إلى اللوحة وعرض رؤوس الأعمدة من دون بيانات
2. انقر فوق الزر **Update Now**، وسيجري ملء الجدول بـ 100 صف من **CUSTOMER**. 3. اسحب جدول **ORDERS** إلى المصنف، ثم عيّن **Custkey** كحقل العلاقة بين الجدولين: محرر العلاقات في Tableau يعرض الربط بين جدولي CUSTOMER وORDERS باستخدام الحقل Custkey
4. أصبح لديك الآن الجدولان **ORDERS** و**LINEITEM** مرتبطين ببعضهما بعضًا ضمن مصدر البيانات، لذا يمكنك استخدام هذه العلاقة للإجابة عن أسئلة حول البيانات. حدِّد علامة التبويب **Sheet 1** في أسفل المصنف. ورقة عمل Tableau تعرض الأبعاد والمقاييس من جداول ClickHouse المتاحة للتحليل
5. لنفترض أنك تريد معرفة عدد العناصر المطلوبة في كل سنة. اسحب **OrderDate** من **ORDERS** إلى قسم **Columns** (الحقل الأفقي)، ثم اسحب **Quantity** من **LINEITEM** إلى **Rows**. سينشئ Tableau المخطط الخطي التالي: مخطط خطي في Tableau يعرض الكمية المطلوبة حسب السنة من بيانات ClickHouse
ليس هذا المخطط الخطي مثيرًا جدًا، لكن مجموعة البيانات أُنشئت بواسطة برنامج نصي وصُممت لاختبار أداء الاستعلامات، لذا ستلاحظ أنه لا توجد اختلافات كبيرة في الطلبات المُحاكاة ضمن بيانات TCPD. 6. لنفترض أنك تريد معرفة متوسط قيمة الطلب (بالدولار) حسب الربع السنوي وأيضًا حسب وسيلة الشحن (جوًا، بريدًا، سفينة، شاحنة، إلخ): * انقر علامة التبويب **New Worksheet** لإنشاء ورقة جديدة * اسحب **OrderDate** من **ORDERS** إلى **Columns** وغيّره من **Year** إلى **Quarter** * اسحب **Shipmode** من **LINEITEM** إلى **Rows** ينبغي أن ترى ما يلي: عرض جدولي متقاطع في Tableau مع الأرباع السنوية كأعمدة ووسائل الشحن كصفوف
7. قيم **Abc** تملأ المساحة فقط إلى أن تسحب مقياسًا إلى الجدول. اسحب **Totalprice** من \* *ORDERS*\* إلى الجدول. لاحظ أن العملية الحسابية الافتراضية هي **SUM** لـ **Totalprices**: جدول متقاطع في Tableau يعرض مجموع السعر الإجمالي حسب الربع السنوي ووسيلة الشحن
8. انقر على **SUM** وغيّر **Measure** إلى **Average**. ومن القائمة المنسدلة نفسها، حدِّد **Format** وغيّر **Numbers** إلى **Currency (Standard)**: جدول متقاطع في Tableau يعرض متوسط سعر الطلب حسب الربع السنوي ووسيلة الشحن مع تنسيق العملة
أحسنت! لقد نجحت في ربط Tableau بـ ClickHouse، وفتحت أمامك عالمًا كاملًا من الإمكانات لتحليل بيانات ClickHouse وتصورها.
## ثبّت الموصل يدويًا
إذا كنت تستخدم إصدارًا قديمًا من Tableau Desktop لا يتضمّن الموصل افتراضيًا، فيمكنك تثبيته يدويًا باتباع الخطوات التالية: 1. نزّل أحدث ملف taco من [Tableau Exchange](https://exchange.tableau.com/products/1064) 2. ضع ملف taco في * macOS: `~/Documents/My Tableau Repository/Connectors` * Windows: `C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors` 3. أعد تشغيل Tableau Desktop. إذا تم الإعداد بنجاح، فستجد الموصل ضمن قسم `New Data Source`.
## نصائح حول الاتصال والتحليل
لمزيد من الإرشادات حول تحسين تكامل Tableau-ClickHouse، يُرجى زيارة [نصائح الاتصال](/ar/integrations/connectors/data-visualization/tableau/tableau-connection-tips) و[نصائح التحليل](/ar/integrations/connectors/data-visualization/tableau/tableau-analysis-tips).
## الاختبارات
يُختبر الموصل باستخدام [إطار عمل TDVT](https://tableau.github.io/connector-plugin-sdk/docs/tdvt)، ويحقق حاليًا معدل تغطية بنسبة 97%.
## الخلاصة
يمكنك ربط Tableau بـ ClickHouse باستخدام برنامج التشغيل العام لـ ClickHouse عبر ODBC/JDBC. ومع ذلك، يعمل هذا الموصل على تبسيط عملية إعداد الاتصال. إذا واجهت أي مشكلات مع الموصل، فلا تتردد في التواصل عبر GitHub.