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

# argMax

الاسم البديل: `max_by`

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

أُضيف في: v1.1.0

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

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

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

**البنية**

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

**الأسماء البديلة**: `max_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 argMax(user, salary) FROM salary;
```

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

**مثال موسّع للتعامل مع NULL**

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

SELECT argMax(a, b), max(b) FROM test;
```

```response title=Response theme={null}
┌─argMax(a, b)─┬─max(b)─┐
│ b            │      3 │
└──────────────┴────────┘
```

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

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

```response title=Response theme={null}
┌─argMax(a, tuple(b, a))─┐
│ c                      │
└────────────────────────┘
```