> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 计算最小 `val` 值对应的 `arg` 值。如果有多行的 `val` 相等且为最大值，则返回哪个关联的 `arg` 是不确定的。

# argMin

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

引入版本：v1.1.0

计算最小 `val` 值对应的 `arg` 值。如果有多行的 `val` 都等于最小值，则返回其中哪一行对应的 `arg` 是不确定的。
`arg` 和 `min` 两部分的行为都类似于[聚合函数](/zh/reference/functions/aggregate-functions)：它们在处理过程中都会[跳过 `Null`](/zh/reference/functions/aggregate-functions#null-processing)，并且如果存在非 `Null` 值，就会返回非 `Null` 值。

**另请参见**

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

**语法**

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

**参数**

* `arg` — 要查找最大值的参数。[`const String`](/zh/reference/data-types/string)
* `val` — 最小值。[`(U)Int8/16/32/64`](/zh/reference/data-types/int-uint) 或 [`Float*`](/zh/reference/data-types/float) 或 [`Date`](/zh/reference/data-types/date) 或 [`DateTime`](/zh/reference/data-types/datetime) 或 [`Tuple`](/zh/reference/data-types/tuple)

**返回值**

返回与最小 `val` 值对应的 `arg` 值。其类型与 `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)      │
└────────────────────────┴──────────────────┘
```
