> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-a804b3ad.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Looker Studio، المعروف سابقًا باسم Google Data Studio، هو أداة عبر الإنترنت لتحويل البيانات إلى تقارير ولوحات معلومات مخصّصة وغنية بالمعلومات.
# Looker Studio
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
يمكن لـ Looker Studio الاتصال بـ ClickHouse من خلال واجهة MySQL باستخدام مصدر بيانات Google MySQL الرسمي.
## إعداد ClickHouse Cloud
#### اختر `Connect your app`
بعد إنشاء خدمة ClickHouse Cloud، في شاشة `Connect your app`، اختر MySQL من القائمة المنسدلة.
#### فعِّل واجهة MySQL
بدِّل المفتاح لتفعيل واجهة MySQL لهذه الخدمة.
سيؤدي ذلك إلى إتاحة المنفذ `3306` لهذه الخدمة، كما سيعرض لك شاشة اتصال MySQL التي تتضمن اسم مستخدم MySQL الفريد الخاص بك.
بدلاً من ذلك، لتمكين واجهة MySQL لخدمة موجودة:
#### اختر `Connect`
تأكد من أن خدمتك في حالة `Running`، ثم انقر على الخدمة التي تريد تفعيل واجهة MySQL لها.
اختر "Connect" من القائمة اليمنى:
#### اختر `MySQL`
اختر `MySQL` من القائمة المنسدلة `Connect With`.
#### فعِّل واجهة MySQL
بدِّل المفتاح لتفعيل واجهة MySQL لهذه الخدمة.
سيؤدي ذلك إلى إتاحة المنفذ `3306` لهذه الخدمة، كما سيعرض لك شاشة اتصال MySQL التي تتضمن اسم مستخدم MySQL الفريد الخاص بك.
## إنشاء مستخدم MySQL للقراءة فقط في ClickHouse Cloud
ينشئ ClickHouse Cloud تلقائيًا مستخدمًا باسم `mysql4` يستخدم كلمة المرور نفسها الخاصة بالمستخدم الافتراضي.
ويشير الجزء `` إلى الجزء الأول من اسم المضيف الخاص بك في ClickHouse Cloud.
صيغة اسم المستخدم هذه مطلوبة للتوافق مع الأدوات التي تنشئ اتصالات آمنة لكنها لا تضمّن بيانات [SNI (Server Name Indication)](https://www.cloudflare.com/learning/ssl/what-is-sni) ضمن مصافحة TLS.
ومن دون معلومات SNI، لا يستطيع النظام إجراء التوجيه الداخلي بشكل صحيح، لذلك يوفّر تلميح النطاق الفرعي المضمّن في اسم المستخدم معلومات التوجيه اللازمة.
ويُعد عميل MySQL من سطر الأوامر مثالًا على أداة تتطلب ذلك.
من أفضل الممارسات الموصى بها إنشاء مستخدم MySQL جديد للقراءة فقط.
بالنسبة إلى اسم مضيف ClickHouse Cloud مثل `foobar.us-east1.aws.clickhouse.cloud`، تكون قيمة الجزء `` هي `foobar`، ويمكن أن يكون اسم مستخدم MySQL مخصص مثل `mysql4foobar_team1`.
#### إنشاء ملف تعريف إعدادات للقراءة فقط
أنشئ [ملف تعريف إعدادات](/ar/reference/statements/create/settings-profile) لتطبيقه على مستخدمك المخصّص للقراءة فقط،
مع ضبط الإعداد `readonly` على `1`:
```sql theme={null}
CREATE SETTINGS PROFILE readonly_profile SETTINGS readonly = 1
```
#### إنشاء مستخدم MySQL جديد للقراءة فقط
[أنشئ مستخدمًا](/ar/reference/statements/create/user) باسم يتبع هذه الصيغة:
```sql theme={null}
mysql4_
```
طبّق `readonly_profile` على المستخدم الجديد، وتأكد من أن كلمة المرور بتنسيق double SHA1. على سبيل المثال:
```sql theme={null}
CREATE USER mysql4foobar_readonly
IDENTIFIED WITH double_sha1_password BY 'YourPassword42$'
SETTINGS PROFILE 'readonly_profile';
```
#### منح المستخدم الجديد أذونات الوصول إلى الجداول المطلوبة
[امنح](/ar/reference/statements/grant) المستخدم الجديد الأذونات اللازمة للوصول إلى الجداول أو قواعد البيانات المطلوبة.
على سبيل المثال، إذا كنت تريد منح الوصول إلى `system.query_log` فقط:
```sql theme={null}
GRANT SELECT ON system.query_log TO mysql4foobar_readonly;
```
بالنسبة إلى المستخدم المخصّص للقراءة فقط، احرص على منح أذونات `SELECT` فقط للجداول التي تريد الوصول إليها.
يمكن استخدام المستخدم الذي أنشأته حديثًا للاتصال بخدمة ClickHouse Cloud الخاصة بك عبر واجهة MySQL.
### استكشاف أخطاء تعدد مستخدمي MySQL في ClickHouse Cloud
إذا أنشأت مستخدم MySQL جديدًا وظهر لك الخطأ التالي أثناء الاتصال باستخدام عميل MySQL CLI:
```
ERROR 2013 (HY000): Lost connection to MySQL server at 'reading authorization packet', system error: 54
```
في هذه الحالة، تأكد من أن اسم المستخدم يتبع صيغة `mysql4_`، كما هو موضّح ([أعلاه](#creating-multiple-mysql-users-in-clickhouse-cloud)).
## إعداد خادم ClickHouse المحلي
يُرجى الرجوع إلى [الوثائق الرسمية](/ar/concepts/features/interfaces/mysql)
للتعرّف على كيفية إعداد خادم ClickHouse مع تمكين واجهة MySQL.
إلى جانب إضافة إدخال إلى ملف `config.xml` الخاص بالخادم
```xml theme={null}
9004
```
من *الضروري* أيضًا استخدام
[تشفير كلمة المرور باستخدام 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 '-'
```
يجب أن تكون المخرجات كما يلي:
```
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```
السطر الأول هو كلمة المرور المُولَّدة، والسطر الثاني هو قيمة `hash` التي يمكن استخدامها لإعداد ClickHouse.
فيما يلي مثال على إعداد `mysql_user` يستخدم قيمة `hash` المُولَّدة:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
استبدل الإدخال `password_double_sha1_hex` بقيمة Double SHA1 hash التي تولّدها بنفسك.
بالإضافة إلى ذلك، يُوصى باستخدام `use_mysql_types_in_show_columns`
لعرض أنواع MySQL الأصلية بدلًا من أنواع ClickHouse في نتائج الاستعلام `SHOW [FULL] COLUMNS`،
مما يتيح لأدوات BI فحص مخطط قاعدة البيانات بشكل صحيح عند استخدام موصلات MySQL.
على سبيل المثال:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
```
أو أسنده إلى ملف تعريف مختلف بدلًا من الملف الافتراضي.
إذا كان البرنامج التنفيذي `mysql` متاحًا لديك، يمكنك اختبار الاتصال من سطر الأوامر.
وباستخدام اسم المستخدم المثال (`mysql_user`) وكلمة المرور (`LZOQYnqQN4L/T6L0`) المذكورين أعلاه، سيكون الأمر في سطر الأوامر كما يلي:
```bash theme={null}
mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
```
```
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.
```
أخيرًا، اضبط خادم ClickHouse للاستماع على عنوان IP أو العناوين المطلوبة. على سبيل المثال، في `config.xml`، أزل التعليق عن التالي للاستماع على جميع العناوين:
```bash theme={null}
::
```
## ربط Looker Studio بـ ClickHouse
أولاً، سجّل الدخول إلى [https://lookerstudio.google.com](https://lookerstudio.google.com) باستخدام حساب Google، ثم أنشئ مصدر بيانات جديدًا:
ابحث عن موصل MySQL الرسمي الذي توفّره Google (ويحمل ببساطة اسم **MySQL**):
حدّد تفاصيل الاتصال الخاصة بك. يُرجى ملاحظة أن منفذ واجهة MySQL هو 9004 افتراضيًا،
وقد يختلف ذلك بحسب إعدادات الخادم لديك.
الآن، لديك خياران لجلب البيانات من ClickHouse. أولاً، يمكنك استخدام ميزة Table Browser:
وبدلاً من ذلك، يمكنك تحديد استعلام مخصّص لجلب بياناتك:
أخيرًا، ينبغي أن تتمكن من رؤية بنية الجدول المكتشفة تلقائيًا وضبط أنواع البيانات إذا لزم الأمر.
يمكنك الآن المتابعة إلى استكشاف بياناتك أو إنشاء تقرير جديد!
## استخدام Looker Studio مع ClickHouse Cloud
عند استخدام ClickHouse Cloud، عليك أولاً تمكين واجهة MySQL. يمكنك القيام بذلك من مربع حوار الاتصال، ضمن علامة التبويب "MySQL".
في واجهة مستخدم Looker Studio، اختر خيار "Enable SSL". شهادة SSL الخاصة بـ ClickHouse Cloud موقَّعة من [Let's Encrypt](https://letsencrypt.org/certificates/). يمكنك تنزيل الشهادة الجذرية من [هنا](https://letsencrypt.org/certs/isrgrootx1.pem).
بقية الخطوات هي نفسها المذكورة أعلاه في القسم السابق.