部分批次擷取

部分批次擷取是指能夠擷取包含錯誤的資料，最高可達到特定臨界值。 透過這項功能，使用者可以成功將所有正確的資料內嵌至Adobe Experience Platform，而其所有不正確的資料都會個別批次處理，以及為何無效的詳細資訊。

本檔案提供管理部分批次擷取的教學課程。

快速入門

本教學課程需要對部分批次擷取所涉及的各種Adobe Experience Platform服務有相關的使用知識。 在開始本教學課程之前，請先閱讀下列服務的檔案：

• 批次擷取:從資料檔 Platform 案（例如CSV和Parce）擷取和儲存資料的方法。
• Experience Data Model (XDM):組織客戶體驗資料 Platform 的標準化架構。

以下章節提供您成功呼叫API所需的其他資訊 Platform 。

讀取範例API呼叫

本指南提供範例API呼叫，以示範如何格式化您的請求。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊，請參閱疑難排解指 南中有關如何讀取範例API呼叫的 Experience Platform 章節。

收集必要標題的值

若要呼叫API，您必 Platform 須先完成驗證教 學課程。 完成驗證教學課程後，將提供所有 Experience Platform API呼叫中每個必要標題的值，如下所示：

• 授權：生產者 {ACCESS_TOKEN}
• x-api-key: {API_KEY}
• x-gw-ims-org-id: {IMS_ORG}

中的所有資 Experience Platform 源都與特定虛擬沙盒隔離。 對API的所 Platform 有請求都需要一個標題，該標題會指定要在中執行的操作的沙盒名稱：

• x-sandbox-name: {SANDBOX_NAME}

在API中啟用批次以擷取部分批次

您可以建立啟用部分擷取的新批次。

若要建立新批次，請依照批次擷取開發人員指 南中的步驟進行。 在您達到「建 立批次 」步驟後，在請求內文中新增下列欄位：

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}

屬性	說明
enableErrorDiagnostics	允許生成有關 Platform 批的詳細錯誤消息的標籤。
partialIngestionPercentage	整個批失敗前可接受錯誤的百分比。 因此，在此示例中，最多5%的批可能是錯誤，否則將失敗。

在UI中啟用批次以擷取部分批次

若要透過 Platform UI啟用批次以進行部分擷取，您可以透過來源連線建立新批次、在現有資料集中建立新批次，或透過「Map CSV to XDM flow」建立新批次。

建立新源連接

要建立新源連接，請遵循「源」概述中列出的 步驟。 在到達「資料 流詳細資訊 」步驟後 ，請注意「部分 提取 」和「 錯誤診斷」欄位。

「部 分擷取 」切換可讓您啟用或停用部分批次擷取的使用。

僅當 Partial Ingestion（部分攝取）關 閉時，才會顯示 ​​Error diagnostics（錯誤診斷）切換。 此功能可 Platform 產生有關您所擷取批次的詳細錯誤訊息。 如果已 開啟「部分擷取 」切換，則會自動強制執行增強的錯誤診斷。

「錯 誤閾值 」(Error threshold)允許您在整個批失敗之前設定可接受錯誤的百分比。 依預設，此值會設為5%。

使用現有資料集

若要使用現有資料集，請從選取資料集開始。 右側的側欄會填入資料集的相關資訊。

「部 分擷取 」切換可讓您啟用或停用部分批次擷取的使用。

僅當 Partial Ingestion（部分攝取）關 閉時，才會顯示 ​​Error diagnostics（錯誤診斷）切換。 此功能可 Platform 產生有關您所擷取批次的詳細錯誤訊息。 如果已 開啟「部分擷取 」切換，則會自動強制執行增強的錯誤診斷。

「錯 誤閾值 」(Error threshold)允許您在整個批失敗之前設定可接受錯誤的百分比。 依預設，此值會設為5%。

現在，您可以使用「新增資料」 按鈕來上傳資料 ，而且會使用部分擷取來擷取資料。

使用「將CSV對應至XDM架構」流程

若要使用「將CSV對應至XDM架構」流程，請遵循「將CSV檔案對應」教學課程中 所列的步驟。 一旦到達「添 加資料 」步驟 ，請記下「部分提取」和「錯誤診斷」欄位​​ 。

「部 分擷取 」切換可讓您啟用或停用部分批次擷取的使用。

僅當 Partial Ingestion（部分攝取）關 閉時，才會顯示 ​​Error diagnostics（錯誤診斷）切換。 此功能可 Platform 產生有關您所擷取批次的詳細錯誤訊息。 如果已 開啟「部分擷取 」切換，則會自動強制執行增強的錯誤診斷。

錯誤閾值 ，允許您在整個批失敗之前設定可接受錯誤的百分比。 依預設，此值會設為5%。

下一步

本教學課程涵蓋如何建立或修改資料集以啟用部分批次擷取。 如需批次擷取的詳細資訊，請閱讀批次擷取開 發人員指南。

有關監視部分攝取錯誤的資訊，請閱讀批 次攝取錯誤診斷指南。