部分批次擷取

部分批次擷取是擷取包含錯誤的資料的能力，上限為特定臨界值。 有了這項功能，使用者可以成功地將其所有正確的資料擷取到Adobe Experience Platform，同時將其所有不正確的資料單獨分批處理，以及關於其無效原因的詳細資訊。

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

快速入門

本教學課程需要您具備與部分批次擷取相關的各種Adobe Experience Platform服務的運作知識。 在開始本教學課程之前，請先檢閱下列服務的檔案：

下列章節提供您需瞭解的其他資訊，才能成功呼叫Platform API。

讀取範例 API 呼叫

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

收集所需標頭的值

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

Experience Platform中的所有資源都與特定的虛擬沙箱隔離。 對Platform API的所有請求都需要標頭，以指定將在其中執行作業的沙箱名稱：

在API中啟用部分批次擷取的批次 enable-api

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

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

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

在UI中為部分批次擷取啟用批次 enable-ui

若要透過Platform UI啟用部分擷取的批次，您可以透過來源連線建立新批次、在現有資料集中建立新批次，或透過"將CSV對應至XDM流程"建立新批次。

建立新的來源連線 new-source

若要建立新的來源連線，請依照來源概觀中列出的步驟操作。 到達​ 資料流詳細資料 ​步驟後，請記下​ 部分擷取 ​和​ 錯誤診斷 ​欄位。

部分擷取 ​切換可讓您啟用或停用部分批次擷取。

錯誤診斷 ​切換僅在​ 部分擷取 ​切換關閉時顯示。 此功能可讓Platform產生有關您擷取批次的詳細錯誤訊息。 如果已開啟​ 部分擷取 ​切換，則會自動強制執行增強的錯誤診斷。

錯誤臨界值 ​可讓您在整個批次失敗之前設定可接受的錯誤百分比。 預設情況下，此值會設為5%。

使用現有的資料集 existing-dataset

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

部分擷取 ​切換可讓您啟用或停用部分批次擷取。

錯誤診斷 ​切換僅在​ 部分擷取 ​切換關閉時顯示。 此功能可讓Platform產生有關您擷取批次的詳細錯誤訊息。 如果已開啟​ 部分擷取 ​切換，則會自動強制執行增強的錯誤診斷。

錯誤臨界值 ​可讓您在整個批次失敗之前設定可接受的錯誤百分比。 預設情況下，此值會設為5%。

現在，您可以使用​ 新增資料 ​按鈕上傳資料，並將使用部分擷取來擷取資料。

使用"將CSV對應至XDM結構描述"流程 map-flow

若要使用「將CSV對應至XDM結構描述」流程，請依照將CSV檔案對應至教學課程中列出的步驟操作。 完成​ 新增資料 ​步驟後，請記下​ 部分擷取 ​和​ 錯誤診斷 ​欄位。

部分擷取 ​切換可讓您啟用或停用部分批次擷取。

錯誤診斷 ​切換僅在​ 部分擷取 ​切換關閉時顯示。 此功能可讓Platform產生有關您擷取批次的詳細錯誤訊息。 如果已開啟​ 部分擷取 ​切換，則會自動強制執行增強的錯誤診斷。

錯誤臨界值 ​可讓您在整個批次失敗之前設定可接受的錯誤百分比。 預設情況下，此值會設為5%。

後續步驟 next-steps

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

如需有關監控部分擷取錯誤的資訊，請參閱批次擷取錯誤診斷指南。