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

> تحسب قيمة `arg` المقابلة لأصغر قيمة `val`. إذا وُجدت عدة صفوف لها قيمة `val` متساوية وكانت هي القيمة القصوى، فليس من الحتمي أيٌّ من قيم `arg` المرتبطة ستُعاد.

# argMin

الاسم المستعار: `min_by`

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

أُضيف في: v1.1.0

تحسب قيمة `arg` المقابلة لأدنى قيمة `val`. إذا وُجدت عدة صفوف لها قيمة `val` متساوية وتمثل القيمة القصوى، فإن تحديد أي قيمة `arg` مرتبطة بها ستُعاد ليس حتميًا.
يتصرف كلٌّ من `arg` و`min` على أنهما [دوال تجميعية](/ar/reference/functions/aggregate-functions/index)، وكلاهما [يتجاوز `Null`](/ar/reference/functions/aggregate-functions/index#null-processing) أثناء المعالجة ويُرجع قيمة غير `Null` إذا كانت هناك قيم غير `Null` متاحة.

**انظر أيضًا**

* [Tuple](/ar/reference/data-types/tuple)

**البنية**

```sql theme={null}
argMin(arg, val)
```

**الأسماء البديلة**: `min_by`

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

* `arg` — الوسيط المطلوب إيجاد القيمة العظمى له. [`const String`](/ar/reference/data-types/string)
* `val` — القيمة الصغرى. [`(U)Int8/16/32/64`](/ar/reference/data-types/int-uint) أو [`Float*`](/ar/reference/data-types/float) أو [`Date`](/ar/reference/data-types/date) أو [`DateTime`](/ar/reference/data-types/datetime) أو [`Tuple`](/ar/reference/data-types/tuple)

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

تُرجِع قيمة `arg` المقابلة لأصغر قيمة لـ `val`. النوع مطابق لنوع `arg`.

**أمثلة**

**الاستخدام الأساسي**

```sql title=Query theme={null}
SELECT argMin(user, salary) FROM salary;
```

```response title=Response theme={null}
┌─argMin(user, salary)─┐
│ worker               │
└──────────────────────┘
```

**مثال موسّع مع معالجة NULL**

```sql title=Query theme={null}
CREATE TABLE test
(
    a Nullable(String),
    b Nullable(Int64)
)
ENGINE = Memory AS
SELECT *
FROM VALUES((NULL, 0), ('a', 1), ('b', 2), ('c', 2), (NULL, NULL), ('d', NULL));

SELECT argMin(a, b), min(b) FROM test;
```

```response title=Response theme={null}
┌─argMin(a, b)─┬─min(b)─┐
│ a            │      0 │
└──────────────┴────────┘
```

**استخدام Tuple في المعاملات**

```sql title=Query theme={null}
SELECT argMin(a, (b, a)), min(tuple(b, a)) FROM test;
```

```response title=Response theme={null}
┌─argMin(a, tuple(b, a))─┬─min(tuple(b, a))─┐
│ d                      │ (NULL,NULL)      │
└────────────────────────┴──────────────────┘
```