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

> تمكّن Amazon QuickSight المؤسسات المعتمدة على البيانات من خلال ذكاء الأعمال (BI) الموحّد.

# QuickSight

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 = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

يمكن لـ QuickSight الاتصال بإعداد ClickHouse المحلي (23.11+) عبر واجهة MySQL باستخدام مصدر البيانات الرسمي لـ MySQL ووضع Direct Query.

<div id="on-premise-clickhouse-server-setup">
  ## إعداد خادم ClickHouse محليًا
</div>

يُرجى الرجوع إلى [الوثائق الرسمية](/ar/concepts/features/interfaces/mysql) لمعرفة كيفية إعداد خادم ClickHouse مع تمكين واجهة MySQL.

بخلاف إضافة إعداد إلى ملف `config.xml` الخاص بالخادم

```xml theme={null}
<clickhouse>
    <mysql_port>9004</mysql_port>
</clickhouse>
```

ومن *الضروري* أيضًا استخدام [تشفير كلمة المرور باستخدام Double SHA1](/ar/concepts/features/configuration/settings/settings-users#user-namepassword) للمستخدم الذي سيستخدم واجهة MySQL.

إنشاء كلمة مرور عشوائية مُشفّرة باستخدام Double SHA1 من سطر الأوامر:

```shell theme={null}
PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'
```

يجب أن يبدو الناتج كما يلي:

```text theme={null}
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```

السطر الأول هو كلمة المرور التي جرى إنشاؤها، والسطر الثاني هو قيمة `hash` التي يمكن استخدامها لإعداد ClickHouse.

فيما يلي مثال على إعداد `mysql_user` يستخدم قيمة `hash` المُنشأة:

`/etc/clickhouse-server/users.d/mysql_user.xml`

```xml theme={null}
<users>
    <mysql_user>
        <password_double_sha1_hex>fbc958cc745a82188a51f30de69eebfc67c40ee4</password_double_sha1_hex>
        <networks>
            <ip>::/0</ip>
        </networks>
        <profile>default</profile>
        <quota>default</quota>
    </mysql_user>
</users>
```

استبدل قيمة `password_double_sha1_hex` بتجزئة Double SHA1 التي أنشأتها بنفسك.

يتطلب QuickSight عدة إعدادات إضافية في profile مستخدم MySQL.

`/etc/clickhouse-server/users.d/mysql_user.xml`

```xml theme={null}
<profiles>
    <default>
        <prefer_column_name_to_alias>1</prefer_column_name_to_alias>
        <mysql_map_string_to_text_in_show_columns>1</mysql_map_string_to_text_in_show_columns>
        <mysql_map_fixed_string_to_text_in_show_columns>1</mysql_map_fixed_string_to_text_in_show_columns>
    </default>
</profiles>
```

ومع ذلك، يُوصى بإسناده إلى ملف تعريف مختلف يمكن لمستخدم MySQL لديك استخدامه بدلًا من الملف الافتراضي.

أخيرًا، اضبط خادم ClickHouse ليستمع إلى عنوان IP المطلوب (أو العناوين المطلوبة).
في `config.xml`، أزل التعليق عن السطر التالي للاستماع على جميع العناوين:

```bash theme={null}
<listen_host>::</listen_host>
```

إذا كان الملف التنفيذي `mysql` متاحًا لديك، يمكنك اختبار الاتصال من سطر الأوامر.
وباستخدام اسم المستخدم التجريبي (`mysql_user`) وكلمة المرور (`LZOQYnqQN4L/T6L0`) المذكورين أعلاه، سيكون أمر سطر الأوامر على النحو التالي:

```bash theme={null}
mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
```

```response theme={null}
mysql> show databases;
+--------------------+
| name               |
+--------------------+
| INFORMATION_SCHEMA |
| default            |
| information_schema |
| system             |
+--------------------+
4 rows in set (0.00 sec)
Read 4 rows, 603.00 B in 0.00156 sec., 2564 rows/sec., 377.48 KiB/sec.
```

<div id="connecting-quicksight-to-clickhouse">
  ## ربط QuickSight بـ ClickHouse
</div>

أولاً، انتقل إلى [https://quicksight.aws.amazon.com](https://quicksight.aws.amazon.com)، ثم افتح قسم Datasets وانقر على "New dataset":

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_01.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=49b1475d7a434f610ae6cf35c3f40e42" alt="لوحة معلومات Amazon QuickSight تعرض زر New dataset في قسم Datasets" border width="1555" height="1038" data-path="images/integrations/data-visualization/quicksight_01.webp" />

<br />

ابحث عن موصل MySQL الرسمي المضمّن مع QuickSight (ويظهر باسم **MySQL** فقط):

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_02.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=cc25cccdea446662d9957a7433f0281f" alt="شاشة اختيار مصدر البيانات في QuickSight مع تمييز MySQL في نتائج البحث" border width="2006" height="1040" data-path="images/integrations/data-visualization/quicksight_02.webp" />

<br />

حدّد تفاصيل الاتصال. يُرجى ملاحظة أن منفذ واجهة MySQL هو 9004 افتراضيًا،
وقد يختلف بحسب إعدادات الخادم لديك.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_03.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=8d12ce47aad260d73c210d436d39653c" alt="نموذج إعداد اتصال MySQL في QuickSight مع حقول اسم المضيف والمنفذ وقاعدة البيانات وبيانات الاعتماد" border width="1059" height="1143" data-path="images/integrations/data-visualization/quicksight_03.webp" />

<br />

أمامك الآن خياران لجلب البيانات من ClickHouse. أولاً، يمكنك اختيار جدول من القائمة:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_04.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=c906b615fff9e0b735fc0df219a06b35" alt="واجهة اختيار الجداول في QuickSight تعرض جداول قاعدة البيانات المتاحة من ClickHouse" border width="1061" height="845" data-path="images/integrations/data-visualization/quicksight_04.webp" />

<br />

بدلاً من ذلك، يمكنك تحديد custom SQL لجلب بياناتك:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_05.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=8d200a00f885e178c7279ca430ec0aa8" alt="محرر استعلامات custom SQL في QuickSight لجلب البيانات من ClickHouse" border width="1061" height="845" data-path="images/integrations/data-visualization/quicksight_05.webp" />

<br />

عند النقر على "Edit/Preview data"، ينبغي أن تتمكن من رؤية بنية الجدول المكتشفة أو تعديل custom SQL، إذا اخترت هذه الطريقة للوصول إلى البيانات:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_06.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=29b929b76b27810accdf9c118a0ddc6e" alt="معاينة البيانات في QuickSight تعرض بنية الجدول مع الأعمدة وبيانات نموذجية" border width="1743" height="1277" data-path="images/integrations/data-visualization/quicksight_06.webp" />

<br />

تأكد من تحديد وضع "Direct Query" في الزاوية السفلية اليسرى من واجهة المستخدم:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_07.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=e17b486cb3b7a2a0109569697b38dbe8" alt="واجهة QuickSight مع تمييز خيار وضع Direct Query في الزاوية السفلية" border width="677" height="341" data-path="images/integrations/data-visualization/quicksight_07.webp" />

<br />

يمكنك الآن المتابعة إلى نشر مجموعة البيانات وإنشاء تصور جديد!

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

* لا يعمل استيراد SPICE على النحو المتوقع؛ يُرجى استخدام وضع Direct Query بدلًا من ذلك. راجع [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553).
