部分批次擷取

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

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

快速入門

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

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

以下各節提供您必須知道的其他資訊，以便成功呼叫Platform API。

讀取範例API呼叫

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

收集必要標題的值

若要呼叫Platform API，您必須先完成驗證教學課程。 完成驗證教學課程後，所有Experience Platform API呼叫中每個所需標題的值都會顯示在下面：

• 授權：載體{ACCESS_TOKEN}
• x-api-key:{API_KEY}
• x-gw-ims-org-id:{IMS_ORG}

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

• x-sandbox-name:{SANDBOX_NAME}

在API中啟用批處理以進行部分批處理

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

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

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

在UI中啟用批處理以進行部分批處理

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

建立新源連接

要建立新源連接，請遵循源概述中列出的步驟。 到達​Dataflow detail​步驟後，請注意​Partial ingestion​和​Error diagnostics​欄位。

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

錯誤診斷​僅在​部分攝取​關閉時顯示。 此功能允許Platform生成有關所接收批處理的詳細錯誤消息。 如果​部分擷取​切換開啟，則會自動執行增強的錯誤診斷。

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

使用現有資料集

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

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

錯誤診斷​僅在​部分攝取​關閉時顯示。 此功能允許Platform生成有關所接收批處理的詳細錯誤消息。 如果​部分擷取​切換開啟，則會自動執行增強的錯誤診斷。

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

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

使用"將CSV映射到XDM模式"流

要使用「將CSV映射到XDM架構」流，請遵循將CSV檔案教程中列出的步驟。 在到達​添加資料​步驟後，記下​部分提取​和​錯誤診斷​欄位。

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

錯誤診斷​僅在​部分攝取​關閉時顯示。 此功能允許Platform生成有關所接收批處理的詳細錯誤消息。 如果​部分擷取​切換開啟，則會自動執行增強的錯誤診斷。

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

下一步

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

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