部分批次擷取

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

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

快速入門

本教學課程需要對部分批次擷取所涉及的各種Adobe Experience 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}
注意

如需Platform中沙盒的詳細資訊,請參閱沙盒概述檔案

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

注意

本節說明如何使用API啟用批次以擷取部分批次。 有關使用UI的說明,請閱讀在UI步驟中啟用批處理以進行部分批處理。

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

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

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

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

注意

本節說明如何使用UI啟用批處理以進行部分批處理。 如果您已使用API啟用批次以擷取部分批次,則可跳至下一節。

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

建立新源連接

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

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

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

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

使用現有資料集

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

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

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

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

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

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

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

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

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

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

下一步

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

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free