크로스 소스 리소스 설정
이 기능은 부가 기능입니다. 사용 중인 시스템 버전에서 해당 부가 서비스가 활성화되어 있는지 확인하십시오.
1. 기능 소개
크로스 소스 리소스 설정: 크로스 소스 데이터 소스를 데이터 리소스로 변환
크로스 소스 리소스 설정 기능은 일련의 설정 정보를 통해 AE 네이티브가 아닌 데이터를 읽어 AE 내 데이터 리소스로 변환합니다
예: 태그, 이벤트 및 이벤트 속성, 엔티티 속성 등
AE 네이티브가 아닌 데이터에는 직접 연결 기능으로 연결한 외부 데이터 테이블, 데이터 연동 기능으로 생성한 데이터 테이블, 작업 플로우 기능으로 생성한 데이터 테이블이 포함됩니다
| 리소스 타입 | 사용 시나리오 | 리소스 다운스트림 관리 |
|---|---|---|
| 태그 테이블 | Wide 테이블, Long 테이블 타입의 외부 데이터 구조를 AE의 크로스 소스 태그로 변환 | <유저 태그> 페이지에서 확인 |
| 이벤트 테이블 | 이벤트 정보를 기록한 Wide 테이블을 AE의 이벤트 및 이벤트 속성으로 변환 | <이벤트> <이벤트 속성>의 소스 리소스 관리에서 확인 |
| 엔티티 테이블 | 유저 정보를 기록한 Wide 테이블을 AE의 엔티티 속성(유저 속성)으로 변환 | <유저 속성>의 소스 리소스 관리에서 확인 |
| 차원 테이블 | 차원 관계 정보 Wide 테이블을 특정 속성의 차원 속성으로 변환 | <이벤트 속성> 또는 <유저 속성> 페이지에서 확인 |
2. 목록 페이지 설명
관리 페이지 설명
각 필드 설명은 다음과 같습니다
| 필드 이름 | 설명 |
|---|---|
| 설정 이름 | 크로스 소스 설정의 이름입니다. 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 사용할 수 있습니다
|
| 설정 표시명 | 중국어와 영어 지원, 길이 80자 미만 |
| 설정 안내 | 중국어와 영어 지원, 길이 200자 미만 |
| 유효성 검사 상태 |
|
| 리소스 타입 | 지원: 이벤트 테이블, 태그 테이블, 엔티티 테이블, 차원 테이블
|
| 데이터 소스 | 데이터 개발 플랫폼의 데이터 소스 이름. 데이터 카탈로그.스키마.테이블 이름 형식으로 전체를 입력해야 함 |
| 데이터 소스 설명 | 데이터 개발 플랫폼에서 읽어 온 데이터 소스 설명 |
| Wide/Long 테이블 타입 | 데이터 소스를 해석하는 로직. 열거형 값은
|
| 설정 상세 | 리소스를 해석할 때의 핵심 설정 정보 |
| 생성 시간 | 크로스 소스 설정을 생성한 시각 |
| 작업 |
|
- 일괄 업로드 기능을 사용하면 Excel에서 설정 정보를 편집한 후 여러 크로스 소스 설정을 한 번에 생성할 수 있습니다. 자세한 내용은 크로스 소스 설정 일괄 업로드를 참조하십시오.
3. 페이지 생성 절차 설명
목록 페이지 오른쪽 상단의 [생성] 버튼을 클릭하면 크로스 소스 설정의 페이지 생성 절차로 들어갑니다. 이때 생성할 크로스 소스 리소스 타입을 선택해야 합니다
크로스 소스 리소스 타입 선택
페이지 생성 절차는 데이터 소스 구성, 크로스 소스 설정, 기본 정보의 세 단계로 구성됩니다
3.1 데이터 소스 구성
크로스 소스 설정 절차 1
3.1.1 데이터 소스 선택
<데이터 개발 플랫폼>에서 현재 프로젝트에 사용 권한을 부여한 데이터 소스를 선택해야 합니다
데이터 소스 목록이 비어 있거나 필요한 데이터 소스를 찾을 수 없는 경우, 데이터 개발 담당자에게 해당 데이터 소스가 현재 프로젝트에 권한 부여되었는지 확인을 요청하십시오
초기 상태
데이터 소스 목록
데이터 소스를 선택한 후 [미리보기] 버튼을 클릭하면 데이터 소스의 개요 정보를 확인할 수 있습니다
포함 항목: 데이터 미리보기, 테이블 구조 미리보기, SQL 문
3.1.2 데이터 미리보기
시스템이 데이터 소스에서 예시 데이터 30건을 무작위로 조회하여 표시하므로, 값의 내용과 형식을 확인할 수 있습니다
예: 이름 데이터의 텍스트 형식, 시간 데이터의 정밀도
데이터 미리보기
3.1.3 테이블 구조 미리보기
데이터 소스의 모든 열 정보(이름, 데이터 타입, 비고)를 표시하므로, 데이터 값의 타입 변환이 필요한지 확인할 수 있습니다
예: "88"(텍스트)은 수학 연산을 할 수 없으므로 try_cast() 메서드로 88.0(숫자)으로 변환해야 합니다
테이블 구조 미리보기
3.1.4 SQL 문
데이터 소스를 조회하는 SQL 문을 표시하므로, SQL IDE 기능에 바로 복사하여 사용할 수 있습니다
예: where 조건을 추가하여 이상 데이터를 걸러 내거나, 값을 처리하는 SQL 함수를 테스트
SQL 문 미리보기
3.2 크로스 소스 설정
크로스 소스 설정 절차 2
이 단계에서는 두 가지 정보를 설정해야 합니다:
- 데이터 소스 내 핵심 필드의 해석 방식
- 출력할 크로스 소스 리소스 목록
크로스 소스 필드 및 리소스 목록 미리보기
3.2.1 설정 필드
해석 로직이 다르기 때문에 리소스 타입마다 고유한 설정 필드와 로직이 있으며, 아래 문서에서 각각 설명합니다:
3.2.2 리소스 목록
리소스 목록 기능은 데이터 소스를 읽은 후 그에 대응하는 리소스를 생성하는 데 사용합니다
예: 태그 타입의 데이터 소스를 읽은 후 여러 태그를 생성하며, 각 태그마다 이름, 값 가져오기 방식, 출력 타입, 비고, 열거형 값 등의 정보를 설정해야 합니다
⚠ 리소스 타입에 따라 설정 시 추가 필드가 있을 수 있습니다. 여기서는 공통 기능만 설명하며, 추가 부분은 각 타입의 문서에서 시나리오별로 따로 설명합니다
리소스 목록 미리보기
a.리소스 추가
시스템은 두 가지 리소스 추가 방식을 제공합니다
🟦 리소스 스캔
- 설정 필드 정보를 입력하면 시스템이 해당 리소스 로직에 따라 데이터 소스를 스캔하여 초기 리소스 목록을 생성하므로, 사용자는 이를 바탕으로 삭제하거나 수정할 수 있습니다
- 스캔 후 원본 리소스 타입은 데이터 소스의 타입을 기준으로 하며, AE 시스템에서 허용하는 타입으로 필터링됩니다. 지원하지 않는 타입의 경우 데이터 소스의 하위 타입 이름(예: object, binary)이 표시됩니다
🟦 개별 추가
- 클릭하면 리소스 목록의 첫 행에 빈 레코드가 하나 추가되며, 사용자가 리소스 정보를 직접 입력할 수 있습니다
- 수동으로 추가한 경우 원본 리소스 타입은 기본적으로 비어 있으며, 유효성 검사 후 자동으로 업데이트됩니다
b.수량 개요 및 오류 표시
- 기능 영역 오른쪽 상단에 전체 데이터, 오류 데이터 정보가 표시되므로, 사용자는 현재 리소스 목록의 개요를 파악할 수 있습니다
- 오류 데이터만 표시를 선택하면 시스템이 목록에서 입력 오류가 있는 항목만 필터링하여 표시합니다
⚠ 오류 검사 범위는 현재 설정에 한정됩니다. 여기에 입력한 리소스가 프로젝트 내 다른 리소스와 충돌하는 경우, 오류 상세 정보는 제출 시 검사되어 안내됩니다
오류 리소스 표시 미리보기
c.목록 필드 및 기능
리소스 타입에 따라 목록 필드의 이름이 태그, 속성 등일 수 있으며, 설명의 편의를 위해 아래에서는 리소스로 통칭합니다
각 설정마다 크로스 소스 리소스가 하나씩 출력되며, 설정 정보는 입력, 처리, 출력의 세 가지 내용으로 구성됩니다
🔵 원본 리소스 이름
크로스 소스 리소스에 대응하는 원본 입력 리소스
예: Wide 테이블 구조의 태그에서는 열 하나가 태그 하나에 대응하므로, 여기에는 원본 열 이름을 입력해야 합니다
🔵 원본 리소스 타입
리소스를 스캔하거나 유효성 검사를 한 후, 시스템이 데이터 소스 원본 열의 데이터 타입(예: 텍스트, 숫자, 시간)을 자동으로 읽어 표시합니다
⚠ 지원하지 않는 타입의 경우 데이터 소스의 하위 타입 이름(예: object, binary)이 표시되며, 이때는 값 가져오기 방식으로 처리해야 합니다
🔵 출력 리소스 이름 & 출력 리소스 표시 이름
시스템이 생성하는 크로스 소스 리소스의 이름과 표시 이름으로, 해당 리소스 타입의 이름 요건을 충족해야 합니다
예: 태그 이름은 80자 이하, 이벤트 이름은 60자 이하
🔵 값 가져오기 방식
입력하지 않으면 시스템이 원본 리소스 이름에 따라 값을 그대로 읽습니다
값을 처리해야 할 때는 SQL 함수를 입력하고 데이터 소스의 열 이름과 결합하여 처리할 수 있습니다
예: try_cast( pay_amount as double ) 함수를 사용하여 데이터 소스의 pay_amount 열을 읽고 숫자 타입으로 변환
⚠ 값 가져오기 방식을 입력하면 시스템은 원본 리소스 이름을 무시하므로, 여러 열 결합, 단일 열 분할 등의 로직을 구현할 수 있습니다
⚠ 객체 그룹의 하위 속성에는 값 가져오기 방식을 설정할 수 없으며, 특수한 처리는 상위 속성 수준에서 설정해야 합니다
🔵 출력 리소스 타입
기본 시나리오에서는 출력 리소스 타입을 원본 리소스 타입과 동일하게 두면 됩니다
⚠ 값 가져오기 방식을 입력한 경우 여기서 처리 후의 데이터 타입을 선택해야 합니다. 예: col의 원본 타입이 텍스트이고 try_cast( col as double)로 처리했다면 여기서 숫자를 선택해야 합니다
🔵 확장 정보
위 항목 외의 리소스 정보는 확장 정보에 접혀 있으며, 클릭하면 팝업에서 편집할 수 있습니다. 공통 확장 정보는 비고입니다
⚠ 크로스 소스 리소스 타입에 따라 특정 시나리오에서 확장 정보 필드가 추가될 수 있으며, 관련 내용은 해당 리소스 타입의 문서에서 설명합니다
확장 정보 팝업 미리보기
🔵 열거형 값 로직
분석 모델로 리포트와 대시보드를 구성하면서 리소스를 필터링할 때, 시스템은 현재 리소스의 열거형 값 드롭다운 목록을 표시합니다
속성 열거형 값 드롭다운 미리보기
크로스 소스 리소스를 설정할 때 열거형 값 로직으로 해당 크로스 소스 리소스의 열거형 값을 설정해 두면 비즈니스 담당자가 필터링하기 편리합니다
편집할 때는 먼저 CSV 참고 템플릿을 다운로드하고, 수정한 후 바로 업로드할 수 있습니다
⚠ 다른 도구로 CSV 파일을 내보낸 경우 UTF-8 인코딩 형식으로 설정해야 합니다
⚠ 텍스트, 숫자, 리스트 타입만 열거형 값을 설정할 수 있으며, 리스트의 열거형 값은 리스트 내 요소를 대상으로 합니다
열거형 값 로직 미리보기
🔵 상태
현재 크로스 소스 리소스의 유효성 검사 상태로, 기본 상태는 미검증이며 유효성 검사 후에는 결과가 표시됩니다
발생할 수 있는 오류: 데이터 소스에 열이 존재하지 않음, 값 가져오기 방식 또는 출력 타입 오류 등
⚠ 값 가져오기 방식과 출력 타입의 오류는 실제 데이터와 SQL 문을 함께 보며 조정해야 합니다. 입력하기 전에 데이터 소스를 미리 보고, SQL 문을 복사하여 <SQL IDE> 기능에서 확인해 보는 것을 권장합니다
🔵 작업
각 리소스 설정의 오른쪽에 복사와 삭제 두 가지 작업이 있습니다
-
복사
- 현재 리소스 설정을 복사하며, 새로 추가된 리소스 설정의 이름에 "_copy" 접미사가 붙습니다
-
삭제
-
현재 리소스 설정을 삭제합니다. 페이지에 결과가 플로팅 메시지로 표시되며, 실행 취소 버튼이 제공됩니다
삭제 안내 미리보기
-
3.3 크로스 소스 설정 기본 정보
크로스 소스 설정 절차 3
모든 크로스 소스 설정에 반드시 설정해야 하는 식별 정보입니다
기본 정보 필드 예시
-
크로스 소스 설정 이름
- 현재 크로스 소스 리소스 설정의 이름
- 영문 소문자로 시작해야 하며 영문 소문자, 숫자, 밑줄만 사용할 수 있고, 길이는 80자 미만이어야 합니다
-
크로스 소스 설정 표시명
- 현재 크로스 소스 리소스 설정의 표시 이름
- 길이는 80자 미만이어야 합니다
-
크로스 소스 설정 비고
- 현재 크로스 소스 리소스 설정의 비고 정보
- 길이는 200자 미만이어야 합니다
4. 데이터 타입 설명
- 이벤트/속성 페이지에 표시되는 숫자, 텍스트, 불리언 등의 이름은 "select_type"으로, 멤버가 비즈니스 시나리오에서 선택하거나 분석 모델에서 사용하는 데 쓰입니다
- 데이터 웨어하우스 기본 테이블에 나타나는 bigint, double 등의 이름은 "raw_type"이며, 기본 테이블의 데이터 타입입니다
- 참고용 대응 관계는 다음과 같습니다:
| 화면 표시 타입(select_type) | 기본 타입(raw_type) |
|---|---|
| 숫자 | tinyint,smallint,int,bigint,double,decimal |
| 텍스트 | varchar |
| 불리언 | boolean |
| 시간 | datetime |
| 리스트 | array(varchar/timestamp/boolean/bigint/double... ) |
| 객체 | row( col_str varchar, col_num double, col_array array<varchar> ) |
| 객체 그룹 | array( row( col_str varchar, col_num double, col_array array<varchar>) ) |
리스트 내부의 데이터 타입은 숫자, 텍스트, 불리언, 시간을 지원합니다. 객체, 객체 그룹 내부의 데이터 타입은 숫자, 텍스트, 불리언, 시간, 리스트(내부는 텍스트만 지원)를 지원합니다.
5. 파라미터 제한
-
단일 프로젝트에서 크로스 소스 리소스를 최대 200,000개까지 생성할 수 있습니다(리소스 타입 구분 없음)
Q: 현재 어떤 크로스 소스 리소스가 있는지 어떻게 확인합니까?
A: <리소스 사용 거버넌스> 기능 페이지에서 크로스 소스 리소스로 필터링하면 상세 목록을 확인할 수 있습니다
6. 자주 묻는 질문
크로스 소스 리소스의 상태는 어떻게 확인합니까?
- 리소스 생성을 완료한 후 목록에서 유효성 검사를 클릭하면, 시스템이 설정 정보를 읽어 사용 가능 여부를 확인하고 최종적으로 유효성 검사 결과를 반환합니다
크로스 소스 리소스를 생성했는데 왜 사용할 수 없습니까?
- 미검증, 검증 오류 상태의 리소스는 리포트와 대시보드를 생성하는 데 사용할 수 있지만, 계산 시 유효한 계산 결과를 얻을 수 없습니다
- 유효성 검사를 실행하고 안내에 따라 설정 내용을 수정하여 최종적으로 검증 통과 상태가 되어야 관련 리소스를 계산하고 유효한 결과를 반환할 수 있습니다
유효성 검사를 통과하지 못하고 "xxxx"라는 안내가 표시되는 원인은 무엇이며, 어떻게 해결합니까?
-
필드형 유효성 검사
- 설정 필드에 따라 세밀하게 검사하므로 비교적 명확한 내용을 반환합니다
- 예:
데이터 소스가 존재하지 않거나 권한이 없습니다,事件名称列 event_name 不存在등 - 이 경우 안내에 따라 수정하면 됩니다
-
SQL형 유효성 검사
- SQL 실행이 수반되는 값 가져오기 방식은 SQL 문법, 데이터 타입, 계산 로직 등의 요소를 종합하여 검사해야 하므로 반환되는 결과가 비교적 복잡합니다
- 예:
Cannot apply operator: varchar(4) + integer등 - 이 경우 리소스 중 SQL 문을 사용한 리소스 설정을 확인하고, 오류 안내, 리소스 타입, SQL 함수 등의 정보를 종합하여 원인을 찾아야 합니다