كيفية ربط كتالوج Iceberg في ClickHouse Cloud

مستودعات البياناتCloud

المتطلبات الأساسية

قبل بدء هذا البدء السريع، ينبغي أن يتوفر لديك ما يلي: 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، فيمكنك تحميل مجموعة البيانات هذه. سنستخدم مجموعة البيانات هذه في الشرح هنا.

في هذا البدء السريع، ستقوم بما يلي:

بنهاية هذا البدء السريع، سيكون ClickHouse Cloud متصلاً بكتالوج Iceberg لديك، وستتمكن من تشغيل استعلامات SQL على جداول Iceberg من دون نسخ البيانات.

في هذه الخطوة، ستتصل بـ 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 من كتالوج البيانات لديك.

بالنقر على Show Tables أو SQL Console، ستصل إلى SQL Console مع توصيل قاعدة البيانات الجديدة ببحيرة البيانات لديك وتجسيدها. وإذا دخلت عبر SQL Console، فغيّر قاعدة البيانات من القائمة المنسدلة إلى قاعدة بيانات Iceberg الخاصة بك.
ينبغي أن ترى جدول Iceberg واحدًا أو أكثر ضمن شجرة الملفات. شغّل هذا الاستعلام:

select * from iceberg_database.`iceberg_db.your_table`

الآن بعد أن اتصلت ببحيرة البيانات الخاصة بك، يمكنك تجربة كتابة جدول Iceberg في ClickHouse.

انتبه جيدًا إلى علامات الاقتباس. لا يدعم ClickHouse مساحات أسماء ثلاثية الأجزاء، لذا يجب وضع schema.table بين علامتي اقتباس.