> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.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/string)) — اسم UDF.
* `load_status` ([Enum8('Success' = 0, 'Failed' = 1)](/ar/reference/data-types/enum)) — حالة التحميل. القيم الممكنة: Success — تم تحميل UDF وهو جاهز للاستخدام، Failed — تعذّر تحميل UDF (راجع الحقل 'loading\_error\_message' للتفاصيل).
* `loading_error_message` ([String](/ar/reference/data-types/string)) — رسالة الخطأ التفصيلية عند فشل التحميل. تكون فارغة عند نجاح التحميل.
* `last_successful_update_time` ([Nullable(DateTime)](/ar/reference/data-types/nullable)) — الطابع الزمني لآخر تحديث ناجح. NULL إذا لم ينجح أي تحديث من قبل.
* `loading_duration_ms` ([UInt64](/ar/reference/data-types/int-uint)) — الوقت المستغرق لتحميل UDF بالمللي ثانية.
* `type` ([Enum8('executable' = 0, 'executable\_pool' = 1)](/ar/reference/data-types/enum)) — نوع UDF: 'executable' (عملية واحدة) أو 'executable\_pool' (مجمع عمليات).
* `command` ([String](/ar/reference/data-types/string)) — البرنامج النصي أو الأمر الذي يُنفّذ لهذه UDF.
* `format` ([String](/ar/reference/data-types/string)) — تنسيق البيانات لعمليات الإدخال/الإخراج (مثل 'TabSeparated' و'JSONEachRow').
* `return_type` ([String](/ar/reference/data-types/string)) — نوع القيمة التي تُرجعها الدالة (مثل 'String' و'UInt64').
* `return_name` ([String](/ar/reference/data-types/string)) — معرّف اختياري لقيمة الإرجاع. يكون فارغًا إذا لم يُضبط.
* `argument_types` ([Array(String)](/ar/reference/data-types/array)) — مصفوفة بأنواع الوسيطات (مثل \['String' و'UInt64']).
* `argument_names` ([Array(String)](/ar/reference/data-types/array)) — مصفوفة بأسماء الوسيطات. سلاسل فارغة للوسيطات غير المسمّاة.
* `max_command_execution_time` ([UInt64](/ar/reference/data-types/int-uint)) — الحد الأقصى لعدد الثواني لمعالجة كتلة بيانات. لنوع 'executable\_pool' فقط.
* `command_termination_timeout` ([UInt64](/ar/reference/data-types/int-uint)) — عدد الثواني قبل إرسال SIGTERM إلى عملية الأمر.
* `command_read_timeout` ([UInt64](/ar/reference/data-types/int-uint)) — عدد المللي ثانية المخصصة للقراءة من stdout الخاص بالأمر.
* `command_write_timeout` ([UInt64](/ar/reference/data-types/int-uint)) — عدد المللي ثانية المخصصة للكتابة إلى stdin الخاص بالأمر.
* `pool_size` ([UInt64](/ar/reference/data-types/int-uint)) — عدد مثيلات عملية الأمر. لنوع 'executable\_pool' فقط.
* `send_chunk_header` ([UInt8](/ar/reference/data-types/int-uint)) — ما إذا كان سيتم إرسال عدد الصفوف قبل كل جزء من البيانات (قيمة منطقية).
* `execute_direct` ([UInt8](/ar/reference/data-types/int-uint)) — ما إذا كان سيتم تنفيذ الأمر مباشرةً (1) أو عبر /bin/bash (0).
* `lifetime` ([UInt64](/ar/reference/data-types/int-uint)) — فترة إعادة التحميل بالثواني. تعني 0 تعطيل إعادة التحميل.
* `deterministic` ([UInt8](/ar/reference/data-types/int-uint)) — ما إذا كانت الدالة تُرجع النتيجة نفسها للوسيطات نفسها (قيمة منطقية).

<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 وتهيئتها.