# MAX

> StackQL の MAX 集約関数：列または列のグループ内の最大値。

Source: https://stackql.io/ja/language-spec/functions/aggregate/max

列の入力または列のグループに基づいて最大値を返します。  

関連項目：  
[[` SELECT `]](/language-spec/select) 

* * * 

## 構文

```sql
/* aggregate function */
SELECT MAX(columnExpression) FROM <multipartIdentifier>
[ GROUP BY groupByColumn ];
```
```sql
/* scalar (multi-argument) function */
SELECT MAX(scalarExpression1, scalarExpressionN, ...) FROM <multipartIdentifier>;
```

## 引数

### 集約関数

__*columnExpression*__  
オペランド（`+`、`-`、...）を含む列または式。

> `MAX` 関数は、列のデータ型に基づいて、指定された列の最大値を返します。たとえば、整数の列に対する `MAX` 操作は、その列または列のグループの最大の整数を返します。一方、文字列の列または列のグループに対する `MAX` 操作は、最大の ASCII 値を返します（一般に、辞書順で並べ替えたときの最初の値ですが、いくつかの違いがあります）。

__*groupByColumn*__  
要約操作または集約操作の対象となる 1 つ以上の列。`GROUP BY` 句は、列のグループごとに 1 行を返します。

> `MAX` 関数は `NULL` 値を無視します。

> グループ内のすべての値が `NULL` の場合、`MAX` 関数は `NULL` を返します。

### スカラー関数

__*scalarExpression*__  
最大値を決定して返す対象となる列または式のリスト（2 つ以上）。 

> いずれかの引数が `NULL` の場合、スカラー `MAX` 関数は `NULL` を返します。 

> スカラー（複数引数）の `MAX` 関数は、照合関数を定義する引数を左から右へ検索し、その照合関数をすべての文字列比較に使用します。 

> スカラー `MAX` 関数のどの引数も照合関数を定義していない場合は、`BINARY` 照合関数が使用されます。 

> 引数が 1 つだけ指定された場合は、`MAX` 集約関数が呼び出されます。

## 戻り値

入力のデータ型（またはグループ）に基づいて最大値を返します。

* * *

## 例

### 列の最大値を返す

```sql
SELECT name, location, max(timeCreated) 
FROM google.storage.buckets WHERE project = 'stackql';
```

### 列の値ごとに最大値を返す

```sql
SELECT name, location,
max(round(julianday('now')-julianday(timeCreated))) as age
FROM google.storage.buckets WHERE project = 'stackql'
GROUP BY location;
```

### スカラー `max` 関数を使用して値のリストから最大値を返す

```sql
SELECT max(json_extract(disks, '$[0].diskSizeGb'),json_extract(disks, '$[1].diskSizeGb')) as largest_disk
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

### `MAX` をウィンドウ関数として使用してパーティション内の最大値を求める

```sql
-- Find the most recent issue in each state
SELECT
    number,
    title,
    state,
    created_at,
    MAX(created_at) OVER (PARTITION BY state) as latest_in_state
FROM github.issues.issues
WHERE owner = 'stackql'
  AND repo = 'stackql'
ORDER BY state, created_at DESC;
```

詳細については、[https://www.sqlite.org/lang_aggfunc.html#max_agg](https://www.sqlite.org/lang_aggfunc.html#max_agg) または [https://www.sqlite.org/lang_corefunc.html#max_scalar](https://www.sqlite.org/lang_corefunc.html#max_scalar) を参照してください。