2차 개발 도구

최근 업데이트 2026. 10. 02.

1. 개요

2.8 버전에서 기존 데이터 삭제 도구가 2차 개발 도구에 통합되었습니다.

ta-tool은 AE 프라이빗 배포 클러스터용 2차 개발 도구로, 기본적으로 처음 세 대의 서버에 배포되며(단일 서버 시스템에는 반드시 배포됨), 사용자가 편리하게 사용할 수 있는 다양한 2차 개발 기능을 제공합니다. 현재 제공하는 기능은 다음과 같습니다.

데이터 삭제
속성 타입 수정 및 삭제
이벤트 데이터 중복 제거
커스텀 데이터 가져오기. 커스텀 데이터는 SQL을 통해 이벤트 테이블, 유저 테이블과 조인 조회할 수 있습니다
커스텀 테이블 삭제
조회 키 생성. 사용자는 조회 키를 사용해 POST 메서드로 조회 API를 호출할 수 있습니다
정기적으로 실행되는 스크립트 설정. SQL로 AE 백엔드의 데이터를 조회하고 AE 데이터베이스에 다시 쓸 수 있습니다
정기적으로 실행되는 스크립트 설정. DataX 엔진을 통해 DataX가 지원하는 데이터 소스의 데이터를 AE 데이터베이스에 쓸 수 있습니다
데이터 아카이브 및 데이터 복원

2. 사용 방법

2차 개발 도구가 배포된 서버(분산 배포의 경우 기본적으로 처음 세 대)에 로그인하고, su - ta 명령을 실행해 ta 사용자로 전환한 다음 ta-tool을 실행해 명령 도움말을 확인합니다. 다음과 같이 표시됩니다.

su - ta
ta-tool

usage: ta-tool <명령> [옵션]
명령:
user_event_import [-conf <configPath >|--configration <configPaht>] [-d <date>|--date <date>]   데이터 백필
data_transfer [-conf <configPath >|--configration <configPaht>] [-d <date>|--date <date>]       커스텀 데이터를 TA 시스템으로 가져오기
drop_table [-t <table>|--table <table>]                                                         지정한 테이블 삭제
generate_api_secret [-appid <appid>]                                                            appid를 기반으로 해당 api_secret 생성
generate_root_secret                                                                            root 조회 키 생성
data_archive [start|stop|retry] [-jobid <jobid>]                                                아카이브 명령 (start: 작업 시작, stop: 작업 중지, retry: 실패한 작업 재실행, jobid 지정 필요)
data_reload  [start|stop|retry] [-jobid <jobid>]                                                복원 명령 (start: 작업 시작, stop: 작업 중지, retry: 실패한 작업 재실행, jobid 지정 필요)
datax_engine [-conf <configPath >|--configration <configPaht>]                                  DATAX 엔진 기반으로 데이터를 TA 시스템으로 가져오기
update_user_by_foreignkey [-conf <configPath >|--configration <configPaht>]                     외부 유저 속성 연관 가져오기
data_del                                                                                        데이터 삭제 기능
dupevent_del  [-hashNum <hashNum>|-needIncludeServerTime <true|false>]                          중복 이벤트 제거 기능
modify_meta                                                                                     메타데이터 수정 기능

옵션:
 -appid,--appid <appid>                appid 파라미터 설정
 -conf,--configration <configration>   설정 파일 경로 설정
 -d,--date <date>                      날짜 파라미터 설정
 -h,--help                             도움말 문서를 표시하고 종료
 -jobid,--jobid <jobid>                작업 ID, 아카이브/복원 실패 시 지정한 작업을 재실행하는 데 사용
 -t,--table <table>                    테이블 이름을 설정하면 지정한 테이블 삭제

예시:
ta-tool --help  도움말 정보 표시
ta-tool user_event_import -conf /data/home/ta/import_configs/*.json [-d 2019-08-01]      커스텀 유저 이벤트 데이터를 TA 시스템으로 가져오기
ta-tool data_transfer -conf /data/home/ta/dt_configs/*.json [--date 2019-08-01]          커스텀 테이블을 TA 시스템으로 가져오기
ta-tool drop_table -t test                                                               test 테이블 삭제
ta-tool generate_api_secret -appid test-appid                                            api_secret 생성
ta-tool generate_root_secret                                                             root 조회 키 생성
ta-tool data_archive start                                                               데이터 아카이브
ta-tool data_reload start                                                                데이터 복원
ta-tool data_archive retry -jobid jobid_1234                                             데이터 아카이브 실패 작업 재시도
ta-tool data_reload  retry -jobid jobid_1234                                             데이터 복원 실패 작업 재시도
ta-tool datax_engine -conf /data/home/ta/datax_configs/stream2stream.json                datax 엔진 호출
ta-tool data_del                                                                         데이터 삭제
ta-tool dupevent_del                                                                     이벤트 데이터 중복 제거
ta-tool modify_meta                                                                      메타데이터 수정