수학 함수

acos

도입 버전: v1.1

인수의 아크 코사인 값을 반환합니다.

구문

acos(x)

인수(Arguments)

x — 아크 코사인(arc cosine)을 계산할 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 아크 코사인(arc cosine)을 반환합니다. 반환 타입은 Float*입니다.

예시(Examples)

사용 예시(Usage example)

SELECT acos(0.5);

1.0471975511965979

acosh

도입 버전: v20.12

역쌍곡 코사인 값을 반환합니다.

구문

acosh(x)

인수

x — 각의 쌍곡 코사인 값. 값의 범위: 1 ≤ x < +∞. (U)Int* 또는 Float* 또는 Decimal*

반환 값

라디안 단위의 각도를 반환합니다. 값의 범위: 0 ≤ acosh(x) < +∞. Float64

예시

사용 예시

SELECT acosh(1)

asin

도입 버전: v1.1

지정된 인자의 아크사인을 계산합니다. 인자가 [-1, 1] 범위에 있을 때 [-pi() / 2, pi() / 2] 범위의 값을 반환합니다.

구문

asin(x)

인자

x — 아크사인 값을 계산할 인자입니다. (U)Int* 또는 Float* 또는 Decimal

반환값

제공된 인자 x의 아크사인 값을 반환합니다. 반환 타입은 Float64입니다.

예시

inverse

SELECT asin(1.0) = pi() / 2, sin(asin(1)), asin(sin(1))

1 1 1

float32

SELECT toTypeName(asin(1.0::Float32))

Float64

nan

SELECT asin(1.1), asin(-2), asin(inf), asin(nan)

nan nan nan nan

asinh

도입 버전: v20.12

역쌍곡 사인(inverse hyperbolic sine) 값을 반환합니다.

구문

asinh(x)

인수

x — 각도의 쌍곡선 사인 값입니다. 구간 -∞ < x < +∞에 속하는 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

라디안 단위의 각도를 반환합니다. 구간 -∞ < asinh(x) < +∞에 속하는 값입니다. Float64

예시

기본 사용법

SELECT asinh(0)

atan

도입 버전: v1.1

인수의 아크탄젠트 값을 반환합니다.

구문

atan(x)

인수

x — 아크탄젠트(arc tangent)를 계산할 대상 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 아크탄젠트(arc tangent) 값을 반환합니다. Float*

예시

사용 예시

SELECT atan(1);

0.7853981633974483

atan2

도입 버전: v20.12

유클리드 평면에서 양의 x축과 점 (x, y) ≠ (0, 0)으로 향하는 반직선 사이의 각도를 라디안 단위로 나타낸 atan2 값을 반환합니다.

구문

atan2(y, x)

인수

y — 반직선이 통과하는 점의 y-좌표입니다. (U)Int* 또는 Float* 또는 Decimal*
x — 반직선이 통과하는 점의 x-좌표입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

-π < θ ≤ π를 만족하는 각도 θ를 라디안 단위의 Float64 값으로 반환합니다.

예시

사용 예시

SELECT atan2(1, 1)

0.7853981633974483

atanh

도입된 버전: v20.12

역쌍곡 탄젠트 함수의 값을 반환합니다.

구문

atanh(x)

인수

x — 쌍곡선 탄젠트의 값. 값의 범위: -1 < x < 1. (U)Int*, Float* 또는 Decimal*. (U)Int* 또는 Float* 또는 Decimal*

반환 값

라디안 단위의 각도를 반환합니다. 반환 값의 범위: -∞ < atanh(x) < +∞ Float64

예시

사용 예시

SELECT atanh(0)

cbrt

도입: v1.1

인수의 세제곱근을 반환합니다.

구문

cbrt(x)

인수

x — 세제곱근을 구할 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 세제곱근을 반환합니다. Float*

예시

사용 예

SELECT cbrt(8);

cos

도입: v1.1

인수의 코사인 값을 반환합니다.

구문

cos(x)

인수

x — 라디안 단위의 각도. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 코사인 값을 반환합니다. Float*

예제

사용 예제

SELECT cos(0);

cosh

도입 버전: v20.12

인수의 쌍곡 코사인을 반환합니다.

구문

cosh(x)

인수

x — 라디안 단위의 각도입니다. 값의 범위는 -∞ < x < +∞입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

반환되는 값의 범위는 1 ≤ cosh(x) < +∞입니다. Float64

예시

기본 사용법

SELECT cosh(0)

degrees

도입 버전: v22.2

라디안 값을 도 단위로 변환합니다.

구문

degrees(x)

인수

x — 라디안 단위의 입력값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x를 도(degree) 단위 값으로 변환하여 반환합니다. Float64

예시

기본 사용법

SELECT degrees(3.141592653589793)

e

도입 버전: v1.1

오일러 상수(e)를 반환합니다.

구문

e()

인수

없음

반환 값

오일러 상수(Euler 상수)를 반환합니다. 반환 타입: Float64

예시

사용 예시

SELECT e();

2.718281828459045

erf

도입 버전: v1.1

x가 0 이상일 때, erf(x/(σ√2))는 표준편차 σ를 갖는 정규분포를 따르는 확률 변수가 기대값에서 x보다 더 크게 벗어난 값을 가질 확률입니다.

구문

erf(x)

인수

x — 오차 함수 값을 계산할 대상 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

오차 함수 값을 반환합니다. Float*

예제

3시그마 규칙(Three sigma rule)

SELECT erf(3 / sqrt(2))

┌─erf(divide(3, sqrt(2)))─┐
│      0.9973002039367398 │
└─────────────────────────┘

erfc

도입 버전: v1.1

큰 x 값에서도 정밀도를 잃지 않고 1-erf(x)에 가까운 값을 반환합니다.

구문

erfc(x)

인수

x — 오차 함수 값을 계산할 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

상보 오차 함수의 값을 반환합니다. Float*

예시

사용 예시

SELECT erfc(0);

exp

도입 버전: v1.1

x가 함수에 전달된 인수일 때, e의 x 제곱값을 반환합니다.

구문

exp(x)

인수

x — 지수. (U)Int* 또는 Float* 또는 Decimal*

반환값

e^x를 반환합니다. Float*

예제

기본 사용법

SELECT round(exp(-1), 4)

┌─round(exp(-1), 4)─┐
│            0.3679 │
└───────────────────┘

exp10

도입된 버전: v1.1

주어진 인수를 지수로 사용한 10의 거듭제곱 값을 반환합니다.

구문

exp10(x)

인수

x — 지수 값. (U)Int* 또는 Float* 또는 Decimal*

반환 값

10^x를 반환합니다. Float*

예제

사용 예제

SELECT exp10(2);

exp2

도입: v1.1

지정된 인수를 지수로 한 2의 거듭제곱을 반환합니다.

구문

exp2(x)

인수(Arguments)

x — 지수. (U)Int* 또는 Float* 또는 Decimal*

반환 값(Returned value)

2^x를 반환합니다. Float*

예시(Examples)

사용 예시(Usage example)

SELECT exp2(3);

factorial

도입된 버전: v22.11

정수 값의 팩토리얼을 계산합니다. 0의 팩토리얼은 1입니다. 마찬가지로 factorial() FUNCTION은 모든 음수 값에 대해 1을 반환합니다. 입력 인수의 최댓값은 20이며, 값이 21 이상이면 예외가 발생합니다.

구문

factorial(n)

인수

n — 팩토리얼을 계산할 정수입니다. 최대값은 20입니다. (U)Int8/16/32/64

반환 값

입력값의 팩토리얼을 UInt64로 반환합니다. 입력값이 0 또는 음수일 경우 1을 반환합니다. UInt64

예시

사용 예시

factorial(10)

hypot

도입 버전: v20.12

직각삼각형의 빗변 길이를 반환합니다. hypot 함수는 매우 크거나 매우 작은 수를 제곱할 때 발생할 수 있는 문제를 방지합니다.

구문

hypot(x, y)

매개변수

x — 직각삼각형에서 직각을 이루는 첫 번째 변. (U)Int* 또는 Float* 또는 Decimal*
y — 직각삼각형에서 직각을 이루는 두 번째 변. (U)Int* 또는 Float* 또는 Decimal*

반환 값

직각삼각형의 빗변 길이를 반환합니다. Float64

예제

기본 사용 예

SELECT hypot(1, 1)

1.4142135623730951

intExp10

도입 버전: v1.1

exp10과 유사하지만 UInt64 숫자를 반환합니다.

구문

intExp10(x)

인수

x — 지수입니다. Int* 또는 UInt* 또는 Float*

반환값

10^x를 반환합니다. UInt64

예시

사용 예시

SELECT intExp10(2);

intExp2

도입 버전: v1.1

exp2와 유사하지만 UInt64 정수를 반환합니다.

구문

intExp2(x)

인수

x — 지수. Int* 또는 UInt* 또는 Float*

반환 값

2^x를 반환합니다. UInt64

예제

사용 예제

SELECT intExp2(3);

lgamma

도입 버전: v1.1

감마 함수의 로그를 반환합니다.

구문

lgamma(x)

인수

x — 감마 함수의 로그값을 계산할 숫자. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 감마 함수의 로그값을 반환합니다. Float*

예시

사용 예시

SELECT lgamma(5);

3.1780538303479458

log

도입: v1.1

인수의 자연 로그를 반환합니다.

구문

log(x)

별칭(Aliases): ln

인수(Arguments)

x — 자연 로그를 계산할 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값(Returned value)

x의 자연 로그를 반환합니다. Float*

예시(Examples)

사용 예시(Usage example)

SELECT log(10);

2.302585092994046

log10

도입: v1.1

인수의 상용로그(10진 로그)를 반환합니다.

구문

log10(x)

인수

x — 상용로그(밑이 10인 로그)를 계산할 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 상용로그를 반환합니다. Float*

예시

사용 예시

SELECT log10(100);

log1p

도입된 버전: v20.12

log(1+x)를 계산합니다. x의 값이 작은 경우 log(1+x)보다 log1p(x)를 사용하는 것이 더 정확합니다.

구문

log1p(x)

인수

x — 구간 -1 < x < +∞에 속하는 값. (U)Int* 또는 Float* 또는 Decimal*

반환 값

구간 -∞ < log1p(x) < +∞ 에 속하는 값을 반환합니다. Float64

예시

사용 예시

SELECT log1p(0)

log2

도입 버전: v1.1

인자의 이진 로그를 반환합니다.

구문

log2(x)

인자

x — 이진 로그를 계산할 숫자입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 이진 로그를 반환합니다. Float*

예제

사용 예제

SELECT log2(8);

pi

도입된 버전: v1.1

원주율 π 값을 반환합니다.

구문

pi()

인수(Arguments)

없음.

반환 값(Returned value)

pi를 반환합니다. 반환 타입은 Float64입니다.

예시(Examples)

사용 예시(Usage example)

SELECT pi();

3.141592653589793

pow

도입: v1.1

x의 y 제곱 값을 반환합니다.

구문

pow(x, y)

별칭: power

인수

x — 밑. (U)Int8/16/32/64 또는 Float* 또는 Decimal*
y — 지수. (U)Int8/16/32/64 또는 Float* 또는 Decimal*

반환값

x^y를 Float64 형식으로 반환합니다.

예시

사용 예시

SELECT pow(2, 3);

radians

도입 버전: v22.2

각도의 단위를 도(degree)에서 라디안(radian)으로 변환합니다.

구문

radians(x)

인수(Arguments)

x — 도(degree) 단위의 입력 값. (U)Int* 또는 Float* 또는 Decimal*

반환 값

라디안(radian) 단위의 값을 반환합니다. Float64

예시(Examples)

사용 예시(Usage example)

SELECT radians(180)

3.141592653589793

sign

도입된 버전: v21.2

실수의 부호를 반환합니다.

구문

sign(x)

인수

x — -∞부터 +∞까지의 값입니다. (U)Int* 또는 Decimal* 또는 Float*

반환 값

x < 0일 때 -1, x = 0일 때 0, x > 0일 때 1을 반환합니다. Int8

예제

0의 부호

SELECT sign(0)

양수일 때의 부호

SELECT sign(1)

음수일 때의 부호

SELECT sign(-1)

-1

sin

도입 버전: v

인수의 사인(sine)을 반환합니다.

구문

sin(x)

인수

x — 사인 값을 계산할 숫자입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 사인 값을 반환합니다.

예시

간단한 예

SELECT sin(1.23)

0.9424888019316975

sinh

도입 버전: v20.12

쌍곡선 사인(hyperbolic sine)을 반환합니다.

구문

sinh(x)

인수

x — 라디안 단위의 각도입니다. 값의 범위는 -∞ < x < +∞입니다. (U)Int* 또는 Float* 또는 Decimal*

반환값

구간 -∞ < sinh(x) < +∞에 속하는 값을 반환합니다. Float64

예시

사용 예시

SELECT sinh(0)

sqrt

도입 버전: v1.1

인수의 제곱근을 반환합니다.

구문

sqrt(x)

인수

x — 제곱근을 구할 값입니다. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 제곱근을 반환합니다. Float*

예시

사용 예시

SELECT sqrt(16);

tan

도입: v1.1

인수의 탄젠트 값을 반환합니다.

구문

tan(x)

인수

x — 라디안 값의 각도. (U)Int* 또는 Float* 또는 Decimal*

반환 값

x의 탄젠트 값을 반환합니다. Float*

예시

사용 예시

SELECT tan(0);

tanh

도입된 버전: v20.1

쌍곡선 탄젠트를 반환합니다.

구문

tanh(x)

인수

x — 라디안 단위의 각도입니다. 값의 구간: -∞ < x < +∞. (U)Int* 또는 Float* 또는 Decimal*

반환 값

-1 < tanh(x) < 1 구간의 값을 반환합니다. Float*

예시

사용 예시

SELECT tanh(0)

tgamma

도입된 버전: v1.1

감마 함수값을 반환합니다.

문법

tgamma(x)

인수

x — 감마 함수 값을 계산할 수. (U)Int* 또는 Float* 또는 Decimal*

반환 값

감마 함수 값을 반환합니다. Float*

예시

사용 예시

SELECT tgamma(5);

widthBucket

도입된 버전: v23.3

히스토그램에서 매개변수 operand가 속하는 버킷의 번호를 반환합니다. 이 히스토그램은 low부터 high까지의 범위를 동일한 너비의 count개의 버킷으로 나눈 것입니다. operand가 low보다 작으면 0을 반환하고, operand가 high보다 크거나 같으면 count+1을 반환합니다. 다른 데이터베이스와의 호환성을 위해 대소문자를 구분하지 않는 별칭 WIDTH_BUCKET도 제공합니다.

구문

widthBucket(operand, low, high, count)

별칭: width_bucket

인수

operand — 버킷을 결정할 값입니다. (U)Int8/16/32/64
low — 히스토그램 범위의 하한값입니다. (U)Int8/16/32/64
high — 히스토그램 범위의 상한값입니다. (U)Int8/16/32/64
count — 동일한 너비를 가진 버킷 개수입니다. 0이 될 수 없습니다. UInt8/16/32/64

반환 값

버킷 번호를 정수로 반환합니다. operand < low 이면 0을, operand >= high 이면 count+1을 반환합니다. UInt8/16/32/64

예시

사용 예시

widthBucket(10.15, -8.6, 23, 18)

acos​

acosh​

asin​

asinh​

atan​

atan2​

atanh​

cbrt​

cos​

cosh​

degrees​

e​

erf​

erfc​

exp​

exp10​

exp2​

factorial​

hypot​

intExp10​

intExp2​

lgamma​

log​

log10​

log1p​

log2​

pi​

pow​

radians​

sign​

sin​

sinh​

sqrt​

tan​

tanh​

tgamma​

widthBucket​

acos

acosh

asin

asinh

atan

atan2

atanh

cbrt

cos

cosh

degrees

e

erf

erfc

exp

exp10

exp2

factorial

hypot

intExp10

intExp2

lgamma

log

log10

log1p

log2

pi

pow

radians

sign

sin

sinh

sqrt

tan

tanh

tgamma

widthBucket