singleValueOrNull

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

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

الصيغة

singleValueOrNull(x)

الوسائط

• x — عمود من أي نوع بيانات باستثناء Map أو Array أو Tuple، ولا يمكن أن يكون من النوع Nullable. Any

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

تُعيد القيمة الوحيدة إذا كانت هناك قيمة واحدة فقط فريدة وغير NULL في x. وتُعيد NULL إذا لم تكن هناك أي قيم أو إذا وُجدت قيمتان متميزتان على الأقل. Any أو NULL

أمثلة

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

CREATE TABLE test (x UInt8 NULL) ENGINE=Log;
INSERT INTO test (x) VALUES (NULL), (NULL), (5), (NULL), (NULL);
SELECT singleValueOrNull(x) FROM test;

┌─singleValueOrNull(x)─┐
│                    5 │
└──────────────────────┘

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

INSERT INTO test (x) VALUES (10);
SELECT singleValueOrNull(x) FROM test;

┌─singleValueOrNull(x)─┐
│                 ᴺᵁᴸᴸ │
└──────────────────────┘