본문 바로가기

SOFTWARE

DBridge

DB Bridge

DB든 API든 이관 프로그램을 만들지 않고, 규칙만 등록하면 바뀐 데이터와 실행 순서는 엔진이 담당합니다.

1.x갱신 2026-08DB→DB · API→DB · 멀티프로세스 배치

이관 프로그램 대신 배치 규칙

옮길 대상을 코드가 아니라 규칙으로 정의합니다. 사람은 무엇을 옮길지만 적고, 언제 · 어떤 순서로 · 몇 건이 맞는지는 엔진이 맡습니다.

사람이 적는 것

  • 원천 조회 SQL과 목표 적재 SQL
  • 전체 적재인지 증분 적재인지
  • 선행 규칙과 실행 스테이지
  • 증분 조회의 시작 기간

엔진이 맡는 것

  • 조회 구간 — 지난 실행 지점부터 이번 실행 시각까지 계산
  • 실행 순서 — 스테이지는 차례로, 스테이지 안에서는 선행 완료 뒤 병렬
  • 적재 경로 — 대량 경로를 판정하고, 실패하면 일반 적재로 전환
  • 건수 확인 — 조회·적재 건수를 대조해 허용 오차를 넘으면 실패
  • 실행 지점 전진 — 후처리까지 성공한 실행만 다음 기준이 됨

새 연계는 화면 등록으로 추가합니다.

두 가지 적재 흐름

원천은 DB와 HTTP API 두 가지입니다. 목표는 RDBMS뿐 아니라 검색 색인·벡터 DB·그래프 DB까지 같은 규칙 체계로 적재합니다.

SourceRDBMS 또는 HTTP API
DBridge규칙 · 스케줄 · 변환 · 모니터링
TargetRDBMS · 검색 색인 · 벡터 DB · 그래프 DB

연계 방향은 DB→DBAPI→DB 두 가지입니다. API는 Source에만 올 수 있고, DB→API 송신은 제품 범위가 아닙니다.

제품이 하는 일

읽고, 쓰고, 맞았는지 확인하고, 계속 돌립니다. 네 단계가 한 제품 안에 있습니다.

추출 원천에서 읽습니다

  • 읽기 전용 조회원천 DB에는 조회만 수행하고 쓰지 않습니다.
  • 시간 구간 증분지난 실행 지점 이후 바뀐 구간만 다시 읽습니다.
  • 선언형 API 호출기관 API는 코드 추가 없이 화면 선언으로 연계합니다.
  • 타입 변환이기종 DBMS의 타입 차이를 변환하고 손실 가능성을 알립니다.

적재 목표에 씁니다

  • 전체 · 증분 적재전량 재적재와 변경분 병합을 규칙에서 선택합니다.
  • 대량 적재 경로목표 DBMS의 대량 적재 경로를 자동 판정하고, 실패한 묶음은 일반 적재로 이어 씁니다.
  • 논리 분할 병렬큰 작업을 키 구간으로 나눠 동시에 적재합니다.
  • 검색·벡터·그래프 적재검색 색인, 벡터 DB, 그래프 DB에도 같은 규칙 체계로 적재하고, 반영이 확인된 건수만 셉니다.

검증 맞았는지 확인합니다

  • 건수 자기검증조회 건수와 적재 건수를 대조해 허용 오차를 넘으면 실패로 처리합니다.
  • 독립 재조회 대사적재가 끝난 뒤 목표를 다시 조회해 원천과 대조합니다.
  • 4축 대사건수 · 집계 · 해시 · 행 순으로 어긋난 지점을 좁혀 갑니다.
  • 검증 원장대사 결과를 SHA-256 해시체인으로 이어 붙여 사후 수정할 수 없게 남깁니다.

운영 계속 돌립니다

  • 내장 스케줄러예약 실행 · 수동 실행 · 일시중지와 재개를 관리 콘솔에서 다룹니다.
  • 스테이지 의존성선행 규칙이 끝난 뒤 실행하고, 선행 실패를 종속 작업에 전파합니다.
  • 중복 실행 방지이중 잠금으로 같은 작업이 겹쳐 도는 것을 막습니다.
  • 실행 · 변경 이력실행 결과와 정의 변경을 이력으로 남깁니다.

적재가 성공해도 대사를 통과하지 못하면 검증 원장에 그대로 남습니다.

어디에 쓰나

옮기는 목적이 달라도 등록하는 것은 규칙 하나입니다.

실제 관리 화면

배치 규칙부터 API 접속정보, 호출 계약, 응답 필드 매핑까지 실제 콘솔 흐름을 확인하세요.

배치 규칙 · API Source와 DB Target을 한 화면에서 관리 배치 규칙 · API Source와 DB Target을 한 화면에서 관리

실제 DBridge 화면이며, 계정·내부 주소·업무 식별자와 데이터는 데모 값으로 대체하거나 마스킹했습니다.

핵심 화면 클로즈업

전체 화면은 운영 맥락을, 클로즈업은 편집·매핑 구조를 보여줍니다.

DBridge DB와 API 소스 배치 규칙 목록
배치 규칙 · DB·API Source와 DB Target
DBridge API Source에서 DB Target으로 응답 필드를 매핑하는 화면
API→DB · 요청 파라미터와 응답 필드 매핑
DBridge 선언 API 요청 계약 상세 화면
선언 API · 메서드, 경로, 본문 템플릿
DBridge API 첫 페이지 요청값과 시험 호출 화면
API 테스트 · 첫 페이지 요청값과 시험 호출

지원 소스·타깃

인터넷 없는 망에 설치합니다

반입 번들을 만들어 매체로 옮기고, 현장에서는 빌드하지 않고 설치만 합니다. 실행 중에도 외부 네트워크를 쓰지 않습니다.

운영 중 외부 저장소나 원격 API에 접속하지 않습니다 — 설치도 실행도 망 안에서 끝납니다.

사양

공개 버전 계열
1.x
지원 흐름
DB→DB · API→DB
Target 저장소
RDBMS · 검색 색인 · 벡터 DB · 그래프 DB
방향 제약
API는 Source 전용 · DB→API 송신 없음
메타 저장
PostgreSQL
실행
내장 스케줄러 · 수동 실행 · 일시중지/재개
배포
Docker Compose · 폐쇄망 배포

도입 · 시작하기

  1. 요건 검토 — DB→DB 또는 API→DB 방향, 소스·타깃, 데이터 규모와 실행 주기를 정합니다.
  2. 메타 정의 — 접속정보, 배치 규칙, 쿼리 또는 API 호출 계약과 의존성을 등록합니다.
  3. 검증·스케줄 — 관리 콘솔에서 검증한 뒤 수동 또는 내장 스케줄로 실행합니다.

도입을 검토하고 계신가요?

고객 요건과 운영 환경에 맞춰 구성·도입 절차를 안내해 드립니다. 데모·제안 요청은 문의로 받습니다.

이미지를 클릭하면 원본 크기 · 바깥 클릭이나 Esc로 닫기