Set up docs MCPالمتطلبات الأساسية
قبل بدء هذا البدء السريع، ينبغي أن يتوفر لديك ما يلي:
To successfully follow this guide, you’ll need the following:
- A running ClickHouse Cloud service. If you don’t have one yet, complete the ClickHouse Cloud quick start first.
- إمكانية الوصول إلى بحيرة بيانات متوافقة مع Iceberg
- Data Lake Catalog (URL + بيانات الاعتماد)
- حسب نوع Data Lake Catalog: بيانات اعتماد تخزين الكائنات (على سبيل المثال، تخزين متوافق مع S3)
- جدول Iceberg واحد موجود مسبقًا على الأقل ومُسجَّل في الكتالوج
إذا لم تكن لديك بيانات موجودة بالفعل في كتالوج Iceberg، فيمكنك تحميل مجموعة البيانات هذه. سنستخدم مجموعة البيانات هذه في الشرح هنا.
ما ستبنيه
في هذا البدء السريع، ستقوم بما يلي:
- الاتصال بـ Iceberg REST Catalog في ClickHouse Cloud
- إنشاء قاعدة بيانات ClickHouse تستند إلى هذا الكتالوج
- الاستعلام مباشرةً من ClickHouse عن جدول Iceberg موجود
- التحقق من أن ClickHouse يقرأ البيانات من بحيرة البيانات لديك
بنهاية هذا البدء السريع، سيكون ClickHouse Cloud متصلاً بكتالوج Iceberg لديك، وستتمكن من تشغيل استعلامات SQL على جداول Iceberg من دون نسخ البيانات.
إنشاء اتصال DataLakeCatalog
في هذه الخطوة، ستتصل بـ Data Lake Catalog لديك في ClickHouse Cloud.
-
افتح خدمة ClickHouse Cloud الخاصة بك.
-
انتقل إلى Data Sources â Connect to your Data Lake Catalog.
-
حدّد كتالوج البيانات من القائمة المنسدلة.
-
املأ النموذج ببيانات الاعتماد ومعلومات الاتصال. بالنسبة إلى Unity Catalog، أدخل ما يلي:
- Open Table Format (Iceberg)
- اسم قاعدة بيانات ClickHouse. سيكون هذا هو اسم قاعدة بيانات ClickHouse التي ستجري منها الاستعلامات على جداول Iceberg.
- معرّف مساحة العمل
- اسم كتالوج Databricks
- معرّف العميل
- السرّ الخاص بالعميل
أدرج الصور
-
احفظ الكتالوج. ينبغي أن يظهر الآن كتالوج البيانات في صفحة Data Sources مع عدد الجداول المتاحة في قاعدة البيانات.
الاستعلام عن جدول Iceberg
في هذه الخطوة، ستستعلم عن جدول Iceberg من كتالوج البيانات لديك.
- بالنقر على
Show TablesأوSQL Console، ستصل إلى SQL Console مع توصيل قاعدة البيانات الجديدة ببحيرة البيانات لديك وتجسيدها. وإذا دخلت عبرSQL Console، فغيّر قاعدة البيانات من القائمة المنسدلة إلى قاعدة بيانات Iceberg الخاصة بك. - ينبغي أن ترى جدول Iceberg واحدًا أو أكثر ضمن شجرة الملفات. شغّل هذا الاستعلام:
select * from iceberg_database.`iceberg_db.your_table`- سيُرجع ClickHouse الصفوف من جدول Iceberg الخاص بك.
الخطوات التالية
الآن بعد أن اتصلت ببحيرة البيانات الخاصة بك، يمكنك تجربة كتابة جدول Iceberg في ClickHouse.
