1 of 100

Tmax OpenSQL 3.0 manual_v1.5.0

OpenSQL Manual

안내서 정보
안내서 제목 : OpenSQL 매뉴얼 발행일 : 2026-05-21 소프트웨어 버전 : OpenSQL 3 안내서 버전 : v1.5.0

OpenSQL® (이하 OpenSQL) 제품은 오픈소스 PostgreSQL DBMS에 대한 운영 및 관리를 제공합니다. 본 안내서는 OpenSQL을 사용하는 사용자를 대상으로 기술합니다.

사전 필요 지식

데이터베이스의 이해
RDBMS의 이해
PostgreSQL 의 이해
운영체제 및 시스템 환경의 이해
UNIX 계열 (LINUX 포함) 운영체제의 기본 지식

티맥스티베로 OpenSQL 매뉴얼에 적용되는 저작권 안내사항 입니다.

경기도 성남시 분당구 정자일로 45 티맥스타워

Tel : +82-1544-8629

E-Mail : gitbook@tibero.com

이 소프트웨어(OpenSQL®) 사용설명서의 내용과 프로그램은 저작권법과 국제 조약에 의해서 보호받고 있습니다. 사용설명서의 내용과 여기에 설명된 프로그램은 TmaxTibero Co., Ltd.와의 사용권 계약 하에서만 사용이 가능하며, 사용설명서는 사용권 계약의 범위 내에서만 배포 또는 복제할 수 있습니다.

이 사용 설명서의 전부 또는 일부분을 TmaxTibero의 사전 서면 동의 없이 전자, 기계, 녹음 등의 수단을 사용하여 전송, 복제, 배포, 2차적 저작물 작성 등의 행위를 하여서는 안됩니다. 이 소프트웨어 사용 설명서와 프로그램의 사용권 계약은 어떠한 경우에도 사용 설명서 및 프로그램과 관련된 지적 재산권(등록 여부를 불문)을 양도하는 것으로 해석되지 아니하며, 브랜드나 로고, 상표 등을 사용할 권한을 부여하지 않습니다. 사용 설명서는 오로지 정보의 제공만을 목적으로 하고, 이로 인한 계약상의 직접적 또는 간접적 책임을 지지 아니하며, 사용설명서 상의 내용은 법적 또는 상업적인 특정한 조건을 만족시키는 것을 보장하지는 않습니다. 사용 설명서의 내용은 제품의 업그레이드나 수정에 따라 그 내용이 예고 없이 변경될 수 있으며, 내용상의 오류가 없음을 보장하지 않습니다.

OpenSQL®는 TmaxTibero Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서 참조용으로만 사용됩니니다.

Noto는 Google Inc.의 상표입니다. Noto 글꼴은 오픈 소스입니다. 모든 Noto 글꼴은 SIL Open Font License, 버전 1.1에 따라 게시됩니다. (https://www.google.com/get/noto/)

본 제품의 일부 파일 또는 모듈은 아래의 라이선스를 준수합니니다.

Apache License Version 2.0
Apache License Version 1.1
Mozilla Public License Version 1.1
Berkeley Software Distribution (BSD)

본 문서는 총 4개의 장으로 구성됩니다.

TmaxTibero의 OpenSQL의 구성을 설명합니다.

🔎

OpenSQL 제품으로 구성된 환경을 설치하는 방법에 대하여 기술합니다.

🔎

OpenSQL 제품으로 구성된 환경을 관리하는 방법에 대하여 기술합니다.

🔎

TmaxTibero의 OpenSQL에서만 지원되는 확장 기능인 O2 Extensions 기능을 설명합니다.

OpenSQL 개요

OpenSQL v3.0 은 오픈소스 관계형 데이터베이스 관리시스템 (RDBMS) 인 PostgreSQL을 기반으로 높은 성능과 고가용성을 제공하는 데이터베이스 클러스터입니다.

OpenSQL Components

OpenSQL 데이터베이스

PostgreSQL 기반의 오픈소스 관계형 데이터베이스 관리 시스템으로 뛰어난 확장성과 SQL 표준을 준수합니다.

OpenHA

OpenSQL 클러스터의 고가용성을 담당하는 솔루션으로, OpenHA Cluster Manager와 OpenHA DCS로 구성됩니다.

OpenHA Cluster Manager Patroni 기반의 클러스터 관리 모듈로, 각 데이터베이스 노드의 상태를 실시간 감지하고 자동 Failover, Primary 노드 선출, 구성 변경 관리 기능을 수행합니다.
OpenHA DCS(Distributed Configuration Store)
etcd 기반의 분산 키-값 저장소로, OpenSQL 클러스터의 멤버십 및 구성 정보를 안정적으로 저장·공유합니다.

PostgreSQL 커넥션풀링, 로드밸런싱 및 VIP Failover 기능을 제공하며, Rust 언어로 작성된 고성능 Connection Pooler 입니다.

Full, 증분, 차분 백업 방식을 제공하며, Python 언어로 작성된 오픈소스 PostgreSQL 데이터베이스 백업 관리 솔루션입니다.

OpenSQL 설치

OpenSQL 3 바이너리 설치

OpenHA DCS (Distributed Configuration Store)

OpenHA의 분산 구성 저장소로, 클러스터 멤버십과 각 인스턴스 상태를 안정적으로 저장·공유하며, 리더 선출을 수행합니다. 이 기능은 etcd 기술을 기반으로 구현되었으며, 관리 도구로 etcdctl을 제공합니다.

설치를 완료하면 아래의 명령어로 OpenHA DCS(etcd 와 etcdctl 기반)의 버전을 확인할 수 있습니다.

OpenSQL 데이터베이스

OpenSQL 설치를 위한 기본환경 설정 및 PostgreSQL 설치 과정을 안내합니다.

OpenSQL은 PostgreSQL 기반의 데이터베이스 패키지로 본 매뉴얼은 OpenSQL 설치를 위한 기본환경 설정 및 PostgreSQL 설치 과정을 안내합니다.

OpenSQL 바이너리 압축을 해제하면 scripts 디렉토리 안에 setenv.sh , install.sh 등 OpenSQL 설치를 위한 스크립트가 포함되어 있습니다.

opensql 유저가 생성되며 해당 유저로 전환됩니다.

OpenSQL이 설치될 위치를 환경 변수 OPENSQL_HOME 로 설정합니다.

OPENSQL 환경 변수를 bashrc에 설정하고, OPENSQL을 설치하는데 필요한 디렉터리 위치를 설정합니다.

OpenHA 클러스터 매니저(OpenHA Cluster Manager)

OpenHA의 핵심 관리 모듈인 OpenHA 클러스터 매니저(OpenHA Cluster Manager) 설치 과정에 대해서 안내합니다.

OpenHA의 핵심 관리 모듈로, 각 노드에 설치된 PostgreSQL 데이터베이스 인스턴스의 라이프사이클을 관리하고, 클러스터 구성을 통한 고가용성 기능을 제공합니다. 장애 발생 시 자동 Failover, Primary 노드 선출, 클러스터 상태 조회 등의 기능을 수행합니다.

이 모듈은 Patroni 기술을 기반으로 구현되었으며, REST API를 통해 클러스터 제어가 가능합니다.

OpenHA Cluster Manager 설치 과정에 대해서 기술합니다.

해당 노드에 PostgreSQL 서버가 설치되어 있어야 하며, postgres 사용자가 구성되어 있어야 합니다.

오픈 프록시(OpenProxy)

Rust 기반 서버 프로세스인 오픈프록시(OpenProxy)에 대해 안내합니다.

개요

오픈프록시(OpenProxy)는 Rust 기반 서버 프로세스로 PostgreSQL 데이터베이스에 대한 커넥션 풀링, 쿼리 라우팅을 통한 로드밸런싱, 데이터베이스 샤딩 및 가상 IP 기반 Failover 기능을 제공하는 프록시 서버입니다.

본 문서는 OpenSQL 패키징 툴을 이용해 작성한 OpenSQL 패키지로부터 OpenProxy를 설치하는 방법에 대하여 기술합니다.

설치

1. Openproxy 구성

OpenSQL 패키지 내 $OPENSQL_INSTALL_HOME/openproxy 디렉토리에는 Openproxy 구동에 필요한 다음 세가지 파일이 포함되어 있습니다.

Openproxy 바이너리 openproxy
구동에 필요한 설정 파일 (openproxy.toml)
systemd 등록에 필요한 service 파일 (openproxy.service)

파일들을 사용하여 OpenProxy를 설정하고 systemd를 통해 서비스로 등록할 수 있습니다.

아래 명령어를 통해 바이너리의 버전을 확인할 수 있습니다.

Barman

Python 기반 오픈소스 솔루션인 Barman에 대해 안내합니다.

개요

Barman은 Python 기반 오픈소스 솔루션으로 PostgreSQL 데이터베이스의 Full 및 증분 방식의 백업 생성과 관리, 특정 시점 지정 복구 (PITR) 기능을 지원합니다.

본 문서는 OpenSQL 패키징 툴을 이용해 작성한 OpenSQL 패키지로부터 Barman을 설치하는 방법에 대하여 기술합니다.

설치

1. OPENSQL_INSTALL_HOME 디렉토리 설정

2. Barman 설치

Barman 설치 여부 확인

Components 설정/실행

OpenSQL v3.0 의 components 별 실행 순서는 아래와 같습니다.

Etcd
Patroni + PostgreSQL
OpenProxy

OpenSQL 관리

오픈프록시(OpenProxy) 관리

본 문서에서는 OpenProxy의 Connection Pooling, 로드밸런싱, 가상 IP 및 이중화 구성에 대한 설명과 Configuration 파라미터를 통해 해당 기능을 관리하는 방법에 대하여 기술합니다.

사용법

OpenSQL-Installer 를 통해 설치한 경우 OpenProxy는 아래 명령어로 기동된 상태입니다.

$OPENSQL_HOME/etc/openproxy.toml 설정 파일을 로드하여 백그라운드(nohup)로 프로세스를 실행합니다.
프로세스 기동 확인 후 PID를

O2 Extensions

본 안내서는 OpenSQL을 사용하는 사용자를 대상으로 기술합니다.

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의 도입으로 인해 성능, 유연성, 안정성이 크게 향상되었습니다.

설치 안내서

참조 안내서

SQL 함수(SQL function) 참조 안내서

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

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

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

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

집계함수(Aggregate Functions)

WM_CONCAT

Syntax

WM_CONCAT
(
  expr  IN text
)
RETURNS text;

개요

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

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

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

입력 값이 NULL인 경우 해당 값은 집계에서 제외합니다.
첫 번째 값이 입력되면 새로운 상태(문자열 버퍼)가 생성합니다.
이후 값이 입력되면 기존 문자열 뒤에 기본 구분자(콤마)가 추된 후, 해당 값이 이어서 결합합니다.
집계가 완료되면 누적된 문자열이 최종 결과로 반환합니다.

파라미터

설명

조건함수(Conditional Functions)

GREATEST

Syntex

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

개요

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

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

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

파라미터

설명

expr1

LEAST

Syntax

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

개요

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

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

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

파라미터

설명

expr1

LNNVL

Syntax

LNNVL
(
  value  IN boolean
)
RETURNS boolean;

개요

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

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

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

파라미터

설명

value

NANVL

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을 다른 값으로 대체할 때 쓰입니다.

파라미터

설명

NVL

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

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

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

파라미터

설명

날짜시간함수(DateTime Functions)

DBTIMEZONE

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

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

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

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

LAST_DAY

Syntax

개요

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

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

파라미터

설명

value

date, timestamptz 타입입니다; 마지막 날짜를 구할 기준 날짜입니다. timestamptz의 경우, 해당 달의 첫 날을 구한 후 한 달을 더하고 하루를 빼는 방식으로 계산합니다.

예제

MONTHS_BETWEEN

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일 기준으로 계산됩니다.

파라미터

설명

date1 / timestamptz1

SESSIONTIMEZONE

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

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

SYS_EXTRACT_UTC

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 타입을 사용해야 합니다.

파라미터

설명

time

SYSDATE

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

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

SYSTIMESTAMP

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

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

NUMTOYMINTERVAL

Syntax

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

개요

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

파라미터

설명

expr

변환할 입력 값입니다.

interval_unit

TO_YMINTERVAL

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 타입으로 변환하는 함수입니다.

파라미터

설명

sql_format

구간의 값을 반환하는 text 타입이며, 다음과 같은 포맷으로 구성됩니다. '[+|-]years-months'

ym_iso_format

구성요소

설명

Format 함수(Format Functions)

TO_MULTI_BYTE

Syntax

TO_MULTI_BYTE
(
  str  IN text
)
RETURNS text;

개요

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

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

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

파라미터

설명

str

TO_SINGLE_BYTE

Syntax

개요

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

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

파라미터

설명

str

text 타입입니다; 변환할 대상 문자열입니다. 다중 바이트 문자들이 단일 바이트 문자로 변환됩니다.

예제

TO_TIMESTAMP_TZ

Syntax

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

개요

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

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

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

파라미터

설명

Math 함수(Math Functions)

BITAND

Syntax

BITAND(expr1, expr2)

개요

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

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

인자 A는 SIGN(A) * FLOOR(ABS(A))로 대체됩니다.
인자 A는 n-bit two's complement 이진 정수 값으로 변환됩니다. 2 비트 값은 비트 단위 AND 연산을 통해 합쳐집니다.
n-bit two's complement 값은 NUMBER으로 다시 변환됩니다.

파라미터

설명

COSH

Syntax

개요

COSH는 n의 hyperbolic cosine입니다.

파라미터

설명

num

Numeric data type이거나 Numeric으로 변환될 수 있는 data type을 인자로 취할 수 있습니다.

반환 타입은 인자로 주었던 numeric data type과 같습니다.

예제

MOD

Syntax

MOD(num1, num2);

개요

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

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

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

num1 - num2 * FLOOR(num1/num2)

파라미터

설명

REMAINDER

Syntax

REMAINDER(num1, num2);

개요

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

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

파라미터

설명

SINH

Syntax

개요

SINH는 num의 hyperbolic sine입니다.

파라미터

설명

num

Numeric data type이거나 Numeric으로 변환될 수 있는 data type을 인자로 취할 수 있습니다.

반환 타입은 인자로 주었던 numeric data type과 같습니다.

예제

TANH

Syntax

개요

COSH는 n의 hyperbolic cosine입니다.

파라미터

설명

num

Numeric data type이거나 Numeric으로 변환될 수 있는 data type을 인자로 취할 수 있습니다.

반환 타입은 인자로 주었던 numeric data type과 같습니다.

예제

BIN_TO_NUM

Syntax

개요

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

파라미터

설명

expr

expr는 숫자형 타입이나 숫자형 타입으로 변환될 수 있는 값을 반환하는 임의의 연산식입니다.expr의 반환 값이 숫자형 타입이 아니면 숫자형 타입으로 변환 후 정수 값으로 변환해서 사용합니다. (trunc() 결과와 같다)변환 후의 정수 값은 0 또는 1 이어야 합니다.

예제

Misc 함수(Misc Functions)

SYS_GUID

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

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

DUMP

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 함수에 대해 어떤 특정 출력 포맷에 의존하면 안됩니다.

텍스트 함수(Text Functions)

INSTR

Syntax

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

개요

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

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

파라미터

설명

LENGTH

Syntax

개요

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

파라미터

설명

str

문자열을 반환하는 임의의 연산식입니다. CHAR, TEXT 타입을 가질 수 있습니다.

예제

LPAD

Syntax

LPAD(expr1, num [, expr2])

개요

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

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

파라미터

설명

expr1

LTRIM

Syntax

LTRIM(str [, char_set])

개요

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

파라미터

설명

str

문자열을 반환하는 임의의 연산식입니다.

NLSSORT

Syntax

NLSSORT(str [, ' nlsparam '])

개요

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

파라미터

설명

str

정렬하기 위한 문자열 값입니다. TEXT, CHAR 타입의 데이터가 올 수 있습니다.

REGEXP_COUNT

Syntax

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

개요

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

파라미터

설명

str

문자열을 반환하는 임의의 연산식입니다. TEXT, CHAR의 타입이 올 수 있습니다.

REGEXP_LIKE

Syntax

REGEXP_COUNT(str, pattern [, match_param])

개요

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

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

파라미터

설명

str

REGEXP_SUBSTR

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

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

파라미터

설명

RPAD

Syntax

RPAD(expr1, num [, expr2])

개요

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

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

파라미터

설명

expr1

RTRIM

Syntax

RTRIM(str [, char_set])

개요

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

파라미터

설명

str

문자열을 반환하는 임의의 연산식입니다.

SUBSTR

Syntax

SUBSTR(str, position [, length])

개요

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

파라미터

설명

str

문자열을 반환하는 임의의 연산식입니다. smallint, integer, bigint, decimal, numeric 타입의 숫자형 데이터가 들어오면 자동으로 문자열로 변환된 후 문자열로써 처리됩니다.

ASCIISTR

Syntax

개요

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

파라미터

설명

str

문자열을 반환하는 임의의 연산식입니다.

예제

HEXTORAW

Syntax

개요

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

파라미터

설명

str

16진수 형태의 문자열 값을 반환하는 임의의 연산식입니다.

예제

RAWTOHEX

Syntax

개요

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

파라미터

설명

raw

문자열 값을 반환하는 임의의 연산식입니다.

예제

XML 함수(XML Functions)

가상 IP 및 이중화 구성 관리

개요

OpenProxy 에서 제공하는 가상 라우터 다중화 프로토콜 (VRRP) 기반의 가상 IP (Virtual IP) 설정 및 관제 기능에 대한 설명과 구성 방법에 대하여 서술합니다.

가상 IP 관리 기능

OpenProxy 에서는 가상 라우터 다중화 프로토콜 (VRRP) 기반으로 Virtual IP 를 관리하여 한 OpenProxy 노드가 예기치 않게 종료되어도 같은 가상 IP를 이용해 서비스 고가용성을 유지할 수 있습니다. 이때 PostgreSQL 커넥션 Pooling 및 로드밸런싱 기능에 영향을 미치지 않도록 별도의 비동기 런타임을 통하여 가상 라우터 이벤트를 처리합니다.

지정한 네트워크 인터페이스의 Multicast 주소로 Advertisement Packet을 보내 노드 간 통신하는 Multicast 방식, 혹은 다른 모든 Peer 노드 (OpenProxy가 구성된 다른 노드) 들의 IPv4 주소를 설정하여 통신하는Unicast 방식으로 동작합니다.

Advertisement Packet의 송/수신은 Linux Raw (L3; IP) 소켓을 열고 네트워크의 Multicast 주소 224.0.0.18 에 바인딩 혹은 자신이 구동중인 노드의 IPv4 주소에 바인딩 (Unicast 옵션을 활성화한 경우) 함으로써 이루어집니다.
가상 IP 점유 / 해제는 Linux NetLink 소켓을 열고 커널에 RTM_NEWADDR 혹은 RTM_DELADDR 메세지를 직접 보내는 방식으로 이루어집니다.

가상 IP 기능 활성화를 위해서는 OpenProxy 프로세스에 Linux 시스템 권한 cap_net_admin 과 cap_net_raw 설정이 필요합니다.

Patroni를 이용해 구성된 PostgreSQL 클러스터에 대해 OpenProxy에서 접속할 PostgreSQL 서버의 Role을 정의할 필요 없이 Patroni의 REST API를 통한 Topology Discovery를 수행하도록 지정할 수 있습니다.

각 Pool의 Shard 마다 use_patroni (Boolean) 키를 true로 설정해 활성화할 수 있으며 정의되어 있지 않은 경우는 해당 기능이 비활성화됩니다.
Shard 마다 필요한 경우 patroni_port 변수를 추가로 설정해 기본 Port 8008 이 아닌 다른 Port를 리스닝하고 있는 Patroni 서버와도 연동할 수 있습니다.
Patroni 서버와 연동해 클러스터 토폴로지를 가져오는 경우 Shard의 Server 마다 설정한 PostgreSQL에 접속하기 위한 Port 번호와 PostgreSQL 노드 Role (

Patroni와 연동되도록 설정된 Pool은 설정된 renew_interval (밀리초 단위, 기본값: 5000) 주기마다 Patroni의 REST API 서버에 요청을 보내, PostgreSQL 서버의 접속 정보와 Primary/Replica 역할(Role) 정보를 가져옵니다.

Patroni 서버로 보내는 HTTP 요청은 기본적으로 1초의 타임아웃을 가집니다. Shard 내 서버에 요청을 보낸 후, 타임아웃 시간 내에 응답을 받지 못하거나 응답 파싱(Parsing)에 실패할 경우, 다음 서버로 요청을 보내는 방식으로 동작합니다.
모든 서버에 질의했음에도 응답을 정상적으로 처리하지 못한 경우, 서버의 역할(Role)을 업데이트하지 않습니다. 이로 인해 트랜잭션 풀링 모드에서의 쿼리 파싱(Query Parsing) 및 읽기-쓰기 분리(Read-Write Splitting) 기능이 정상적으로 동작하지 않을 수 있습니다.

OpenProxy 설정파일인 openproxy.toml 에 [general.virtual_router] 항목을 설정하여 가상 라우터 기능을 활성화할 수 있습니다.

해당 항목이 정의되면 OpenProxy 프로세스 시작 시 별도 런타임을 통해 가상 라우터 상태 머신 (State Machine) 이 활성화되어 가상 IP 관련 이벤트를 처리합니다.

interface 항목은 다른 OpenProxy 노드들과 통신할 수 있는(즉 실제 물리 네트워크 인터페이스 카드를 통하여 연결된) 이 노드의 네트워크 인터페이스 이름을 지정합니다.
router_id 항목은 이 네트워크에서 가상 라우터 클러스터를 구분할 식별자로 1 ~ 255 사이의 값을 가집니다. 가상 IP MASTER 선출에 참여할 다른 OpenProxy 노드들과 같은 값을 가져야 합니다.
priority 항목은 MASTER 가상 라우터 선출에 있어 이 노드가 가질 우선순위 값으로 1 ~ 255 사이의 값을 가집니다. 우선순위 값이 255 인 노드는 시작과 동시에 BACKUP 상태가 아닌 MASTER 상태로 가상 IP 점유를 시도하게 됩니다. 이 외에는 Advertisement 패킷을 통해 전달되는 우선순위 값을 인식하여 가장 높은 노드가 MASTER 상태가 됩니다. 노드마다 다르게 설정하는 것을 권장합니다.

OpenProxy 설정파일인 openproxy.toml 에 Patroni REST API와 연동하고자 하는 Pool이 정의된 섹션의 Shard 정의에 use_patroni 키를 설정하여 토폴로지 Discovery 기능을 활성화합니다.

[general] 섹션의 renew_interval 값을 설정하여 openproxy.toml 파일을 읽어오거나 Patroni 서버에 질의하여 PostgreSQL 서버의 Role을 업데이트 할 주기를 조정할 수 있습니다.
Port 번호와 Role 값은 OpenProxy Connection 생성 시에 실제로 참조되는 값은 아니지만 하위 호환성을 위해 입력되어야 합니다.

가상 라우터 기능을 활성화하기 위해서는 OpenProxy 프로세스를 root 사용자 권한으로 실행하거나 cap_net_raw, cap_net_admin 권한이 부여되어야 합니다.

cap_net_raw 는 RAW 타입 네트워크 소켓을 열기 위해 필요합니다.
cap_net_admin 은 네트워크 인터페이스에 Secondary IP 추가 / 삭제를 위해 필요합니다.

아래와 같이 Linux setcap 을 이용해 실행 바이너리 openproxy 에 권한을 부여합니다.

systemd 서비스로 설정하여 구동하는 경우 .service 파일에 아래 옵션을 추가하여 권한을 부여합니다.

OpenSQL 통합 설치

1. 개요

OpenSQL 통합 설치는 OpenSQL-Installer 를 이용합니다.

OpenSQL-Installer는 OpenSQL 클러스터를 설치하는 Python 기반 인스톨러입니다. 설치 방식은 두 가지 중 하나를 선택합니다.

방식

스크립트

설명

설치되는 컴포넌트는 라이선스 에디션에 따라 자동으로 결정됩니다. 수동으로 선택하는 별도 설정은 없습니다.

컴포넌트

역할

모드

node1

node2

node3

버전

도구

용도

제어 서버에서 실행하므로 SSH 관련 도구가 필요합니다.

도구

용도

인스톨러가 원격/로컬 노드의 필수 패키지를 자동으로 검증합니다.

을 확인하여 필수 패키지 설치해야 합니다.

자동 설치: common.env에서 AUTO_INSTALL_PREREQS=true로 설정하면 인스톨러가 누락된 필수 패키지를 자동으로 설치합니다.

라이선스 XML은 opensql-installer/licenses/ 하위에 배치합니다. 인스톨러가 설치 중 각 노드로 복사하고 OPENSQL_LICENSE_PATH를 자동으로 설정합니다.

모드별 필수 라이선스 개수:

모드

필요 개수

대상 노드

제어 서버 → 각 노드: SSH 접속 가능해야 합니다.
인스톨러가 SSH 키(~/.ssh/id_rsa_opensql)를 자동 생성하고 각 노드에 등록합니다.
키 등록 시 최초 1회 SSH 비밀번호가 필요합니다.

로컬 설치: opensql_local_installer.py를 실행하는 사용자에게 sudo 권한이 필요합니다.
원격 설치: 각 노드의 SSH 접속 사용자에게 sudo 권한이 필요합니다.

인스톨러 실행 전, OpenSQL 배포 패키지(.tar.gz)를 먼저 압축 해제해야 합니다.

압축을 풀면 Tmax_OpenSQL_* 형태의 디렉토리가 생성되며, 그 안에 opensql-installer/가 포함됩니다.

설정 파일은 공통 설정(config/common.env)과 원격 설치 전용 설정(config/remote.env)으로 나뉩니다. 컴포넌트별 세부 옵션은 각 *.config.env에서 관리합니다.

로컬 설치와 원격 설치 모두에서 사용하는 공통 설정입니다. 인스톨러가 NODE1_IP ~ NODE3_IP와 현재 서버 IP를 비교하여 자신의 역할을 자동으로 감지합니다.

설치 수행 시 OPENSQL_USER와 OPENSQL_GROUP 은 자동 생성되며 sudo 권한이 부여됩니다.
- 이미 동명의 유저와 그룹이 존재한다면 무시가 됩니다.
- 기존의 유저와 그룹을 이용하려면 해당 유저에 sudo 권한이 부여된 상태여야 정상 설치됩니다.

제어 서버에서 opensql_remote_installer.py를 실행할 때 추가로 사용하는 설정입니다. 노드별 이름, SSH 접속 정보, 라이선스 파일명을 설정합니다. 노드 IP와 공통 설정은 config/common.env를 함께 참조합니다.

비밀번호 지정은 우선순위 순으로 다음과 같습니다.

방법 1: 실행 옵션으로 전달 (권장)

비밀번호를 파일에 저장하지 않고 실행 시점에 옵션으로 전달합니다.

방법 2: remote.env에 기재

각 컴포넌트의 포트, 사용자, 타임아웃 등 세부 옵션을 설정합니다. 기본값으로 충분한 경우 수정하지 않아도 됩니다.

파일

대상 컴포넌트

2node-witness 모드에서는 node3(witness)의 etcd 포트를 반드시 명시해야 합니다.

config/common.env에 설정합니다:

여러 클러스터 구성 시: 클러스터마다 다른 포트로 충돌을 방지합니다.

클러스터

CLUSTER_ID

CLIENT_PORT

PEER_PORT

테스트 환경이나 단일 서버 환경에 적합합니다.

공통 설정 (**config/common.env**):

원격 설치 전용 설정 (**config/remote.env**):

실행:

운영 환경의 표준 구성입니다.

공통 설정 (**config/common.env**):

NODE1_IP ~ NODE3_IP는 모든 노드에서 동일하게 설정합니다. 로컬 설치에서 각 노드마다 실행할 때 NODE_NAME과 LICENSE_NAME만 해당 노드에 맞게 변경합니다.

원격 설치 전용 설정 (**config/remote.env**):

실행:

2개의 PostgreSQL 노드와 별도의 etcd witness 노드로 구성합니다.

공통 설정 (**config/common.env**):

NODE1_IP ~ NODE3_IP는 모든 노드에서 동일하게 설정합니다. node1/node2에서 실행 시 NODE_NAME과 LICENSE_NAME을 해당 노드에 맞게 변경합니다. node3(witness)에는 LICENSE_NAME을 비워둡니다.

etcd 옵션 (**config/etcd.config.env**):

원격 설치 전용 설정 (**config/remote.env**):

실행:

동일한 node3에 여러 클러스터를 구성할 경우 클러스터마다 다른 포트를 지정합니다.

클러스터 1: CLUSTER_ID=c1, WITNESS_ETCD_CLIENT_PORT=2379, WITNESS_ETCD_PEER_PORT=2380

클러스터 2: CLUSTER_ID=c2, WITNESS_ETCD_CLIENT_PORT=2479, WITNESS_ETCD_PEER_PORT=2480

각 노드에 직접 SSH 접속한 후 실행합니다.

node1, node2, node3 각각에서 NODE_NAME과 LICENSE_NAME을 변경하여 실행합니다. 완료 후 다른 노드에서도 동일하게 실행해야 클러스터가 완성됩니다.

제어 서버에서 한 번 실행하면 모든 노드에 일괄 설치됩니다.

옵션

설명

단계

이름

설명

단계

이름

설명

방식

로그 위치

인스톨러는 각 노드의 opensql 유저 홈에 ~/.opensqlrc 파일을 생성합니다.

인스톨러가 기록하는 기본 내용:

커스텀 환경 변수 추가:

변경 후 재로드:

주의: 인스톨러를 재실행하면 ~/.opensqlrc가 덮어씌워집니다. 재실행 후에도 유지할 변수는 ~/.bashrc 끝에 직접 추가하세요. (~/.bashrc는 인스톨러가 source 라인만 추가하며 기존 내용을 덮어쓰지 않습니다.)

포트

컴포넌트

config/common.env의 NODE1_IP ~ NODE3_IP가 현재 서버의 실제 IP와 일치하는지 확인하세요.
hostname -I 명령으로 현재 서버 IP를 확인하세요.

SSH 비밀번호가 올바른지 확인하세요.
sshpass가 설치되어 있는지 확인하세요: which sshpass
수동으로 키를 등록해볼 수 있습니다:

로그에 표시된 설치 명령을 해당 노드에서 실행합니다.
또는 AUTO_INSTALL_PREREQS=true 설정 후 재실행합니다.

opensql-installer/licenses/ 디렉토리를 생성하고 XML 파일을 배치했는지 확인하세요.
LICENSE_NAME (로컬) 또는 NODE{n}_LICENSE_NAME (원격) 값이 실제 파일명과 일치하는지 확인하세요.

라이선스 XML 파일에 <edition> 태그가 포함되어 있는지 확인하세요.
지원 에디션: standard, enterprise, ai

각 노드에 서로 다른 라이선스 XML을 사용해야 합니다.

환경 변수 설정 단계 로그에서 오류가 없었는지 확인하세요.

etcd 서비스 로그를 확인합니다:
etcd 포트가 이미 사용 중인지 확인합니다:

OpenProxy 로그를 확인합니다:
포트가 이미 사용 중인지 확인합니다:

Patroni 로그를 확인합니다:
Patroni API 상태를 확인합니다:

Patroni 관리

patronictl은 Patroni 패키지와 함께 설치되는 Python 3로 작성된 CLI (커맨드라인 인터페이스)로, Patroni 클러스터가 제공하는 REST API를 이용하여 클러스터를 관제 하거나 DCS에 접근하기 위한 기능을 제공합니다.

PostgreSQL 클러스터의 관리와 상태 체크, 설정 값 등을 확인하기 위해 사용합니다.

설치 확인

patronictl은 기본적으로 Python 3 패키지 patroni 와 함께 제공됩니다. 아래와 같이 노드에 patronictl이 설치되어 있는지 여부와 버전을 확인할 수 있습니다.

$ which patronictl 
/usr/local/bin/patronictl

$ patronictl version
patronictl version 4.0.5

Local Configuration File 설정하기

Patroni 프로세스 실행 시 매개변수로 입력 받는 경로에 위치한 yml 파일로부터 읽어오는 설정 값들에 대해 설명합니다.

Local Configuration 항목값들은 Patroni 프로세스에 SIGHUP 시그널을 보내거나 REST API 서버에 POST /reload 요청을 보내 설정 파일을 새로 읽어오도록 함으로써 갱신할 수 있습니다. 기본 템플릿 환경 구성 파일의 경로는 $OPENSQL_HOME/etc/patroni/patroni.yml 를 참조합니다. 해당 경로에 yml 파일을 생성하고 해당 파일의 내용을 수정하여 구성하고자 하는 환경에 맞게 변경합니다.

Patroni 클러스터의 메타 정보, etcd 연결 정보, 로깅 구성, REST API 서버 구성 및 PostgreSQL 파라미터 정보를 정의할 수 있습니다.
PostgreSQL 파라미터 셋은 Local Configuration 및 Global Dynamic Configuration로 설정할 수 있습니다. 중복되는 키가 있는 경우 Local Configuration의 값이 우선합니다.
bootstrap.dcs 항목을 정의해 아래의 Global Dynamic Configuration의 초기 구성 셋을 설정할 수 있습니다.

scope: 구성하고자 하는 Patroni 클러스터의 이름으로 PostgreSQL 파라미터 cluster_name 에 적용됩니다.
namespace: Configuration Store 내에서 사용할 키의 접두어입니다.
name: 해당 인스턴스 (노드) 의 이름으로 클러스터 내에서 Unique 해야하며 설정하지 않는 경우 호스트네임이 사용됩니다.

log.type: 로그 형식을 지정하는 항목으로 plain 과 json 두 가지 옵션을 지원합니다. json 타입 사용을 위해서는 Python 패키지 patroni[jsonlogger] 설치가 추가로 필요합니다.
log.format: 로그 메세지 형식을 지정하는 항목으로 Python logging 패키지의 LogRecord 모듈에서 지정하는 포맷 문자열 규칙을 따릅니다.

restapi.listen: Patroni REST API 서버가 바인딩 될 IPv4 주소와 포트 번호를 지정합니다.
restapi.connect_address: Patroni 멤버 간 통신을 위해 사용할 이 노드의 외부 식별 가능한 Rest API 서버 주소를 IPv4 주소 : 포트번호 형식으로 입력합니다. 클러스터 멤버를 조회하는 API 호출 시에도 이 값이 Parsing 되어 Host 주소로 사용됩니다.

etcd v3 인 경우의 예시

etcd3.protocol: etcd3 클러스터에 접근 시 사용할 프로토콜로 http 혹은 https 를 지원합니다. http 가 기본 값으로 사용되며 https 인 경우 etcd3.cacert, etcd3.cert, etcd3.key 항목 설정이 추가로 필요합니다.

Patroni 시작 시 노드에 PostgreSQL 데이터베이스가 초기화되지 않은 경우 이 섹션의 내용을 참조하여 데이터베이스 인스턴스를 초기화합니다. 이미 구성된 PostgreSQL 데이터베이스가 노드에 있는 경우 이 섹션의 내용 또는 추가되는 변경사항은 Patroni에 반영되지 않습니다.

하위 항목 bootstrap.dcs 의 내용은 Patroni 클러스터를 초기화하며 DCS에 Global Dynamic Configuration 으로 저장할 값들입니다.

bootstrap.dcs: Patroni 클러스터 환경설정으로 초기화 시 DCS의 /<namespace>/<scope>/config 에 저장되는 Global Dynamic Configuration 셋입니다.
bootstrap.initdb: 데이터베이스 초기화 방법으로 initdb (기본값) 를 설정한 경우 initdb 실행 시 넘겨줄 파라미터의 배열입니다.

PostgreSQL 데이터베이스의 시스템 파라미터, 기본 사용자, Host Based Authentication 규칙 및 데이터베이스 파라미터 등을 정의합니다. Patroni 설정값 세팅 중 Local Configuration에 해당합니다.

지정할 수 있는 항목들은 Global Dynamic Configuration의 키 postgresql 로 지정하는 항목과 동일합니다. 같은 키가 이 파일과 Global Dynamic Configuration에 중복으로 정의되는 경우 이 파일 (즉 Local Configuration File) 에 정의되는 값이 우선합니다.

postgresql.listen: 해당 노드의 Patroni가 실행할 PostgreSQL 서버가 Listen할 주소를 <IP주소>:<Port번호> 형태로 입력합니다.
postgresql.connect_address: 다른 노드 혹은 클라이언트 어플리케이션에서 참조할 PostgreSQL의 접속 URL을 입력합니다. 클러스터 정보 및 DSN을 조회할 때 반환되는 값입니다.
postgresql.proxy_address: PostgreSQL 서버에 접근하기 위한 Proxy 서버가 있는 경우 필요에 따라 서비스 디스커버리를 위해 그 Proxy 서버의 URL을 입력할 수 있으며 이 값은 DCS의 클러스터 정보에 같이 저장됩니다.

patronictl은 별도의 구성 설정을 저장하지 않으며, 매 실행 시 클러스터의 정보를 가져오기 위해 DCS 접속 URL 혹은 Patroni 접속 URL이 주어져야 합니다.

클러스터 구성에 사용한 Configuration .yml 파일을 인자로 주어 아래와 같이 사용합니다.

아래와 같이 Linux alias로 등록해 사용할 수도 있습니다.

클러스터의 구성 노드와 각 노드의 접속 정보, 상태 정보를 출력합니다.

클러스터 노드의 DSN (Data Source Name) 을 출력합니다. 별도 옵션이 주어지지 않으면 Leader 노드 접속 정보를 출력합니다.

특정 Role을 가진 멤버에 대한 접속 정보를 출력하거나 이름으로 특정 멤버에 대한 접속 정보를 출력할 수도 있습니다.

클러스터의 멤버 노드 중 하나의 PostgreSQL 프로세스를 재시작합니다. 클러스터 이름 (메타 정보에서 설정) 이 인자로 주어져야 하며 추가로 멤버 노드의 이름을 옵션으로 넣을 수 있습니다. 멤버 이름이 지정되지 않은 경우 모든 노드들이 한번씩 재시작됩니다.

대화형 프롬프트를 통해 재시작 일시 (바로 재시작하는 옵션과 Timestamp를 지정하여 재시작을 스케쥴하는 기능을 제공) 를 입력하며 재시작할 PostgreSQL 서버의 버전을 확인하여 필터링하는 기능을 제공합니다.

클러스터의 멤버 노드 중 하나의 PostgreSQL 서버를 재시작하지 않고 Configuration을 다시 불러오는 기능입니다. 클러스터 이름이 인자로 주어져야 하며 추가로 멤버 노드의 이름을 옵션으로 넣을 수 있습니다.

대화형 프롬프트를 통해 클러스터 멤버 리로딩을 스케쥴할 지 여부를 확인합니다.

Context 값이 internal, postmaster 인 PostgreSQL 변수 (GUC)는 Reloading 기능으로 변경할 수 없습니다. internal 변수는 서버 프로그램을 컴파일할 때 혹은 initdb 명령어로 데이터베이스를 초기화할 때 결정되는 변수로 데이터베이스 재설치 없이 변경할 수 없으며 postmaster 변수는 PostgreSQL 프로세스를 재시작해야 변경할 수 있습니다.

클러스터에서 발생한 Failover / Switchover 이력을 조회합니다.

특정 Role을 가진 PostgreSQL 노드에 데이터베이스 쿼리를 실행하여 결과값을 확인할 수 있습니다.

클러스터에 발생한 장애로 Leader 노드가 없는 경우 수동으로 Failover를 실행할 수 있습니다.

정상 동작중인 클러스터에서도 patronictl failover 명령어로 수동 Failover를 수행할 수 있습니다. 다만 정상 동작중인 클러스터에서 Leader 인스턴스를 변경하고자 하는 경우 patronictl switchover 명령어를 사용하는 것이 권장됩니다.

PostgreSQL / Patroni Leader 노드를 Replica로 전환하고, 다른 Replica 노드 중 하나를 Leader로 승격시키는 동작입니다.

Patroni 클러스터의 자동 Failover 기능을 중단시키고 유지보수 모드 (Maintenance Mode) 로 클러스터를 전환합니다.

Resume 명령어로 유지보수 모드를 종료하고 클러스터의 자동 Failover 기능을 다시 활성화합니다.

DCS를 조회하여 현재 Patroni 클러스터에 적용된 설정값들을 확인할 수 있습니다.

DCS에 저장된 Patroni 클러스터의 동적 환경설정 (Dynamic Configuration) 값을 수정할 수 있습니다.

로컬 사용자의 EDITOR 환경변수로 지정된 텍스트 에디터 또는 vi 를 서브프로세스로 실행하여 TTY 형태로 Configuration을 수정 후 저장할 수 있습니다.

뷰(View) 참조 안내서

뷰에 대한 참조 안내서입니다.

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

search_path를 설정하지 않은 경우

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

{schema_name}.{view_name}

-- 예시) o2views extension 설치 후, 새로 추가된 dba_tab_columns라는 뷰 사용합니다.
-- select * from oracle.dba_tab_columns;

search_path를 설정한 경우

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

-- 현재 접속 세션에서 스미카 'oracle'를 가장 우선순위 높은 search_path로 설정합니다.
set search_path to oracle, public;

{view_name}

-- 예시) o2views extension 설치 후, 새로 추가된 dba_tab_columns라는 뷰 사용합니다.
-- select * from dba_tab_columns;

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

ALL_COL_PRIVS

ALL_COL_PRIVS는 다음 유형의 권한을 보여줍니다.

현재 유저가 객체의 소유자, 권한 부여자 또는 권한 피부여자인 컬럼 객체 권한
활성화된 Role이나 PUBLIC이 권한 피부여자인 컬럼 객체 권한

컬럼

타입

설명

ALL_CONS_COLUMNS는 현재 사용자가 접근할 수 있고 Constraint에 지정된 컬럼들을 보여줍니다.

컬럼

타입

설명

ALL_CONSTRAINTS는 현재 사용자가 접근 가능한 테이블에 대한 Constraint 정의를 보여줍니다.

컬럼

타입

설명

ALL_INDEXES는 현재 사용자가 접근 가능한 테이블에 존재하는 인덱스에 대한 정보를 보여줍니다.

컬럼

타입

설명

ALL_IND_COLUMNS은 현재 사용자가 접근 가능한 테이블에 정의된 인덱스를 구성하는 컬럼들의 정보를 보여줍니다.

컬럼

타입

설명

ALL_OBJECTS는 데이터베이스에 존재하는 모든 객체에 대한 정보를 보여줍니다.

컬럼

타입

설명

ALL_PART_TABLES는 현재 사용자가 접근할 수 있는 파티션 테이블의 객체 수준 파티셔닝 정보를 보여줍니다.

컬럼

타입

설명

ALL_SOURCE를 통해 함수, 프로시저, 트리거, 패키지 명세, 패키지 본문 등 다양한 프로그램 유형의 소스 코드를 보여줍니다.

컬럼

타입

설명

ALL_TABLES는 현재 사용자가 액세스할 수 있는 모든 테이블을 보여줍니다.

컬럼

타입

설명

ALL_TAB_COLUMNS는 현재 사용자가 접근할 수 있는 테이블, 뷰, 클러스터의 컬럼들을 보여줍니다.

컬럼

타입

설명

ALL_TAB_PARTITIONS는 현재 사용자가 접근할 수 있는 파티션에 대해 파티션 레벨의 파티셔닝 정보, 파티션 저장 매개변수를 보여줍니다.

컬럼

타입

설명

ALL_TAB_PRIVS는 다음 유형의 권한을 보여줍니다.

현재 유저가 객체의 소유자, 권한 부여자 또는 권한 피부여자인 테이블 객체 권한
활성화된 Role이나 PUBLIC이 권한 피부여자인 테이블 객체 권한

컬럼

타입

설명

ALL_TRIGGERS는 현재 사용자가 액세스할 수 있는 모든 트리거를 표시합니다.

컬럼

타입

설명

ALL_TYPES는 현재 사용자가 액세스할 수 있는 모든 유형을 표시합니다.

컬럼

타입

설명

ALL_USERS는 현재 사용자에게 보이는 데이터베이스의 모든 사용자를 보여줍니다.

컬럼

타입

설명

ALL_VIEWS는 사용자 정의된 모든 뷰들에 대한 정보를 보여줍니다.

컬럼

타입

설명

DBA_CONS_COLUMNS는 Database 내 제약 조건이 설정된 모든 컬럼을 보여줍니다.

컬럼

타입

설명

DBA_COL_PRIVS는 Database 내 모든 컬럼 객체 권한을 보여줍니다.

컬럼

타입

설명

DBA_CONSTRAINTS는 Database 내 모든 테이블의 모든 제약 조건 정의를 보여줍니다.

컬럼

타입

설명

DBA_INDEXES는 Database에 존재하는 모든인덱스에 대한 정보를 보여줍니다.

컬럼

타입

설명

DBA_IND_COLUMNS은 Database 내 모든테이블에 정의된 인덱스를 구성하는 컬럼들의 정보를 보여줍니다.

컬럼

타입

설명

DBA_OBJECTS는 데이터베이스에 존재하는 모든 객체에 대한 정보를 보여줍니다.

컬럼

타입

설명

DBA_PART_TABLES는 데이터베이스에 존재하는 모든 파티션 테이블의 정보를 보여줍니다.

컬럼

타입

설명

DBA_PROCEDURES는 사용 가능한 모든 함수와 프로시저를 연관된 속성과 함께 보여줍니다.

컬럼

타입

설명

DBA_ROLES는 데이터베이스 내의 모든 ROLE을 보여줍니다.

컬럼

타입

설명

DBA_ROLE_PRIVS는 사용자에게 할당된 모든 역할에 대한 정보를 보여줍니다.

컬럼

타입

설명

DBA_SOURCE를 통해 함수, 프로시저, 트리거, 패키지 명세, 패키지 본문 등 다양한 프로그램 유형의 소스 코드를 보여줍니다.

컬럼

타입

설명

DBA_TAB_COLUMNS는 Database 내 모든 테이블, 뷰들의 컬럼을 보여줍니다.

컬럼

타입

설명

DBA_TAB_PARTITIONS는 모든 파티션에 대해 파티션 레벨의 파티셔닝 정보, 파티션 저장 매개변수를 보여줍니다.

컬럼

타입

설명

DBA_TAB_PRIVS는 Database 내 모든 테이블의 권한을 보여줍니다.

컬럼

타입

설명

DBA_TABLES는 데이터베이스의 모든 테이블을 보여줍니다.

컬럼

타입

설명

DBA_TRIGGERS는 데이터베이스의 모든 트리거를 표시합니다.

컬럼

타입

설명

DBA_TYPES는 모든 유형을 표시합니다.

컬럼

타입

설명

DBA_USERS는 Database 내 모든 유저의 이름에 대한 정보를 보여줍니다.

컬럼

타입

설명

DBA_VIEWS는 Database 내사용자 정의된 모든 뷰들에 대한 정보를 보여줍니다.

컬럼

타입

설명

DUAL 테이블은 다른 테이블을 참조하지 않는 SELECT 문에서 사용할 수 있으며, 최소한 한 개의 행을 반환해야 할 때 유용합니다. DUAL 테이블에서 선택하는 것은 SELECT 문을 사용하여 상수 표현식을 계산할 때 유용합니다. DUAL 테이블에는 단 하나의 행만 존재하므로, 상수 값은 한 번만 반환됩니다.

컬럼

타입

설명

각 O2 extension과 O2의 버전 정보와 업데이트 시점을 출력하는 뷰입니다.

컬럼

타입

설명

O2_MEMORY_CONTEXT_INFO는 O2에서 사용하는 메모리 컨텍스트 정보를 제공하는 뷰입니다.

컬럼

타입

설명

O2_SHARED_MEMORY_INFO는 SHARED MEMORY 사용량을 보여주는 뷰입니다.

컬럼

타입

설명

PRODUCT_COMPONENT_VERSION은 구성 요소 제품에 대한 버전과 상태에 대한 뷰입니다.

컬럼

타입

설명

USER_COL_PRIVS는 현재 유저가 객체의 소유자, 권한 부여자 또는 권한 피부여자인 컬럼 객체 권한을 보여줍니다.

컬럼

타입

설명

USER_CONS_COLUMNS는 현재 사용자가 소유하고 있고 Constraint에 지정된 컬럼들을 보여줍니다.

컬럼

타입

설명

USER_CONSTRAINTS는 현재 사용자가 소유한 테이블에 대한 Constraint 정의를 보여줍니다.

컬럼

타입

설명

USER_INDEXES는 현재 사용자가 소유한 테이블에 존재하는 인덱스에 대한 정보를 보여줍니다.

컬럼

타입

설명

USER_IND_COLUMNS은 현재 사용자가 소유한 테이블에 정의된 인덱스를 구성하는 컬럼들의 정보를 보여줍니다.

컬럼

타입

설명

USER_OBJECTS는 현재 유저가 소유한 객체에 대한 정보를 보여줍니다.

컬럼

타입

설명

USER_PART_TABLES는 현재 사용자가 소유한 파티션 테이블의 객체 수준 파티셔닝 정보를 보여줍니다.

컬럼

타입

설명

USER_ROLE_PRIVS는 현재 사용자에게 부여된 권한에 대한 정보를 보여줍니다.

컬럼

타입

설명

USER_SOURCE를 통해 함수, 프로시저, 트리거, 패키지 명세, 패키지 본문 등 다양한 프로그램 유형의 소스 코드를 보여줍니다.

컬럼

타입

설명

USER_TABLES는 현재 사용자가 소유한 모든 테이블을 보여줍니다.

컬럼

타입

설명

USER_TAB_COLUMNS는 현재 사용자가 소유한 테이블, 뷰, 클러스터의 컬럼들을 보여줍니다.

컬럼

타입

설명

USER_TAB_PARTITIONS는 현재 사용자가 소유한 파티션에 대해 파티션 레벨의 파티셔닝 정보, 파티션 저장 매개변수를 보여줍니다.

컬럼

타입

설명

USER_TAB_PRIVS는 현재 유저가 객체의 소유자인 테이블 권한을 보여줍니다.

컬럼

타입

설명

USER_TRIGGERS는 현재 사용자가 소유한 모든 트리거를 표시합니다.

컬럼

타입

설명

USER_TYPES는 현재 사용자가 소유한 모든 유형을 표시합니다.

컬럼

타입

설명

USER_USERS는 현재 사용자를 보여줍니다.

컬럼

타입

설명

USER_VIEWS는 현재 유저가 정의한 뷰들에 대한 정보를 보여줍니다.

컬럼

타입

설명

Tmax OpenSQL 3.0 manual_v1.5.0

OpenSQL Manual

사전 필요 지식

목차

OpenSQL 개요

OpenSQL Components

OpenSQL 데이터베이스

OpenHA

OpenSQL 설치

OpenSQL 3 바이너리 설치

OpenHA DCS (Distributed Configuration Store)

OpenSQL 데이터베이스

OpenHA 클러스터 매니저(OpenHA Cluster Manager)

오픈 프록시(OpenProxy)

개요

설치

1. Openproxy 구성

Barman

개요

설치

1. OPENSQL_INSTALL_HOME 디렉토리 설정

2. Barman 설치

Barman 설치 여부 확인

Components 설정/실행

OpenSQL 관리

오픈프록시(OpenProxy) 관리

사용법

O2 Extensions

아키텍처 개요

PostgreSQL의 Extension 소개

O2 Extensions 소개

설치 안내서

참조 안내서

SQL 함수(SQL function) 참조 안내서

집계함수(Aggregate Functions)

WM_CONCAT

Syntax

개요

조건함수(Conditional Functions)

GREATEST

Syntex

개요

파라미터

LEAST

Syntax

개요

파라미터

LNNVL

Syntax

개요

파라미터

NANVL

Syntax

개요

파라미터

NVL

날짜시간함수(DateTime Functions)

DBTIMEZONE

LAST_DAY

Syntax

개요

파라미터

예제

MONTHS_BETWEEN

Syntax

개요

파라미터

SESSIONTIMEZONE

SYS_EXTRACT_UTC

Syntax

개요

파라미터

SYSDATE

SYSTIMESTAMP

NUMTOYMINTERVAL

Syntax

개요

파라미터

TO_YMINTERVAL

Syntax