> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> قواميس geobase المضمّنة في ClickHouse

# القواميس المضمّنة (geobase)

export const CloudNotSupportedBadge = () => {
  return <div className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            غير مدعوم في ClickHouse Cloud
        </div>;
};

<CloudNotSupportedBadge />

<Note>
  هذه الصفحة لا تنطبق على [ClickHouse Cloud](https://clickhouse.com/cloud). الميزة الموثقة هنا غير متاحة في خدمات ClickHouse Cloud.
  راجع دليل [التوافق مع Cloud](/docs/ar/products/cloud/guides/cloud-compatibility) الخاص بـ ClickHouse لمزيد من المعلومات.
</Note>

يتضمن ClickHouse ميزة مدمجة للعمل مع geobase.

يتيح لك ذلك ما يلي:

* استخدام معرّف المنطقة للحصول على اسمها باللغة المطلوبة.
* استخدام معرّف المنطقة للحصول على معرّف مدينة أو منطقة أو دائرة اتحادية أو دولة أو قارة.
* التحقق مما إذا كانت منطقة ما جزءًا من منطقة أخرى.
* الحصول على تسلسل المناطق الأم.

تدعم جميع الدوال «التعدّد المحلي»، أي القدرة على استخدام وجهات نظر مختلفة حول تبعية المناطق في الوقت نفسه. لمزيد من المعلومات، راجع قسم «الدوال الخاصة بالعمل مع قواميس تحليلات الويب».

تكون القواميس الداخلية معطّلة في الحزمة الافتراضية.
لتمكينها، أزل التعليق عن المعلَمين `path_to_regions_hierarchy_file` و`path_to_regions_names_files` في ملف تهيئة الخادم.

يتم تحميل geobase من ملفات نصية.

ضع ملفات `regions_hierarchy*.txt` في الدليل `path_to_regions_hierarchy_file`. يجب أن يحتوي مَعلَم التهيئة هذا على المسار إلى الملف `regions_hierarchy.txt` (التسلسل الهرمي الإقليمي الافتراضي)، ويجب أن تكون الملفات الأخرى (`regions_hierarchy_ua.txt`) موجودة في الدليل نفسه.

ضع ملفات `regions_names_*.txt` في الدليل `path_to_regions_names_files`.

يمكنك أيضًا إنشاء هذه الملفات بنفسك. يكون تنسيق الملف كما يلي:

`regions_hierarchy*.txt`: TabSeparated (من دون ترويسة)، الأعمدة:

* معرّف المنطقة (`UInt32`)
* معرّف المنطقة الأم (`UInt32`)
* نوع المنطقة (`UInt8`): 1 - قارة، 3 - دولة، 4 - دائرة اتحادية، 5 - منطقة، 6 - مدينة؛ أما الأنواع الأخرى فلا قيم لها
* عدد السكان (`UInt32`) — عمود اختياري

`regions_names_*.txt`: TabSeparated (من دون ترويسة)، الأعمدة:

* معرّف المنطقة (`UInt32`)
* اسم المنطقة (`String`) — لا يمكن أن يحتوي على علامات جدولة أو محارف سطر جديد، حتى لو كانت مُهرَّبة.

تُستخدم مصفوفة مسطّحة للتخزين في RAM. لذلك، يجب ألا تتجاوز المعرّفات مليونًا.

يمكن تحديث القواميس من دون إعادة تشغيل الخادم. ومع ذلك، لا يتم تحديث مجموعة القواميس المتاحة.
عند التحديث، تُفحَص أوقات تعديل الملفات. وإذا تغيّر ملف، يُحدَّث القاموس.
يُضبط الفاصل الزمني للتحقق من التغييرات في المعلَمة `builtin_dictionaries_reload_interval`.
لا تحظر تحديثات القواميس (باستثناء التحميل عند أول استخدام) الاستعلامات. أثناء التحديثات، تستخدم الاستعلامات الإصدارات القديمة من القواميس. وإذا حدث خطأ أثناء التحديث، يُكتَب الخطأ في سجل الخادم، وتستمر الاستعلامات في استخدام الإصدار القديم من القواميس.

نوصي بتحديث القواميس دوريًا من geobase. أثناء التحديث، أنشئ ملفات جديدة واكتبها في موقع منفصل. وعندما يصبح كل شيء جاهزًا، أعد تسميتها بأسماء الملفات التي يستخدمها الخادم.

توجد أيضًا دوال للعمل مع معرّفات أنظمة التشغيل ومحركات البحث، لكن لا ينبغي استخدامها.