데이터 테이블

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

데이터 테이블은 시스템에서 제공하는 데이터 연동 방식 중 하나이며, 이 밖에 SDK 연동도 있습니다. 고객은 자체 데이터를 데이터 테이블로 가져와 분석에 사용할 수 있습니다.

현재 데이터 테이블은 이벤트 속성과 유저 속성의 차원 테이블로 사용할 수 있으며, 표 형식 파일을 가져오는 방식으로 데이터 테이블의 데이터를 업데이트할 수 있습니다.

1. 데이터 테이블 생성

데이터 테이블 생성을 클릭하면 파일 업로드와 SQL 동적 빌드 두 가지 방식 중 하나를 선택하여 데이터 테이블을 생성할 수 있습니다. 파일 업로드를 선택한 경우 표 형식 파일 하나를 가져오면 새 데이터 테이블을 생성할 수 있습니다(CSV 파일 저장 방법 참조). Excel 형식 파일은 100M, CSV 형식 파일은 500M를 초과할 수 없습니다. 데이터 파일이 이 범위를 초과하면 생성한 후 증분 업데이트로 여러 번에 나누어 가져올 수 있습니다.

새로 생성한 데이터 테이블의 열 이름은 업로드한 표 형식 파일의 열 이름(첫 행)과 같으며, 유저는 각 필드의 데이터 타입도 지정해야 합니다. 테이블 기본 키의 데이터 타입은 생성 후 변경할 수 없으며, 기본 키 데이터 타입에 따라 연결할 수 있는 속성 범위가 달라집니다. 자세한 내용은 아래 표를 참조하십시오.

속성 데이터 타입	차원 테이블 추가 설명
텍스트, 숫자, 불리언	차원 테이블을 추가할 수 있으며, 테이블 기본 키의 데이터 타입이 속성과 같아야 합니다.
시간	차원 테이블을 추가할 수 있으며, 테이블 기본 키의 데이터 타입은 텍스트여야 하고 지정한 시간 형식과 같아야 합니다.
리스트	차원 테이블을 추가할 수 있으며, 테이블 기본 키의 데이터 타입은 텍스트여야 합니다.
객체, 객체 그룹	차원 테이블 속성을 추가할 수 없습니다. 객체의 하위 속성에는 차원 테이블을 추가할 수 있습니다.

미리보기 화면에서 각 열의 데이터가 정상적으로 파싱되었는지 확인합니다. 파싱에 실패한 데이터 행은 오류 상세 정보를 다운로드하여 확인할 수 있습니다.

파일의 데이터는 새로 생성한 테이블에 자동으로 삽입됩니다. 파일에서 서로 다른 행의 첫 번째 열 값이 같으면 중복을 제거한 후 데이터 테이블에 삽입하며, 같은 값 중 행 번호가 가장 작은 데이터를 남깁니다. (Tips: Schema는 기본적으로 업로드한 테이블의 첫 번째 열을 기본 키로 사용하고 기본 키 값은 중복될 수 없으므로 자동으로 중복이 제거됩니다)

2. 데이터 업데이트

증분 업데이트는 비교적 가벼운 업데이트 방식으로, 업데이트할 때 변경된 소량의 데이터만 가져오면 됩니다. 가져온 데이터의 기본 키 필드 값이 데이터 테이블에 이미 있으면 업데이트하고, 없으면 새 데이터를 삽입합니다. 이 방식은 가져온 파일에 없는 기본 키 값의 데이터에는 영향을 주지 않습니다.

1회 업로드 파일 크기에 제한이 있으므로(Excel 형식 파일은 100M, CSV 형식 파일은 500M 이하), 많은 데이터를 업데이트하려면 여러 번에 나누어 가져오면 됩니다.

증분 업데이트에 업로드하는 표는 현재 데이터 테이블과 구조가 완전히 같아야 합니다(열 이름과 열 순서 모두 일치해야 함).

변경할 데이터 범위가 크거나 일부 데이터를 삭제해야 할 때는 대체 업데이트를 권장합니다. 이 방식은 기존 데이터 테이블의 데이터를 먼저 비운 다음, 이번에 가져온 표의 데이터를 전부 테이블에 씁니다. 파일 요구 사항은 증분 업데이트와 같습니다.

유저는 데이터 테이블 API 로 데이터 테이블을 업데이트할 수도 있습니다. v3.8 이전에 생성한 차원 테이블을 사용하는 경우 차원 테이블 API로 데이터를 업데이트할 수 있습니다.

3. 데이터 테이블 관리

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

테이블 필드의 표시 이름을 조정하려면 증분 업데이트 시 수정할 수 있습니다. 열을 추가하거나 삭제하거나 열의 데이터 타입을 변경하려면(기본 키 필드는 데이터 타입 변경 미지원) 대체 업데이트 시 수정할 수 있습니다.

테이블 구조 변경은 이 데이터 테이블을 사용하는 리소스에 영향을 주므로 게시해야 적용됩니다. 목록의 게시 상태 열에도 데이터 테이블에 게시되지 않은 업데이트가 있다고 표시됩니다. 게시할 때는 이번에 반영할 테이블 구조와 관련 영향을 확인해야 합니다.

데이터 테이블의 데이터나 구조를 변경한 후 되돌려야 하면 데이터 테이블 버전 기록에서 복원할 수 있습니다. 복원 내용에는 데이터 테이블 구조와 데이터 테이블 내 데이터가 포함되지만, 데이터 테이블과 속성의 연결 관계는 포함되지 않습니다.

데이터 테이블은 삭제하면 복구할 수 없습니다. 데이터 테이블이 차원 테이블로 추가되어 있으면 데이터 테이블을 삭제할 때 이를 통해 생성된 차원 테이블 속성도 함께 삭제됩니다.

유저는 데이터 테이블 API 로 데이터 테이블을 관리할 수도 있습니다.

4. 데이터 테이블 사용

데이터 테이블 화면에서 데이터 테이블을 하나 이상의 속성의 차원 테이블로 바로 추가할 수 있습니다. 자세한 내용은 데이터 테이블 속성 연결을 참조하십시오. 물론 유저 속성과 이벤트 속성 화면에서도 데이터 테이블을 차원 테이블로 추가할 수 있습니다.

5. 기능 권한

기능별 역할 권한은 다음과 같습니다.

기능	사용 권한	기능 상세
메타데이터 관리	보기	이벤트, 이벤트 속성, 유저 속성 목록 보기, 데이터 테이블 미리보기
메타데이터 관리	보기	속성의 차원 테이블 내보내기, 데이터 테이블 내용 다운로드, 데이터 테이블 과거 내용 다운로드
메타데이터 관리	편집	파일 업로드 방식 데이터 테이블 추가·편집, 파일 업로드 방식 데이터 테이블의 과거 버전 복원
메타데이터 관리	편집	SQL 문으로 생성하는 데이터 테이블 추가·편집