데이터 삭제 도구
1. 소개
데이터 삭제 도구는 AE 시스템의 데이터를 삭제하는 데 사용합니다. 기간과 이벤트 타입에 따라 이벤트 데이터를 삭제하거나, 전체 데이터(유저 데이터 포함)를 삭제할 수 있습니다. 이벤트 테이블과 유저 테이블의 Meta 데이터(즉, 테이블 구조)는 삭제되지 않습니다. Meta 데이터를 삭제해야 한다면 새 프로젝트를 만들고 기존 프로젝트를 삭제하는 것을 권장합니다.
테스트 데이터를 정리하거나 데이터에 이상이 있을 때만 데이터를 삭제하는 것을 권장하며, 데이터를 자주 삭제하는 용도로는 권장하지 않습니다. 이 도구는 신중하게 사용하십시오.
2. 사용 설명
2.7 및 이전 버전에서는 ta-data-del을 실행하여 데이터 삭제 도구에 진입하십시오
데이터 삭제 도구는 프라이빗 배포 서비스 사용자만 사용할 수 있습니다. root 사용자로 프라이빗 클러스터에서 2차 개발 도구가 배포된 서버(분산 배포 시 기본적으로 처음 세 대)에 로그인한 후 su - ta를 실행합니다
이어서 ta-tool data_del을 실행하면 데이터 삭제 도구 화면으로 들어갑니다.
2.1 삭제할 프로젝트의 appid 입력
프로젝트의 appid는 AE 백엔드의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에 있는 프로젝트 정보 카드에서 조회하거나, 데이터 → 데이터 연동 → 연동 가이드의 페이지 상단에서 확인할 수 있습니다.
2.2 프로젝트 이름 확인
입력을 마치면 삭제할 프로젝트의 프로젝트 이름이 표시됩니다. "y"를 입력하면 확인하고, "n"을 입력하면 작업을 취소합니다
2.3 데이터 삭제 타입 선택
다음으로 삭제할 데이터를 선택합니다. 이벤트 데이터(즉, 이벤트 테이블의 데이터)만 삭제하거나, 전체 데이터(모든 이벤트 테이블 데이터와 모든 유저 테이블 데이터)를 삭제할 수 있습니다. 아래 표는 두 가지 삭제 방식에서 사용할 수 있는 작업입니다.
| 삭제 데이터 타입 | 이벤트 데이터만 | 전체 데이터 |
|---|---|---|
| 이벤트(event) 테이블 삭제 여부 | √ | √ |
| 유저(user) 테이블 삭제 여부 | √ | |
| 시간 선택 가능 여부 | √ | 모든 시간 |
| 이벤트 선택 가능 여부 | √ | 모든 이벤트 |
2.4 이벤트 데이터를 삭제하는 경우의 작업
다음으로 삭제할 이벤트의 이벤트 이름을 입력합니다. 여기에 입력하는 이벤트 이름은 데이터를 전송할 때의 key 값이며, 표시 이름이 아닙니다. 이벤트 이름은 데이터 → 데이터 관리 → 이벤트에서 조회할 수 있습니다. 여러 이벤트를 삭제할 때는 ","로 구분하며, 입력을 마치면 삭제될 이벤트 이름이 표시됩니다.
아무 문자도 입력하지 않고 바로 Enter 키를 눌러 확인하면 모든 이벤트 데이터를 삭제하는 것으로 간주합니다.
2.5 이벤트 데이터 삭제 기간 입력
다음으로 데이터를 삭제할 기간을 입력합니다. 선택할 수 있는 시간 단위는 "일"이며, 날짜는 yyyy-MM-dd 형식으로 입력하십시오. 입력하지 않고 바로 Enter 키를 눌러 확인하면 기존 데이터의 첫날/마지막 날을 선택한 것으로 간주합니다. 구체적인 작업은 아래 표와 같습니다(빈칸은 입력하지 않음을 뜻합니다).
| 삭제 데이터 타입 | 시작 날짜 | 종료 날짜 |
|---|---|---|
| 전체 기간 데이터 삭제 | ||
| 첫날부터 특정일까지의 데이터 삭제 | 날짜 입력 | |
| 특정일부터 이후의 데이터 삭제 | 날짜 입력 | |
| 특정 기간의 데이터 삭제 | 날짜 입력 | 날짜 입력 |
여기서는 전체 기간 데이터를 삭제하는 경우를 예로 듭니다.
2.6 커스텀 조건 사용
삭제 시작 날짜와 종료 날짜를 지정한 경우 커스텀 조건 입력란이 나타납니다. 이 기능을 사용하면 SQL 문으로 삭제할 데이터의 판단 조건을 더 세분화할 수 있으며, 입력한 커스텀 조건은 삭제 문의 WHERE 조건으로 사용됩니다. 특정 필드를 is not null /is null로 직접 지정하지 않더라도, 시스템은 최종 조건에 "col" is not null을 자동으로 덧붙입니다.
커스텀 조건의 문법은 presto 표준을 따릅니다. 삭제 전에 삭제 문의 SQL 미리보기와 조건에 맞는 데이터 양을 제공합니다. 먼저 SQL IDE로 삭제할 데이터를 조회한 후, WHERE 절의 조건을 이곳의 커스텀 조건에 복사하는 것을 권장합니다.
커스텀 조건에는 서브쿼리 문을 입력할 수 없습니다
2.7 최종 확인
마지막으로 삭제하기 전에 삭제할 프로젝트 이름, 삭제할 이벤트 이름, 삭제 기간을 포함한 최종 확인을 진행합니다. 확인은 총 두 번 필요하며(두 번째에는 삭제 후 데이터를 복구할 수 없다는 점을 다시 알립니다), 두 번 모두 "y"를 입력해야 데이터 삭제가 시작됩니다. 잘못 입력했다면 "n"을 입력하여 도구를 종료한 후 다시 입력할 수 있습니다.
2.8 전체 데이터를 삭제하는 경우의 작업
전체 데이터 삭제를 선택하면 바로 삭제 전 확인을 진행합니다. 마찬가지로 두 번 확인해야 하며, 두 번 모두 "y"를 입력해야 데이터 삭제가 시작됩니다. 잘못 입력했다면 "n"을 입력하여 도구를 종료한 후 다시 입력할 수 있습니다.
3. 주의 사항
3.1 데이터 삭제 도구는 테이블의 데이터만 삭제하며, 다음 데이터는 삭제하지 않습니다
- 프로젝트 멤버 데이터
- 프로젝트 정보 데이터(프로젝트 ID 및 APPID)
- 사용한 이벤트 양
- 이벤트, 이벤트 속성, 유저 속성의 메타데이터
- 그리고 메타데이터 관리에서 설정한 표시 이름, 비고, 숨김 상태, 대시보드와 리포트 정보 등
위 데이터를 삭제해야 한다면 새 프로젝트를 만드는 것을 권장합니다.
3.2 데이터 삭제 중에는 삭제 기간에 새 데이터가 들어오지 않도록 하십시오
데이터 삭제 도구를 사용하기 전에 삭제 기간에 더 이상 새 데이터가 들어오지 않는지 확인하십시오(예를 들어 어제 데이터를 삭제한다면 삭제하는 동안 어제 데이터가 더 이상 들어와서는 안 됩니다). 그래야 데이터 삭제 효과를 보장할 수 있습니다. 데이터를 삭제하는 동안 삭제 기간의 데이터가 들어오면 데이터가 완전히 삭제되지 않을 수 있습니다.
3.3 데이터 삭제 실행 시 표시되는 메시지
백그라운드 데이터 동기화 작업이 끝난 후 삭제를 실행해야 합니다. 5 분 후 다시 시도합니다. 기다려 주십시오! 1회차
프로그램이 자동으로 실행할 때까지 기다리거나, 잠시 후 삭제 작업을 다시 시도하십시오.