산술 함수는 UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32 또는 Float64 타입의 임의의 두 피연산자에 대해 동작합니다.
연산을 수행하기 전에 두 피연산자는 결과 타입으로 변환됩니다. 결과 타입은 다음과 같이 결정됩니다(아래 함수 문서에서 별도로
지정하지 않는 한).
- 두 피연산자가 모두 32비트 이하이면 결과 타입의 크기는 두 피연산자 중 더 큰 타입보다 한 단계 큰 타입의 크기가 됩니다
(정수 크기 승격). 예를 들어
UInt8 + UInt16 = UInt32 또는 Float32 * Float32 = Float64입니다.
- 피연산자 중 하나가 64비트 이상이면 결과 타입의 크기는 두 피연산자 중 더 큰 타입과 동일한 크기가 됩니다. 예를
들어
UInt32 + UInt128 = UInt128 또는 Float32 * Float64 = Float64입니다.
- 피연산자 중 하나가 부호 있는 타입이면 결과 타입도 부호 있는 타입이 되고, 그렇지 않으면 부호 없는 타입이 됩니다. 예를 들어
UInt32 * Int32 = Int64 또는 UInt32 * UInt32 = UInt64입니다.
이 규칙은 결과 타입이 가능한 모든 결과를 표현할 수 있는 가장 작은 타입이 되도록 합니다. 이로 인해 값 범위 경계 부근에서는
오버플로우 위험이 생길 수 있지만, 최대 64비트 네이티브 정수 폭을 사용해 계산을 빠르게 수행할 수 있습니다. 또한 이러한 동작은
64비트 정수(BIGINT)를 가장 큰 정수 타입으로 제공하는 다른 많은 데이터베이스와의 호환성도 보장합니다.
예시:
SELECT toTypeName(0), toTypeName(0 + 0), toTypeName(0 + 0 + 0), toTypeName(0 + 0 + 0 + 0)
┌─toTypeName(0)─┬─toTypeName(plus(0, 0))─┬─toTypeName(plus(plus(0, 0), 0))─┬─toTypeName(plus(plus(plus(0, 0), 0), 0))─┐
│ UInt8 │ UInt16 │ UInt32 │ UInt64 │
└───────────────┴────────────────────────┴─────────────────────────────────┴──────────────────────────────────────────┘
x의 절대값을 계산합니다. x가 부호 없는 유형이면 값에 변화가 없습니다. x가 부호 있는 유형이면 부호 없는 숫자를 반환합니다.
구문
인수
반환 값
x의 절댓값
예시
사용 예시
도입 버전: v25.11.0
전달된 인수의 평균값을 계산해 반환합니다.
숫자 및 시간 관련 타입을 지원합니다.
구문
인수
x1, x2] — 평균 계산에 사용할 두 값을 받습니다.
반환 값
제공된 인수의 평균값을 반환합니다. 결과는 호환 가능한 가장 큰 유형으로 승격됩니다.
예시
숫자 타입
SELECT avg2(toUInt8(3), 1.0) AS result, toTypeName(result) AS type;
-- UInt8이 비교를 위해 64비트로 승격되어야 하므로 반환되는 유형은 Float64입니다.
┌─result─┬─type────┐
│ 2 │ Float64 │
└────────┴─────────┘
SELECT avg2(toDecimal32(1, 2), 2) AS result, toTypeName(result) AS type;
┌─result─┬─type──────────┐
│ 1.5 │ Decimal(9, 2) │
└────────┴───────────────┘
SELECT avg2(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;
┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘
SELECT avg2(toDateTime('2025-01-01 00:00:00'), toDateTime('2025-01-03 12:00:00')) AS result, toTypeName(result) AS type;
┌──────────────result─┬─type─────┐
│ 2025-01-02 06:00:00 │ DateTime │
└─────────────────────┴──────────┘
SELECT avg2(toTime64('12:00:00', 0), toTime64('14:00:00', 0)) AS result, toTypeName(result) AS type;
┌───result─┬─type──────┐
│ 13:00:00 │ Time64(0) │
└──────────┴───────────┘
- 10진수 정수를 big-endian 기준의 16진수 포맷으로 변환합니다. 즉, 3351772109 -> C7 C7 FB CD (4바이트)
- 바이트 순서를 뒤집습니다. 즉, C7 C7 FB CD -> CD FB C7 C7
- 결과를 big-endian으로 가정하고 다시 정수로 변환합니다. 즉, CD FB C7 C7 -> 3455829959
이 함수의 한 가지 사용 예시는 IPv4의 바이트 순서를 뒤집는 것입니다:
┌─toIPv4(byteSwap(toUInt32(toIPv4('205.251.199.199'))))─┐
│ 199.199.251.205 │
└───────────────────────────────────────────────────────┘
x를 반환합니다. (U)Int*
예시
사용 예시
SELECT byteSwap(3351772109)
SELECT byteSwap(3351772109)
SELECT byteSwap(123294967295)
a와 b의 몫을 계산합니다. 결과 타입은 항상 Float64입니다.
정수 나눗셈에는 intDiv 함수를 사용합니다.
0으로 나누면 inf, -inf 또는 nan이 반환됩니다.
SELECT divide(25,5) AS quotient, toTypeName(quotient)
result_scale 인수(const Integer, 범위 [0, 76])로 명시적으로 지정할 수 있습니다. 지정하지 않으면 결과 스케일은 주어진 인수 중 최댓값이 됩니다.
이 함수는 일반적인 divide보다 훨씬 느리게 동작합니다.
정밀도를 제어할 필요가 없거나 빠른 계산이 필요하다면 divide 사용을 고려하십시오. divideDecimal(x, y[, result_scale])
Decimal256
예시
예시 1
divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)
┌─divideDecimal(toDecimal256(-12, 0), toDecimal32(2.1, 1), 10)─┐
│ -5.7142857142 │
└──────────────────────────────────────────────────────────────┘
SELECT toDecimal64(-12, 1) / toDecimal32(2.1, 1);
SELECT toDecimal64(-12, 1) as a, toDecimal32(2.1, 1) as b, divideDecimal(a, b, 1), divideDecimal(a, b, 5);
┌─divide(toDecimal64(-12, 1), toDecimal32(2.1, 1))─┐
│ -5.7 │
└──────────────────────────────────────────────────┘
┌───a─┬───b─┬─divideDecimal(toDecimal64(-12, 1), toDecimal32(2.1, 1), 1)─┬─divideDecimal(toDecimal64(-12, 1), toDecimal32(2.1, 1), 5)─┐
│ -12 │ 2.1 │ -5.7 │ -5.71428 │
└─────┴─────┴────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────┘
divide와 동일하지만 0으로 나누면 NULL을 반환합니다.
구문
인수
반환 값
x를 y로 나눈 몫 또는 NULL입니다.
예시
0으로 나누기
SELECT divideOrNull(25, 0)
x — 첫 번째 정수 - y — 두 번째 정수
반환 값
x와 y의 최대공약수입니다.
예시
사용 예시
도입 버전: v20.3.0
부동소수점 값이 유한한지 검사합니다.
삼항 연산자를 사용하면 유사한 결과를 얻을 수 있습니다: isFinite(x) ? x : y.
구문
인수
반환 값
예시
사용 예시
SELECT 1/0 AS infimum, ifNotFinite(infimum,42)
x를 y로 나누는 정수 나눗셈을 수행합니다. 즉,
몫을 내림하여 가장 가까운 작은 정수로 계산합니다.
결과는 피제수(첫 번째 매개변수)와 동일한 비트를 가집니다.
0으로 나누는 경우, 몫이 피제수의 표현 범위에 맞지 않는 경우,
또는 가장 작은 음수를 -1로 나누는 경우 예외가 발생합니다.
구문
인수
x — 왼쪽 피연산자. - y — 오른쪽 피연산자.
반환 값
x와 y를 정수 나눗셈한 결과
예시
두 개의 float에 대한 정수 나눗셈
SELECT intDiv(toFloat64(1), 0.001) AS res, toTypeName(res)
┌──res─┬─toTypeName(intDiv(toFloat64(1), 0.001))─┐
│ 1000 │ Int64 │
└──────┴─────────────────────────────────────────┘
SELECT
intDiv(1, 0.001) AS res,
toTypeName(res)
Received exception from server (version 23.2.1):
Code: 153. DB::Exception: Received from localhost:9000. DB::Exception:
Cannot perform integer division, because it will produce infinite or too
large number: While processing intDiv(1, 0.001) AS res, toTypeName(res).
(ILLEGAL_DIVISION)
intDiv와 동일하지만, 0으로 나누거나 가장 작은 음수를 -1로 나누는 경우에는 NULL을 반환합니다.
구문
인수
반환 값
x를 y로 정수 나눗셈한 결과 또는 NULL입니다.
예시
0으로 나눌 때의 정수 나눗셈
SELECT intDivOrNull(1, 0)
SELECT intDivOrNull(-9223372036854775808, -1)
intDiv와 동일하지만, 0으로 나누거나 가장 작은 음수를 -1로 나눌 경우 0을 반환합니다.
구문
인수
반환 값
a와 b를 정수 나눗셈한 결과 또는 0입니다.
예시
0으로 나누는 정수 나눗셈
SELECT intDivOrZero(1, 0)
SELECT intDivOrZero(0.05, -1)
NaN도 아니면 1을 반환하며,
그렇지 않으면 0을 반환합니다.
구문
인수
반환 값
x가 무한대가 아니고 NaN도 아니면 1이고, 그렇지 않으면 0입니다.
예시
숫자가 유한한지 확인
도입 버전: v1.1.0
Float32 또는 Float64 인수가 무한대이면 1을 반환하고, 그렇지 않으면 0을 반환합니다.
NaN의 경우에는 0을 반환합니다.
구문
인수
반환 값
x가 무한대이면 1, 그렇지 않으면 0입니다(NaN인 경우 포함).
예시
숫자가 무한대인지 확인
SELECT isInfinite(inf), isInfinite(NaN), isInfinite(10))
NaN이면 1을, 그렇지 않으면 0을 반환합니다.
구문
인수
x — NaN인지 여부를 평가할 인수입니다. Float*
반환 값
NaN이면 1, 그렇지 않으면 0입니다.
예시
사용 예시
도입 버전: v1.1.0
두 값 x와 y의 최소공배수를 반환합니다.
0으로 나누거나, 표현 가능한 가장 작은 음수를 -1로 나누면 예외가 발생합니다.
구문
인수
반환 값
x와 y의 최소공배수를 반환합니다. (U)Int*
예시
사용 예시
도입 버전: v21.11.0
두 숫자 값 x와 y 중에서 더 큰 값을 반환합니다.
구문
인수
반환 값
x와 y 중 더 큰 값을 반환합니다. Float64
예시
사용 예시
도입 버전: v25.11.0
제공된 인수의 평균값을 계산해 반환합니다.
숫자 및 시간 타입을 지원합니다.
구문
인수
x1[, x2, ...] — 평균을 계산할 단일 값 또는 여러 값을 받습니다.
반환 값
주어진 인수의 평균값을 반환하며, 가장 큰 호환 타입으로 승격됩니다.
예시
숫자 타입
SELECT midpoint(1, toUInt8(3), 0.5) AS result, toTypeName(result) AS type;
-- 반환 유형은 Float64입니다. UInt8이 비교를 위해 64비트로 승격되어야 하기 때문입니다.
┌─result─┬─type────┐
│ 1.5 │ Float64 │
└────────┴─────────┘
SELECT midpoint(toDecimal32(1.5, 2), toDecimal32(1, 1), 2) AS result, toTypeName(result) AS type;
┌─result─┬─type──────────┐
│ 1.5 │ Decimal(9, 2) │
└────────┴───────────────┘
SELECT midpoint(toDate('2025-01-01'), toDate('2025-01-05')) AS result, toTypeName(result) AS type;
┌─────result─┬─type─┐
│ 2025-01-03 │ Date │
└────────────┴──────┘
SELECT midpoint(toDateTime('2025-01-01 00:00:00'), toDateTime('2025-01-03 12:00:00')) AS result, toTypeName(result) AS type;
┌──────────────result─┬─type─────┐
│ 2025-01-02 06:00:00 │ DateTime │
└─────────────────────┴──────────┘
SELECT midpoint(toTime64('12:00:00', 0), toTime64('14:00:00', 0)) AS result, toTypeName(result) AS type;
┌───result─┬─type──────┐
│ 13:00:00 │ Time64(0) │
└──────────┴───────────┘
x와 y 중 더 작은 값을 반환합니다.
구문
인수
반환 값
x와 y 중 더 작은 값을 반환합니다. Float64
예시
사용 예시
도입 버전: v1.1.0
두 값 a와 b의 차이를 계산합니다. 결과는 항상 부호 있는 값입니다.
plus와 마찬가지로, date 또는 date with time 값에서 정수를 뺄 수 있습니다.
또한 date with time 값 간의 뺄셈도 지원하며, 이 경우 두 값 사이의 시간 차이가 반환됩니다.
구문
인수
반환 값
x에서 y를 뺀 값
예시
두 수 빼기
정수와 날짜의 뺄셈
SELECT minus(toDate('2025-01-01'),5)
mod
인수
반환 값
a % b의 나머지입니다.
예시
사용 예시
도입 버전: v1.1.0
나눗셈의 나머지를 계산합니다. 이 함수는 C++ % 연산자를 사용하는 레거시 modulo 구현이며, 인수가 음수이면 결과도 음수가 될 수 있습니다. 이 함수는 이전 테이블 파티셔닝 로직과의 하위 호환성을 위해 제공됩니다. 표준 동작이 필요하면 modulo 또는 positiveModulo를 사용하십시오.
구문
인수
반환 값
나눗셈의 나머지를 반환합니다. (U)Int* 또는 Float*
예시
기본 사용법
SELECT moduloLegacy(10, 3)
a를 b로 나눌 때의 나머지를 계산합니다. 함수 modulo와 유사하지만, moduloOrNull은 오른쪽 인수가 0이면 NULL을 반환합니다.
구문
별칭: modOrNull
인수
반환 값
x를 y로 나눈 나머지를 반환합니다. 제수가 0이면 null을 반환합니다.
예시
제수가 0일 때의 moduloOrNull
SELECT moduloOrNull(5, 0)
modulo와 유사하지만, 나누는 수가 0이면 modulo 함수처럼
예외가 발생하지 않고 0을 반환합니다.
구문
인수
반환 값
a % b의 나머지를 반환합니다. 제수가 0이면 0을 반환합니다.
예시
사용 예시
SELECT moduloOrZero(5, 0)
x와 y를 곱한 결과를 계산합니다.
구문
인수
반환 값
x와 y의 곱을 반환합니다.
예시
두 수를 곱하기
도입 버전: v22.12.0
두 개의 decimal 값에 대해 곱셈을 수행합니다. 결과 값의 유형은 Decimal256입니다.
결과 스케일은 result_scale 인수(범위 [0, 76]의 상수 Integer)로 명시적으로 지정할 수 있습니다. 지정하지 않으면 결과 스케일은 주어진 인수 중 최대 스케일이 됩니다.
이 함수들은 일반적인 multiply보다 훨씬 느리게 동작합니다.
정밀도를 제어할 필요가 없거나 빠른 계산이 필요하다면 multiply 사용을 고려하십시오. multiplyDecimal(a, b[, result_scale])
Decimal256
예시
사용 예시
SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)
SELECT multiplyDecimal(toDecimal256(-12, 0), toDecimal32(-2.1, 1), 1)
┌─multiply(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│ -26.8609633 │
└───────────────────────────────────────────────────────────┘
┌─multiplyDecimal(toDecimal64(-12.647, 3), toDecimal32(2.1239, 4))─┐
│ -26.8609 │
└──────────────────────────────────────────────────────────────────┘
SELECT
toDecimal64(-12.647987876, 9) AS a,
toDecimal64(123.967645643, 9) AS b,
multiplyDecimal(a, b);
SELECT
toDecimal64(-12.647987876, 9) AS a,
toDecimal64(123.967645643, 9) AS b,
a * b;
┌─────────────a─┬─────────────b─┬─multiplyDecimal(toDecimal64(-12.647987876, 9), toDecimal64(123.967645643, 9))─┐
│ -12.647987876 │ 123.967645643 │ -1567.941279108 │
└───────────────┴───────────────┴───────────────────────────────────────────────────────────────────────────────┘
Received exception from server (version 22.11.1):
Code: 407. DB::Exception: Received from localhost:9000. DB::Exception: Decimal math overflow:
While processing toDecimal64(-12.647987876, 9) AS a, toDecimal64(123.967645643, 9) AS b, a * b. (DECIMAL_OVERFLOW)
x의 부호를 반대로 바꿉니다. 결과는 항상 부호 있는 형식입니다.
구문
인수
반환 값
x의 부호를 반전한 값인 -x를 반환합니다.
예시
사용 예시
도입된 버전: v1.1.0
두 값 x와 y의 합을 계산합니다. 별칭: x + y (연산자)입니다.
정수와 날짜 또는 날짜/시간 값을 더할 수도 있습니다. 전자의 경우
날짜의 일 수가 증가하고, 후자의 경우
날짜/시간 값의 초 수가 증가합니다.
날짜와 시간도 더할 수 있습니다. Date와 Time을 더하면
DateTime이 됩니다. Date와 Time64를 더하거나, Date32와
Time 또는 Time64를 더하면 DateTime64가 됩니다.
구문
인수
x — 왼쪽 피연산자. - y — 오른쪽 피연산자.
반환 값
x와 y를 더한 값을 반환합니다
예시
두 숫자 더하기
정수와 날짜 더하기
SELECT plus(toDate('2025-01-01'),5)
SELECT toDate('2025-01-01') + CAST('14:30:25', 'Time')
x를 y로 나눌 때의 나머지를 계산합니다. modulo 함수와
유사하지만 positiveModulo는 항상 음수가 아닌 값을 반환합니다.
구문
별칭: positive_modulo, pmod
인수
반환 값
x에서 y로 나누어떨어지는 x 이하의 가장 가까운 정수를 뺀 값을 반환합니다.
예시
사용 예시
SELECT positiveModulo(-1, 10)
a를 b로 나눌 때의 나머지를 계산합니다. 함수 positiveModulo와 유사하지만, positiveModuloOrNull은 오른쪽 인수가 0이면 NULL을 반환합니다.
구문
positiveModuloOrNull(x, y)
positive_modulo_or_null, pmodOrNull
인수
반환 값
x에서 y로 나누어떨어지는 x 이하의 가장 큰 정수를 뺀 값을 반환합니다. 제수가 0이면 null을 반환합니다.
예시
positiveModuloOrNull
SELECT positiveModuloOrNull(5, 0)
