Numeric Functions Specification
수치 함수 상세 스펙
- Numeric Function은 단일 행을 입력받아 하나의 값을 반환하는 Single-Row Function이다.
* Single-Row Functions | 단일 행 함수 (URL)
[Oracle Database 19c] Single-Row Functions | 단일 행 함수
Single-Row Functions 단일 행 함수 - 단일 행 함수는 쿼리 대상 Table 혹은 View 의 모든 Row 들에 대해 수행한 연산의 결과를 단일 Row 로 반환한다. - 단일 행 함수는 SELECT 쿼리에서 아래 Clause 들에 위치할
dad-rock.tistory.com
Function Summary (함수 요약)
- ABS(n)
- n의 절댓값
- ACOS(n)
- Arc Cosine n 값 - ASIN(n)
- Arc Sine n 값 - ATAN(n)
- Arc Tangent n 값 - ATAN2(n1, n2)
- Arc Tangent2 n1, n2 값
- BITAND(expr1, expr2)
- expr1과 expr2를 Bitwise AND 연산한 값
- CEIL(n)
- n을 올림한 값
- COS(n)
- Cosine n 값
- COSH(n)
- Hyperbolic Cosine n 값
- EXP(n)
e^n 값 - FLOOR(n)
- n을 내림한 값
- LN(n)
- ln n 값
- LOG(n2, n1)
log_{n2} n1 값
- MOD(n2, n1)
n2 MOD n1 값
- NANVL(n2, n1)
- n2가 NaN 일 경우, n1으로 대체
- POWER(n2, n1)
n2 ^ n1 값
- REMAINDER(n2, n1)
- n2 MOD n1 값
- ROUND(n [, integer ])
- n을 반올림한 값
- SIGN(n)
- n의 부호값
- SIN(n)
- Sine n 값
- SINH(n)
- Hyperbolic Sine n 값
- SQRT(n)
- Square Root n 값
- TAN(n)
- Tangent n 값
- TANH(n)
- Hyperbolic Tangent n 값
- TRUNC(n1 [, n2 ])
- n1을 소수점 n2 자리 이하를 절삭한 값
- WIDTH_BUCKET(expr, min_value, max_value, num_buckets)
- expr 값의 히스토그램
Function Specification (함수 상세 스펙)
ABS(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 절댓값을 구하고자 하는 값이다. |
- n의 절댓값을 반환한다.
ACOS(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Arc Cosine을 구하고자 하는 값이다. - [-1, 1] 사이의 실수값만 허용된다. |
- Arc Cosine n 값을 반환한다.
- n은 [-1, 1] 사이의 실수값만 허용되며, [0, pi] 사이의 실수값(Radian)을 반환한다.
ASIN(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Arc Sine을 구하고자 하는 값이다. - [-1, 1] 사이의 실수값만 허용된다. |
- Arc Sine n 값을 반환한다.
- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.
ATAN(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Arc Tangent를 구하고자 하는 값 |
- Arc Tangent n 값을 반환한다.
- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.
ATAN2(n1, n2)
-> NUMBER| Parameter | Type | Description |
| n1 | Any Numeric Value | - Arc Tangent2를 구하고자 하는 값 |
| n2 | Any Numeric Value | - Arc Tangent2를 구하고자 하는 값 |
- Arc Tangent2 값을 반환한다.
- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.
BITAND(expr1, expr2)
-> NUMBER| Parameter | Type | Description |
| expr1 | NUMBER | - Bitwise AND 를 위한 피연산자 |
| expr2 |
NUMBER | - Bitwise AND 를 위한 피연산자 |
- expr1 과 expr2 를 Bitwise AND 연산한 결과를 반환한다.
- Argument 의 값 중 하나라도 NULL 이 입력되면, BITAND 는 NULL을 반환한다.
- expr1, expr2는 [\(-2^{n-1}\), \(2^{n-1}\)] 사이의 값만 허용되며,
허용범위를 초과한 값이 입력될 경우, 반환값은 정의되지 않았다.
CEIL(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 올림할 값 |
- 값을 올림한다.
COS(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Cosine을 구하고자 하는 값이다. |
- Cosine n 값을 반환한다.
COSH(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Hyperbolic Cosine을 구하고자 하는 값이다. |
- Hyperbolic Cosine n 값을 반환한다.
EXP(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - e를 밑으로 하는 거듭제곱을 구하고자 하는 값이다. |
- \(e^n\) 값을 반환한다.
(\(e\)는 Euler's Number로 약 2.71828 이다.)
FLOOR(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 내림할 값이다. |
- 값을 내림한다.
LN(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 자연로그를 구하고자 하는 값이다. - 0을 초과하는 값만 허용된다. |
- Natural Logarithm n 을 반환한다.
LOG(n2, n1)
-> NUMBER| Parameter | Type | Description |
| n2 | Numeric Data Type | - 로그 연산에서 Base(밑) 값이다. - 0을 초과하고, 1을 제외한 값만 허용된다. |
| n1 | Numeric Data Type | - 로그 연산에서 진수 값이다. - 0을 초과하는 값만 허용된다. |
- \(log_{n2} n1\) 값을 반환한다.
MOD(n2, n1)
-> Numeric Data Type| Parameter | Type | Description |
| n2 | Numeric Data Type | - 피제수이다. |
| n1 | Numeric Data Type | - 제수이다. |
- n2 % n1 값을 반환한다.
(n2를 n1으로 나누었을 때 나머지 값을 반환한다.)
- REMAINDER 함수는 ROUND 함수를 통해 나머지 값을 구하는 반면,
MOD 함수는 FLOOR 함수를 통해 나머지 값을 구한다.
NANVL(n2, n1)
-> Numeric Data Type| Parameter | Type | Description |
| n2 | BINARY_FLOAT BINARY_DOUBLE |
- NaN 검사 대상이다. |
| n1 | BINARY_FLOAT BINARY_DOUBLE |
- 대체할 값이다. |
- n2가 NaN 일 경우, n1을 반환한다.
- n2가 NaN 이 아닐 경우, n2를 반환한다.
POWER(n2, n1)
-> NUMBER (Otherwise)
-> BINARY_DOUBLE (Argument is BINARY_FLOAT or BINARY_DOUBLE)| Parameter | Type | Description |
| n2 | Numeric Data Type | - Base(밑) 값이다. |
| n1 | Numeric Data Type | - Exponent(지수) 값이다. - n2가 음수일 경우, n1은 정수만 허용된다. |
- \(n2^{n1}\) 을 반환한다.
REMAINDER(n2, n1)
-> Numeric Data Type
- n2 MOD n1 값을 반환한다.
(n2를 n1으로 나누었을 때 나머지 값을 반환한다.)
- MOD 함수는 FLOOR 함수를 통해 나머지 값을 구하는 반면,
REMAINDER 함수는 ROUND 함수를 통해 나머지 값을 구한다.
ROUND(n [, integer ])
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 반올림 대상 값이다. |
| integer | Numeric Data Type | - 반올림 시 몇째 자리에서 반올림할지에 대한 값이다. - 값이 없을 경우, 0으로 지정된다. |
- integer 자리까지 n을 반올림한다.
SIGN(n)
-> NUMBER| Parameter | Type | Description |
| n | Numeric Data Type | - 부호를 구하고자 하는 값이다. |
- n < 0 이면 -1,
n = 0 이면 0,
n > 0 이면 1 을 반환한다.
- n이 BINARY_FLOAT 혹은 BINARY_DOUBLE 인 경우에 대해서는
n < 0 이면 -1,
n ≥ 0 이거나 n = NaN 이면 1을 반환한다.
SIN(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Sine을 구하고자 하는 값이다. |
- Sine n 값을 반환한다.
SINH(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Hyperbolic Sine을 구하고자 하는 값이다. |
- Hyperbolic Sine n 값을 반환한다.
SQRT(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 제곱근을 구하고자 하는 값이다. |
- Square Root n 값을 반환한다.
- n이 BINARY_FLOAT 혹은 BINARY_DOUBLE 일 경우,
n ≥ 0 이면, 양수를
n = 0 이면, -0을
n < 0 이면 NaN 을 반환한다.
TAN(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Tangent를 구하고자 하는 값이다. |
- Tangent n 값을 반환한다.
TANH(n)
TANH(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Hyperbolic Tangent를 구하고자 하는 값이다. |
- Hyperbolic Tangent n 값을 반환한다.
TRUNC(n1 [, n2 ])
-> Numeric Data Type (Otherwise)
-> Number (n2 is included)| Parameter | Type | Description |
| n1 | Numeric Data Type | - 절사하고자 하는 수이다. |
| n2 | Numeric Data Type | - 절사할 Precision 이다. |
- n2 자리까지 절사된 n1 값을 리턴한다.
- n2의 기본값은 0 이다.
- n2에서 소수점 자리수는 양수로, 정수 자리수는 음수로 표현한다.
WIDTH_BUCKET(expr, min_value, max_value, num_buckets)| Parameter | Type | Description |
| expr | Numeric Data Type, DATE |
- 분할할 데이터로, 칼럼명 혹은 수식 등의 값이다. |
| min_value | Numeric Data Type, DATE |
- expr 값 중 분할할 가장 작은 값이다. |
| max_value | Numeric Data Type, DATE |
- expr 값 중 분할할 가장 큰 값이다. |
| num_buckets | Numeric Data Type (Positive Integer) |
- 분할할 그룹의 개수이다. |
- expr이 min_value 와 max_value 사이에서 어느 부분에 위치하고 있는지를 반환한다.
- expr이 null 이면, WIDTH_BUCKET 은 null 을 반환한다.
Reference: Oracle, SQL Language Reference : 7 Functions, URL, 2023년 4월 5일 검색
Numeric Functions Specification
수치 함수 상세 스펙
- Numeric Function은 단일 행을 입력받아 하나의 값을 반환하는 Single-Row Function이다.
* Single-Row Functions | 단일 행 함수 (URL)
[Oracle Database 19c] Single-Row Functions | 단일 행 함수
Single-Row Functions 단일 행 함수 - 단일 행 함수는 쿼리 대상 Table 혹은 View 의 모든 Row 들에 대해 수행한 연산의 결과를 단일 Row 로 반환한다. - 단일 행 함수는 SELECT 쿼리에서 아래 Clause 들에 위치할
dad-rock.tistory.com
Function Summary (함수 요약)
- ABS(n)
- n의 절댓값
- ACOS(n)
- Arc Cosine n 값 - ASIN(n)
- Arc Sine n 값 - ATAN(n)
- Arc Tangent n 값 - ATAN2(n1, n2)
- Arc Tangent2 n1, n2 값
- BITAND(expr1, expr2)
- expr1과 expr2를 Bitwise AND 연산한 값
- CEIL(n)
- n을 올림한 값
- COS(n)
- Cosine n 값
- COSH(n)
- Hyperbolic Cosine n 값
- EXP(n)
e^n 값 - FLOOR(n)
- n을 내림한 값
- LN(n)
- ln n 값
- LOG(n2, n1)
log_{n2} n1 값
- MOD(n2, n1)
n2 MOD n1 값
- NANVL(n2, n1)
- n2가 NaN 일 경우, n1으로 대체
- POWER(n2, n1)
n2 ^ n1 값
- REMAINDER(n2, n1)
- n2 MOD n1 값
- ROUND(n [, integer ])
- n을 반올림한 값
- SIGN(n)
- n의 부호값
- SIN(n)
- Sine n 값
- SINH(n)
- Hyperbolic Sine n 값
- SQRT(n)
- Square Root n 값
- TAN(n)
- Tangent n 값
- TANH(n)
- Hyperbolic Tangent n 값
- TRUNC(n1 [, n2 ])
- n1을 소수점 n2 자리 이하를 절삭한 값
- WIDTH_BUCKET(expr, min_value, max_value, num_buckets)
- expr 값의 히스토그램
Function Specification (함수 상세 스펙)
ABS(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 절댓값을 구하고자 하는 값이다. |
- n의 절댓값을 반환한다.
ACOS(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Arc Cosine을 구하고자 하는 값이다. - [-1, 1] 사이의 실수값만 허용된다. |
- Arc Cosine n 값을 반환한다.
- n은 [-1, 1] 사이의 실수값만 허용되며, [0, pi] 사이의 실수값(Radian)을 반환한다.
ASIN(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Arc Sine을 구하고자 하는 값이다. - [-1, 1] 사이의 실수값만 허용된다. |
- Arc Sine n 값을 반환한다.
- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.
ATAN(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Arc Tangent를 구하고자 하는 값 |
- Arc Tangent n 값을 반환한다.
- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.
ATAN2(n1, n2)
-> NUMBER| Parameter | Type | Description |
| n1 | Any Numeric Value | - Arc Tangent2를 구하고자 하는 값 |
| n2 | Any Numeric Value | - Arc Tangent2를 구하고자 하는 값 |
- Arc Tangent2 값을 반환한다.
- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.
BITAND(expr1, expr2)
-> NUMBER| Parameter | Type | Description |
| expr1 | NUMBER | - Bitwise AND 를 위한 피연산자 |
| expr2 |
NUMBER | - Bitwise AND 를 위한 피연산자 |
- expr1 과 expr2 를 Bitwise AND 연산한 결과를 반환한다.
- Argument 의 값 중 하나라도 NULL 이 입력되면, BITAND 는 NULL을 반환한다.
- expr1, expr2는 [\(-2^{n-1}\), \(2^{n-1}\)] 사이의 값만 허용되며,
허용범위를 초과한 값이 입력될 경우, 반환값은 정의되지 않았다.
CEIL(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 올림할 값 |
- 값을 올림한다.
COS(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Cosine을 구하고자 하는 값이다. |
- Cosine n 값을 반환한다.
COSH(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - Hyperbolic Cosine을 구하고자 하는 값이다. |
- Hyperbolic Cosine n 값을 반환한다.
EXP(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - e를 밑으로 하는 거듭제곱을 구하고자 하는 값이다. |
- \(e^n\) 값을 반환한다.
(\(e\)는 Euler's Number로 약 2.71828 이다.)
FLOOR(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 내림할 값이다. |
- 값을 내림한다.
LN(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 자연로그를 구하고자 하는 값이다. - 0을 초과하는 값만 허용된다. |
- Natural Logarithm n 을 반환한다.
LOG(n2, n1)
-> NUMBER| Parameter | Type | Description |
| n2 | Numeric Data Type | - 로그 연산에서 Base(밑) 값이다. - 0을 초과하고, 1을 제외한 값만 허용된다. |
| n1 | Numeric Data Type | - 로그 연산에서 진수 값이다. - 0을 초과하는 값만 허용된다. |
- \(log_{n2} n1\) 값을 반환한다.
MOD(n2, n1)
-> Numeric Data Type| Parameter | Type | Description |
| n2 | Numeric Data Type | - 피제수이다. |
| n1 | Numeric Data Type | - 제수이다. |
- n2 % n1 값을 반환한다.
(n2를 n1으로 나누었을 때 나머지 값을 반환한다.)
- REMAINDER 함수는 ROUND 함수를 통해 나머지 값을 구하는 반면,
MOD 함수는 FLOOR 함수를 통해 나머지 값을 구한다.
NANVL(n2, n1)
-> Numeric Data Type| Parameter | Type | Description |
| n2 | BINARY_FLOAT BINARY_DOUBLE |
- NaN 검사 대상이다. |
| n1 | BINARY_FLOAT BINARY_DOUBLE |
- 대체할 값이다. |
- n2가 NaN 일 경우, n1을 반환한다.
- n2가 NaN 이 아닐 경우, n2를 반환한다.
POWER(n2, n1)
-> NUMBER (Otherwise)
-> BINARY_DOUBLE (Argument is BINARY_FLOAT or BINARY_DOUBLE)| Parameter | Type | Description |
| n2 | Numeric Data Type | - Base(밑) 값이다. |
| n1 | Numeric Data Type | - Exponent(지수) 값이다. - n2가 음수일 경우, n1은 정수만 허용된다. |
- \(n2^{n1}\) 을 반환한다.
REMAINDER(n2, n1)
-> Numeric Data Type
- n2 MOD n1 값을 반환한다.
(n2를 n1으로 나누었을 때 나머지 값을 반환한다.)
- MOD 함수는 FLOOR 함수를 통해 나머지 값을 구하는 반면,
REMAINDER 함수는 ROUND 함수를 통해 나머지 값을 구한다.
ROUND(n [, integer ])
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 반올림 대상 값이다. |
| integer | Numeric Data Type | - 반올림 시 몇째 자리에서 반올림할지에 대한 값이다. - 값이 없을 경우, 0으로 지정된다. |
- integer 자리까지 n을 반올림한다.
SIGN(n)
-> NUMBER| Parameter | Type | Description |
| n | Numeric Data Type | - 부호를 구하고자 하는 값이다. |
- n < 0 이면 -1,
n = 0 이면 0,
n > 0 이면 1 을 반환한다.
- n이 BINARY_FLOAT 혹은 BINARY_DOUBLE 인 경우에 대해서는
n < 0 이면 -1,
n ≥ 0 이거나 n = NaN 이면 1을 반환한다.
SIN(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Sine을 구하고자 하는 값이다. |
- Sine n 값을 반환한다.
SINH(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Hyperbolic Sine을 구하고자 하는 값이다. |
- Hyperbolic Sine n 값을 반환한다.
SQRT(n)
-> Numeric Data Type| Parameter | Type | Description |
| n | Numeric Data Type | - 제곱근을 구하고자 하는 값이다. |
- Square Root n 값을 반환한다.
- n이 BINARY_FLOAT 혹은 BINARY_DOUBLE 일 경우,
n ≥ 0 이면, 양수를
n = 0 이면, -0을
n < 0 이면 NaN 을 반환한다.
TAN(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Tangent를 구하고자 하는 값이다. |
- Tangent n 값을 반환한다.
TANH(n)
TANH(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE (n is BINARY_FLOAT)| Parameter | Type | Description |
| n | Numeric Data Type | - Hyperbolic Tangent를 구하고자 하는 값이다. |
- Hyperbolic Tangent n 값을 반환한다.
TRUNC(n1 [, n2 ])
-> Numeric Data Type (Otherwise)
-> Number (n2 is included)| Parameter | Type | Description |
| n1 | Numeric Data Type | - 절사하고자 하는 수이다. |
| n2 | Numeric Data Type | - 절사할 Precision 이다. |
- n2 자리까지 절사된 n1 값을 리턴한다.
- n2의 기본값은 0 이다.
- n2에서 소수점 자리수는 양수로, 정수 자리수는 음수로 표현한다.
WIDTH_BUCKET(expr, min_value, max_value, num_buckets)| Parameter | Type | Description |
| expr | Numeric Data Type, DATE |
- 분할할 데이터로, 칼럼명 혹은 수식 등의 값이다. |
| min_value | Numeric Data Type, DATE |
- expr 값 중 분할할 가장 작은 값이다. |
| max_value | Numeric Data Type, DATE |
- expr 값 중 분할할 가장 큰 값이다. |
| num_buckets | Numeric Data Type (Positive Integer) |
- 분할할 그룹의 개수이다. |
- expr이 min_value 와 max_value 사이에서 어느 부분에 위치하고 있는지를 반환한다.
- expr이 null 이면, WIDTH_BUCKET 은 null 을 반환한다.
Reference: Oracle, SQL Language Reference : 7 Functions, URL, 2023년 4월 5일 검색
