> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> جدول نظامي يحتوي على حالة التحميل والبيانات الوصفية للتهيئة الخاصة بالدوال المعرّفة من قبل المستخدم (UDFs).

# system.user_defined_functions

<div id="description">
  ## الوصف
</div>

يتضمن حالة التحميل، ومعلومات عن الخطأ، والبيانات الوصفية للتهيئة الخاصة بـ [الدوال المعرّفة من قبل المستخدم (UDFs)](/ar/reference/functions/regular-functions/udf).

<div id="columns">
  ## الأعمدة
</div>

* `name` ([String](/ar/reference/data-types/index)) — اسم دالة UDF.
* `load_status` ([Enum8('Success' = 0, 'Failed' = 1)](/ar/reference/data-types/index)) — حالة التحميل. القيم الممكنة:
  * **Success** — تم تحميل UDF وأصبحت جاهزة للاستخدام
  * **Failed** — فشل تحميل UDF (راجع الحقل 'loading\_error\_message' لمزيد من التفاصيل).
* `loading_error_message` ([String](/ar/reference/data-types/index)) — رسالة الخطأ التفصيلية عند فشل التحميل. تكون فارغة إذا تم التحميل بنجاح.
* `last_successful_update_time` ([Nullable(DateTime)](/ar/reference/data-types/index)) — الطابع الزمني لآخر تحديث ناجح. تكون NULL إذا لم ينجح من قبل.
* `loading_duration_ms` ([UInt64](/ar/reference/data-types/index)) — الوقت المستغرَق في تحميل UDF، بالمللي ثانية.
* `type` ([Enum8('executable' = 0, 'executable\_pool' = 1)](/ar/reference/data-types/index)) — نوع UDF: 'executable' (عملية واحدة) أو 'executable\_pool' (مجموعة عمليات).
* `command` ([String](/ar/reference/data-types/index)) — السكربت أو الأمر المطلوب تنفيذه لهذه UDF.
* `format` ([String](/ar/reference/data-types/index)) — تنسيق البيانات لعمليات الإدخال/الإخراج (مثل 'TabSeparated' و'JSONEachRow').
* `return_type` ([String](/ar/reference/data-types/index)) — نوع الإرجاع للدالة (مثل 'String' و'UInt64').
* `return_name` ([String](/ar/reference/data-types/index)) — معرّف اختياري للقيمة المعادة. يكون فارغًا إذا لم يتم تكوينه.
* `argument_types` ([Array(String)](/ar/reference/data-types/index)) — مصفوفة أنواع المعاملات (مثل \['String', 'UInt64']).
* `argument_names` ([Array(String)](/ar/reference/data-types/index)) — مصفوفة أسماء المعاملات. تُستخدم سلاسل فارغة للمعاملات غير المسماة.
* `max_command_execution_time` ([UInt64](/ar/reference/data-types/index)) — الحد الأقصى بالثواني لمعالجة كتلة بيانات. فقط للنوع 'executable\_pool'.
* `command_termination_timeout` ([UInt64](/ar/reference/data-types/index)) — عدد الثواني قبل إرسال SIGTERM إلى عملية الأمر.
* `command_read_timeout` ([UInt64](/ar/reference/data-types/index)) — عدد المللي ثانية المخصصة للقراءة من stdout الخاص بالأمر.
* `command_write_timeout` ([UInt64](/ar/reference/data-types/index)) — عدد المللي ثانية المخصصة للكتابة إلى stdin الخاص بالأمر.
* `pool_size` ([UInt64](/ar/reference/data-types/index)) — عدد مثيلات عملية الأمر. فقط للنوع 'executable\_pool'.
* `send_chunk_header` ([UInt8](/ar/reference/data-types/index)) — ما إذا كان سيتم إرسال عدد الصفوف قبل كل جزء بيانات (قيمة منطقية).
* `execute_direct` ([UInt8](/ar/reference/data-types/index)) — ما إذا كان سيتم تنفيذ الأمر مباشرةً (1) أو عبر ‎/bin/bash‏ (0).
* `lifetime` ([UInt64](/ar/reference/data-types/index)) — الفاصل الزمني لإعادة التحميل بالثواني. 0 يعني أن إعادة التحميل معطلة.
* `deterministic` ([UInt8](/ar/reference/data-types/index)) — ما إذا كانت الدالة تعيد النتيجة نفسها للمعاملات نفسها (قيمة منطقية).

<div id="example">
  ## مثال
</div>

اعرض جميع UDFs وحالة تحميلها:

```sql theme={null}
SELECT
    name,
    load_status,
    type,
    command,
    return_type,
    argument_types
FROM system.user_defined_functions
FORMAT Vertical;
```

```response theme={null}
Row 1:
──────
name:           my_sum_udf
load_status:    Success
type:           executable
command:        /var/lib/clickhouse/user_scripts/sum.py
return_type:    UInt64
argument_types: ['UInt64','UInt64']
```

العثور على UDFs الفاشلة:

```sql theme={null}
SELECT
    name,
    loading_error_message
FROM system.user_defined_functions
WHERE load_status = 'Failed';
```

<div id="see-also">
  ## انظر أيضًا
</div>

* [الدوال المعرّفة من قِبل المستخدم](/ar/reference/functions/regular-functions/udf) — كيفية إنشاء UDFs وتهيئتها.