타사 BI 도구와 함께 사용할 중첩된 데이터 구조 평면화

Adobe Experience Platform 쿼리 서비스 는 FLATTEN 타사 BI 도구를 통해 데이터베이스에 연결할 때 설정. 이 기능은 타사 BI 도구의 중첩된 데이터 구조를 병합하여 사용성을 개선하고 데이터를 검색, 분석, 변환 및 보고하는 데 필요한 워크로드를 줄입니다.

다음과 같은 많은 BI 도구 Tableau 및 Power BI 중첩된 데이터 구조를 기본적으로 지원하지 않습니다. 다음 FLATTEN 를 설정하면 플랫 버전을 제공하거나 쿼리 서비스를 사용하기 위해 데이터 위에 SQL 보기를 만들 필요가 없습니다 CTAS 또는 INSERT INTO 임시 스키마를 사용할 때 데이터 세트를 플랫 버전으로 복제하는 작업.

다음 FLATTEN 를 설정하면 각 리프 필드의 구조가 테이블의 루트로 가져오고 원래 네임스페이스 뒤에 필드 이름이 지정됩니다. 이렇게 하면 필드의 컨텍스트를 유지하면서 점 표기법을 사용하여 필드를 해당 XDM(Experience Data Model) 경로와 일치시킬 수 있습니다.

전제 조건

사용 FLATTEN 설정을 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.

FLATTEN 설정을 사용하여 데이터베이스에 연결 connect-with-flatten

다음 FLATTEN 를 설정하면 중첩된 데이터 구조가 속성 이름이 행 값을 포함하는 열 이름이 되는 별도의 열로 병합됩니다. 중첩된 데이터 구조를 지원하지 않는 BI 도구의 데이터로 작업할 때 이 설정은 Ad Hoc 스키마의 사용성을 개선하고 필요한 워크로드를 줄입니다.

선택한 타사 클라이언트와 쿼리 서비스에 연결할 때 FLATTEN 을 데이터베이스 이름으로 설정합니다. 특정 BI 도구를 연결하는 방법에 대한 자세한 내용은 클라이언트를 Query Service에 연결 개요. 연결 문자열에는 다음이 포함되어야 합니다.

입력은 다음 형식을 사용해야 합니다.

{sandbox_name}:{all/ID/database_name}?FLATTEN

연결 문자열의 예는 다음과 같습니다.

prod:all?FLATTEN

예 example

이 안내서에 사용된 예제 스키마는 표준 필드 그룹을 사용합니다 상거래 세부 정보, 다음을 활용 commerce 개체 구조 및 productListItems 배열입니다. 다음에 대한 XDM 설명서 참조: 다음에 대한 추가 정보: 상거래 세부 정보 필드 그룹. 스키마 구조의 표현은 아래 이미지에서 볼 수 있습니다.

BI 도구가 중첩된 데이터 구조를 지원하지 않는 경우 중첩된 필드에 직렬화된 값이 포함되어 있으면 이 필드를 참조하기 어려울 수 있습니다(예: commerce 및 productListItems 예제 스키마에서). 이러한 값은 인코딩된 단일 의 일부로 표시될 수 있습니다 commerce 문자열 필드 및 는 실제로 사용할 수 없습니다.

다음 값은 commerce.order.priceTotal (3018.0), commerce.order.purchaseID (c9b5aff9-25de-450b-98f4-4484a2170180) 및 commerce.purchases.value(1.0) 형식이 잘못된 중첩 필드의 경우.

("(3018.0,c9b5aff9-25de-450b-98f4-4484a2170180)","(1.0)")

를 사용하여 FLATTEN 을 설정하면 점 표기법과 원래 경로 이름을 사용하여 스키마 내의 개별 필드 또는 중첩된 데이터 구조의 전체 섹션에 액세스할 수 있습니다. 를 사용하는 이 형식의 예 commerce 필드 그룹은 아래에 나와 있습니다.

commerce.order.priceTotal
commerce.order.purchaseID
commerce.purchases.value

다음 FLATTEN 설정은 다른 데이터 구조를 처리할 때 특정 제한을 갖습니다. 전체 세부 정보는 제한 섹션.

쿼리의 필드에 따옴표 사용 quotation-marks

이제 병합된 루트 필드는 해당 XDM 경로와 일치하도록 점 표기법을 사용합니다. 쿼리에 사용할 경우 필드를 따옴표(" ")로 묶어야 합니다.

아래의 SQL 예는 중첩 쿼리의 원래 상태를 표시합니다.

SELECT YEAR(timestamp) AS year,
       SUM(commerce.order.priceTotal) AS revenue
FROM purchase_events_dataset
WHERE commerce.purchases.value > 0
GROUP BY 1;

병합된 데이터 필드를 사용할 때 쿼리는 점 표기법을 사용하여 작성되며 아래와 같이 따옴표로 묶여 있습니다.

SELECT YEAR(timestamp) AS year,
       SUM("commerce.order.priceTotal") AS revenue
FROM purchase_events_dataset
WHERE "commerce.purchases.value" > 0
GROUP BY 1;

제한 사항 limitations

다음 FLATTEN 설정은 현재 다음 데이터 구조를 병합하지 않습니다.

맵과 배열 제한을 모두 해결하려면 Power BI의 고급 옵션 -> SQL 문과 같은 BI 도구 원시 SQL 편집 기능을 사용해야 합니다.

맵 및 배열 제한 사항을 모두 해결하려면 원시 SQL 편집과 같은 BI 도구가 필요합니다. 방법은 안내서 참조 Power BI 고급 옵션을 사용하여 사용자 지정 SQL 쿼리를 입력합니다. SQL 문 섹션에서 참조할 수 있습니다.

다음 단계

이 문서에서는 타사 BI 도구와 함께 사용할 중첩된 데이터 구조를 병합하는 방법을 다룹니다. 클라이언트를 아직 연결하지 않은 경우 다음을 참조하십시오. 클라이언트 연결 개요 지원되는 타사 클라이언트 목록입니다.