部分批量攝取

部分批處理接收是指能夠接收包含錯誤的資料,最高可達到某個閾值。 利用此功能,用戶可以成功將其所有正確資料接收到Adobe Experience Platform,同時將其所有不正確的資料分別進行批處理,並詳細瞭解其無效的原因。

本文檔提供了管理部分批處理接收的教程。

快速入門

本教程需要瞭解與部分批量接收有關的Adobe Experience Platform各服務的工作知識。 在開始本教程之前,請查看以下服務的文檔:

以下各節提供了您需要瞭解的其他資訊,以便成功撥打 Platform API。

讀取示例API調用

本指南提供了示例API調用,以演示如何格式化請求。 這些包括路徑、必需的標頭和正確格式化的請求負載。 還提供了API響應中返回的示例JSON。 有關示例API調用文檔中使用的約定的資訊,請參見上的 如何讀取示例API調用 的 Experience Platform 疑難解答指南。

收集所需標題的值

為了呼叫 Platform API,必須首先完成 驗證教程。 完成身份驗證教程將提供所有中每個必需標頭的值 Experience Platform API調用,如下所示:

  • 授權:持 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

中的所有資源 Experience Platform 與特定虛擬沙箱隔離。 所有請求 Platform API需要一個標頭,該標頭指定操作將在以下位置進行的沙盒的名稱:

  • x-sandbox-name: {SANDBOX_NAME}
注意

有關中的沙箱的詳細資訊 Platform,請參見 沙盒概述文檔

在API中為部分批接收啟用批

注意

本節介紹使用API為部分批接收啟用批處理。 有關使用UI的說明,請閱讀 在UI中啟用批處理部分接收 的子菜單。

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

要建立新批,請執行 批量攝取顯影劑指南。 一旦你到達 建立批 步驟,在請求正文中添加以下欄位:

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

在UI中為部分批接收啟用批

注意

本節介紹使用UI啟用批處理以進行部分批處理接收。 如果已使用API為部分批接收啟用了批,則可以跳到下一節。

通過啟用批以進行部分攝取 Platform UI,您可以通過源連接建立新批、在現有資料集中建立新批或通過「 」建立新批將CSV映射到XDM流。

新建源連接

要建立新源連接,請按照 源概述。 一旦你到達 資料流詳細資訊 步驟,注意 部分攝取錯誤診斷 的子菜單。

部分攝取 切換允許您啟用或禁用部分批接收。

錯誤診斷 僅當 部分攝取 切換關閉。 此功能允許 Platform 生成有關接收的批的詳細錯誤消息。 如果 部分攝取 開啟切換,自動強制執行增強的錯誤診斷。

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

使用現有資料集

要使用現有資料集,請從選擇資料集開始。 右邊的提要欄將填充有關資料集的資訊。

部分攝取 切換允許您啟用或禁用部分批接收。

錯誤診斷 僅當 部分攝取 切換關閉。 此功能允許 Platform 生成有關接收的批的詳細錯誤消息。 如果 部分攝取 開啟切換,自動強制執行增強的錯誤診斷。

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

現在,您可以使用 添加資料 按鈕,然後用部分攝入來攝取。

使用「」將CSV映射到XDM架構"流"

使用「」將CSV映射到XDM架構「流」,按照 映射CSV檔案教程。 一旦你到達 添加資料 步驟,注意 部分攝取錯誤診斷 的子菜單。

部分攝取 切換允許您啟用或禁用部分批接收。

錯誤診斷 僅當 部分攝取 切換關閉。 此功能允許 Platform 生成有關接收的批的詳細錯誤消息。 如果 部分攝取 開啟切換,自動強制執行增強的錯誤診斷。

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

後續步驟

本教程介紹如何建立或修改資料集以啟用部分批處理接收。 有關批量攝取的詳細資訊,請閱讀 批量攝取顯影劑指南

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

本頁內容