部分批次擷取是指能夠擷取包含錯誤的資料,最高可達到特定臨界值。 透過這項功能,使用者可以成功將所有正確的資料內嵌至Adobe Experience Platform,而其所有不正確的資料都會個別批次處理,以及為何無效的詳細資訊。
本檔案提供管理部分批次擷取的教學課程。
本教學課程需要對部分批次擷取所涉及的各種Adobe Experience Platform服務有相關的使用知識。 在開始本教學課程之前,請先閱讀下列服務的檔案:
以下各節提供您必須知道的其他資訊,以便成功呼叫Platform API。
本指南提供範例API呼叫,以示範如何格式化您的請求。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。
若要呼叫Platform API,您必須先完成驗證教學課程。 完成驗證教學課程後,所有Experience Platform API呼叫中每個所需標題的值都會顯示在下面:
{ACCESS_TOKEN}
{API_KEY}
{IMS_ORG}
Experience Platform中的所有資源都隔離到特定的虛擬沙盒。 對Platform API的所有請求都需要一個標題,該標題指定要在中執行操作的沙盒的名稱:
{SANDBOX_NAME}
如需Platform中沙盒的詳細資訊,請參閱沙盒概述檔案。
本節說明如何使用API啟用批次以擷取部分批次。 有關使用UI的說明,請閱讀在UI步驟中啟用批處理以進行部分批處理。
您可以建立啟用部分擷取的新批次。
若要建立新批次,請依照批次擷取開發人員指南中的步驟進行。 在您達到建立批次步驟後,在請求內文中新增下列欄位:
{
"enableErrorDiagnostics": true,
"partialIngestionPercentage": 5
}
屬性 | 說明 |
---|---|
enableErrorDiagnostics |
允許Platform生成有關批的詳細錯誤消息的標籤。 |
partialIngestionPercentage |
整個批失敗前可接受錯誤的百分比。 因此,在此示例中,最多5%的批可能是錯誤,否則將失敗。 |
本節說明如何使用UI啟用批處理以進行部分批處理。 如果您已使用API啟用批次以擷取部分批次,則可跳至下一節。
若要透過Platform UI啟用批次以進行部分擷取,您可以透過來源連線建立新批次、在現有資料集中建立新批次,或透過「將CSV對應至XDM流程」建立新批次。
要建立新源連接,請遵循源概述中列出的步驟。 到達Dataflow detail步驟後,請注意Partial ingestion和Error diagnostics欄位。
部分擷取切換可讓您啟用或停用部分批次擷取的使用。
錯誤診斷僅在部分攝取關閉時顯示。 此功能允許Platform生成有關所接收批處理的詳細錯誤消息。 如果部分擷取切換開啟,則會自動執行增強的錯誤診斷。
錯誤閾值允許您在整個批失敗之前設定可接受錯誤的百分比。 依預設,此值會設為5%。
若要使用現有資料集,請從選取資料集開始。 右側的側欄會填入資料集的相關資訊。
部分擷取切換可讓您啟用或停用部分批次擷取的使用。
錯誤診斷僅在部分攝取關閉時顯示。 此功能允許Platform生成有關所接收批處理的詳細錯誤消息。 如果部分擷取切換開啟,則會自動執行增強的錯誤診斷。
錯誤閾值允許您在整個批失敗之前設定可接受錯誤的百分比。 依預設,此值會設為5%。
現在,您可以使用新增資料按鈕來上傳資料,並會使用部分擷取來擷取資料。
要使用「將CSV映射到XDM架構」流,請遵循將CSV檔案教程中列出的步驟。 在到達添加資料步驟後,記下部分提取和錯誤診斷欄位。
部分擷取切換可讓您啟用或停用部分批次擷取的使用。
錯誤診斷僅在部分攝取關閉時顯示。 此功能允許Platform生成有關所接收批處理的詳細錯誤消息。 如果部分擷取切換開啟,則會自動執行增強的錯誤診斷。
錯誤 閾值允許您在整個批失敗之前設定可接受錯誤的百分比。依預設,此值會設為5%。
本教學課程涵蓋如何建立或修改資料集以啟用部分批次擷取。 有關批次擷取的詳細資訊,請閱讀批次擷取開發人員指南。
有關監視部分攝取錯誤的資訊,請閱讀批次攝取錯誤診斷指南。