# MAX

> StackQL의 MAX 집계 함수: 열 또는 열 그룹에서 가장 큰 값을 반환합니다.

Source: https://stackql.io/ko/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` 작업은 `BINARY` 데이터 정렬 함수로 문자열을 비교했을 때 마지막으로 정렬되는 값을 반환합니다(바이트 단위로 비교하므로 대문자가 소문자보다 먼저 정렬됩니다).

__*groupByColumn*__  
요약 또는 집계 작업을 수행하는 데 사용되는 하나 이상의 열입니다. `GROUP BY` 절은 열 그룹당 1행을 반환합니다.

> `MAX` 함수는 `NULL` 값을 무시합니다.

> 그룹의 모든 값이 `NULL`이면 `MAX` 함수는 `NULL`을 반환합니다.

### 스칼라 함수

__*scalarExpression*__  
가장 큰 값을 결정하여 반환할 대상인 열 또는 식의 목록(2개 이상)입니다.

> 인수 중 하나라도 `NULL`이면 스칼라 `MAX` 함수는 `NULL`을 반환합니다.

> 스칼라 또는 다중 인수 `MAX` 함수는 인수를 왼쪽에서 오른쪽으로 검색하여 데이터 정렬 함수를 정의하는 인수를 찾고, 그 데이터 정렬 함수를 모든 문자열 비교에 사용합니다.

> 스칼라 `MAX` 함수의 인수 중 어느 것도 데이터 정렬 함수를 정의하지 않으면 `BINARY` 데이터 정렬 함수가 사용됩니다.

> 인수가 하나만 제공되면 `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) 페이지를 참조하세요
