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

> نصائح حول الاتصال بـ Tableau عند استخدام الموصل الرسمي لـ ClickHouse.

# نصائح حول الاتصال

export const ClickHouseSupportedBadge = () => {
  return <div className="ClickHouseSupportedBadge">
            <div className="ClickHouseSupportedIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <path d="M1.30762 1.39073C1.30762 1.3103 1.37465 1.22986 1.46849 1.22986H2.64824C2.72868 1.22986 2.80912 1.29689 2.80912 1.39073V14.4886C2.80912 14.5691 2.74209 14.6495 2.64824 14.6495H1.46849C1.38805 14.6495 1.30762 14.5825 1.30762 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M4.2832 1.39073C4.2832 1.3103 4.35023 1.22986 4.44408 1.22986H5.62383C5.70427 1.22986 5.7847 1.29689 5.7847 1.39073V14.4886C5.7847 14.5691 5.71767 14.6495 5.62383 14.6495H4.44408C4.36364 14.6495 4.2832 14.5825 4.2832 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M7.25977 1.39073C7.25977 1.3103 7.3268 1.22986 7.42064 1.22986H8.60039C8.68083 1.22986 8.76127 1.29689 8.76127 1.39073V14.4886C8.76127 14.5691 8.69423 14.6495 8.60039 14.6495H7.42064C7.3402 14.6495 7.25977 14.5825 7.25977 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M10.2354 1.39073C10.2354 1.3103 10.3024 1.22986 10.3962 1.22986H11.576C11.6564 1.22986 11.7369 1.29689 11.7369 1.39073V14.4886C11.7369 14.5691 11.6698 14.6495 11.576 14.6495H10.3962C10.3158 14.6495 10.2354 14.5825 10.2354 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M13.2256 6.6057C13.2256 6.52526 13.2926 6.44482 13.3865 6.44482H14.5662C14.6466 6.44482 14.7271 6.51186 14.7271 6.6057V9.27354C14.7271 9.35398 14.6601 9.43442 14.5662 9.43442H13.3865C13.306 9.43442 13.2256 9.36739 13.2256 9.27354V6.6057Z" fill="currentColor" />
                </svg>
            </div>
            متوافق مع ClickHouse
        </div>;
};

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

<div id="initial-sql-tab">
  ## علامة تبويب Initial SQL
</div>

إذا كان مربع الاختيار *Set Session ID* مفعّلًا في علامة التبويب Advanced (افتراضيًا)، فلا تتردد في ضبط [الإعدادات](/ar/reference/settings/session-settings) على مستوى الجلسة باستخدام

```text theme={null}
SET my_setting=value;
```

<div id="advanced-tab">
  ## علامة تبويب Advanced
</div>

في 99% من الحالات، لن تحتاج إلى علامة تبويب Advanced. أما في 1% المتبقية، فيمكنك استخدام الإعدادات التالية:

* **معلَمات الاتصال المخصّصة**. يكون `socket_timeout` محددًا بالفعل افتراضيًا، وقد تحتاج إلى تغيير هذا المعلَم إذا كانت بعض عمليات الاستخراج تستغرق وقتًا طويلًا جدًا في التحديث. تُحدَّد قيمة هذا المعلَم بالمللي ثانية. ويمكنك العثور على بقية المعلَمات [هنا](https://github.com/ClickHouse/clickhouse-jdbc/blob/master/clickhouse-client/src/main/java/com/clickhouse/client/config/ClickHouseClientOption.java)، ثم إضافتها في هذا الحقل مفصولة بفواصل

* **`custom_http_params` المخصّص في JDBC Driver**. يتيح لك هذا الحقل تمرير بعض المعلَمات إلى سلسلة الاتصال الخاصة بـ ClickHouse عبر إرسال القيم إلى [معلَم `custom_http_params` الخاص بالمشغّل](https://github.com/ClickHouse/clickhouse-jdbc#configuration). على سبيل المثال، بهذه الطريقة يتم تحديد `session_id` عند تفعيل مربع الاختيار *Set Session ID*

* **`typeMappings` في JDBC Driver**. يتيح لك هذا الحقل [تمرير قائمة بتعيينات أنواع بيانات ClickHouse إلى أنواع بيانات Java التي يستخدمها JDBC Driver](https://github.com/ClickHouse/clickhouse-jdbc#configuration). يعرض الموصل تلقائيًا الأعداد الصحيحة الكبيرة كسلاسل نصية بفضل هذا المعلَم، ويمكنك تغيير ذلك بتمرير مجموعة التعيينات الخاصة بك *(لا أعرف لماذا)* باستخدام
  ```text theme={null}
  UInt256=java.lang.Double,Int256=java.lang.Double
  ```
  اقرأ المزيد عن التعيين في القسم المقابل

* **معلَمات URL الخاصة بـ JDBC Driver**. يمكنك تمرير بقية [معلَمات المشغّل](https://github.com/ClickHouse/clickhouse-jdbc#configuration)، مثل `jdbcCompliance`، في هذا الحقل. انتبه: يجب تمرير قيم المعلَمات بتنسيق URL Encoded. وإذا مرّرت `custom_http_params` أو `typeMappings` في هذا الحقل وفي الحقول السابقة ضمن علامة تبويب Advanced، فستكون لقيم الحقلين السابقين في علامة تبويب Advanced أولوية أعلى

* **مربع الاختيار Set Session ID**. يلزم هذا الخيار لضبط الإعدادات على مستوى الجلسة في علامة تبويب Initial SQL، ويُنشئ `session_id` مع طابع زمني ورقم شبه عشوائي بالتنسيق `"tableau-jdbc-connector-*{timestamp}*-*{number}*"`

<div id="limited-support-for-uint64-int128-uint256-data-types">
  ## دعم محدود لأنواع البيانات UInt64 وInt128 و(U)Int256
</div>

بشكل افتراضي، يعرض المشغّل الحقول من الأنواع *UInt64 وInt128 و(U)Int256* كسلاسل نصية، **لكنه يعرضها فقط ولا يحولها**. وهذا يعني أنك عند محاولة كتابة الحقل المحسوب التالي، ستحصل على خطأ

```text theme={null}
LEFT([myUInt256], 2) // Error!
```

للعمل مع حقول Integer الكبيرة كما لو كانت سلاسل نصية، يجب تغليف الحقل صراحةً بالدالة STR()

```text theme={null}
LEFT(STR([myUInt256]), 2) // Works well!
```

ومع ذلك، تُستخدم مثل هذه الحقول غالبًا لحساب عدد القيم الفريدة *(مثل المعرّفات كـ Watch ID وVisit ID في Yandex.Metrica)* أو كـ *بُعد* لتحديد مستوى تفصيل التصور، وهي تؤدي هذا الغرض جيدًا.

```text theme={null}
COUNTD([myUInt256]) // Works well too!
```

عند استخدام معاينة البيانات (عرض البيانات) لجدول يحتوي على حقول UInt64، لم يعد يظهر أي خطأ.