본문으로 건너뛰기

크로스 소스 설정 일괄 업로드

최근 업데이트 2026. 10. 03.
노트

설정 업로드 기능을 사용하면 EXCEL에서 설정의 필드와 리소스 정보를 빠르게 편집하여 크로스 소스 설정을 한 번에 일괄 생성할 수 있습니다

작업할 때는 먼저 페이지 생성 절차로 크로스 소스 설정을 1개 만든 다음, 이를 내보내 EXCEL에서 복사하고 수정할 수 있습니다

1. 일괄 업로드 절차​

EXCEL 설정 업로드 설명


2. EXCEL 템플릿​

📎 跨源资产映射模板_空白.xlsx(69 KB) 📎 跨源资产映射模板_含样例.xlsx(83 KB)

3. 시트 설명​

EXCEL에서 크로스 소스 리소스 설정을 편집할 때는 다음 시트가 있습니다

  • 크로스 소스 리소스 설정 목록
  • 태그 테이블 상세 설정
  • 이벤트 속성 상세 설정
  • 이벤트 이름 상세 설정
  • 이벤트 및 이벤트 속성 관계 설정
  • 엔티티 테이블 상세 설정
  • 차원 테이블 상세 설정
  • 열거형 값 설정

크로스 소스 리소스 설정 EXCEL 시트 미리보기

각 시트의 용도는 다음과 같습니다

시트 이름타입사용 시나리오
크로스 소스 리소스 설정 목록공통각 행이 하나의 크로스 소스 리소스 설정에 해당하며, 설정의 데이터 소스, 리소스 타입, 설정 필드 등의 정보를 선언해야 함
태그 테이블 상세 설정태그 테이블크로스 소스 태그 테이블의 리소스 목록. 원본 리소스 이름, 값 가져오기 방식, 출력 리소스 이름 등의 정보 포함
이벤트 속성 상세 설정이벤트 테이블크로스 소스 이벤트 테이블의 이벤트 속성 리소스 목록. 원본 리소스 이름, 값 가져오기 방식, 출력 리소스 이름 등의 정보 포함
이벤트 이름 상세 설정이벤트 테이블크로스 소스 이벤트 테이블의 이벤트 리소스 목록. 출력 이벤트 이름, 원본 이벤트 목록 등의 정보 포함
이벤트 및 이벤트 속성 관계 설정이벤트 테이블크로스 소스 이벤트 테이블의 이벤트 속성과 이벤트의 매핑 관계
엔티티 테이블 상세 설정엔티티 테이블크로스 소스 엔티티 테이블의 리소스 목록. 원본 리소스 이름, 값 가져오기 방식, 출력 리소스 이름 등의 정보 포함
차원 테이블 상세 설정차원 테이블크로스 소스 차원 테이블의 리소스 목록. 원본 리소스 이름, 값 가져오기 방식, 출력 리소스 이름 등의 정보 포함
열거형 값 설정공통태그, 이벤트 속성, 엔티티 속성, 차원 속성의 열거형 값 설정

⚠ 실제 사용 시에는 필요에 따라 해당 시트만 입력하면 됩니다. 예:

  • 크로스 소스 태그 테이블을 설정할 때 입력: <크로스 소스 리소스 설정 목록>, <태그 테이블 상세 설정>
  • 크로스 소스 이벤트 테이블을 설정할 때 입력: <크로스 소스 리소스 설정 목록>, <이벤트 속성 상세 설정>, <이벤트 이름 상세 설정>, <이벤트 및 이벤트 속성 관계 설정>
  • 일부 리소스에 열거형 값을 설정해야 할 때는 위 내용에 더해 <열거형 값 설정>도 입력합니다

4. 크로스 소스 리소스 설정_공통 필드 설명​

크로스 소스 리소스 설정 이름크로스 소스 리소스 설정 표시 이름설정 안내리소스 타입데이터 소스 선택Wide/Long 테이블 타입설정 상세상태
route_tag_all_key★★태그 테이블 전체 필드 템플릿★★

설정 상세에 모든 설정 필드와 설명을 표시

★★★★★★★★★★

태그 테이블hive.ws_test.welletltziWide 테이블

주체 열: efsad_col_1

분석 주체: 유저

---업로드 전에 이 줄 삭제---

태그 이름 열: tag_name

태그 값 열: tag_value

---업로드 전에 이 줄 삭제---

태그 날짜 버전:과거 버전만/최신 버전만/과거 및 최신 버전

날짜 정보 열:col_FOULK

날짜 정보 형식:yyyyMMdd

헤더 필드 미리보기

각 필드 설명은 다음과 같습니다

필드 이름설명
크로스 소스 리소스 설정 이름현재 설정의 이름. 영문 소문자로 시작해야 하며 숫자, 영문 소문자, 밑줄을 포함할 수 있음. 길이 제한 80자
크로스 소스 리소스 설정 표시 이름현재 설정의 표시 이름. 길이 제한 80자
설정 안내현재 설정의 비고 설명. 길이 제한 200자
리소스 타입태그 테이블, 이벤트 테이블, 엔티티 테이블, 차원 테이블로 설정 가능
데이터 소스 선택데이터 소스 이름. 전체 이름을 입력해야 함. 예: hive.ws_test.tbl_name
Wide/Long 테이블 타입Wide 테이블 또는 Long 테이블. 태그 테이블 리소스만 Long 테이블로 설정 가능
설정 상세리소스에 따라 "이름: 값" 형식으로 필드 설정 정보를 입력. 자세한 내용은 아래 "리소스별 특수 필드 설명" 장 참조
상태크로스 소스 설정의 유효성 검사 상태. 다운로드 시 시스템이 자동으로 채우므로 입력할 필요 없음

5. 리소스 목록_공통 필드 설명​

첫 번째 시트에서 설정을 선언한 후, 해당 타입의 리소스 상세 설정에서 이 설정에 속한 리소스 목록을 설정해야 합니다

예: 첫 번째 시트에서 이름이 route_config_01인 크로스 소스 태그 테이블 설정을 선언했다면, <태그 테이블 상세 설정>에서 설정해야 하는 태그 목록의 예시는 다음과 같습니다

크로스 소스 리소스 설정 이름원본 태그 이름원본 태그 타입출력 태그 이름출력 태그 표시 이름값 가져오기 방식출력 태그 타입확장 정보열거형 값 로직상태
route_config_01tag_01숫자tag_01태그_01숫자업데이트 방식:수동 업로드
route_config_01tag_02시간tag_02태그_02시간

값 시간대:8

비고:시간 타입 태그의 확장 필드 "값 시간대"

업데이트 방식:수동 업로드
route_config_01tag_03텍스트tag_03태그_03텍스트비고:추가 설명 내용업데이트 방식:수동 업로드
route_config_01tag_04리스트tag_04태그_04리스트업데이트 방식:수동 업로드
route_config_01tag_05리스트tag_05태그_05리스트비고:추가 설명 내용업데이트 방식:수동 업로드

태그 리소스 목록_미리보기

리소스 타입마다 헤더 필드가 조금씩 다르므로, 아래에서는 {리소스}로 통일하여 표기합니다

모든 리소스에 공통으로 입력해야 하는 필드는 다음과 같습니다. 그 밖의 특수 필드와 설정 로직은 "리소스별 특수 필드 설명" 장을 참조하십시오

필드 이름설명
크로스 소스 리소스 설정 이름현재 리소스 정보에 해당하는 크로스 소스 설정 이름. <크로스 소스 리소스 설정 목록>에 입력되어 있어야 함
원본 {리소스} 이름일반적으로 데이터 소스의 열 이름(Wide 테이블) 또는 데이터 행 값(Long 테이블)을 입력
원본 {리소스} 타입다운로드 시 시스템이 자동으로 채우므로 입력할 필요 없음
출력 {리소스} 이름해당 리소스의 이름을 설정. 해당 리소스의 규칙을 따라야 함
출력 {리소스} 표시 이름해당 리소스의 표시 이름을 설정. 해당 리소스의 규칙을 따라야 함
값 가져오기 방식값에 특수 처리가 필요할 때 SQL 함수를 입력할 수 있으며, 입력하면 원본 리소스 이름은 무시됨
출력 {리소스} 타입해당 리소스의 데이터 타입을 설정. 값 가져오기 방식이 있으면 처리 후의 데이터 타입을 입력해야 함
확장 정보리소스의 기타 설정 정보. 일반적으로 비고이며, 시나리오에 따라 다른 설정 필드가 있을 수 있음
열거형 값 로직숫자, 텍스트, 리스트 타입의 리소스만 열거형 값 설정을 지원하며, 현재는 "업데이트 방식: 수동 업로드"로만 설정 가능
상태다운로드 시 시스템이 자동으로 채우므로 입력할 필요 없음

6. 리소스별 특수 필드 설명​

리소스마다 설정 정보에 연쇄 의존 관계가 있을 수 있으므로, 해당 리소스의 <설정 설명> 매뉴얼 내용을 참조할 수 있습니다

EXCEL에도 관련 의존 관계와 유효성 검사 로직이 있으며, 이를 바탕으로 일괄 편집 및 업로드 기능을 제공합니다

6.1 크로스 소스 태그 테이블​

🔵 설정 상세

이 섹션의 정보는 <크로스 소스 리소스 설정 목록> 시트의 설정 상세 열에 입력합니다

여러 필드는 "이름: 값" 형식으로 줄 바꿈하여 구분하고 해당 셀에 입력합니다

리소스 타입설정 상세
태그 테이블

주체 열: efsad_col_1

분석 주체: 유저

---업로드 전에 이 줄 삭제---

태그 이름 열: tag_name

태그 값 열: tag_value

---업로드 전에 이 줄 삭제---

태그 날짜 버전:과거 버전만/최신 버전만/과거 및 최신 버전

날짜 정보 열:col_FOULK

날짜 정보 형식:yyyyMMdd

크로스 소스 태그 테이블_설정 상세 미리보기

필드 이름필드 분류필수 여부로직 설명예시 값
주체 열주체 정보필수데이터 소스에서 태그 주체 정보를 기록한 열user_name
분석 주체주체 정보필수프로젝트에서 데이터 소스에 대응하는 분석 주체플레이어
태그 이름 열값 정보Long 테이블인 경우에만 입력Long 테이블에서 태그 이름을 기록한 열tag_name
태그 값 열값 정보Long 테이블인 경우에만 입력Long 테이블에서 대부분의 태그 값을 기록한 열tag_value
태그 날짜 버전날짜 버전 정보필수태그 데이터에 날짜 정보가 포함되는지 여부와 기록 방식과거 버전만, 최신 버전만, 과거 및 최신 버전
날짜 정보 열날짜 버전 정보태그 날짜 버전이 최신 버전만이 아닐 때 입력데이터 소스에서 태그 값의 날짜 정보를 기록한 열tag_date
날짜 정보 형식날짜 버전 정보태그 날짜 버전이 최신 버전만이 아닐 때 입력데이터 소스에서 태그 값의 날짜 정보를 기록한 형식yyyyMMdd

🔵 리소스 이름 및 데이터 타입

크로스 소스 태그의 출력 리소스는 다음 데이터 타입을 지원합니다:

텍스트, 숫자, 불리언, 시간, 리스트

속성 이름은 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 포함할 수 있고 길이는 80자를 초과할 수 없습니다

값 가져오기 방식의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시

🔵 태그의 확장 정보

크로스 소스 태그에는 태그 값에 해당하는 시간대를 표시하는 값 시간대 필드를 설정해야 하며, 기본값은 현지 시간(99)입니다

분석, 운영 패키지의 일부 기능에서는 시간대 설정이 같은 태그만 사용할 수 있습니다

출력 태그 타입확장 정보
불리언값 시간대: 99
숫자값 시간대: 99
숫자

비고:추가 설명 내용

값 시간대: 99

크로스 소스 태그_확장 정보 미리보기

6.2 크로스 소스 차원 테이블​

🔵 설정 상세

이 섹션의 정보는 <크로스 소스 리소스 설정 목록> 시트의 설정 상세 열에 입력합니다

여러 필드는 "이름: 값" 형식으로 줄 바꿈하여 구분하고 해당 셀에 입력합니다

리소스 타입설정 상세
차원 테이블

주체 속성 테이블 타입: 이벤트 속성

주체 속성: item_id

주체 열: item_id

---업로드 전에 이 줄 삭제---

시간 단위: 시간

크로스 소스 차원 테이블_설정 상세 미리보기

필드 이름필드 분류필수 여부로직 설명예시 값
주체 속성 테이블 타입주체 정보필수차원 정보를 연관해야 하는 주체 속성이 이벤트 속성인지 유저 속성인지이벤트 속성
주체 속성주체 정보필수차원 정보를 연관해야 하는 주체 속성 이름item_id
주체 열주체 정보필수데이터 소스에서 주체 속성과 연관할 데이터 열 이름item_id
시간 단위특수 매칭 로직주체 속성이 시간 타입일 때만 입력주체 속성이 "시간"이면 연관할 때 잘라낼 시간 단위월

⚠ 주체 속성의 데이터 타입이 "시간"이면 설정 상세에 시간 단위를 입력해야 하며, 동시에 주체 열의 타입은 반드시 "텍스트"이고 내용 형식은 yyyy-MM-dd HH:mm:ss여야 합니다

사용 시나리오: 주체 속성이 "가입 시간"이고 비즈니스상 특정 월에 신규 유저 유치 캠페인이 있으며, 데이터 소스 A의 첫 번째 열에 신규 유저 유치 캠페인의 월(예: 2025-01-01)이 기록되어 있는 경우, 주체 속성의 시간 단위도 월로 설정하고 데이터 소스 A의 첫 번째 열과 연관해야 합니다

🔵 리소스 이름 및 데이터 타입

크로스 소스 차원 속성의 출력 리소스는 다음 데이터 타입을 지원합니다:

텍스트, 숫자, 불리언, 시간

속성 이름은 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 포함할 수 있고 길이는 80자를 초과할 수 없습니다

값 가져오기 방식의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시

6.3 크로스 소스 엔티티 테이블​

경고

현재 버전의 크로스 소스 엔티티 테이블은 전송된 유저 속성을 대체하는 데 사용되며, 다른 기능에 영향을 주지 않도록 다음 정보는 운영 관리 명령으로 설정해야 합니다

데이터 소스 이름, 주체 열

EXCEL에서 설정할 때 주의할 사항

  • 단일 프로젝트에는 엔티티 테이블 크로스 소스 설정이 1개만 존재할 수 있습니다
  • 크로스 소스 리소스 설정 이름에는 고정값 user_entity_route를 입력해야 합니다
  • 데이터 소스 선택에는 hive.ws_product.entity를 입력해야 합니다
  • 설정 상세에는 key: value 형식으로 입력해야 합니다

🔵 설정 상세

이 섹션의 정보는 <크로스 소스 리소스 설정 목록> 시트의 설정 상세 열에 입력합니다

여러 필드는 "이름: 값" 형식으로 줄 바꿈하여 구분하고 해당 셀에 입력합니다

리소스 타입설정 상세
엔티티 테이블

주체 열: (운영 관리 명령으로 설정 필요) 여기에는 자리 표시자를 남겨 둠

---업로드 전에 이 줄 삭제---

데이터 업데이트 시간 열: update_time_pix

크로스 소스 엔티티 테이블_설정 상세 미리보기

필드 이름필드 분류필수 여부로직 설명예시 값
주체 열주체 정보필수데이터 소스에서 유저 식별 정보를 기록한 열. 유저 드릴다운 기능에 영향user_id
데이터 업데이트 시간 열데이터 시효 정보비필수데이터 소스에서 데이터 업데이트 시간을 기록한 열. 스마트 운영 패키지에 사용update_time

🔵 리소스 이름 및 데이터 타입

크로스 소스 차원 속성의 출력 리소스는 다음 데이터 타입을 지원합니다:

텍스트, 숫자, 불리언, 시간, 리스트, 객체, 객체 그룹

속성 이름은 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 포함할 수 있고 길이는 80자를 초과할 수 없습니다

객체 그룹의 하위 속성은 상위 속성 이름과 하위 속성 이름을 영문 마침표로 구분합니다

값 가져오기 방식의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시

6.4 크로스 소스 이벤트 테이블​

🔵 설정 상세

이 섹션의 정보는 <크로스 소스 리소스 설정 목록> 시트의 설정 상세 열에 입력합니다

여러 필드는 "이름: 값" 형식으로 줄 바꿈하여 구분하고 해당 셀에 입력합니다

리소스 타입설정 상세
이벤트 테이블

주체 열: 유저 id를 나타내는 열 이름(선택 입력, 유저 데이터 드릴다운에 영향)

---업로드 전에 이 줄 삭제---

이벤트명 값 가져오기 방식: 열 값 읽기/고정값

이벤트 이름: 이벤트 이름이 고정값일 때 입력

이벤트 이름 열: 이벤트 이름이 있는 열 이름

---업로드 전에 이 줄 삭제---

이벤트 시간 값 가져오기 방식: 열 값 읽기/커스텀 SQL

이벤트 시간 열: 이벤트 시간이 있는 열 이름

이벤트 시간 로직: 커스텀 SQL일 때 입력

---업로드 전에 이 줄 삭제---

이벤트 시간대 값 가져오기 방식: 열 값 읽기/고정값/커스텀 SQL

이벤트 시간대: 시간대가 고정값일 때 입력

이벤트 시간대 열: 이벤트 시간대가 있는 열 이름

이벤트 시간대 로직: 커스텀 SQL일 때 입력

---업로드 전에 이 줄 삭제---

데이터 파티션 방식: 단일 열 날짜 파티션/커스텀 푸시다운 로직

날짜 정보 열: 날짜 파티션이 있는 열 이름

날짜 정보 형식: yyyy-MM-dd/yyyymmdd

푸시다운 로직: 커스텀 푸시다운 로직의 SQL

크로스 소스 이벤트 테이블_설정 상세 미리보기

필드 이름필드 분류필수 여부로직 설명예시 값
주체 열주체 정보선택 사항유저 id를 나타내는 열 이름. 유저 데이터 드릴다운에 영향user_id
이벤트명 값 가져오기 방식이벤트 이름 정보필수열 값 읽기/고정값열 값 읽기
이벤트 이름이벤트 이름 정보이벤트명 값 가져오기 방식=고정값일 때 입력이벤트 이름이 고정값일 때 입력user_login
이벤트 이름 열이벤트 이름 정보이벤트명 값 가져오기 방식=열 값 읽기일 때 입력이벤트 이름이 있는 열 이름event_name
이벤트 시간 값 가져오기 방식이벤트 시간 정보필수열 값 읽기/커스텀 SQL열 값 읽기
이벤트 시간 열이벤트 시간 정보이벤트 시간 값 가져오기 방식=열 값 읽기일 때 입력이벤트 시간이 있는 열 이름event_time
이벤트 시간 로직이벤트 시간 정보이벤트 시간 값 가져오기 방식=커스텀 SQL일 때 입력커스텀 SQL일 때 입력try_cast( ts as timestamp )
이벤트 시간대 값 가져오기 방식이벤트 시간대 정보필수열 값 읽기/고정값/커스텀 SQL열 값 읽기
이벤트 시간대이벤트 시간대 정보이벤트 시간대 값 가져오기 방식=고정값일 때 입력시간대가 고정값일 때 입력8
이벤트 시간대 열이벤트 시간대 정보이벤트 시간대 값 가져오기 방식=열 값 읽기일 때 입력이벤트 시간대가 있는 열 이름tz
이벤트 시간대 로직이벤트 시간대 정보이벤트 시간대 값 가져오기 방식=커스텀 SQL일 때 입력커스텀 SQL일 때 입력try_cast( tz as double )
데이터 파티션 방식데이터 파티션 정보필수단일 열 날짜 파티션/커스텀 푸시다운 로직단일 열 날짜 파티션
날짜 정보 열데이터 파티션 정보데이터 파티션 방식=단일 열 날짜 파티션일 때 입력날짜 파티션이 있는 열 이름pt
날짜 정보 형식데이터 파티션 정보데이터 파티션 방식=단일 열 날짜 파티션일 때 입력yyyy-MM-dd/yyyymmddyyyy-MM-dd
푸시다운 로직데이터 파티션 정보데이터 파티션 방식=커스텀 푸시다운 로직일 때 입력커스텀 푸시다운 로직의 SQL

커스텀 푸시다운 로직에 대한 자세한 설명은 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시

🔵 크로스 소스 이벤트 테이블에서 설정해야 하는 리소스

크로스 소스 이벤트 테이블을 설정할 때는 다음 세 가지 리소스를 설정해야 합니다:

  • 이벤트 속성 상세 설정
  • 이벤트 이름 상세 설정
  • 이벤트 및 이벤트 속성 관계 설정

🔵 이벤트 속성 이름 및 데이터 타입

크로스 소스 이벤트 속성의 출력 리소스는 다음 데이터 타입을 지원합니다:

텍스트, 숫자, 불리언, 시간, 리스트, 객체, 객체 그룹

속성 이름은 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 포함할 수 있고 길이는 80자를 초과할 수 없습니다

객체 그룹의 하위 속성은 상위 속성 이름과 하위 속성 이름을 영문 마침표로 구분합니다

값 가져오기 방식의 복잡한 시나리오는 다음을 참조하십시오: 크로스 소스 설정 복잡한 시나리오 및 SQL 예시

🔵 이벤트 이름 상세 설정

크로스 소스 리소스 설정 이름출력 이벤트 이름원본 이벤트 목록출력 이벤트 표시 이름확장 정보상태
route_event_configdevice_first기기 활성화
route_event_configlogin('login1', 'login2','login3')로그인비고: 3개 버전의 이름 변경 통합
route_event_configlevel_up('lv_u')레벨 업

이벤트 이름 상세 설정 미리보기

첫 번째 열에는 해당 크로스 소스 설정 이름을 입력하며, 출력 이벤트 이름, 원본 이벤트 목록 등의 정보는 필요한 시나리오에 따라 입력할 수 있습니다

이벤트 이름은 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 포함할 수 있고 길이는 60자를 초과할 수 없습니다

시나리오 A: 이벤트 이름 열의 값을 그대로 출력 이벤트 이름으로 사용

  • 출력 이벤트 이름에 원본 값을 입력하면 됩니다

시나리오 B: 여러 원본 이벤트를 하나의 출력 이벤트로 합치기

  • 예: 같은 의미의 이벤트가 트래킹 버전 변경으로 인해 여러 원본 이벤트 이름을 가지는 경우
  • 출력 이벤트 이름에 원하는 이벤트 이름을 입력합니다
  • 원본 이벤트 목록에 합칠 원본 이벤트 목록을 영문 괄호, 작은따옴표, 쉼표로 입력합니다. 예: ( 'login1', 'login2' )

시나리오 C: 원본 이벤트의 이름 변경

  • 위의 시나리오 B와 같은 방법으로, 출력 이벤트 이름을 입력한 후 원본 이벤트 목록에 이벤트 이름 1개만 입력하면 됩니다. 예: ( 'login_old' )

🔵 이벤트 및 이벤트 속성 관계 설정

크로스 소스 리소스 설정 이름이벤트 이름이벤트 속성 이름
route_event_configdevice_firstchannel
route_event_configloginchannel
route_event_configlevel_upchannel
route_event_configlevel_uplevel_after
route_event_configlevel_upmap_id

이벤트 및 이벤트 속성 관계 설정 미리보기

첫 번째 열에는 해당 크로스 소스 설정 이름을 입력합니다

두 번째 열과 세 번째 열에는 연관된 이벤트 이름과 속성 이름을 각각 입력하며, 이벤트가 여러 속성과 연관되어 있으면 여러 행으로 입력합니다(예: level_up)

이 문서가 도움이 되었나요?