위치:
사용자 정의 공동 작업 템플릿
사용자 정의 공동 작업 템플릿은 제공자가 필수 메타데이터 특성 및 공동 작업 조건을 지정하기 위해 만들 수 있는 JSON 파일입니다. 사용자 정의 템플릿은 각 사용 사례 아래에서 여러 사용 사례와 여러 쿼리를 지원할 수 있습니다. 사용자 정의 템플릿을 만들려면 패키지를 만드는 동안 샘플 JSON을 복사하고 필드 값을 지정한 다음, 템플릿을 업로드합니다. 클린 룸 패키지를 만들 때 Data 360 설정에서 샘플 JSON을 다운로드할 수도 있습니다.
템플릿 개요
사용자 정의 공동 작업 템플릿에는 다음 필드가 포함되어 있습니다.
| 필드 이름 | 데이터 유형 | 요구 사항 | 허용된 값 | 설명 |
|---|---|---|---|---|
name |
문자열 | 필수 | N/A | 공동 작업 템플릿의 이름입니다. |
description |
문자열 | 선택 사항 | N/A | 공동 작업 템플릿에 대한 간단한 설명입니다. |
tables |
개체 | 필수 | N/A | 공동 작업 쿼리에서 사용되는 입력 테이블입니다. |
queries |
개체 | 필수 | N/A | 사용 사례를 지원하기 위해 클린 룸 공동 작업에서 실행할 쿼리입니다. |
테이블 구성
쿼리에서 사용되는 각 입력 테이블은 tables 필드로 정의해야 합니다. 각 테이블 정의에는 tableConfigs 속성이 포함되어야 합니다.
tableConfigs(어레이, 필수) – 테이블 정의 목록입니다. 각 항목은 하나의 테이블 구성을 나타내며 다음 필드를 포함해야 합니다.
| 필드 이름 | 데이터 유형 | 요구 사항 | 허용된 값 | 설명 |
|---|---|---|---|---|
name |
문자열 | 필수 | N/A | 테이블의 이름입니다. |
description |
문자열 | 선택 사항 | N/A | 테이블 정의에 대한 간단한 설명입니다. |
role |
문자열 | 필수 | 공급업체 또는 소비자 | 공동 작업에서 테이블을 공유하는 역할입니다. |
columns |
array | 필수 | N/A | 테이블의 스키마입니다. 각 열 개체는 테이블의 필드를 정의하며, name, type, 선택적 description 및 defaultvalue(있는 경우)를 포함해야 합니다. |
쿼리 구성
쿼리 섹션은 클린 룸의 결합된 데이터 집합에 허용할 모든 쿼리를 정의합니다. 각 쿼리에 queryConfigs 속성이 포함되어야 합니다.
queryConfigs(어레이, 필수) – 쿼리 구성 목록입니다. 각 항목은 단일 쿼리를 정의하며 다음 필드를 포함해야 합니다.
| 필드 이름 | 데이터 유형 | 요구 사항 | 허용된 값 | 설명 |
|---|---|---|---|---|
name |
문자열 | 필수 | N/A | 쿼리의 이름입니다. |
description |
문자열 | 선택 사항 | N/A | 쿼리 구성에 대한 간단한 설명입니다. |
useCase |
문자열 | 필수 | 중첩 또는 사용자 지정 | 이 쿼리가 지원하는 사용 사례입니다. |
type |
문자열 | 필수 | SQL | 쿼리 유형입니다. |
source |
문자열 | 필수 | N/A | 실제 SQL 쿼리 텍스트입니다.
|
referencedTables |
문자열의 배열 | 필수 | N/A | 쿼리에서 참조하는 모든 테이블의 목록입니다. 이 필드에는 테이블 이름이 하나 이상 포함되어야 합니다. |
queryParameters |
개체 | 선택 사항 | N/A | 쿼리에서 사용되는 동적 매개 변수입니다. 각 queryParameter에는 name, type 및 선택적 description 필드가 있는 queryParamConfigs이 포함되어야 합니다. |
analysisConfigs |
개체 | 선택 사항 | N/A | 출력 옵션입니다(예: outputPath). |
- 사용자 정의 공동 작업 템플릿 샘플 JSON
아래의 템플릿 코드를 복사하거나 Data 360에서 직접 다운로드하여 사용자 정의 템플릿 만들기를 시작합니다. 필수 및 옵션 필드를 적절한 값으로 채웁니다. - 사용자 정의 템플릿에 대해 지원되는 데이터 유형
사용자 정의 템플릿에서 지원되는 데이터 유형은 정리실 플랫폼에 따라 다릅니다. 쿼리를 성공적으로 실행하려면 지원되는 데이터 유형을 준수합니다.
