1 of 5

TroubleShooting

Common Issues

O2 Extension을 사용하면서 문제가 발생할 경우 수행할 수 있는 조치 방법을 설명합니다.

예외 발생

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

에러 코드가 ‘O2’로 시작할 경우

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

TroubleShooting - 에러 코드 페이지를 참조하여 상황에 맞는 에러인지 확인합니다.
상황에 맞는 에러인 경우 TroubleShooting - 에러 코드 조치 가이드에 맞게 조치합니다.

에러 코드가 ‘O2’로 시작하지 않을 경우

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

를 참조하여 발생한 에러 코드가 상황에 맞는 에러인지 확인합니다.
상황에 맞는 에러인 경우 조치 가이드에 맞게 조치합니다.

데이터베이스의 성능 저하는 복합적인 원인을 가질 수 있습니다. O2 Extension 사용 시 성능 저하가 발생하더라도 PostgreSQL 코어나 다른 요소로부터 기인한 문제일 수 있습니다.

O2 Extension으로부터 기인한 성능 저하 문제인지 확인하는 몇 가지 방법을 제시합니다.

O2Functions의 빌트인 함수를 대체할 수 있는 PostgreSQL 빌트인 함수로 변경하여 테스트 합니다.
1. 만약 PostgreSQL 빌트인 함수로 대체 후 성능 저하가 해결된다면 O2Functions로부터 기인한 문제이므로 OpenSQL Support 팀에 문의합니다.
2. 만약 성능 저하가 해결되지 않는다면 PostgreSQL 코어나 다른 요소로부터 기인한 문제일 수 있으므로 병목현상의 원인을 다른 요소에서 찾아야 합니다.

PostgreSQL은 한 세션이 한 프로세스를 점유합니다. 만약 질의 처리 중 세션이 강제 종료될 경우 세션이 점유하고 있던 프로세스도 같이 강제 종료됩니다. 다른 세션은 영향을 받지 않습니다.

만약 O2 Extension에서의 버그로 인해 Segmentation Fault와 같은 시그널을 유발하는 에러가 발생할 경우를 대비하여 O2 Extension은 커스텀 시그널 핸들링 로직을 PostgreSQL에 주입했습니다. 커스텀 시그널 핸들링 로직은 시그널로 인해 세션이 강제 종료될 경우 PostgreSQL 로그에 문제가 발생한 위치의 Backtrace 로그를 출력합니다.

해당 시나리오가 발생할 경우 PostgreSQL 로그에서 Backtrace 로그를 찾아 저장하고 OpenSQL 지원팀에 문의합니다.

PostgreSQL의 에러 레벨 중 ‘PANIC’ 레벨은 모든 세션을 강제 종료합니다.

O2 Extension 사용 시 공유 메모리에 대한 잘못된 제어 및 접근을 동반한 버그로 인해 ‘PANIC’ 레벨의 에러가 발생할 수 있습니다. DBMS_PIPE와 DBMS_ALERT는 공유 메모리를 사용하고 있는 Extension으로 모종의 이유로 인해 공유 메모리 제어 시 에러가 발생할 경우 상기 상황이 발생할 가능성이 있습니다.

해당 상황이 발생한 경우 공유 메모리가 손상되었을 가능성이 있으므로 인스턴스 재기동이 필요합니다. PostgreSQL 로그에서 Backtrace 로그를 찾아 저장하고 OpenSQL 지원팀에 문의합니다.

이 결과는 Postgresql의 스펙에 따른 한계로 보입니다.

입력하는 데이터의 크기를 적절한 수치로 줄여보고 해당 방법으로도 해결이 되지 않는다면, PostgreSQL 로그에서 Backtrace 로그를 찾아 저장하고 OpenSQL 지원팀에 문의합니다.

에러 코드

개요

O2 Extension은 PostgreSQL의 빌트인 에러코드와 O2 Extension의 커스텀 에러 코드를 발생시킵니다. PostgreSQL 빌트인 에러코드에 대한 자세한 내용은 PostgreSQL Error Codes 매뉴얼을 참조합니다.

PostgreSQL의 에러코드는 5개의 문자로 구성됩니다. O2 Extension의 커스텀 에러 코드는 상위 2개 문자가 'O2'로 고정이고, 세 번째 문자는 에러 코드의 카테고리를 정의합니다.

에러 코드

카테고리 ‘0’ - 공통 에러

에러 코드

로그 레벨

설명

O2001

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

에러 코드

로그 레벨

설명

Large Data 처리 가이드

BLOB/CLOB <- TEXT, BYTEA

1GB 이하
TOAST에 의존합니다.
- PostgreSQL의 각 page영역은 일반적으로 8kb의 고정된 크기로 되어있고 각 tuple이 여러 페이지에 나뉘어 존재할 수 없습니다. (매우 큰 값을 바로 저장할 수 없습니다.)
  이 한계를 극복하기 위해서, 큰 필드 값은 압축되어 저장되거나 여러 개의 물리적 ROWS로 분할되어 저장됩니다.
- 이 기법을 TOAST (The Oversized-Attribute Storage Technique)라고 하며 PostgreSQL에서 큰 데이터 값을 메모리 내에서 효율적으로 처리하는 데에 사용됩니다.

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

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

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

FAQ

Q. PostgreSQL 서버에 O2 Extension을 어떻게 설치합니까?

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

Q. 설치한 O2 Extension을 어떻게 활성화합니까?

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

Q. O2 Extension이 특정 PostgreSQL 버전과 호환되지 않는 경우도 있습니까?

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

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

Extension

Feature

Object Type

PostgreSQL 최소 버전

A. 데이터베이스 성능 저하는 다양한 이유로 인해 발생할 수 있으며 문제 해결을 위해서는 정확한 원인을 찾는 것이 중요합니다. 성능 저하 해결에 대한 자세한 내용은 을 참조합니다.

A. O2 Extension에서는 PostgreSQL의 빌트인 에러 코드와 O2 Extension의 커스텀 에러 코드를 발생시킵니다. PostgreSQL의 빌트인 에러 코드는 매뉴얼을 참조합니다. O2 Extension의 커스텀 에러 코드는 을 참조합니다.

A. PostgreSQL은 Extension을 간단한 SQL 구문으로 업데이트할 수 있도록 설계되어 있습니다. O2 Extension도 마찬가지로 간단한 SQL 구문을 사용하여 업데이트할 수 있다. 자세한 내용은 를 참조합니다.

A. PostgreSQL은 Extension을 데이터베이스 객체로서 관리하며 간단한 SQL 구문으로 제거할 수 있도록 설계되어 있습니다. O2 Extension도 마찬가지로 간단한 SQL 구문을 사용하여 제거할 수 있습니다. 자세한 내용은 를 참조합니다.

A. O2 Extension 관련 로그는 PostgreSQL의 로그 파일에 함께 작성됩니다.

Common Issues

O2 Extension을 사용하면서 문제가 발생할 경우 수행할 수 있는 조치 방법을 설명합니다.

예외 발생

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

에러 코드가 ‘O2’로 시작할 경우

TroubleShooting - 에러 코드 페이지를 참조하여 상황에 맞는 에러인지 확인합니다.
상황에 맞는 에러인 경우 TroubleShooting - 에러 코드 조치 가이드에 맞게 조치합니다.

에러 코드가 ‘O2’로 시작하지 않을 경우

를 참조하여 발생한 에러 코드가 상황에 맞는 에러인지 확인합니다.
상황에 맞는 에러인 경우 조치 가이드에 맞게 조치합니다.

O2 Extension으로부터 기인한 성능 저하 문제인지 확인하는 몇 가지 방법을 제시합니다.

O2Functions의 빌트인 함수를 대체할 수 있는 PostgreSQL 빌트인 함수로 변경하여 테스트 합니다.
1. 만약 PostgreSQL 빌트인 함수로 대체 후 성능 저하가 해결된다면 O2Functions로부터 기인한 문제이므로 OpenSQL Support 팀에 문의합니다.
2. 만약 성능 저하가 해결되지 않는다면 PostgreSQL 코어나 다른 요소로부터 기인한 문제일 수 있으므로 병목현상의 원인을 다른 요소에서 찾아야 합니다.

해당 시나리오가 발생할 경우 PostgreSQL 로그에서 Backtrace 로그를 찾아 저장하고 OpenSQL 지원팀에 문의합니다.

PostgreSQL의 에러 레벨 중 ‘PANIC’ 레벨은 모든 세션을 강제 종료합니다.

이 결과는 Postgresql의 스펙에 따른 한계로 보입니다.

FAQ

Q. PostgreSQL 서버에 O2 Extension을 어떻게 설치합니까?

Q. 설치한 O2 Extension을 어떻게 활성화합니까?

Q. O2 Extension이 특정 PostgreSQL 버전과 호환되지 않는 경우도 있습니까?

Extension

Feature

Object Type

PostgreSQL 최소 버전

A. O2 Extension 관련 로그는 PostgreSQL의 로그 파일에 함께 작성됩니다.

TroubleShooting

Common Issues

예외 발생

에러 코드가 ‘O2’로 시작할 경우

에러 코드가 ‘O2’로 시작하지 않을 경우

에러 코드

개요

에러 코드

카테고리 ‘0’ - 공통 에러

Large Data 처리 가이드

BLOB/CLOB <- TEXT, BYTEA

FAQ

Q. PostgreSQL 서버에 O2 Extension을 어떻게 설치합니까?

Q. 설치한 O2 Extension을 어떻게 활성화합니까?

Q. O2 Extension이 특정 PostgreSQL 버전과 호환되지 않는 경우도 있습니까?

TroubleShooting

Large Data 처리 가이드

BLOB/CLOB <- TEXT, BYTEA

Common Issues

예외 발생

에러 코드가 ‘O2’로 시작할 경우

에러 코드가 ‘O2’로 시작하지 않을 경우

성능 저하 발생

싱글 세션 강제종료 발생

모든 세션 강제종료 발생

TEXT 타입에 많은 양의 데이터 입력시 Out of memory 발생

Large Object

Migration 가이드

FAQ

Q. PostgreSQL 서버에 O2 Extension을 어떻게 설치합니까?

Q. 설치한 O2 Extension을 어떻게 활성화합니까?

Q. O2 Extension이 특정 PostgreSQL 버전과 호환되지 않는 경우도 있습니까?

Q. O2 Extension을 사용한 후 성능 저하가 발생하면 어떻게 해결할 수 있습니까?

Q. O2 Extension 사용 중 발생하는 일반적인 에러 코드와 그 해결 방법은 무엇입니까?

Q. O2 Extension을 최신으로 업데이트하는 방법은 무엇입니까?

Q. 더 이상 필요하지 않은 O2 Extension을 어떻게 제거합니까?

Q. O2 Extension 관련 로그를 어디서 확인할 수 있습니까?

에러 코드

개요

에러 코드

카테고리 ‘0’ - 공통 에러

카테고리 ‘A’ - DBMS_ALERT 에러

카테고리 ‘B’ - License 에러

카테고리 ‘D’ - DBMS_JOB 에러

카테고리 ‘F’ - O2Functions 에러

카테고리 ‘H’ - DBMS_RLS 에러

카테고리 ‘J’ - O2Scheduler 에러

카테고리 ‘L’ - UTL_FILE 에러

카테고리 ‘P’ - DBMS_PIPE 에러

카테고리 ‘Q’ - DBMS_SQL 에러

카테고리 ‘R’ - DBMS_RANDOM 에러

카테고리 ‘S’ - DBMS_ASSERT 에러

카테고리 ‘U’ - DBMS_OUTPUT 에러

카테고리 ‘V’ - O2Views 에러

카테고리 ‘X’ - Debug 에러