查詢服務(資料Distiller)和匯出資料集

本文概述如何使用Experience Platform查詢服務(資料Distiller)和資料集匯出的組合來實作以下專案 資料匯出使用案例：

Adobe Analytics可使用其 資料摘要 功能。 資料摘要是從 Adobe Analytics 中取得原始資料的有力方式。本文會說明如何從Experience Platform中取得類似的原始資料，以便您實施上述使用案例。 在適用情況下，本文所述的功能會與Adobe Analytics資料摘要進行比較，以釐清資料與程式的差異。

簡介

使用查詢服務(Data Distiller)匯出資料時，資料集匯出包含以下專案：

先決條件

使用此使用案例所述的功能之前，請確定您符合下列所有需求：

查詢服務

Experience Platform查詢服務可讓您查詢及聯結Experience Platform資料湖中的任何資料集，就像它是資料庫表格一樣。 然後，您可以將結果擷取為新資料集，以供進一步用於報告或匯出。

您可以使用查詢服務 使用者介面， a 使用者端透過PostgresQL通訊協定連線，或 RESTful API 以建立及排程收集資料摘要資料的查詢。

建立查詢

您可以使用標準ANSI SQL for SELECT敘述句和其他有限命令的所有功能，來建立和執行產生資料摘要資料的查詢。 另請參閱 SQL語法 以取得詳細資訊。 除了此SQL語法以外，Adobe還支援：

資料摘要欄

您可以在查詢中使用的XDM欄位取決於資料集所依據的結構描述定義。 請確定您瞭解資料集所根據的結構描述。 如需詳細資訊，請參閱 資料集UI指南.

若要協助您定義資料摘要欄位與XDM欄位之間的對應，請參閱 分析欄位對應. 另請參閱 結構描述UI總覽 有關如何管理XDM資源（包括結構描述、類別、欄位群組和資料型別）的詳細資訊。

例如，如果您想使用 頁面名稱 做為資料摘要的一部分：

身分

在Experience Platform中，有多種身分可供使用。 建立查詢時，請確定您正在正確查詢身分。

您通常會在個別的欄位群組中找到身分。 在實作ECID (ecid)可定義為具有的欄位群組的一部分 core 物件，它本身就是物件的一部分， identification 物件(例如： _sampleorg.identification.core.ecid)。 ECID在結構中的組織方式可能有所不同。

或者，您可以使用 identityMap 以查詢身分。 此 identityMap 屬於型別 Map 並使用 巢狀資料結構.

另請參閱 在UI中定義身分欄位 以取得如何在Experience Platform中定義身分欄位的詳細資訊。

請參閱 Analytics資料中的主要識別碼 瞭解在使用Analytics來源聯結器時，Adobe Analytics身分如何對應到Experience Platform身分。 此對應可作為設定身分識別的指引，即使未使用Analytics來源聯結器亦然。

點選層級資料和識別

根據實作，傳統上在Adobe Analytics中收集的點選層級資料現在會儲存為Experience Platform中的時間戳記事件資料。 下表摘錄自 分析欄位對應 和顯示如何將點選層級特定的Adobe Analytics資料摘要欄與查詢中的對應XDM欄位的範例。 此表格也顯示如何使用XDM欄位識別點選、造訪和訪客的範例。

張貼欄

Adobe Analytics資料摘要會使用附有欄的概念 post_ 前置詞，處理之後包含資料的欄。 如需詳細資訊，請參閱資料摘要常見問題。

透過Experience PlatformEdge Network（Web SDK、Mobile SDK、伺服器API）在資料集中收集的資料不含 post_ 欄位。 因此， post_ 前置詞和 非-post_ 有首碼的資料摘要欄會對應至相同的XDM欄位。 例如，兩者 page_url 和 post_page_url 資料摘要欄會對應至相同的 web.webPageDetails.URL XDM欄位。

另請參閱 比較Adobe Analytics和Customer Journey Analytics的資料處理 以取得資料處理差異的概觀。

此 post_ 在Experience Platform資料湖中收集資料時，為其資料欄型別加上前置詞，則不需要進階轉換，才能成功用於資料摘要使用案例。 在查詢中執行這些進階轉換涉及使用 Adobe定義的函式 用於工作階段化、歸因和重複資料刪除。 另請參閱 範例 這些函式的使用方式。

查詢

若要從其他資料集中查詢資料，請使用標準SQL功能(WHERE 子句， INNER JOIN， OUTER JOIN和其他)。

計算

若要在欄位（欄）上執行計算，請使用標準SQL函式(例如 COUNT(*))或 數學和統計運運算元與函式 Spark SQL的一部分。 另外， 視窗函式 提供更新彙總的支援，並傳回有序子集中每一列的單一專案。 另請參閱 範例 這些函式的使用方式。

巢狀資料結構

資料集所根據的結構描述通常包含複雜的資料型別，包括巢狀資料結構。 先前已提及 identityMap 是巢狀資料結構的範例。 如需範例，請參閱下文 identityMap 資料。

{
   "identityMap":{
      "FPID":[
         {
            "id":"55613368189701342632255821452918751312",
            "authenticatedState":"ambiguous"
         }
      ],
      "CRM":[
         {
            "id":"2394509340-30453470347",
            "authenticatedState":"authenticated"
         }
      ]
   }
}

您可以使用 explode() 或其他陣列功能 從Spark SQL取得巢狀資料結構內的資料，例如：

select explode(identityMap) from demosys_cja_ee_v1_website_global_v1_1 limit 15;

或者，您可以使用點標籤法來參照個別元素。 例如：

select identityMap.ecid from demosys_cja_ee_v1_website_global_v1_1 limit 15;

請參閱「在 Query Service 中使用巢狀資料結構」以了解更多資訊。

範例

對於查詢：

請參閱：

排程查詢

您可以排程查詢，以確保查詢已執行，而且結果會以您偏好的間隔產生。

使用查詢編輯器

您可以使用查詢編輯器排程查詢。 排程查詢時，您可以定義輸出資料集。 另請參閱 查詢排程 以取得詳細資訊。

使用查詢服務API

或者，您可以使用RESTful API來定義查詢和排程查詢。 請參閱 查詢服務API指南 以取得詳細資訊。
請確定您將輸出資料集定義為選用的一部分 ctasParameters 建立查詢時的屬性(建立查詢)或建立查詢的排程時(建立排定的查詢)。

匯出資料集

一旦您建立並排程查詢，且驗證結果後，您就可以將原始資料集匯出至雲端儲存空間目的地。 此匯出位於「Experience Platform目的地」術語中，稱為「資料集匯出目的地」。 另請參閱 將資料集匯出至雲端儲存空間目的地 以取得概覽。

支援下列雲端儲存空間目的地：

EXPERIENCE PLATFORMUI

您可以透過Experience Platform UI匯出及排程匯出輸出資料集。 本節將說明相關步驟。

選取目的地

當您決定要將輸出資料集匯出到哪個雲端儲存空間目的地時， 選取目的地. 如果您尚未設定偏好雲端儲存空間的目的地，您必須 建立新的目的地連線.

在設定目的地時，您可以

選取資料集

當您選取目的地時，在下一個 選取資料集 您必須從資料集清單中選取輸出資料集的步驟。 如果您建立了多個排程的查詢，且希望輸出資料集傳送至相同的雲端儲存空間目的地，則可選取對應的輸出資料集。 另請參閱 選取您的資料集 以取得詳細資訊。

排程資料集匯出

最後，您想要將資料集匯出排程為 正在排程 步驟。 在該步驟中，您可以定義排程，以及輸出資料集匯出是否應為增量式的。 另請參閱 排程資料集匯出 以取得詳細資訊。

最後步驟

檢閱 您的選取範圍並在正確後，開始將輸出資料集匯出至雲端儲存空間目的地。

您必須 驗證 資料匯出成功。 匯出資料集時，Experience Platform會建立一或多個 .json 或 .parquet 存放位置中定義的檔案。 預期會根據您設定的匯出排程，將新檔案儲存在您的儲存位置。 Experience Platform會在您指定為所選目的地一部分的儲存位置中建立資料夾結構，並存放匯出的檔案。 每次匯出時都會建立一個新資料夾，其模式如下： folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMM. 預設檔案名稱是隨機產生的，並確保匯出的檔案名稱是唯一的。

流程服務API

或者，您可以使用API匯出和排程匯出輸出資料集。 相關步驟的記錄於 使用流量服務API匯出資料集.

開始使用

若要匯出資料集，請確定您已 必要許可權. 同時確認您要傳送輸出資料集的目的地支援匯出資料集。 然後，您必須 收集必要和選用標題的值 用於API呼叫的內容。 您也需要 識別目的地的連線規格和流程規格ID 您打算將資料集匯出至。

擷取合格的資料集

您可以 擷取合格資料集的清單 匯出，並使用「 」確認輸出資料集是否屬於該清單 GET /connectionSpecs/{id}/configs API。

建立來源連線

接下來，您必須 建立來源連線 針對您要匯出至雲端儲存空間目的地的輸出資料集（使用其唯一ID）。 您使用 POST /sourceConnections API。

驗證到目的地（建立基礎連線）

您現在必須 建立基礎連線 使用驗證並安全地儲存認證至您的雲端儲存空間目的地 POST /targetConection API。

提供匯出引數

接下來，您必須 建立其他目標連線來儲存匯出引數 對於您的輸出資料集，再次使用 POST /targetConection API。 這些匯出引數包括位置、檔案格式、壓縮等等。

設定資料流

最後，您 設定資料流 以確保您的輸出資料集已使用，匯出至雲端儲存空間目的地 POST /flows API。 在此步驟中，您可以使用來定義匯出排程 scheduleParams 引數。

驗證資料流

至 檢查資料流的成功執行，使用 GET /runs API，將資料流ID指定為查詢引數。 此資料流ID是您設定資料流時傳回的識別碼。

驗證 資料匯出成功。 匯出資料集時，Experience Platform會建立一或多個 .json 或 .parquet 存放位置中定義的檔案。 預期會根據您設定的匯出排程，將新檔案儲存在您的儲存位置。 Experience Platform會在您指定為所選目的地一部分的儲存位置中建立資料夾結構，並存放匯出的檔案。 每次匯出時都會建立一個新資料夾，其模式如下： folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMM. 預設檔案名稱是隨機產生的，並確保匯出的檔案名稱是唯一的。

結論

簡而言之，模擬Adobe Analytics資料摘要功能隱含著使用查詢服務設定排程查詢，以及在排程資料集匯出中使用這些查詢的結果。