> ## 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.

> تُستخدم الدالة التجميعية `singleValueOrNull` لتنفيذ عوامل تشغيل الاستعلامات الفرعية، مثل `x = ALL (SELECT ...)`. وتتحقق مما إذا كانت البيانات تحتوي على قيمة واحدة فقط وفريدة وغير `NULL`.

# singleValueOrNull

<div id="singleValueOrNull">
  ## singleValueOrNull
</div>

أُضيفت في: v21.9.0

تُستخدم الدالة التجميعية `singleValueOrNull` لتنفيذ عوامل تشغيل الاستعلامات الفرعية، مثل `x = ALL (SELECT ...)`. وهي تتحقق مما إذا كانت البيانات تحتوي على قيمة فريدة واحدة فقط غير NULL.
إذا كانت هناك قيمة فريدة واحدة فقط، فإنها تُرجعها. وإذا لم تكن هناك أي قيم أو وُجدت قيمتان مختلفتان على الأقل، فإنها تُرجع NULL.

**الصيغة**

```sql theme={null}
singleValueOrNull(x)
```

**الوسائط**

* `x` — عمود من أي نوع بيانات باستثناء Map أو Array أو Tuple، ولا يمكن أن يكون من النوع Nullable. [`Any`](/ar/reference/data-types/index)

**القيمة المُعادة**

تُعيد القيمة الوحيدة إذا كانت هناك قيمة واحدة فقط فريدة وغير `NULL` في `x`. وتُعيد `NULL` إذا لم تكن هناك أي قيم أو إذا وُجدت قيمتان متميزتان على الأقل. [`Any`](/ar/reference/data-types/index) أو [`NULL`](/ar/reference/syntax#null)

**أمثلة**

**قيمة فريدة واحدة**

```sql title=Query theme={null}
CREATE TABLE test (x UInt8 NULL) ENGINE=Log;
INSERT INTO test (x) VALUES (NULL), (NULL), (5), (NULL), (NULL);
SELECT singleValueOrNull(x) FROM test;
```

```response title=Response theme={null}
┌─singleValueOrNull(x)─┐
│                    5 │
└──────────────────────┘
```

**عدّة قيم مميّزة**

```sql title=Query theme={null}
INSERT INTO test (x) VALUES (10);
SELECT singleValueOrNull(x) FROM test;
```

```response title=Response theme={null}
┌─singleValueOrNull(x)─┐
│                 ᴺᵁᴸᴸ │
└──────────────────────┘
```