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

> يُرجع أول قيمة يصادفها في عمود.

# any

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

أُضيف في: v1.1.0

تُرجع أول قيمة يتم العثور عليها في عمود.

<Warning>
  نظرًا إلى أن الاستعلام قد يُنفَّذ بترتيب عشوائي، فإن نتيجة هذه الدالة غير حتمية. وإذا كنت بحاجة إلى نتيجة عشوائية ولكن حتمية، فاستخدم الدالتين min أو max.
</Warning>

بشكل افتراضي، لا تُرجع الدالة NULL مطلقًا، أي إنها تتجاهل قيم NULL في عمود الإدخال.
ومع ذلك، إذا استُخدمت الدالة مع المعدِّل `RESPECT NULLS`، فإنها تُرجع أول قيمة تتم قراءتها سواء أكانت NULL أم لا.

**تفاصيل التنفيذ**

في بعض الحالات، يمكنك الاعتماد على ترتيب التنفيذ.
وينطبق ذلك على الحالات التي يأتي فيها `SELECT` من استعلام فرعي يستخدم `ORDER BY`.

عندما يحتوي استعلام `SELECT` على عبارة `GROUP BY` أو على الأقل دالة تجميع واحدة، فإن ClickHouse (على عكس MySQL) يشترط أن تكون جميع التعبيرات في عبارات `SELECT` و`HAVING` و`ORDER BY` محسوبة من المفاتيح أو من دوال التجميع.
وبعبارة أخرى، يجب استخدام كل عمود مُحدَّد من الجدول إما ضمن المفاتيح أو داخل دوال التجميع.
وللحصول على سلوك مماثل لما في MySQL، يمكنك وضع الأعمدة الأخرى داخل دالة التجميع `any`.

<Note>
  نوع الإرجاع للدالة هو نفسه نوع الإدخال، باستثناء LowCardinality الذي يتم تجاهله.
  وهذا يعني أنه عند عدم وجود صفوف كمدخلات، فستُرجع القيمة الافتراضية لذلك النوع (0 للأعداد الصحيحة، أو Null لعمود Nullable()).
  ويمكنك استخدام المُركِّب -OrNull لتعديل هذا السلوك.
</Note>

**الصياغة**

```sql theme={null}
any(column)[ RESPECT NULLS]
```

**الأسماء البديلة**: `any_value`, `first_value`

**الوسيطات**

* `column` — اسم العمود. [`Any`](/ar/reference/data-types/index)

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

تُرجِع أول قيمة تتم مصادفتها.
[`Any`](/ar/reference/data-types/index)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
CREATE TABLE tab (city Nullable(String)) ENGINE=Memory;
INSERT INTO tab (city) VALUES (NULL), ('Amsterdam'), ('New York'), ('Tokyo'), ('Valencia'), (NULL);
SELECT any(city), anyRespectNulls(city) FROM tab;
```

```response title=Response theme={null}
┌─any(city)─┬─anyRespectNulls(city)─┐
│ Amsterdam │ ᴺᵁᴸᴸ                  │
└───────────┴───────────────────────┘
```