데이터 테이블

데이터 테이블은 데이터 접근 방법 중 하나로, SDK를 통한 데이터 전송도 가능합니다. 운영 멤버는 분석을 위해 자체 데이터를 데이터 테이블에 업로드할 수 있습니다.

현재 데이터 테이블은 이벤트 속성과 유저 속성의 참조 테이블로 사용될 수 있으며, 테이블 파일을 임포트함으로써 데이터 테이블을 업데이트할 수 있습니다.

데이터 테이블 생성

테이블 파일을 업로드해 새로운 데이터 테이블을 생성합니다 (csv 파일 저장 방법 참조). Excel 형식 파일은 100MB를 초과할 수 없으며, csv 형식 파일은 500MB를 초과할 수 없습니다. 데이터 파일이 상기 범위를 초과하는 경우, 증분 업데이트를 통해 여러 배치로 업로드할 수 있습니다.

새로 생성된 데이터 테이블의 열 이름은 업로드된 테이블 파일의 열 이름(첫 번째 행)과 일치하며, 사용자는 각 필드의 데이터 타입도 지정해야 합니다. 테이블의 메인 키 데이터 타입은 생성 후 변경할 수 없으니 주의하시기 바랍니다. 메인 키의 데이터 타입은 연결할 수 있는 속성의 범위에 영향을 줍니다. 자세한 내용은 다음 표를 참조하십시오.

속성 데이터 타입	참조 테이블 추가 설명
문자열, 값, 불리언	참조 테이블을 추가할 수 있습니다. 테이블의 메인 키 데이터 타입은 속성의 데이터 타입과 동일해야 합니다.
시간	참조 테이블을 추가할 수 있습니다. 테이블의 메인 키 데이터 타입은 문자열이어야 하며, 시간 형식을 지정해야 합니다.
리스트	참조 테이블을 추가할 수 있습니다. 테이블의 메인 키 데이터 타입은 문자열이어야 합니다.
객체 객체 그룹	참조 테이블의 속성은 추가할 수 없습니다. 객체의 서브 속성은 참조 테이블을 추가할 수 있습니다.

프리뷰에서 각 열의 데이터 분석이 정상인지 확인한 후, 오류 상세 정보를 다운로드하여 테이블에서 분석에 실패한 데이터 행을 얻을 수 있습니다.

테이블 파일 내의 데이터는 자동으로 새 테이블에 삽입됩니다. 파일 내 다른 행의 데이터의 첫 번째 열이 동일한 값인 경우, 중복을 제거한 후 데이터 테이블에 삽입됩니다. 중복 제거 방법은 동일한 값 중에서 행 번호가 가장 작은 데이터가 됩니다. (팁: 스키마에 의해 업로드된 테이블의 첫 번째 열은 기본적으로 메인 키이므로, 메인 키의 값을 반복할 수 없으며, 자동으로 중복이 제거됩니다)

데이터 업데이트

증분 업데이트는 비교적 가벼운 업데이트 방법입니다. 업데이트 시 소량의 변경된 데이터만 업로드하면 됩니다. 업로드된 데이터의 메인 키 필드 값이 데이터 테이블에 이미 존재하는 경우, 업데이트가 실행됩니다. 존재하지 않는 경우 새로운 데이터가 삽입됩니다. 이 업데이트 방법은 업로드된 테이블 파일에 표시되지 않는 메인 키 값의 데이터에는 영향을 주지 않습니다.

한 번의 업로드 파일 크기에는 제한이 있습니다 (Excel 형식 파일은 100MB를 초과할 수 없으며, csv 형식 파일은 500MB를 초과할 수 없습니다). 더 많은 데이터를 업데이트해야 하는 경우, 여러 번의 업로드를 통해 실현할 수 있습니다.

증분 업데이트의 테이블 구조는 현재 데이터 테이블과 완전히 일치해야 합니다 (열 이름과 열의 순서 포함).

변경되는 데이터의 범위가 크거나 일부 데이터를 삭제해야 하는 경우, 대체 업데이트를 사용하는 것이 좋습니다. 이 업데이트 방법은 먼저 원본 데이터 테이블의 데이터를 클리어한 후 테이블에 임포트된 모든 데이터를 테이블에 기록합니다. 테이블 파일의 요구 사항은 증분 업데이트의 요구 사항과 동일합니다.

데이터 테이블 API를 사용하여 데이터 테이블을 업데이트할 수도 있습니다. 사용자가 v3.8 이전에 생성된 참조 테이블을 사용하는 경우, 데이터는 참조 테이블 API를 통해 업데이트할 수 있습니다.

데이터 테이블 관리

데이터 테이블에서는 테이블 구조의 업데이트, 테이블의 삭제, 및 테이블과 데이터의 버전 복원 등의 관리 작업을 생성된 데이터에 대해 실행할 수 있습니다.

테이블 필드의 표시 이름을 조정해야 하는 경우, 증분 업데이트로 변경할 수 있습니다. 열을 추가하거나 삭제해야 하는 경우, 또는 열의 데이터 타입을 변경해야 하는 경우 (메인 키 필드는 데이터 타입 변경을 지원하지 않음), 대체 업데이트로 변경할 수 있습니다.

테이블 구조의 변경은 이 데이터 테이블을 사용하는 에셋에 영향을 미치므로, 활성화하기 위해선 공개해야 합니다. 리스트의 상태 열에서는 데이터 테이블에 공개되지 않은 업데이트가 있다는 것도 알려줍니다. 공개할 때는 테이블 구조와 관련된 영향을 확인해야 합니다.

데이터 테이블의 데이터나 구조가 변경된 후, 그것을 되돌려야 할 경우, 데이터 테이블의 버전 기록을 복원할 수 있습니다. 복원되는 내용에는 데이터 테이블 구조와 데이터 테이블 내의 데이터가 포함되지만, 데이터 테이블과 속성 간의 관계는 포함되지 않습니다.

데이터 테이블을 삭제하면 복원할 수 없습니다. 데이터 테이블을 참조 테이블로 추가한 경우, 데이터 테이블을 삭제하면 생성한 참조 테이블의 속성이 동기적으로 삭제됩니다.

데이터 테이블 API를 통해 데이터 테이블을 관리할 수도 있습니다.

데이터 테이블 사용

데이터 테이블에서는 하나 또는 여러 속성을 가진 참조 테이블로 직접 추가할 수 있습니다(자세한 내용은 데이터 테이블 관련 속성을 참조하십시오). 물론, 유저 속성과 이벤트 속성에 데이터 테이블을 참조 테이블로 추가하는 것도 가능합니다.

사용 권한

항목	내용	루트 게정	관리자	애널리스트	멤버
원본 데이터 조회	데이터 테이블 프리뷰, 속성 참조 테이블의 내보내기, 데이터 테이블의 내용 다운로드, 데이터 테이블의 히스토리 내용 다운로드	◎	◎	○	×
원본 데이터 편집	데이터 테이블의 새로운 추가, 데이터 테이블의 편집, 데이터 테이블의 히스토리 버전 복원	◎	◎	○	×

권한 설명:

◎ 부여됨

○ 기본적으로 부여되나 제외 가능

△ 기본적으로 부여되지 않으나 부여 가능

× 부여되지 않음