웹 콘솔 가이드¶

Datatrans는 CLI와 웹 콘솔(UI)을 함께 지원합니다. 콘솔은 진행 상황을 조회하는 화면에 더해, 프로젝트에 작업을 저장하고 테이블·매핑·스크램블링 규칙을 편집하여 검증·실행·예약까지 수행하는 작업 공간입니다.

데이터 병렬 처리와 스크램블링을 통한 테스트 데이터 구축 작업을 브라우저에서 반복 실행하고 결과를 확인할 수 있습니다. CLI를 사용하는 기존 운영 방식도 계속 사용할 수 있습니다.

1. 접속과 최초 설정¶

서버의 Datatrans 설치 루트에서 번들 Python으로 콘솔을 시작합니다.

export DATATRANS_HOME="$PWD"
python/bin/python3 -m dashboard --host 0.0.0.0 --port 7501

사용자 PC에서 http://서버주소:7501에 접속합니다. 이 명령은 수동 기동이며 콘솔 자체의 부팅 시 자동 기동을 설정하는 명령은 아닙니다. 프런트엔드는 정적 자산으로 제공되어 운영 서버에 별도의 프런트엔드 개발용 Node 프로세스가 필요하지 않습니다.

첫 관리자 등록에서 아이디·사용자명·10자 이상의 비밀번호를 등록합니다. 최초 등록은 한 번만 가능합니다.
관리자가 설정에서 서버 라이선스 상태를 확인하고 필요한 활성화를 진행합니다. 라이선스는 접속한 사용자 PC가 아닌 Datatrans 서버 PC 기준입니다.
설정 → 사용자에서 작업용 user 계정을 추가합니다.
DB 연결에서 Source/Target과 필요한 Trigger Repository 연결을 등록·테스트합니다.
프로젝트를 만들고 연결·사용자·생성/수정/실행 권한을 지정합니다.
작업용 사용자로 로그인하여 할당된 프로젝트에서 작업을 준비합니다.

계정과 프로젝트는 ContextMeta와 독립적으로 관리합니다. 로그인 화면의 아이디 저장은 로그인 성공 후 아이디만 해당 브라우저에 저장하며, 해제하면 삭제합니다. 비밀번호는 이 기능으로 저장하지 않습니다.

2. 관리자와 작업 사용자¶

역할	주요 작업
`admin`	사용자·DB 연결·프로젝트 할당·권한·실행 승인 관리, 작업과 결과 조회, 허용된 실행 중단·보관
`user`	할당된 프로젝트에서 권한에 따라 작업 생성·수정·검증·실행·예약

관리자는 작업을 직접 생성·수정·실행하지 않습니다. 실제 데이터 작업은 사용자 계정으로 진행합니다. 생성·수정·실행 권한은 각각 적용되며 실행 권한만으로 작업을 수정할 수는 없습니다.

Source/Target은 Oracle, Trigger Repository는 Oracle 또는 PostgreSQL을 지원합니다. DB 연결은 관리자가 프로젝트에 지정하며 작업 사용자가 실행 화면에서 임의의 연결로 바꾸지 않습니다. 과거 작업 버전을 실행해도 현재 프로젝트에 지정된 연결을 사용합니다.

DB 연결 등록·수정 창의 접속 테스트는 입력한 값을 저장하지 않고 검사합니다. 연결 수정 시 비밀번호를 비워 두면 기존 값을 유지하며, 일반 조회·프로젝트 내보내기에는 비밀번호를 반환하지 않습니다.

3. 작업 만들기와 편집¶

왼쪽 프로젝트 탐색기에서 할당된 프로젝트를 선택하고 + 작업으로 작업을 만듭니다. 프로젝트는 한 단계 폴더이고 그 아래에 작업을 저장합니다.

편집 영역	설정 내용
기본·연결	작업명, TRANSFER/TRIGGER/PREVIEW 모드, 프로젝트 연결 확인, Trigger 조회 설정
테이블	스키마 또는 테이블 선택, 제외 목록, 스키마 변경, 접두·접미사, 조회 조건
매핑	Mapping YAML과 Source·Target·조회조건 및 컬럼 대응표 편집
스크램블링	Target별 YAML 규칙, 표 편집, 입력·출력 컬럼 선택과 규칙 테스트
실행 옵션	병렬도, 적재 방식, 실행 순서·우선순위, SCN/기준시각, 문자셋과 Oracle 대기 설정
검증	입력 검사, DB 메타데이터 검사, DB Preview와 선택적 원본 민감정보 탐색
버전 · 내보내기	저장된 버전 조회·불러오기, 저장된 parfile과 규칙 문서 내보내기

저장은 새 작업 버전을 만듭니다. 이전 버전을 불러와 수정한 뒤 다시 저장하거나, 작업을 복제하여 다음 테스트 데이터 구축에 재사용할 수 있습니다. 미저장 상태로 다른 작업으로 이동하거나 로그아웃할 때는 변경 내용 확인이 표시됩니다.

기존 CLI 작업 가져오기¶

parfile 가져오기로 작업명과 공개 실행 옵션을 가져옵니다. 접속 비밀번호는 가져오지 않으며 프로젝트에 지정된 연결을 사용합니다.
parfile에서 참조하던 Mapping·Scrambling 파일은 별도로 업로드합니다.
테이블 목록을 붙여넣거나 DB에서 찾기로 선택할 수 있습니다.
Mapping과 Scrambling은 YAML 외에 표 편집을 지원하며 Excel의 TSV 데이터를 붙여넣을 수 있습니다.
YAML에 적용 후 작업을 저장합니다. 표 내용을 변경하여 적용하면 YAML을 재구성하므로 기존 주석은 정리될 수 있습니다. 취소하거나 변경 없이 적용하면 원문을 유지합니다.
저장된 parfile 내보내기는 저장된 작업 버전을 기준으로 생성합니다. UI 전용 설정이 모두 CLI 파라미터로 변환되는 것은 아닙니다.

4. 검증과 실행¶

입력 검사로 작업 옵션과 규칙 정의를 점검합니다.
실행 권한이 있고 실행 통제 대상이 아니라면 DB 메타데이터 검사로 실제 연결·대상 구조를 검사합니다.
DB Preview 실행으로 실제 Source 표본과 Target 메타데이터를 확인합니다. Target에 시험 INSERT를 하는 검사는 아닙니다.
적재 방식과 저장 버전을 확인하고 실행 또는 저장 후 실행을 선택합니다.
실행 상세에서 전송 진행·오류·실행 이력과 보고서를 확인합니다.

APPEND는 기존 데이터를 유지하며 추가하고, TRUNCATE는 비운 뒤 적재합니다. REPLACE·STRUCTURE의 구조 변경 의미와 Mapping 제한은 실행 파라미터를 확인하세요.

실행 통제 프로젝트¶

프로젝트의 실행 통제를 사용하면 실행 요청 또는 DB Preview 요청으로 접수합니다. 관리자가 실행 요청 내역에서 접수 후 10분 이내에 허용 또는 제한합니다. 허용된 요청은 신청자 명의로 한 번 실행됩니다.

실행 통제 프로젝트의 DB 검증은 관리자 확인을 거치는 Preview 요청으로 진행합니다. 승인 전에 권한·연결·설정·규칙 등이 바뀌면 기존 요청이 무효화될 수 있습니다. 예약은 실행 요청과 별개의 사전 승인 절차를 사용합니다.

규칙 테스트와 Preview의 차이¶

스크램블링 메뉴와 작업의 규칙 테스트는 입력한 합성 표본의 함수 결과를 확인합니다. 실제 DB 조회·전체 전송 성공을 검증하는 기능과는 다릅니다. 관리자 전용 규칙 관리에서는 Python 규칙의 조회·복제·편집·구문 검사·코드 테스트·버전 관리를 제공합니다. 등록된 코드는 서버에서 실행되는 신뢰된 관리자 코드입니다.

검증 → 원본 민감정보 탐색은 PREVIEW 실행에서만 선택적으로 적용합니다. UI/API는 표본 행 수 1~10,000행(기본 100행)을 지정할 수 있습니다. Preview 가이드에서 적재 호환성 검증과 민감정보 탐색 결과의 차이를 확인하세요.

5. 모니터링과 결과¶

콘솔에서 접수된 실행은 브라우저와 분리되어 처리되므로 브라우저를 닫아도 계속됩니다. 실행 상세에서는 권한과 상태에 따라 일시정지·재개·종료를 요청할 수 있습니다. 종료 요청이 이미 반영한 데이터를 되돌리지는 않습니다.

실행 모니터에서 실행 상태, 테이블별 진행, 처리 행 수, 처리율·자원 관측과 오류를 확인합니다.
Preview 보고서에서 테이블을 펼쳐 컬럼별 검증 결과를 보고 Markdown으로 내보냅니다.
COMPLETED_WITH_ERRORS는 오류 포함 완료입니다. PREVIEW 결과와 작업 상태는 따로 확인합니다.
관리자는 프로젝트 실행과 CLI 실행을 한 목록에서 조회하고 실행 경로로 구분합니다. CLI 실행은 모든 프로젝트에서 조회하며 특정 프로젝트에 임의로 귀속시키지 않습니다.
CLI 상세는 조회용이며 프로젝트 실행용 설정 재사용·실행 제어를 제공하지 않습니다. 일반 웹 사용자는 프로젝트에 속하지 않은 CLI 이력을 조회할 수 없습니다.

6. 예약과 표시 설정¶

작업의 예약에서 저장된 버전을 선택하여 일회 또는 반복 실행을 등록합니다. 반복 기준 시간대와 선택적 반복 만료날짜를 지정하고 수정·삭제·지금 실행·예약 이력을 관리할 수 있습니다. 실행 통제 프로젝트는 예약 자체의 사전 승인이 필요합니다.

예약은 systemd 사용자 timer/service가 기동합니다. 운영 계정의 준비와 CLI 예약의 차이는 예약 가이드를 확인하세요.

설정 → 표시 → 표시 시간대는 브라우저에 표시되는 시각만 바꿉니다. 기본값은 브라우저 현지 시간이며 서버 시계·예약 실행 기준을 바꾸지 않습니다. 라이트·다크·시스템 테마도 선택할 수 있습니다.

7. 암호화 연동 관리¶

별도 Datatrans Encryption Key Server가 구성된 환경에서는 관리자 전용 Runtime Key 승인 메뉴에서 암호화 서버의 요청을 검토하고 1차 승인·거부할 수 있습니다. 이후 Key Server의 별도 관리자 2차 승인과 정책 검증이 필요합니다.

콘솔에 키 조회·다운로드 기능은 없으며 실제 Runtime Key나 봉인 키를 받거나 저장하지 않습니다. 연동 설정이 없으면 미설정 안내를 표시합니다. 이 메뉴는 암호화 연동의 승인 기능이며, 작업의 모든 컬럼을 자동 암호화하는 전역 스위치는 아닙니다.

8. 보관과 도움말¶

프로젝트·작업·예약·실행 이력·규칙은 서버에 보관됩니다. 프로젝트 내보내기만으로 연결 자격증명이나 전체 서버 상태까지 백업되는 것은 아닙니다. 설치 백업에는 콘솔 관리 데이터, 보호된 자격증명 키, 예약 저장소, 설정과 규칙 자원을 함께 포함합니다.

도움말 메뉴에서는 CLI 도움말을 검색하고 절별로 펼치거나 전체 펼치기·전체 접기를 사용할 수 있습니다. CLI 명령은 대화형 모드, 공개 옵션은 실행 파라미터에서 확인하세요.