平面化巢狀資料結構以用於協力廠商BI工具
Adobe Experience Platform查詢服務支援 FLATTEN
透過第三方BI工具連線至資料庫時設定。 此功能可平面化協力廠商BI工具中的巢狀資料結構,以提高其可用性並減少擷取、分析、轉換和報表資料所需的工作量。
許多BI工具如 Tableau 和 Power BI 不原生支援巢狀資料結構。 此 FLATTEN
設定會移除在資料上建立SQL檢視以提供平面版本或使用查詢服務的需要 CTAS
或 INSERT INTO
當使用臨時結構描述時,可將資料集複製到一般版本的工作。
此 FLATTEN
設定會將每個分葉欄位的結構提取到表格的根中,並在原始名稱空間之後命名欄位。 這可讓您使用點標籤法來比對欄位與其體驗資料模型(XDM)路徑,同時保留欄位的內容。
先決條件
使用 FLATTEN
設定需要實際瞭解下列Adobe Experience Platform元件:
使用FLATTEN設定連線到資料庫 connect-with-flatten
此 FLATTEN
將巢狀資料結構設定為個別的欄,其中屬性名稱會成為保留列值的欄名稱。 在不支援巢狀資料結構的BI工具中使用資料時,此設定可改善臨時結構描述的可用性並減少必要的工作負載。
使用您選擇的協力廠商使用者端連線至查詢服務時,請附加 FLATTEN
設定為資料庫名稱。 如需有關如何連線特定BI工具的資訊,請參閱 將使用者端連線至查詢服務總覽. 連線字串應包含:
- 沙箱名稱。
- 冒號後面接著
all
或特定資料集ID、檢視ID或資料庫名稱。 - 問號(?) 後面接著
FLATTEN
關鍵字。
輸入內容應採用以下格式:
{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
設定目前不會平面化下列資料結構:
EXPLODE
函式以存取陣列。若要解決Map和Array限制,您需要使用BI工具原始SQL編輯,例如Power BI中的「進階選項 — > SQL陳述式」。
需要原始的SQL編輯等BI工具才能解決對應和陣列限制。 請參閱操作方法指南 使用Power BI進階選項輸入自訂SQL查詢 在SQL陳述式區段中。
後續步驟
本檔案說明如何平面化巢狀資料結構以搭配協力廠商BI工具使用。 如果您尚未連線使用者端,請參閱 使用者端連線概觀 以取得支援的第三方使用者端清單。