O2 Extensions는 TmaxTibero의 OpenSQL에서만 지원되는 확장 기능이므로, 이에 대한 기술 문서는 OpenSQL 매뉴얼에 'O2 Extensions' 항목으로 통합하여 제공합니다.

PostgreSQL의 Extension 소개

PostgreSQL은 확장성이 뛰어난 오픈소스 데이터베이스로 잘 알려져 있습니다. 이러한 명성을 이루는 데에는 PostgreSQL의 기능을 유연하게 확장할 수 있는 Extension Framework가 큰 역할을 합니다. Extension을 활용한 기능 확장은 PostgreSQL의 다양한 데이터 타입 및 함수 지원을 가능하게 하며, 더 나아가 내부 기능의 개선도 가능합니다.

Extension의 중요한 특징은 PostgreSQL 인스턴스에 동적으로 로딩 된다는 것입니다. 즉, PostgreSQL에서는 Extension을 통해 새로운 기능을 추가할 때 소스를 다시 빌드하거나 실행 파일을 교체할 필요가 없습니다. 인스턴스 기동 시 초기화 작업이 필요한 Extension을 제외하면, Extension을 추가할 때 인스턴스를 다시 기동하는 일도 필요 없습니다. 이러한 점 때문에 PostgreSQL에서는 새로운 기능을 추가하는 작업이 매우 간편합니다.

O2 Extensions 소개

O2는 OpenSQL for Oracle의 약어로, Oracle 데이터 타입, 뷰, 내장 함수 및 내장 패키지를 호환해주는 Extension의 집합입니다. O2는 오픈소스 프로젝트인 Orafce를 기반으로 시작되었지만, 다양한 방면에서 많은 변화가 있었습니다. 원래 하나의 Extension으로 관리되었던 Orafce를 여러 개의 Extension으로 분리하였습니다.

O2 Extensions에는 아래 Extension이 포함되어 있습니다.

• O2Types: Oracle 데이터 타입 호환 Extension

• O2Views: Oracle 뷰 호환 Extension

• O2Functions: Oracle 내장 함수 호환 Extension

• Package Extensions: Oracle 내장 패키지 호환 Extension 모음

  • DBMS_ALERT

  • DBMS_ASSERT

  • DBMS_OUTPUT

원래 하나의 Extension으로 관리되었던 Orafce를 여러 개의 Extension으로 분리하여, 패치 작업의 유연성을 크게 향상 시켰습니다. 또한, 오랜 기간 동안 점진적으로 개발되면서 공통된 컨벤션이나 프레임워크의 부재가 문제였는데, 이를 통합하는 과정에서 개선시켰습니다.

O2 Extension에서 제공하는 내장 함수나 패키지는 내부적으로 사용자 정의 함수(UDF)로 구성되어 있습니다. PostgreSQL은 사용자 정의 함수를 작성할 때 SQL, PL/pgSQL뿐만 아니라 C/C++, Python, Perl, Rust 등 다양한 프로그래밍 언어를 지원합니다. O2 Extension은 특히 SQL 및 PL/pgSQL로 작성된 사용자 정의 함수를 C 코드로 변경하여 성능을 향상시켰습니다.

PostgreSQL Query 실행 엔진이 SQL이나 PL/pgSQL로 작성된 UDF를 실행할 때 내부적으로 커서를 생성하여 서브쿼리를 실행하지만, C 코드로 작성된 함수는 컴파일 된 라이브러리에서 직접 실행되므로 빠른 성능을 보장합니다. 또한, C 코드로 구현하면 PostgreSQL 라이브러리를 활용하여 더 정교하고 유연한 구현이 가능합니다.

기존 Orafce는 하나의 Extension으로 관리되었기 때문에, 전체 구현 중 하나의 요소에 문제가 발생하면 전체 Extension을 업데이트해야 했습니다. 반면, O2는 여러 개의 Extension으로 나누어 관리함으로써, 문제가 발생한 Extension만 교체하면 됩니다. 예를 들어, DBMS_ALERT나 DBMS_PIPE와 같이 공유 메모리를 사용하는 패키지는 shared_preload_libraries에 추가하여 DB 인스턴스를 기동해야 하는데, O2의 경우 이들 Extension이 별도로 분리되어 있어 필요한 Extension만 shared_preload_libraries에 추가하면 되도록 개선했습니다. 이와 같은 개선 사항들은 O2 Extension이 PostgreSQL 사용자들에게 더 강력하고 유연한 Oracle 호환 기능을 제공할 수 있습니다. 또한, O2 Extension의 도입으로 인해 성능, 유연성, 안정성이 크게 향상되었습니다.

o2functions extension 설치 후 신규 함수들이 추가되며, 아래의 2가지 형식으로 사용하여야 합니다.

스키마(기본 oracle)의 이름을 function 앞에 추가하여 사용합니다.

스키마(기본 oracle)를 가장 높은 우선순위 search_path로 설정한 경우, 스키마를 생략하고 사용할 수 있습니다.

각 함수들 사양은 스키마를 생략한 형태로 기술합니다.

dbtimezone 함수는 서버의 기본 시간대를 텍스트 형태로 반환합니다.

내부적으로는 현재 데이터베이스의 설정을 확인하기 위해 pg_db_role_setting 테이블을 조회하며,

만약 해당 설정이 없으면 pg_settings에서 기본 TimeZone 값을 가져옵니다.

즉, 서버에 설정된 기본 시간대를 조회해서 문자열로 제공합니다.

sessiontimezone 함수는 현재 세션의 타임존을 텍스트 값으로 반환합니다.

내부적으로는 show_timezone() 함수를 호출하여 현재 세션의 시간대를 조회한 후, 이를 텍스트로 변환해 반환합니다.

sysdate 함수는 서버 시간대 기준의 현재 문(statement) 타임스탬프를 반환합니다.

Oracle의 sysdate와 유사하게 동작하며, 반환되는 타임스탬프는 소수 자릿수를 제거하여 Oracle DATE 타입처럼 사용됩니다.

systimestamp 함수는 현재 문(statement)의 타임스탬프를 서버의 시간대 기준으로 반환합니다.

내부적으로는 GetCurrentTimestamp()를 호출하여 서버의 타임존에 맞춰 타임스탬프 값을 가져옵니다.

SINH는 num의 hyperbolic sine입니다.

SYS_GUID는 16 바이트의 RAW 데이터로 구성된 전역 고유 식별자를 생성해서 반환합니다.

uuid는 pseudorandom 방식으로 생성됩니다.

Syntax

개요

주어진 날짜가 속한 달의 마지막 날짜를 반환합니다.

DATE 타입의 경우, 단순히 그 달의 마지막 일자를 계산하며, TIMESTAMPTZ 타입의 경우에는 날짜를 절삭한 후 원래의 시간 정보를 결합하여 타임스탬프 값을 반환합니다.

파라미터

예제

Syntax

개요

입력된 다중 바이트 문자열을 가능한 경우 해당하는 단일 바이트(ASCII) 문자로 변환합니다.

입력 문자열에서 다중 바이트 문자가 미리 정의된 매핑 테이블에 의해 단일 바이트 값(대개 ASCII 코드 0x20 이상의 값)으로 치환되며, 변환이 불가능한 문자는 원래 그대로 반환됩니다.

파라미터

예제

Syntax

개요

COSH는 n의 hyperbolic cosine입니다.

파라미터

예제

Syntax

개요

COSH는 n의 hyperbolic cosine입니다.

파라미터

예제

Syntax

개요

BIN_TO_NUM는 bit vector를 해당 정수 값으로 변환해주는 함수입니다.

파라미터

예제

Syntax

개요

LENGTH 는 주어진 str의 길이를 반환합니다.

파라미터

예제

Syntax

개요

ASCIISTR은 주어진 문자열을 데이터베이스 문자 집합의 아스키 문자열로 반환합니다. ASCII 이외의 문자는 \xxxx 형태로 변경됩니다. xxxx는 UTF-16 코드입니다.

파라미터

예제

Syntax

개요

HEXTORAW는 16진수로 표현된 문자열의 RAW 값을 구하는 함수입니다.

파라미터

예제

Syntax

개요

RAWTONHEX는 문자열 raw 값을 16진수로 표현된 문자열로 바꾸는 함수입니다.

파라미터

예제

Syntax

개요

RAWTOHEX는 문자열 raw 값을 16진수로 표현된 문자열로 바꾸는 함수입니다.

파라미터

예제

Syntex

GREATEST
(
  expr1       IN anynonarray,
  expr_array  IN variadic anyarray
)
RETURNS anynonarray;

개요

GREATEST 함수는 전달된 인자들 중에서 가장 큰 값을 반환합니다.

만약 인자 중 하나라도 NULL이면, 전체 결과가 NULL이 됩니다.

PostgreSQL 기본 함수는 모든 인자가 NULL일 때만 NULL을 반환하는데, 이 함수는 하나라도 NULL이면 NULL을 반환합니다.

파라미터

Syntax

LEAST
(
  expr1       IN anynonarray,
  expr_array  IN variadic anyarray
)
RETURNS anynonarray;

개요

LEAST 함수는 전달된 인자들 중에서 가장 작은 값을 반환합니다.

만약 인자 중 하나라도 NULL이면, 전체 결과가 NULL이 됩니다.

PostgreSQL 기본 함수는 모든 인자가 NULL일 때만 NULL을 반환하는데, 이 함수는 하나라도 NULL이면 NULL이 됩니다.

파라미터

Syntax

LNNVL
(
  value  IN boolean
)
RETURNS boolean;

개요

lnnvl 함수는 입력된 불리언 값에 대해 반대 값을 반환합니다.

즉, 인자가 true면 false를, false면 true를 반환합니다.

또한, 인자가 NULL이면 true를 반환합니다.

파라미터

Syntax

NANVL
(
  value         IN { real, double precision, numeric },
  replacement   IN { varchar, real, double precision, numeric }
)
RETURNS { real, double precision, numeric };

개요

NANVL 함수는 첫 번째 인자가 NaN(Not a Number)이면 두 번째 인자값을 반환하고, NaN이 아니면 첫 번째 인자값을 그대로 반환합니다.

두 번째 인자가 varchar 가 아니라면, 첫 번째 인자와 타입이 동일해야 합니다.

부동 소수점이나 숫자형 데이터에서 NaN을 다른 값으로 대체할 때 쓰입니다.

파라미터

Syntax

MONTHS_BETWEEN
(
  date1  IN date,
  date2  IN date
)
RETURNS numeric;

MONTHS_BETWEEN
(
  timestamptz1  IN timestamptz,
  timestamptz2  IN timestamptz
)
RETURNS numeric;

개요

MONTHS_BETWEEN 함수는 두 날짜(또는 타임스탬프) 사이의 개월 수를 계산해서 반환합니다.

두 날짜의 연, 월, 일을 비교하여 개월 차이를 구하는데, 만약 두 날짜 모두 해당 월의 마지막 날이면 정수 개월 수로 계산합니다.

그렇지 않은 경우에는 일(day) 차이를 31일로 나눈 값이 소수점 이하로 더해져 반환됩니다. 즉, 소수점 이하 값은 31일 기준으로 계산됩니다.

파라미터

Syntax

SYS_EXTRACT_UTC
(
  time  IN timestamp with time zone
)
RETURNS timestamp without time zone;

SYS_EXTRACT_UTC
(
  time  IN timestamp without time zone
)
RETURNS timestamp without time zone;

개요

입력받은 타임스탬프(with/without time zone)를 UTC 기준의 타임스탬프(without timezone)로 변환해서 반환합니다.

TIMESTAMP(without time zone)의 경우, 명시한 timezone 정보와 관계 없이 값을 세션의 timezone을 기준으로 해석한 후, 해당 값을 UTC 기준의 타임스탬프로 변환해서 반환합니다.

즉, 명시한 timezone에 따라 해당 함수를 적용 하고 싶을 시, 반드시 TIMESTAMP가 아닌 TIMESTAMPTZ 타입을 사용해야 합니다.

파라미터

Syntax

NUMTOYMINTERVAL
(
  expr             IN numeric,
  interval_unit    IN text
)
RETURNS interval;

개요

NUMTOYMINTERVAL은 입력으로 들어온 값을 년도-달 구간 형식으로 변환하는 함수입니다.

파라미터

Syntax

TO_YMINTERVAL
(
  sql_format IN text -- format: '[+|-]years-months'
)
RETURNS interval;

TO_YMINTERVAL
(
  ym_iso_format IN text -- format: '[-]P[<years>Y][<months>M]'
)
RETURNS interval;

개요

TO_YMINTERVAL은 문자열을 INTERVAL YEAR TO MONTH 타입으로 변환하는 함수입니다.

파라미터

Syntax

TO_MULTI_BYTE
(
  str  IN text
)
RETURNS text;

개요

단일 바이트(ASCII) 문자를 데이터베이스 인코딩에 따른 해당 다중 바이트 문자로 변환합니다.

예를 들어, ASCII 범위(0x20 ~ 0x7E)에 해당하는 문자는 미리 정의된 다중 바이트 매핑 테이블(UTF8, EUC_JP, EUC_CN 등)에 따라 변환됩니다.

데이터베이스 인코딩이 해당 매핑 테이블 중 하나에 해당하면, 입력 문자열의 각 문자를 대응하는 다중 바이트 문자열로 치환하고, 그 외의 문자는 그대로 반환합니다.

파라미터

Syntax

TO_TIMESTAMP_TZ
(
  str  IN text,
  fmt  IN text
)
RETURNS timestamp with time zone;

개요

입력된 문자열과 포맷 모델을 이용하여 타임스탬프 with time zone (timestamptz) 값으로 변환합니다.

PostgreSQL 내장 함수to_timestamp 함수를 활용해 문자열을 지정한 형식에 따라 파싱하고, 그 결과를 timestamptz 타입으로 반환합니다.

Oracle과 달리 타입 안정성을 지키기 위해, 날짜 타입의 변수를 받지 않습니다.

파라미터

Syntax

BITAND(expr1, expr2)

개요

BITAND 연산은 입력과 출력을 bit로 이뤄진 벡터로 처리합니다. 이때 출력은 입력을 비트 단위로 AND 연산한 것의 결과입니다.

BITAND는 다음과 같은 단계를 걸쳐 계산됩니다.

1. 인자 A는 SIGN(A) * FLOOR(ABS(A))로 대체됩니다.

2. 인자 A는 n-bit two's complement 이진 정수 값으로 변환됩니다. 2 비트 값은 비트 단위 AND 연산을 통해 합쳐집니다.

3. n-bit two's complement 값은 NUMBER으로 다시 변환됩니다.

Syntax

MOD(num1, num2);

개요

MOD는 num1을 num2로 나눈 나머지를 반환하는 함수입니다. num2이 0이면, num1을 반환합니다.

이 함수는 num1 또는 num2가 음수면 전통적인 Modulus 함수와는 다른 결과를 반환합니다.

전통적인 Modulus 함수는 다음과 같습니다.

num1 - num2 * FLOOR(num1/num2)

파라미터

Syntax

REMAINDER(num1, num2);

개요

REMAINDER은 num1을 num2로 나눈 나머지를 반환하는 함수입니다.

MOD가 FLOOR을 사용하고 REMAINDER은 Bankers' Round 방식의 Round를 사용하는 것을 제외하면 비슷합니다.

파라미터

Syntax

DUMP(expr[, return_fmt [, start_position [, length ] ] ])

개요

DUMP 는 data type code, byte 단위의 길이, expr 의 내부 표현을 가진 TEXT를 반환합니다.

기본적으로, 반환 값은 character set 정보를 가지고 있지 않습니다.

expr 의 character set 이름을 찾으려면 return_fmt에 1000을 더하면 됩니다.

파라미터

• 10은 10진법의 결과를 반환합니다.

• 16은 16진법의 결과를 반환합니다.

• 17은 컴파일러의 문자 집합에서 출력 가능한 문자로 해석될 수 있는 경우에만 출력 된 각 바이트를 반환합니다. 일부 ASCII 형식의 문자는 ‘?’ 로도 출력 될 수 있습니다. 그렇지 않은 경우 16진법으로 출력됩니다. 모든 NLS 파라미터는 무시됩니다. return_fmt가 17인 DUMP 함수에 대해 어떤 특정 출력 포맷에 의존하면 안됩니다.

Syntax

INSTR(string, substring [, position [, occurrence]])

개요

INSTR 함수는 string에서 substring을 검색하는 함수입니다. 이 검색 연산은 주어진 문자열에서 substring과 같은 길이의 하위 문자열을 순차적으로 비교하여 일치하는지 확인하는 방식으로 진행됩니다.

검색은 앞쪽(순방향) 또는 뒤쪽(역방향)으로 수행되며, 각 비교 대상 하위 문자열은 이전 하위 문자열의 첫 번째 문자에서 한 글자씩 이동하며 시작됩니다. 만약 부분 문자열과 일치하는 하위 문자열을 찾으면, 해당 부분 문자열의 첫 번째 문자의 위치를 나타내는 정수를 반환합니다. 일치하는 substring이 없으면 0을 반환합니다.

파라미터

Syntax

LTRIM(str [, char_set])

개요

LTRIM 은 str의 왼쪽으로부터 char_set 내에 포함된 모든 문자를 제거하는 함수입니다.

파라미터

Syntax

LPAD(expr1, num [, expr2])

개요

LPAD 는 expr1의 왼쪽에 expr2를 연속적으로 붙이고, num만큼의 길이를 가진 문자열을 반환하는 함수입니다.

대부분의 문자 집합에서는 반환 되는 문자열의 문자 수와 길이가 동일하지만, 한글과 같은 멀티 바이트 문자 집합의 경우에는 두 값이 다를 수 있습니다.

파라미터

Syntax

NLSSORT(str [, ' nlsparam '])

개요

NLSSORT 는 str을 정렬하기 위해 사용되는 문자 바이트를 반환하는 함수입니다.

파라미터

Syntax

REGEXP_COUNT(str, pattern [, position [, match_param]])

개요

REGEXP_COUNT 는 str 내에서 정규 표현식으로 주어진 패턴이 몇 번이나 일치하는지 반환하는 함수입니다.

파라미터

Syntax

REGEXP_COUNT(str, pattern [, match_param])

개요

REGEXP_LIKE 는 str과 정규 표현식으로 주어진 패턴을 비교합니다.

POSIX 정규 표현식 표준을 따릅니다.

파라미터

Syntax

RPAD(expr1, num [, expr2])

개요

RPAD 는 expr1의 오른쪽 expr2를 연속적으로 붙이고, num만큼의 길이를 가진 문자열을 반환하는 함수입니다.

대부분의 문자 집합에서는 반환되는 문자열의 문자 수와 길이가 동일하지만, 한글과 같은 멀티 바이트 문자 집합의 경우에는 두 값이 다를 수 있습니다.

파라미터

Syntax

RTRIM(str [, char_set])

개요

RTRIM 은 str의 오른쪽으로부터 char_set 내에 포함된 모든 문자를 제거하는 함수입니다.

파라미터

Syntax

SUBSTR(str, position [, length])

개요

SUBSTR 은 str 내의 position 위치로부터 length 길이의 문자열을 추출하여 반환하는 함수입니다.

파라미터

Syntax

EXISTSNODE
(
  xml IN xml,
  xpath_str IN text,
  namespace_str IN text DEFAULT NULL
)
RETURNS integer;

개요

EXISTSNODE는 XML 문서에서 질의한 XPath에 해당 노드가 있는지 검사하는 함수입니다. 반환되는 값은 integer 타입이며, 해당 노드가 있으면 1을 없으면 0을 반환합니다.

xpath_string 인자에 리터럴 NULL이 입력된 경우, 다른 인자들이 유효하더라도 에러를 발생시키지 않고 NULL을 반환합니다.

파라미터

BLOB/CLOB <- TEXT, BYTEA

• 1GB 이하

• TOAST에 의존합니다.

  • PostgreSQL의 각 page영역은 일반적으로 8kb의 고정된 크기로 되어있고 각 tuple이 여러 페이지에 나뉘어 존재할 수 없습니다. (매우 큰 값을 바로 저장할 수 없습니다.)

    이 한계를 극복하기 위해서, 큰 필드 값은 압축되어 저장되거나 여러 개의 물리적 ROWS로 분할되어 저장됩니다.

  • 이 기법을 TOAST (The Oversized-Attribute Storage Technique)라고 하며 PostgreSQL에서 큰 데이터 값을 메모리 내에서 효율적으로 처리하는 데에 사용됩니다.

• 4TB 이하

• 특징

  • 파일에 대한 표준 작업과 유사한 읽기/쓰기 API를 사용하여 생성, 수정 및 삭제할 수 있습니다.

  • 대형 개체의 일부를 읽고 업데이트하는 작업을 효율적으로 수행할 수 있는 반면 TOAST 로 처리된 필드의 대부분 작업은 전체 값을 단위로 읽거나 씁니다.

오라클의 LOB은 4GB까지 지원하는 반면, O2의 LOB은 TEXT, BYTEA 타입에 기반하기 때문에 1GB까지 지원합니다. 따라서 1GB 넘는 데이터 이관 시에는 PostgreSQL의 Large Object를 사용해야 합니다.

• Large Object 이관에 필요한 API 참고 문서

LISTAGG 함수는 Oracle의 LISTAGG 집계 함수를 PostgreSQL에서 구현한 확장 함수입니다.

이 함수는 그룹 내의 여러 텍스트 값을 하나의 문자열로 결합하여 반환합니다.

그룹 내의 여러 텍스트 값을 하나의 문자열로 결합하는 집계 함수입니다.

입력된 텍스트 값을 순차적으로 결합하여 하나의 문자열을 생성합니다.

내부 동작 과정은 다음과 같습니다:

• 입력 값이 NULL인 경우 해당 값은 집계에서 제외합니다.

• 첫 번째 값이 입력되면 새로운 상태(문자열 버퍼)가 생성합니다.

NVL 함수는 두 인자 중 첫 번째 인자가 NULL이 아니면 그 값을 반환하고, 만약 NULL이면 두 번째 인자의 값을 반환합니다.

동일한 타입의 인자에 대해서만 호출되지만, 서로 다른 타입일 경우 암묵적 형 변환을 수행합니다.

return 타입은 첫번째 인자의 타입을 따릅니다.

TO_DSINTERVAL은 문자열을 INTERVAL DAY TO SECOND 타입으로 변환하는 함수입니다.

주어진 숫자 값을 특정 단위(예: 'DAY', 'HOUR', 'MINUTE', 'SECOND')로 해석하여 INTERVAL 타입으로 변환합니다.

숫자 값은 정수부와 소수부로 나뉘며,

• 'DAY'인 경우 정수부는 일(day)로, 소수부는 24를 곱해 시간, 분, 초로 변환됩니다.

• 'HOUR'인 경우 정수부는 시간(hour)로, 소수부는 60을 곱해 분과 초로 변환됩니다.

텍스트(또는 정수형 값을 문자열로 변환한 값)를 Oracle 스타일의 날짜/시간 형식에 따라 TIMESTAMP(0)(밀리세컨드 없는 시분초까지의 날짜+시분초) 값으로 변환합니다.

포맷 모델(fmt)이 제공되면 해당 형식에 맞게 날짜를 해석하며, 제공되지 않을 경우 기본 형식에 따라 변환됩니다.

빈 문자열을 입력하면 NULL을 반환합니다.

Oracle과 달리 타입 안정성을 지키기 위해, 날짜 타입의 변수를 받지 않습니다.

REGEXP_INSTR 는 str 내에서 정규 표현식으로 주어진 패턴이 일치하는 위치를 반환하는 함수입니다.

만약 str과 일치하지 않으면 0을 반환합니다.

REGEXP_COUNT 는 str 내에서 정규 표현식으로 주어진 패턴을 탐색해 다른 문자열로 대치하는 함수입니다.

REGEXP_COUNT 는 str 내에서 정규 표현식으로 주어진 패턴을 탐색하여 해당 문자열을 반환하는 함수입니다.

결과의 타입은 str의 타입과 동일합니다.

아래 방법으로 해결되지 않는 경우 매뉴얼에 기재된 기술서비스센터의 에 문의합니다.

O2 Extension에서 생성한 커스텀 에러는 모두 ‘O2’로 시작하는 에러 코드가 부여됩니다. 만약 O2 Extension 사용 시 ‘O2’로 시작하는 에러 코드가 발생한 경우 아래와 같이 조치를 취합니다.

1. 페이지를 참조하여 상황에 맞는 에러인지 확인합니다.

2. 상황에 맞는 에러인 경우 조치 가이드에 맞게 조치합니다.

만약 O2 Extension 사용 시 ‘O2’로 시작하지 않는 에러 코드가 발생하더라도 O2 Extension에서 발생시킨 예외일 수 있습니다. 해당 상황에서는 아래와 같이 조치를 취합니다.

Syntax

NVL2(expr1, expr2, expr3)

개요

NVL2 함수는 첫 번째 인자가 NULL이 아닐 경우 두 번째 인자의 값을 반환하고, 만약 첫 번째 인자가 NULL이면 세 번째 인자의 값을 반환합니다.

두 번째와 세 번째 인자는 동일한 범주의 타입이어야 하며, 필요한 경우 암묵적 형 변환을 수행하는 별도 변형 함수가 존재합니다.

파라미터

Syntax

ADD_MONTHS
(
  date    IN,
  number  IN 
)
RETURNS date;

ADD_MONTHS
(
  TIMESTAMP WITH TIME ZONE  IN,
  number                    IN
)
RETURNS TIMESTAMP WITH TIME ZONE;

ADD_MONTHS
(
  TIMESTAMP WITHOUT TIME ZONE  IN,
  number                    IN
)
RETURNS TIMESTAMP WITHOUT TIME ZONE;

개요

ADD_MONTHS 함수는 주어진 날짜나 타임스탬프에 지정한 개월 수를 더한 새로운 날짜나 타임스탬프를 반환합니다.

내부적으로 입력 날짜를 연, 월, 일로 분해한 후, 전체 개월 수를 더해 새 연도와 월을 계산합니다.

특히, 입력 날짜가 해당 월의 마지막 날인 경우 새 달의 마지막 날로 조정됩니다.

첫 번째 인자가 timestamptz 인 경우, 날짜 계산 후 기존의 시간 정보를 그대로 유지합니다.

Syntax

NEXT_DAY
(
  value          IN date,
  weekday        IN text
)
RETURNS date;

NEXT_DAY
(
  value          IN date,
  weekday_index  IN integer
)
RETURNS date;

NEXT_DAY
(
  value          IN TIMESTAMP WITH TIME ZONE,
  weekday        IN text
)
RETURNS TIMESTAMP without time zone;

NEXT_DAY
(
  value          IN TIMESTAMP WITH TIME ZONE,
  weekday_index  IN integer
)
RETURNS TIMESTAMP without time zone;

개요

주어진 날짜 이후에 나오는 첫 번째 특정 요일의 날짜를 반환합니다.

문자열 형태의 요일(예: 'Monday', 'Tue' 등) 또는 요일 인덱스(1부터 7, 1은 일요일)를 인자로 받아 처리합니다.

TIMESTAMP WITH TIME ZONE 타입의 경우, 날짜 계산 후 원래 시간 부분을 그대로 유지하여 타임스탬프 값을 반환합니다.

파라미터

Syntax

ROUND
(
  expr  IN date [, fmt   IN text]
)
RETURN date;

ROUND
(
  expr  IN timestamp without time zone [, fmt   IN text]
)
RETURN timestamp without time zone;

ROUND
(
  expr  IN timestamp with time zone [, fmt   IN text]
)
RETURN timestamp with time zone;

개요

ROUND 함수는 날짜나 타임스탬프 값을 주어진 포맷 모델에 따라 반올림합니다.

즉, 지정한 단위(예: 연, 월, 분 등)에 맞춰 날짜나 시간의 값을 조정해서 반환합니다.

포맷 문자열(fmt)을 통해 반올림 단위를 지정할 수 있으며, 값이 NULL이면 그대로 NULL을 반환합니다.

타임스탬프 버전의 경우, 시간 부분을 반올림한 후 초는 0으로 설정됩니다.

파라미터

Syntax

TRUNC
(
  expr  IN date [, fmt   IN text]
)
RETURNS date;

TRUNC
(
  expr  IN timestamp without time zone [, fmt   IN text]
)
RETURNS timestamp without time zone;

TRUNC
(
  expr  IN timestamp with time zone [, fmt   IN text]
)
RETURNS timestamp with time zone;

개요

TRUNC 함수는 날짜나 타임스탬프 값에서 하위 단위를 잘라내고, 지정한 포맷 모델에 맞춰 값을 자른(버림) 결과를 반환합니다.

즉, 값의 시간 또는 날짜 부분에서 소수점 이하(또는 세부 단위)를 제거하여, 원하는 단위(예: 연, 월, 일 등)까지만 남깁니다.

만약 포맷 문자열(fmt)이 제공되지 않으면, 기본적으로 'DDD' (일 단위)로 처리됩니다.

타임스탬프 버전의 경우, 내부의 시간 정보를 함께 처리하여 시간 단위 이하를 잘라내며, 초 이하 정보는 0으로 설정됩다.

파라미터

Syntax

TO_CHAR
(
  value IN { smallint | int | bigint | real | double precision | numeric | text | timestamp | timestamptz }
  [, fmt IN text]
)
RETURNS text

개요

숫자, 날짜, 타임스탬프 또는 문자열 값을 지정한 포맷 모델(fmt)에 따라 문자열로 변환됩니다.

포맷 모델이 제공되지 않으면 각 데이터 타입의 기본 출력 형식에 따라 문자열로 변환됩니다.

숫자형의 경우 정수, 부동소수점, 그리고 numeric 값을 포맷에 따라 변환하며,

날짜와 타임스탬프는 지정된 형식(예: 'YYYY-MM-DD', 'HH24:MI:SS')으로 변환됩니다.

파라미터

Syntax

TO_NUMBER
(
  value  IN { text | smallint | int | bigint | double precision | numeric }
)
RETURNS numeric;

TO_NUMBER
(
  value  IN numeric,
  fmt    IN numeric
)
RETURNS numeric;

개요

입력된 문자열 또는 숫자형 값을 Oracle 스타일의 숫자(numeric)로 변환합니다.

텍스트로 입력된 경우, 로케일 설정에 따라 소수점 및 천 단위 구분 문자를 조정한 후 숫자 형식 문자열을 숫자로 변환합니다.

또한, smallint, int, bigint, double precision 타입 값은 각 타입 전용 내부 로직을 통해 numeric 타입으로 변환됩니다.

numeric 타입의 입력은 그대로 반환 되며, 포맷 모델(fmt)이 제공되면 PG 기본 내장 함수(pg_catalog.to_number) 함수를 이용해 추가 변환 형식을 적용할 수 있습니다.

Syntax

UNISTR
(
  str  IN text
)
RETURNS text;

개요

입력된 텍스트 내의 Unicode escape 시퀀스를 실제 Unicode 문자로 변환하여 반환합니다.

지원하는 escape 형식은 다음과 같습니다.

• \XXXX : 4자리 16진수 형식입니다

• \uXXXX : 4자리 16진수 형식입니다 (앞에 'u' 접두사가 붙음)

• \+XXXXXX : '+' 기호 뒤에 6자리 16진수 형식입니다

• \UXXXXXXXX : 'U' 기호 뒤에 8자리 16진수 형식입니다

함수는 surrogate pair 처리를 통해 올바른 Unicode 코드 포인트로 변환하며, 잘못된 surrogate pair가 감지되면 오류를 발생시킵니다.

'U+0000' 는 유효하지 않은 유니코드 입니다. 따라서 다음과 같은 예시는 오류를 발생시킵니다. \0000 , \u0000 , \+000000 , \U00000000

Syntax

SYS_CONTEXT(namespace TEXT, parameter TEXT, length NUMERIC DEFAULT NULL)

개요

SYS_CONTEXT 함수는 현재 세션의 컨텍스트 네임스페이스와 연결된 파라미터의 값을 반환합니다.

파라미터

userenv 네임스페이스에 대해 다음과 같은 파라미터를 지원합니다.

O2는 PostgreSQL 환경에서 오라클이 지원하는 함수/패키지/타입들과 호환되는 인터페이스를 제공하여 사용자들의 편의를 향상시키는 PostgreSQL Extension 입니다.

OpenSQL에서 지원하는 운영체제/하드웨어 사양과 동일합니다.

O2 Extension에서는 제품 설치를 위한 방법을 다음의 2가지 설치 형태로 제공하고 있습니다.

• make 방식으로 설치

• shell 방식으로 설치

O2types extension 설치 후 신규 데이터 타입들이 추가되며, 아래의 2가지 형식으로 사용하여야 합니다.

스키마(기본 oracle)의 이름을 타입 앞에 추가하여 사용합니다.

스키마(기본 oracle)를 가장 높은 우선순위 search_path로 설정한 경우, 스키마를 생략하고 사용할 수 있습니다.

아래 사양들은 스키마를 생략한 형태로 기술합니다.

DATE 타입은 특정 날짜와 초 단위까지의 시간을 표현하는 데이터 타입입니다. TIMESTAMP(0)과 표현 범위가 동일합니다.

DATE 타입은 다음과 같은 특징이 있습니다.

MEDIAN 집계 함수는 그룹 내의 값들 중 중앙값(median)을 계산하여 반환하는 통계 함수입니다.

Oracle의 MEDIAN 함수를 참고하여 PostgreSQL에서 구현했습니다.

정수형, 실수형, 날짜/시간 타입 데이터 타입에 대해 사용 가능합니다.

내부적으로, MEDIAN 함수는 두 단계로 동작합니다.

집계 단계

• 그룹 내의 값들을 타입에 맞는 벡터(리스트 자료구조)에 수집하는 단계입니다.

A. PostgreSQL은 Extension 설치를 간편하게 할 수 있도록 설계되어 있습니다. O2 Extension도 마찬가지로 손쉽게 설치가 가능합니다. 자세한 내용은 를 참조합니다.

A. PostgreSQL은 동적 링크를 활용하여 Extension을 간단한 SQL 구문으로 활성화하도록 설계되어 있습니다. O2 Extension도 마찬가지로 간단한 SQL 구문을 사용하여 활성화할 수 있습니다. 자세한 내용은 를 참조합니다.

A. O2 Extension의 기능은 대부분 PostgreSQL 14 이상 버전을 지원합니다. 하지만 일부 기능은 PostgreSQL 15 이상을, 또 다른 일부 기능은 PostgreSQL 16 이상의 버전을 요구합니다.

사용 중인 PostgreSQL 버전이 특정 기능의 최소 요구 사항을 충족하지 못할 경우, 설치 시 해당 기능은 자동으로 제외됩니다. 기능별 최소 지원 버전은 아래와 같습니다.