# 메타데이터 관리 도구

# 1. 소개

메타데이터 관리 도구는 주로 TA 시스템에서 이벤트 속성 및 유저 속성을 수정하고 삭제하는 데 사용됩니다. 이 도구는 형식 가져오기 오류 및 데이터 예외가 확인된 경우에만 사용을 권장하며, 메타데이터 조정 중에는 데이터의 ETL 흐름이 중단되기 때문입니다. 잦은 작업은 권장되지 않습니다.

# 2. 사용 방법

메타데이터 관리 도구는 프라이빗 서비스 유저만 사용할 수 있습니다. root가 프라이빗 클러스터의 서버에 로그인하여 su - ta를 실행합니다. 그런 다음 ta-tool modify_meta를 실행하여 메타데이터 관리 도구 인터페이스에 들어갑니다.

# 2.1 처리할 항목의 appid 입력

먼저 수정할 프로젝트의 appid를 입력해야 합니다. TA 시스템의 "프로젝트 관리" 페이지에서 프로젝트의 appid를 확인할 수 있습니다.

# 2.2 프로젝트 이름 확인

appid를 입력한 후, 수정이 필요한 프로젝트의 이름이 표시됩니다. 'y'를 입력하여 확인하고, 'n'을 입력하여 작업을 취소합니다.

# 2.3 메타데이터 작업 유형 선택

다음으로, 수행해야 하는 작업 유형을 추가할 수 있습니다. 여기서는 작업을 반복적으로 추가할 수 있습니다. 작업 설정을 구성한 후 다른 작업을 추가할 수 있으며, "추가 완료"를 선택할 때까지 반복할 수 있습니다. 수정 또는 삭제 작업은 한 번에 완료하는 것을 권장합니다.

# 2.4 이벤트 속성 유형 수정

# 2.4.1 일반 이벤트 속성 수정

예: 이벤트 속성 argNum의 유형을 number에서 string으로 변경
- 작업 유형 선택: 1
- 이벤트 속성 이름 입력: argNum
- 수정 유형 입력: string

# 2.4.2 객체 및 객체 그룹 키의 하위 속성 수정

TIP

메타데이터 관리 도구에서 객체(그룹)의 키를 수정/삭제할 때는 "object.key" 표현식을 사용할 수 있습니다.

예: 객체(그룹) 속성 argrow의 키 channel_id의 유형을 number에서 string으로 변경
- 작업 유형 선택: 1
- 이벤트 속성 이름 입력: argrow.channel_id
- 수정 유형 입력: string

# 2.5 유저 속성 유형 수정

# 2.5.1 일반 유저 속성 수정

예: 유저 속성 user_argNum의 유형을 number에서 string으로 변경
- 작업 유형 선택: 2
- 유저 속성 이름 입력: user_argNum
- 수정 유형 입력: string

# 2.5.2 객체 및 객체 그룹의 하위 속성 수정

예: 객체(그룹) 속성 user_argrow의 키 channel_id의 유형을 number에서 string으로 변경
- 작업 유형 선택: 2
- 이벤트 속성 이름 입력: user_argrow.channel_id
- 수정 유형 입력: string

# 2.6 이벤트 속성 삭제

예: 일반 이벤트 속성 argbool과 객체(그룹) 속성 argrow의 키 level 삭제
- 작업 유형 선택: 3
- 이벤트 속성 이름 입력: argbool, argrow.level

# 2.7 유저 속성 삭제 작업

예: 일반 유저 속성 user_argbool과 객체(그룹) 속성 user_argrow의 키 level 삭제
- 작업 유형 선택: 4
- 유저 속성 이름 입력: user_argbool, user_argrow.level

# 2.8 수정 및 삭제 작업 추가 완료

모든 설정을 완료한 후, "5"를 입력하여 확인

# 2.9 작업 확인

실행 전에 최종 확인을 하며, 'y'를 입력하여 확인하고, 'n'을 입력하여 작업을 취소합니다.

# 2.10 관련 작업 수행

확인이 완료되면 관리 도구는 먼저 TA 시스템의 데이터 ETL 서비스를 일시 중단합니다. 그런 다음 이 설정의 모든 작업이 실행되며, 모든 작업이 완료된 후 데이터 ETL 서비스가 다시 시작됩니다. 이 기간 동안 보고된 데이터는 나중에 데이터베이스에 저장되지만 손실되지는 않습니다.