> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> توثيق دوال معالجة اللغة الطبيعية (NLP)
# دوال معالجة اللغة الطبيعية (NLP)
export const CloudNotSupportedBadge = () => {
return
غير مدعوم في ClickHouse Cloud
;
};
export const ExperimentalBadge = () => {
return ;
};
# دوال معالجة اللغة الطبيعية
{/*AUTOGENERATED_START*/}
## detectCharset
أُضيف في: v22.2.0
يكتشف مجموعة المحارف لسلسلة إدخال غير مُرمَّزة بتنسيق UTF8.
هذه الدالة تجريبية، وقد تتغير بطرق غير متوقعة وغير متوافقة مع الإصدارات السابقة في الإصدارات المستقبلية.
اضبط `allow_experimental_nlp_functions = 1` لتمكينها.
**البنية**
```sql theme={null}
detectCharset(s)
```
**المعاملات**
* `s` — النص المراد تحليله. [`String`](/ar/reference/data-types/string)
**القيمة المُعادة**
يعيد سلسلة نصية تحتوي على رمز مجموعة المحارف المُكتشفة [`String`](/ar/reference/data-types/string)
**أمثلة**
**الاستخدام الأساسي**
```sql title=Query theme={null}
SELECT detectCharset('Ich bleibe für ein paar Tage.')
```
```response title=Response theme={null}
WINDOWS-1252
```
## detectLanguage
أُضيفت في: v22.2.0
تكتشف هذه الدالة لغة سلسلة الإدخال المرمّزة بترميز UTF8.
تستخدم الدالة مكتبة [CLD2](https://github.com/CLD2Owners/cld2) لاكتشاف اللغة، وتُرجع رمز لغة ISO مكوّنًا من حرفين.
كلما كان الإدخال أطول، زادت دقة اكتشاف اللغة.
هذه الدالة تجريبية، وقد تتغير مستقبلاً بطرق غير متوقعة وغير متوافقة مع الإصدارات السابقة.
اضبط `allow_experimental_nlp_functions = 1` لتمكينها.
**البنية**
```sql theme={null}
detectLanguage(s)
```
**الوسيطات**
* `text_to_be_analyzed` — النص المراد تحليله. [`String`](/ar/reference/data-types/string)
**القيمة المُعادة**
تُرجع رمز ISO المكوَّن من حرفين للغة المكتشفة. ومن النتائج الأخرى المحتملة: `un` = غير معروف، وتعذّر اكتشاف أي لغة، `other` = اللغة المكتشفة لا تملك رمزًا من حرفين. [`String`](/ar/reference/data-types/string)
**أمثلة**
**نص متعدد اللغات**
```sql title=Query theme={null}
SELECT detectLanguage('Je pense que je ne parviendrai jamais à parler français comme un natif. Where there\'s a will, there\'s a way.')
```
```response title=Response theme={null}
fr
```
## detectLanguageMixed
تم تقديمها في: v22.2.0
تشبه الدالة [`detectLanguage`](#detectLanguage)، لكن `detectLanguageMixed` تُرجع `Map` من رموز اللغات المكوّنة من حرفين، تكون مرتبطة بالنسبة المئوية لكل لغة في النص.
هذه الدالة تجريبية، وقد تتغير في الإصدارات المستقبلية بطرق غير متوقعة وغير متوافقة مع الإصدارات السابقة.
اضبط `allow_experimental_nlp_functions = 1` لتمكينها.
**البنية**
```sql theme={null}
detectLanguageMixed(s)
```
**المعاملات**
* `s` — النص المراد تحليله [`String`](/ar/reference/data-types/string)
**القيمة المُعادة**
يعيد خريطةً بمفاتيح تمثل رموز ISO مكوّنة من حرفين، وبقيمٍ مقابلة تمثل النسبة المئوية للنص المكتشف لكل لغة [`Map(String, Float32)`](/ar/reference/data-types/map)
**أمثلة**
**لغات مختلطة**
```sql title=Query theme={null}
SELECT detectLanguageMixed('二兎を追う者は一兎をも得ず二兎を追う者は一兎をも得ず A vaincre sans peril, on triomphe sans gloire.')
```
```response title=Response theme={null}
{'ja':0.62,'fr':0.36}
```
## detectLanguageUnknown
قُدِّمت في: v22.2.0
تشبه الدالة [`detectLanguage`](#detectLanguage)، باستثناء أن الدالة detectLanguageUnknown تعمل مع السلاسل النصية غير المشفّرة بترميز UTF8.
يُفضَّل استخدام هذا الإصدار عندما تكون مجموعة المحارف لديك UTF-16 أو UTF-32.
هذه الدالة تجريبية وقد تتغير في الإصدارات المستقبلية بطرق غير متوقعة وغير متوافقة مع الإصدارات السابقة.
عيّن `allow_experimental_nlp_functions = 1` لتمكينها.
**البنية**
```sql theme={null}
detectLanguageUnknown('s')
```
**الوسائط**
* `s` — النص المطلوب تحليله. [`String`](/ar/reference/data-types/string)
**القيمة المُعادة**
يعيد رمز ISO المكوّن من حرفين للغة المكتشفة. النتائج الأخرى المحتملة: `un` = غير معروف، وتعني تعذّر اكتشاف أي لغة، `other` = اللغة المكتشفة ليس لها رمز مكوّن من حرفين. [`String`](/ar/reference/data-types/string)
**أمثلة**
**الاستخدام الأساسي**
```sql title=Query theme={null}
SELECT detectLanguageUnknown('Ich bleibe für ein paar Tage.')
```
```response title=Response theme={null}
de
```
## detectTonality
أُضيف في: v22.2.0
يحدّد الطابع العاطفي لبيانات النص المقدَّمة.
**قيد**
هذه الدالة محدودة في شكلها الحالي، إذ تستخدم القاموس العاطفي المضمَّن ولا تعمل إلا مع اللغة الروسية.
هذه الدالة تجريبية، وقد تتغير بطرق غير متوافقة مع الإصدارات السابقة وبشكل غير متوقع في الإصدارات المستقبلية.
اضبط `allow_experimental_nlp_functions = 1` لتمكينها.
**الصياغة**
```sql theme={null}
detectTonality(s)
```
**الوسائط**
* `s` — النص المراد تحليله. [`String`](/ar/reference/data-types/string)
**القيمة المُعادة**
يعيد متوسط قيمة المشاعر للكلمات في النص [`Float32`](/ar/reference/data-types/float)
**أمثلة**
**تحليل المشاعر باللغة الروسية**
```sql title=Query theme={null}
SELECT
detectTonality('Шарик - хороший пёс'),
detectTonality('Шарик - пёс'),
detectTonality('Шарик - плохой пёс')
```
```response title=Response theme={null}
0.44445, 0, -0.3
```
## lemmatize
أُضيفت في: v21.9.0
تُجري إرجاع الكلمة المعطاة إلى أصلها المعجمي.
تتطلب هذه الدالة قواميس للعمل، ويمكن الحصول عليها من [github](https://github.com/vpodpecan/lemmagen3/tree/master/src/lemmagen3/models).
لمزيد من التفاصيل حول تحميل قاموس من ملف محلي، راجع صفحة ["تعريف القواميس"](/ar/reference/statements/create/dictionary/sources/local-file).
هذه الدالة تجريبية وقد تتغير بطرق غير متوقعة وغير متوافقة مع الإصدارات السابقة في الإصدارات المستقبلية.
اضبط `allow_experimental_nlp_functions = 1` لتمكينها.
**الصيغة**
```sql theme={null}
lemmatize(lang, word)
```
**المعاملات**
* `lang` — اللغة التي ستُطبَّق قواعدها. [`String`](/ar/reference/data-types/string)
* `word` — كلمة مكتوبة بأحرف صغيرة يلزم إرجاعها إلى أصلها الصرفي. [`String`](/ar/reference/data-types/string)
**القيمة المُعادة**
يعيد الصيغة المُرجَعة إلى أصلها الصرفي للكلمة. [`String`](/ar/reference/data-types/string)
**أمثلة**
**إرجاع الكلمات الإنجليزية إلى أصلها الصرفي**
```sql title=Query theme={null}
SELECT lemmatize('en', 'wolves')
```
```response title=Response theme={null}
wolf
```
## stem
استُحدثت في: v21.9.0
تُجري استخراج الجذر لكلمة أو Array من الكلمات باستخدام خوارزميات Snowball.
يجب أن تكون كل سلسلة إدخال كلمة واحدة بحروف صغيرة فقط — فالسلاسل التي تحتوي على مسافات بيضاء تؤدي إلى حدوث Exception.
يؤدي تمرير أحرف كبيرة إلى نتائج undefined.
تعيد String للمدخلات scalar (بما في ذلك FixedString) وArray(String) لمدخلات المصفوفات.
تتوفّر أيضًا متغيرات Nullable وLowCardinality من String وFixedString.
**البنية**
```sql theme={null}
stem(word, language)
```
**الوسيطات**
* `word` — كلمة واحدة مكتوبة بأحرف صغيرة (أو مصفوفة من الكلمات) لتجذيرها. يجب أن تكون بأحرف صغيرة — إذ تؤدي الأحرف الكبيرة إلى نتائج غير محددة. يقبل String و FixedString و Array(String) و Array(FixedString) و Array(Nullable(String)) أو Array(Nullable(FixedString)). [`String`](/ar/reference/data-types/string) أو [`FixedString`](/ar/reference/data-types/fixedstring) أو [`Array(String)`](/ar/reference/data-types/array) أو [`Array(FixedString)`](/ar/reference/data-types/array)
* `language` — اللغة التي ستُطبَّق قواعد التجذير الخاصة بها. استخدم الرمز المكوَّن من حرفين وفق المعيار ISO 639-1 (مثل 'en' و 'de' و 'fr')، راجع [https://en.wikipedia.org/wiki/List\_of\_ISO\_639\_language\_codes](https://en.wikipedia.org/wiki/List\_of\_ISO\_639\_language\_codes). [`String`](/ar/reference/data-types/string)
**القيمة المعادة**
الصيغة المُجذَّرة للكلمة (String)، أو مصفوفة من الكلمات المُجذَّرة (Array(String)). [`String`](/ar/reference/data-types/string) أو [`Array(String)`](/ar/reference/data-types/array)
**أمثلة**
**تجذير كلمة واحدة**
```sql title=Query theme={null}
SELECT stem('blessing', 'en') AS res
```
```response title=Response theme={null}
bless
```
**اختزال مصفوفة من الكلمات إلى جذورها**
```sql title=Query theme={null}
SELECT stem(['blessing', 'disguise'], 'en') AS res
```
```response title=Response theme={null}
['bless','disguis']
```
**تجذير قيمة FixedString**
```sql title=Query theme={null}
SELECT stem(toFixedString('blessing', 10), 'en') AS res
```
```response title=Response theme={null}
bless
```
**استخراج جذر كلمة من النوع Nullable**
```sql title=Query theme={null}
SELECT stem(toNullable('blessing'), 'en') AS res
```
```response title=Response theme={null}
bless
```
## synonyms
أُضيفت في: v21.9.0
تعثر على مرادفات لكلمة معيّنة.
هناك نوعان من امتدادات المرادفات:
* `plain`
* `wordnet`
مع نوع الامتداد `plain`، تحتاج إلى توفير مسار إلى ملف نصي بسيط، حيث يمثّل كل سطر مجموعة معيّنة من المرادفات.
يجب فصل الكلمات في هذا السطر بمسافات أو بمحارف جدولة.
مع نوع الامتداد `wordnet`، تحتاج إلى توفير مسار إلى دليل يحتوي على معجم المرادفات WordNet.
يجب أن يحتوي معجم المرادفات على فهرس معاني WordNet.
هذه الدالة تجريبية وقد تتغير بطرق غير متوقعة وغير متوافقة مع الإصدارات السابقة في الإصدارات المستقبلية.
اضبط `allow_experimental_nlp_functions = 1` لتمكينها.
**البنية**
```sql theme={null}
synonyms(ext_name, word)
```
**الوسيطات**
* `ext_name` — اسم الامتداد الذي سيُجرى البحث فيه. [`String`](/ar/reference/data-types/string)
* `word` — الكلمة المطلوب البحث عنها في الامتداد. [`String`](/ar/reference/data-types/string)
**القيمة المعادة**
تُرجع مصفوفة من المرادفات للكلمة المحددة. [`Array(String)`](/ar/reference/data-types/array)
**أمثلة**
**العثور على المرادفات**
```sql title=Query theme={null}
SELECT synonyms('list', 'important')
```
```response title=Response theme={null}
['important','big','critical','crucial']
```