部分批處理接收是指能夠接收包含錯誤的資料,最高可達到某個閾值。 利用此功能,用戶可以成功將其所有正確資料接收到Adobe Experience Platform,同時將其所有不正確的資料分別進行批處理,並詳細瞭解其無效的原因。
本文檔提供了管理部分批處理接收的教程。
本教程需要瞭解與部分批量接收有關的Adobe Experience Platform各服務的工作知識。 在開始本教程之前,請查看以下服務的文檔:
以下各節提供了您需要瞭解的其他資訊,以便成功撥打 Platform API。
本指南提供了示例API調用,以演示如何格式化請求。 這些包括路徑、必需的標頭和正確格式化的請求負載。 還提供了API響應中返回的示例JSON。 有關示例API調用文檔中使用的約定的資訊,請參見上的 如何讀取示例API調用 的 Experience Platform 疑難解答指南。
為了呼叫 Platform API,必須首先完成 驗證教程。 完成身份驗證教程將提供所有中每個必需標頭的值 Experience Platform API調用,如下所示:
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
中的所有資源 Experience Platform 與特定虛擬沙箱隔離。 所有請求 Platform API需要一個標頭,該標頭指定操作將在以下位置進行的沙盒的名稱:
{SANDBOX_NAME}
有關中的沙箱的詳細資訊 Platform,請參見 沙盒概述文檔。
本節介紹使用API為部分批接收啟用批處理。 有關使用UI的說明,請閱讀 在UI中啟用批處理部分接收 的子菜單。
您可以建立啟用部分攝取的新批。
要建立新批,請執行 批量攝取顯影劑指南。 一旦你到達 建立批 步驟,在請求正文中添加以下欄位:
{
"enableErrorDiagnostics": true,
"partialIngestionPercent": 5
}
屬性 | 說明 |
---|---|
enableErrorDiagnostics |
允許 Platform 生成有關批的詳細錯誤消息。 |
partialIngestionPercent |
整個批失敗前可接受錯誤的百分比。 因此,在本示例中,最多5%的批可能是錯誤,然後才會失敗。 |
本節介紹使用UI啟用批處理以進行部分批處理接收。 如果已使用API為部分批接收啟用了批,則可以跳到下一節。
通過啟用批以進行部分攝取 Platform UI,您可以通過源連接建立新批、在現有資料集中建立新批或通過「 」建立新批將CSV映射到XDM流。
要建立新源連接,請按照 源概述。 一旦你到達 資料流詳細資訊 步驟,注意 部分攝取 和 錯誤診斷 的子菜單。
的 部分攝取 切換允許您啟用或禁用部分批接收。
的 錯誤診斷 僅當 部分攝取 切換關閉。 此功能允許 Platform 生成有關接收的批的詳細錯誤消息。 如果 部分攝取 開啟切換,自動強制執行增強的錯誤診斷。
的 錯誤閾值 允許您在整個批失敗之前設定可接受錯誤的百分比。 預設情況下,此值設定為5%。
要使用現有資料集,請從選擇資料集開始。 右邊的提要欄將填充有關資料集的資訊。
的 部分攝取 切換允許您啟用或禁用部分批接收。
的 錯誤診斷 僅當 部分攝取 切換關閉。 此功能允許 Platform 生成有關接收的批的詳細錯誤消息。 如果 部分攝取 開啟切換,自動強制執行增強的錯誤診斷。
的 錯誤閾值 允許您在整個批失敗之前設定可接受錯誤的百分比。 預設情況下,此值設定為5%。
現在,您可以使用 添加資料 按鈕,然後用部分攝入來攝取。
使用「」將CSV映射到XDM架構「流」,按照 映射CSV檔案教程。 一旦你到達 添加資料 步驟,注意 部分攝取 和 錯誤診斷 的子菜單。
的 部分攝取 切換允許您啟用或禁用部分批接收。
的 錯誤診斷 僅當 部分攝取 切換關閉。 此功能允許 Platform 生成有關接收的批的詳細錯誤消息。 如果 部分攝取 開啟切換,自動強制執行增強的錯誤診斷。
錯誤閾值 允許您在整個批失敗之前設定可接受錯誤的百分比。 預設情況下,此值設定為5%。
本教程介紹如何建立或修改資料集以啟用部分批處理接收。 有關批量攝取的詳細資訊,請閱讀 批量攝取顯影劑指南。
有關監視部分攝取錯誤的資訊,請閱讀 批處理問題錯誤診斷指南。