수치 연산 함수

ABS

ABS(number_expr)

함수는 지정된 인자 값의 절대값을 반환하며, 리턴 값의 타입은 주어진 인자의 타입과 같다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

number_expr – 수치 값을 반환하는 임의의 연산식이다.

Return type

number_expr의 타입

--it returns the absolute value of the argument
SELECT ABS(12.3), ABS(-12.3), ABS(-12.3000), ABS(0.0);
  abs(12.3)             abs(-12.3)            abs(-12.3000)         abs(0.0)
================================================================================
  12.3                  12.3                  12.3000               .0

ACOS

ACOS(x)

ACOS 함수는 인자의 아크 코사인(arc cosine) 값을 반환한다. 즉, 코사인이 x 인 값을 라디안 단위로 반환하며, 리턴 값은 DOUBLE 타입이다. x 는 -1 이상 1 이하의 값이어야 하며, 그 외의 경우 에러를 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT ACOS(1), ACOS(0), ACOS(-1);
  acos(1)                   acos(0)                  acos(-1)
==================================================================================
  0.000000000000000e+00     1.570796326794897e+00     3.141592653589793e+00

ASIN

ASIN(x)

ASIN 함수는 인자의 아크 사인(arc sine) 값을 반환한다. 즉, 사인이 x 인 값을 라디안 단위로 반환하며, 리턴 값은 DOUBLE 타입이다. x 는 -1 이상 1 이하의 값이어야 하며, 그 외의 경우 에러를 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT ASIN(1), ASIN(0), ASIN(-1);
  asin(1)                   asin(0)                  asin(-1)
==============================================================================
  1.570796326794897e+00     0.000000000000000e+00    -1.570796326794897e+00

ATAN

ATAN([y, ]x)

ATAN 함수는 탄젠트가 x 인 값을 라디안 단위로 반환한다. 인자 y 는 생략될 수 있으며, y 가 지정되는 경우 함수는 y / x 의 아크 탄젠트 값을 계산한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x,y – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT ATAN(1), ATAN(-1), ATAN(1,-1);
                   atan(1)                  atan(-1)              atan2(1, -1)
==============================================================================
     7.853981633974483e-01    -7.853981633974483e-01     2.356194490192345e+000

ATAN2

ATAN2(y, x)

ATAN2 함수는 y / x 의 아크 탄젠트 값을 라디안 단위로 반환하며, ATAN() 와 유사하게 동작한다. 인자 x, y 가 모두 지정되어야 한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x,y – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT ATAN2(1,1), ATAN2(-1,-1), ATAN2(Pi(),0);
atan2(1, 1)             atan2(-1, -1)           atan2( pi(), 0)
==============================================================================
 7.853981633974483e-01    -2.356194490192345e+00     1.570796326794897e+00

CEIL

CEIL(number_operand)

CEIL 함수는 인자보다 크거나 같은 최소 정수 값을 인자의 타입으로 반환한다. 리턴 값은 number_operand 인자로 지정된 값의 유효 자릿수를 따른다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

number_operand – 수치 값을 반환하는 임의의 연산식이다.

Return type

INT

SELECT CEIL(34567.34567), CEIL(-34567.34567);
  ceil(34567.34567)     ceil(-34567.34567)
============================================
  34568.00000           -34567.00000

SELECT CEIL(34567.1), CEIL(-34567.1);
  ceil(34567.1)         ceil(-34567.1)
=============================
  34568.0         -34567.0

CONV

CONV(number, from_base, to_base)

CONV 함수는 숫자의 진수를 변환하는 함수이며, 진수가 변환된 숫자를 문자열로 반환한다. 진수의 최소값은 2, 최대값은 36이다. 반환할 숫자의 진수를 나타내는 to_base 가 음수이면 입력 숫자인 number 가 부호 있는(signed) 숫자로 간주되고, 그 외의 경우에는 부호 없는(unsigned) 숫자로 간주된다. from_base 또는 to_base에 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters
  • number – 입력 숫자

  • from_base – 입력 숫자의 진수

  • to_base – 반환할 숫자의 진수

Return type

STRING

SELECT CONV('f',16,2);
'1111'
SELECT CONV('6H',20,8);
'211'
SELECT CONV(-30,10,-20);
'-1A'

COS

COS(x)

COS 함수는 인자의 코사인(cosine) 값을 반환하며, 인자 x 는 라디안 값이어야 한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT COS(pi()/6), COS(pi()/3), COS(pi());
  cos( pi()/6)              cos( pi()/3)                cos( pi())
==============================================================================
  8.660254037844387e-01     5.000000000000001e-01    -1.000000000000000e+00

COT

COT(x)

COT 함수는 인자 x 의 코탄젠트(cotangent) 값을 반환한다. 즉, 탄젠트가 x 인 값을 라디안 단위로 반환하며, 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT COT(1), COT(-1), COT(0);
  cot(1)                   cot(-1)   cot(0)
==========================================================================
  6.420926159343306e-01    -6.420926159343306e-01  NULL

CRC32

CRC32(string)

CRC32 함수는 32비트 정수로 순환 중복 검사 값을 반환한다. NULL을 입력하면 NULL을 반환한다. :param string: 문자열 값을 반환하는 표현식 :rtype: INTEGER

SELECT CRC32('cubrid');
   crc32('cubrid')
==================
         908740081

DEGREES

DEGREES(x)

DEGREES 함수는 라디안 단위로 지정된 인자 x 를 각도로 환산하여 반환한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT DEGREES(pi()/6), DEGREES(pi()/3), DEGREES (pi());
  degrees( pi()/6)          degrees( pi()/3)            degrees( pi())
==============================================================================
  3.000000000000000e+01     5.999999999999999e+01     1.800000000000000e+02

DRANDOM, DRAND

DRANDOM([seed])
DRAND([seed])

DRANDOM / DRAND 함수는 구간 0.0 이상 1.0 미만의 구간에서 임의의 이중 정밀도(double-precision) 부동 소수점 값을 반환하며, seed 인자를 지정할 수 있다. seed 인자의 타입은 INTEGER 이며, 실수가 지정되면 반올림하고, INTEGER 범위를 초과하면 에러를 반환한다.

seed 값이 주어지지 않은 경우 DRAND()는 연산을 출력하는 행(row)의 개수와 관계없이 한 문장 내에서 1회만 연산을 수행하여 오직 한 개의 임의값만 생성하는 반면, DRANDOM()는 함수가 호출될 때마다 매번 연산을 수행하므로 한 문장 내에서 여러 개의 다른 임의 값을 생성한다. 따라서, 무작위 순서로 행을 출력하기 위해서는 ORDER BY 절에 DRANDOM()을 이용해야 한다. 무작위 정수값을 구하기 위해서는 RANDOM()를 사용한다.

Parameters

seed – seed 값

Return type

DOUBLE

SELECT DRAND(), DRAND(1), DRAND(1.4);
                   drand()                  drand(1)                drand(1.4)
==============================================================================
    2.849646518006921e-001    4.163034446537495e-002    4.163034446537495e-002
CREATE TABLE rand_tbl (
    id INT,
    name VARCHAR(255)
);

INSERT INTO rand_tbl VALUES
    (1, 'a'), (2, 'b'), (3, 'c'), (4, 'd'), (5, 'e'),
    (6, 'f'), (7, 'g'), (8, 'h'), (9, 'i'), (10, 'j');

SELECT * FROM rand_tbl;
           id  name
===================================
            1  'a'
            2  'b'
            3  'c'
            4  'd'
            5  'e'
            6  'f'
            7  'g'
            8  'h'
            9  'i'
           10  'j'
--drandom() returns random values on every row
SELECT DRAND(), DRANDOM() FROM rand_tbl;
   drand()                 drandom()
==============================================================================
   7.638782921842098e-001    1.018707846308786e-001
   7.638782921842098e-001    3.191320535905026e-001
   7.638782921842098e-001    3.461714529862361e-001
   7.638782921842098e-001    6.791894283883175e-001
   7.638782921842098e-001    4.533829767754143e-001
   7.638782921842098e-001    1.714224677266762e-001
   7.638782921842098e-001    1.698049867244484e-001
   7.638782921842098e-001    4.507583849604786e-002
   7.638782921842098e-001    5.279091769157994e-001
   7.638782921842098e-001    7.021088290047914e-001
--selecting rows in random order
SELECT * FROM rand_tbl ORDER BY DRANDOM();
           id  name
===================================
            6  'f'
            2  'b'
            7  'g'
            8  'h'
            1  'a'
            4  'd'
           10  'j'
            9  'i'
            5  'e'
            3  'c'

EXP

EXP(x)

EXP 함수는 자연로그의 밑수인 e를 x 제곱한 값을 DOUBLE 타입으로 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT EXP(1), EXP(0);
  exp(1)                    exp(0)
====================================================
  2.718281828459045e+000 1.000000000000000e+000
SELECT EXP(-1), EXP(2.00);
  exp(-1)                 exp(2.00)
====================================================
  3.678794411714423e-001 7.389056098930650e+000

FLOOR

FLOOR(number_operand)

FLOOR 함수는 인자보다 작거나 같은 최대 정수 값을 반환하며, 리턴 값의 타입은 인자의 타입과 같다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

number_operand – 수치 값을 반환하는 임의의 연산식이다.

Return type

number_operand의 타입

--it returns the largest integer less than or equal to the arguments
SELECT FLOOR(34567.34567), FLOOR(-34567.34567);
  floor(34567.34567)    floor(-34567.34567)
============================================
  34567.00000           -34568.00000
SELECT FLOOR(34567), FLOOR(-34567);
  floor(34567)   floor(-34567)
=============================
         34567         -34567

HEX

HEX(n)

HEX 함수는 문자열을 인자로 지정하면 해당 문자열에 대한 16진수 문자열을 반환하고, 숫자를 인자로 지정하면 해당 숫자에 대한 16진수 문자열을 반환한다. 숫자를 인자로 지정하면 CONV(num, 10, 16)과 같은 값을 반환한다.

Parameters

n – 문자열 또는 숫자

Return type

STRING

SELECT HEX('ab'), HEX(128), CONV(HEX(128), 16, 10);
hex('ab')             hex(128)              conv(hex(128), 16, 10)
==================================================================
  '6162'                '80'                  '128'

LN

LN(x)

LN 함수는 진수 x 의 자연 로그(밑수가 e인 로그) 값을 반환하며, 리턴 값은 DOUBLE 타입이다. 진수 x 가 0이거나 음수인 경우, 에러를 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 양수 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT ln(1), ln(2.72);
     ln(1)                     ln(2.72)
=====================================================
     0.000000000000000e+00     1.000631880307906e+00

LOG2

LOG2(x)

LOG2 함수는 진수가 x 이고, 밑수가 2인 로그 값을 반환하며, 리턴 값은 DOUBLE 타입이다. 진수 x 가 0이거나 음수인 경우, 에러를 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 양수 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT log2(1), log2(8);
     log2(1)                   log2(8)
======================================================
     0.000000000000000e+00     3.000000000000000e+00

LOG10

LOG10(x)

LOG10 함수는 진수 x 의 상용 로그 값을 반환하며, 리턴 값은 DOUBLE 타입이다. 진수 x 가 0이거나 음수인 경우, 에러를 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 양수 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT log10(1), log10(1000);
     log10(1)                  log10(1000)
====================================================
     0.000000000000000e+00     3.000000000000000e+00

MOD

MOD(m, n)

MOD 함수는 첫 번째 인자 m 을 두 번째 인자 n 으로 나눈 나머지 값을 정수로 반환하며, 만약 n 이 0이면, 나누기 연산을 수행하지 않고 m 값을 그대로 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

주의할 점은 피제수, 즉 MOD 함수의 인자 m 이 음수인 경우, 전형적인 연산(classical modulus) 방식과 다르게 동작한다는 점이다. 아래의 표를 참고한다.

MOD 함수의 결과

m

n

MOD(m, n)

Classical Modulus m-n*FLOOR(m/n)

11

4

3

3

11

-4

3

-1

-11

4

-3

1

-11

-4

-3

-3

11

0

11

0으로 나누기 에러

Parameters
  • m – 피제수를 나타내며, 수치 값을 반환하는 연산식이다.

  • n – 제수를 나타내며, 수치 값을 반환하는 연산식이다.

Return type

INT

--it returns the reminder of m divided by n
SELECT MOD(11, 4), MOD(11, -4), MOD(-11, 4), MOD(-11, -4), MOD(11,0);
    mod(11, 4)   mod(11, -4)   mod(-11, 4)   mod(-11, -4)   mod(11, 0)
=====================================================================
            3             3            -3             -3           11
SELECT MOD(11.0, 4), MOD(11.000, 4), MOD(11, 4.0), MOD(11, 4.000);
  mod(11.0, 4)          mod(11.000, 4)        mod(11, 4.0)          mod(11, 4.000)
=========================================================================
  3.0                   3.000                 3.0                   3.000

PI

PI()

PI 함수는 π 값을 반환하며, 리턴 값은 DOUBLE 타입이다.

Return type

DOUBLE

SELECT PI(), PI()/2;
     pi()                      pi()/2
====================================================
     3.141592653589793e+00     1.570796326794897e+00

POW, POWER

POW(x, y)
POWER(x, y)

POW 함수와 POWER 함수는 동일하며, 지정된 밑수 x 를 지수 y 만큼 거듭제곱한 값을 반환한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters
  • x – 밑수를 나타내며, 수치 값을 반환하는 연산식이다.

  • y – 지수를 나타내며, 수치 값을 반환하는 연산식이다. 밑수가 음수인 경우, 지수는 반드시 정수가 지정되어야 한다.

Return type

DOUBLE

SELECT POWER(2, 5), POWER(-2, 5), POWER(0, 0), POWER(1,0);
 power(2, 5)              power(-2, 5)               power(0, 0)               power(1, 0)
====================================================================================================
 3.200000000000000e+01    -3.200000000000000e+01     1.000000000000000e+00     1.000000000000000e+00
--it returns an error when the negative base is powered by a non-int exponent
SELECT POWER(-2, -5.1), POWER(-2, -5.1);
ERROR: Argument of power() is out of range.

RADIANS

RADIANS(x)

RADIANS 함수는 각도 단위로 지정된 인자 x 를 라디안 단위로 환산하여 리턴한다. 리턴 값은 DOUBLE 타입이다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT RADIANS(90), RADIANS(180), RADIANS(360);
     radians(90)               radians(180)              radians(360)
==============================================================================
     1.570796326794897e+00     3.141592653589793e+00     6.283185307179586e+00

RANDOM, RAND

RANDOM([seed])
RAND([seed])

RANDOM / RAND 함수는 0 이상 2 31 미만 구간에서 임의의 정수 값을 반환하며, seed 인자를 지정할 수 있다. seed 인자의 타입은 INTEGER 이며, 실수가 지정되면 반올림하고 INTEGER 범위를 초과하면 에러를 반환한다.

seed 값이 주어지지 않은 경우 RAND()는 연산을 출력하는 행(row)의 개수와 관계없이 한 문장 내에서 1회만 연산을 수행하여 오직 한 개의 임의값만 생성하는 반면, RANDOM()은 함수가 호출될 때마다 매번 연산을 수행하므로 한 문장 내에서 여러 개의 다른 임의 값을 생성한다. 따라서, 무작위 순서로 행을 출력하기 위해서는 RANDOM()을 이용해야 한다.

무작위 실수 값을 구하기 위해서는 DRANDOM() 를 사용한다.

Parameters

seed

Return type

INT

SELECT RAND(), RAND(1), RAND(1.4);
       rand()      rand(1)    rand(1.4)
=======================================
   1526981144     89400484     89400484
--creating a new table
SELECT * FROM rand_tbl;
           id  name
===================================
            1  'a'
            2  'b'
            3  'c'
            4  'd'
            5  'e'
            6  'f'
            7  'g'
            8  'h'
            9  'i'
           10  'j'
--random() returns random values on every row
SELECT RAND(),RANDOM() FROM rand_tbl;
       rand()       random()
============================
   2078876566     1753698891
   2078876566     1508854032
   2078876566      625052132
   2078876566      279624236
   2078876566     1449981446
   2078876566     1360529082
   2078876566     1563510619
   2078876566     1598680194
   2078876566     1160177096
   2078876566     2075234419
--selecting rows in random order
SELECT * FROM rand_tbl ORDER BY RANDOM();
           id  name
===================================
            6  'f'
            1  'a'
            5  'e'
            4  'd'
            2  'b'
            7  'g'
           10  'j'
            9  'i'
            3  'c'
            8  'h'

ROUND

ROUND(number_operand, integer)

ROUND 함수는 지정된 인자 number_operand 를 소수점 아래 integer 자리까지 반올림한 값을 반환한다. 반올림할 자릿수를 지정하는 integer 인자가 생략되거나 0인 경우에는 소수점 아래 첫째 자리에서 반올림한다. 그리고 integer 인자가 음수이면, 소수점 위 자리, 즉 정수부에서 반올림한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters
  • number_operand – 수치 값을 반환하는 임의의 연산식이다.

  • integer – 반올림 처리할 위치를 지정한다. 양의 정수 n 이 지정되면 소수점 아래 n 자리까지 표현되고, 음의 정수 n 이 지정되면 소수점 위 n 자리에서 반올림한다.

Return type

number_operand의 타입

--it rounds a number to one decimal point when the second argument is omitted
SELECT ROUND(34567.34567), ROUND(-34567.34567);
  round(34567.34567, 0)   round(-34567.34567, 0)
============================================
  34567.00000           -34567.00000
--it rounds a number to three decimal point
SELECT ROUND(34567.34567, 3), ROUND(-34567.34567, 3)  FROM db_root;
 round(34567.34567, 3)   round(-34567.34567, 3)
============================================
  34567.34600           -34567.34600
--it rounds a number three digit to the left of the decimal point
SELECT ROUND(34567.34567, -3), ROUND(-34567.34567, -3);
 round(34567.34567, -3)   round(-34567.34567, -3)
============================================
  35000.00000           -35000.00000

SIGN

SIGN(number_operand)

SIGN 함수는 지정된 인자 값의 부호를 반환한다. 양수이면 1을, 음수이면 -1을, 0이면 0을 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

number_operand – 수치 값을 반환하는 임의의 연산식이다.

Return type

INT

--it returns the sign of the argument
SELECT SIGN(12.3), SIGN(-12.3), SIGN(0);
    sign(12.3)   sign(-12.3)      sign(0)
========================================
            1            -1            0

SIN

SIN(x)

SIN 함수는 인자의 사인(sine) 값을 반환하며, 인자 x 는 라디안 값이어야 한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT SIN(pi()/6), SIN(pi()/3), SIN(pi());
     sin( pi()/6)              sin( pi()/3)              sin( pi())
==============================================================================
     4.999999999999999e-01     8.660254037844386e-01     1.224646799147353e-16

SQRT

SQRT(x)

SQRT 함수는 x 의 제곱근(square root) 값을 DOUBLE 타입으로 반환한다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다. 만약, 음수이면 에러를 반환한다.

Return type

DOUBLE

SELECT SQRT(4), SQRT(16.0);
     sqrt(4)                   sqrt(16.0)
====================================================
     2.000000000000000e+00     4.000000000000000e+00

TAN

TAN(x)

TAN 함수는 인자의 탄젠트(tangent) 값을 반환하며, 인자 x 는 라디안 값이어야 한다. 리턴 값은 DOUBLE 타입이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters

x – 수치 값을 반환하는 임의의 연산식이다.

Return type

DOUBLE

SELECT TAN(pi()/6), TAN(pi()/3), TAN(pi()/4);
     tan( pi()/6)              tan( pi()/3)              tan( pi()/4)
==============================================================================
     5.773502691896257e-01     1.732050807568877e+00     9.999999999999999e-01

TRUNC, TRUNCATE

TRUNC(x[, dec])
TRUNCATE(x, dec)

TRUNC 함수와 TRUNCATE 함수는 지정된 인자 x 의 소수점 아래 숫자가 dec 자리까지 표현되도록 버림(truncation)한 값을 반환한다. 단, TRUNC 함수의 dec 인자는 생략할 수 있지만, TRUNCATE 함수의 dec 인자는 생략할 수 없다. 버림할 위치를 지정하는 dec 인자가 음수이면 정수부의 소수점 위 dec 번째 자리까지 0으로 표시한다. 리턴 값의 표현 자릿수는 인자 x 를 따른다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

Parameters
  • x – 수치 값을 반환하는 임의의 연산식이다.

  • dec – 버림할 위치를 지정한다. 양의 정수 n 이 지정되면 소수점 아래 n 자리까지 표현되고, 음의 정수 n 이 지정되면 소수점 위 n 자리까지 0으로 표시한다. dec 인자가 0이거나 생략되면 소수부를 버림한다. 단, TRUNCATE 함수에서는 dec 인자를 생략할 수 없다.

Return type

x의 타입

--it returns a number truncated to 0 places
SELECT TRUNC(34567.34567), TRUNCATE(34567.34567, 0);
  trunc(34567.34567, 0)   trunc(34567.34567, 0)
============================================
  34567.00000            34567.00000
--it returns a number truncated to three decimal places
SELECT TRUNC(34567.34567, 3), TRUNC(-34567.34567, 3);
  trunc(34567.34567, 3)   trunc(-34567.34567, 3)
============================================
  34567.34500           -34567.34500
--it returns a number truncated to three digits left of the decimal point
SELECT TRUNC(34567.34567, -3), TRUNC(-34567.34567, -3);
  trunc(34567.34567, -3)   trunc(-34567.34567, -3)
============================================
  34000.00000           -34000.00000

WIDTH_BUCKET

WIDTH_BUCKET(expression, from, to, num_buckets)

WIDTH_BUCKET 함수는 순차적인 데이터 집합을 균등한 범위로 부여된 일련의 버킷으로 나누며, 각 행에 적당한 버킷 번호를 1부터 할당한다. 즉, WIDTH_BUCKET 함수는 equi-width histogram을 생성한다. 반환되는 값은 정수이다. 숫자로 변환되지 않는 문자열을 입력할 때 cubrid.confreturn_null_on_function_errors 파라미터의 값이 no(기본값)면 에러, yes면 NULL을 반환한다.

이 함수는 주어진 버킷 개수로 범위를 균등하게 나누어 버킷 번호를 부여한다. 즉, 버킷마다 각 범위의 넓이는 균등하다.

참고로 NTILE() 분석 함수는 이에 비해 주어진 버킷 개수로 전체 행의 개수를 균등하게 나누어 버킷 번호를 부여한다. 즉, 버킷마다 각 행의 개수는 균등하다.

Parameters
  • expression – 버킷 번호를 부여받기 위한 입력 값. 수치 값을 반환하는 임의의 연산식을 지정한다.

  • fromexpression이 취할 수 있는 범위의 시작값으로, 이 값은 전체 범위 안에 포함된다.

  • toexpression이 취할 수 있는 범위의 마지막 값으로, 이 값은 전체 범위 안에 포함되지 않는다.

  • num_buckets – 버킷의 개수. 추가로 범위 밖의 내용을 담기 위한 0번 버킷과 (num_buckets + 1)번 버킷이 생성된다.

Return type

INT

expression은 버킷 번호를 부여받기 위한 입력 데이터이다. fromto 값으로 숫자형 타입과 날짜/시간 타입의 값 또는 날짜/시간 타입으로 변환 가능한 문자열이 입력될 수 있다. 전체 범위에서 from은 범위에 포함되지만 to는 범위 밖에 존재한다.

예를 들어 WIDTH_BUCKET (score, 80, 50, 3)이 반환하는 값은 score가

  • 80보다 크면 0,

  • [80, 70)이면 1,

  • [70, 60)이면 2,

  • [60, 50)이면 3,

  • 50보다 작거나 같으면 4가 된다.

다음 예제는 80점보다 작거나 같고 50점보다 큰 범위를 1부터 3까지 균등한 점수 범위로 나누어 등급을 부여한다. 해당 범위를 벗어나는 경우 80점보다 크면 0, 50점이거나 50점보다 작으면 4등급을 부여한다.

CREATE TABLE t_score (name VARCHAR(10), score INT);
INSERT INTO t_score VALUES
    ('Amie', 60),
    ('Jane', 80),
    ('Lora', 60),
    ('James', 75),
    ('Peter', 70),
    ('Tom', 50),
    ('Ralph', 99),
    ('David', 55);

SELECT name, score, WIDTH_BUCKET (score, 80, 50, 3) grade
FROM t_score
ORDER BY grade ASC, score DESC;
  name                        score        grade
================================================
  'Ralph'                        99            0
  'Jane'                         80            1
  'James'                        75            1
  'Peter'                        70            2
  'Amie'                         60            3
  'Lora'                         60            3
  'David'                        55            3
  'Tom'                          50            4

다음의 예에서 WIDTH_BUCKET 함수는 birthdate의 지정 범위를 균등하게 나누고 이를 기준으로 버킷 번호를 부여한다. 8 명의 고객을 생년월일을 기준으로 ‘1950-01-01’부터 ‘1999-12-31’까지의 범위를 5개로 균등 분할하며, birthdate 값이 범위를 벗어나면 0 또는 버킷 개수 + 1인 6을 반환한다.

CREATE TABLE t_customer (name VARCHAR(10), birthdate DATE);
INSERT INTO t_customer VALUES
    ('Amie', date'1978-03-18'),
    ('Jane', date'1983-05-12'),
    ('Lora', date'1987-03-26'),
    ('James', date'1948-12-28'),
    ('Peter', date'1988-10-25'),
    ('Tom', date'1980-07-28'),
    ('Ralph', date'1995-03-17'),
    ('David', date'1986-07-28');

SELECT name, birthdate, WIDTH_BUCKET (birthdate, date'1950-01-01', date'2000-1-1', 5) age_group
FROM t_customer
ORDER BY birthdate;
  name                  birthdate     age_group
===============================================
  'James'               12/28/1948            0
  'Amie'                03/18/1978            4
  'Tom'                 07/28/1980            4
  'Jane'                05/12/1983            5
  'David'               07/28/1986            5
  'Lora'                03/26/1987            5
  'Peter'               10/25/1988            5
  'Ralph'               03/17/1995            6