Show Menu
主題×

描述檔系統工作(刪除請求)

Adobe Experience Platform可讓您從多個來源擷取資料,並為個別客戶建立強穩的個人檔案。 Data Lake和即時客戶個人檔案資料儲存中會儲存在Platform中。 有時可能需要從描述檔存放區刪除資料集或批次,以移除不再需要或錯誤新增的資料。 這需要使用即時客戶描述檔API來建立描述檔系統工作(也稱為「刪除請求」),如有需要,也可加以修改、監控或移除。
如果您嘗試從資料湖刪除資料集或批次,請造訪目錄服 務概觀 ,以取得指示。

快速入門

本指南中使用的API端點是即時客戶個人檔案API的一部分。 在繼續之前,請先閱讀 即時客戶個人檔案API開發人員指南 。 尤其是,「描述檔開 發人員指南 」的「快速入門」區段包含相關主題的連結、閱讀本檔案中範例API呼叫的指南,以及成功呼叫任何Experience Platform API所需之必要標題的重要資訊。

檢視刪除請求

刪除請求是長時間執行的非同步程式,這表示您的組織可能同時執行多個刪除請求。 為了查看您的組織當前正在運行的所有刪除請求,您可以對端點執行GET請 /system/jobs 求。
您也可以使用選用的查詢參數來篩選回應中傳回的刪除請求清單。 若要使用多個參數,請使用&符號(&)分隔每個參數。
API格式
GET /system/jobs
GET /system/jobs?{QUERY_PARAMETERS}

參數
說明
start
依照請求的建立時間,偏移傳回的結果頁面。 範例: start=4
limit
限制傳回的結果數。 範例: limit=10
page
依照請求的建立時間傳回特定的結果頁面。 範例: page=2
sort
依特定欄位的升序( asc )或降序( desc )排序結果。 傳回多頁結果時,排序參數無法運作。 範例: sort=batchId:asc
請求
curl -X POST \
  https://platform.adobe.io/data/core/ups/system/jobs \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

回應
回應包含「子系」陣列,每個刪除請求都包含該請求的詳細資料的物件。
{
  "_page": {
    "count": 100,
    "next": "K1JJRDpFaWc5QUwyZFgtMEpBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQVFBQWZBQUg0Ly9yL25PcmpmZndEZUR3QT0="
  },
  "children": [
    {
      "id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
      "imsOrgId": "{IMS_ORG}",
      "batchId": "8d075b5a178e48389126b9289dcfd0ac",
      "jobType": "DELETE",
      "status": "COMPLETED",
      "metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
      "createEpoch": 1559026134,
      "updateEpoch": 1559026137
    },
    {
      "id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
      "imsOrgId": "{IMS_ORG}",
      "dataSetId": "5c802d3cd83fc114b741c4b5",
      "jobType": "DELETE",
      "status": "PROCESSING",
      "metrics": "{\"recordsProcessed\":0,\"timeTakenInSec\":15}",
      "createEpoch": 1559025404,
      "updateEpoch": 1559025406
    }
  ]
}

屬性
說明
_page.count
請求總數。 此回應已針對空間截斷。
_page.next
如果有其他結果頁面存在,請以提供的「下一頁」值取代查 閱請求中的ID值 ,以檢視下一頁結果。
jobType
要建立的作業類型。 在這種情況下,它將始終返回"DELETE"。
狀態
刪除請求的狀態。 可能的值為「新」、「處理」、「已完成」、「錯誤」。
度量
包含已處理的記錄數(「recordsProcessed」)和請求已處理的時間(以秒為單位),或請求完成所需的時間(「timeTakenInSec」)的物件。

建立刪除請求

啟始新刪除請求是透過對端點的POST請求完成的, /systems/jobs 其中,要刪除的資料集或批次的ID在請求的正文中提供。

刪除資料集

若要刪除資料集,資料集ID必須包含在POST請求的正文中。 此動作會刪除指定資料集的ALL資料。 Experience Platform可讓您根據記錄和時間系列結構描述來刪除資料集。
嘗試使用Experience Platform UI刪除啟用設定檔的資料集時,資料集會因擷取而停用,但是在使用API建立刪除請求後,才會刪除。 如需詳細資訊,請參 閱本文 件附錄。
API格式
POST /system/jobs

請求
curl -X POST \
  https://platform.adobe.io/data/core/ups/system/jobs \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "dataSetId": "5c802d3cd83fc114b741c4b5"
      }'

屬性
說明
dataSetId
(必要) ,您要刪除的資料集ID。
回應
成功的回應會傳回新建立之刪除要求的詳細資料,包括要求的唯一、系統產生的唯讀ID。 這可用來查詢請求並檢查其狀態。 在 status 建立請求時,請求會一直保留到 "NEW" 開始處理為止。 回 dataSetId 應中的應符合在請 dataSetId 求中傳送的。
{
    "id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
    "imsOrgId": "{IMS_ORG}",
    "dataSetId": "5c802d3cd83fc114b741c4b5",
    "jobType": "DELETE",
    "status": "NEW",
    "createEpoch": 1559025404,
    "updateEpoch": 1559025406
}

屬性
說明
id
刪除請求的唯一、系統產生的唯讀ID。
dataSetId
資料集的ID,如POST請求中所指定。

刪除批

若要刪除批,批ID必須包含在POST請求的正文中。 請注意,不能根據記錄結構描述刪除資料集的批處理。 只能刪除基於時間系列方案的資料集的批處理。
無法根據記錄結構描述刪除資料集的批的原因是,記錄類型資料集批會覆蓋以前的記錄,因此無法「撤消」或刪除。 基於記錄結構描述的資料集刪除錯誤批處理的影響的唯一方法是使用正確的資料重新生成批處理,以覆蓋錯誤的記錄。
有關記錄和時間序列行為的詳細資訊,請參閱「XDM 系統概述」中有關XDM資料行為 的一節。
API格式
POST /system/jobs

請求
curl -X POST \
  https://platform.adobe.io/data/core/ups/system/jobs \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
       "batchId": "8d075b5a178e48389126b9289dcfd0ac"
      }'

屬性
說明
batchId
(必要) ,您要刪除的批次ID。
回應
成功的回應會傳回新建立之刪除要求的詳細資料,包括要求的唯一、系統產生的唯讀ID。 這可用來查詢請求並檢查其狀態。 在建立請求時,請求的「狀態」為「新」,直到開始處理為止。 回應中的"batchId"應與請求中傳送的"batchId"相符。
{
    "id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
    "imsOrgId": "{IMS_ORG}",
    "batchId": "8d075b5a178e48389126b9289dcfd0ac",
    "jobType": "DELETE",
    "status": "NEW",
    "createEpoch": 1559026131,
    "updateEpoch": 1559026132
}

屬性
說明
id
刪除請求的唯一、系統產生的唯讀ID。
batchId
批次的ID,如POST請求中所指定。
如果您嘗試為記錄資料集批次啟動刪除請求,將會遇到400級錯誤,類似下列:
{
    "requestId": "bc4eb29f-63a8-4653-9133-71238884bb81",
    "errors": {
        "400": [
            {
                "code": "500",
                "message": "Batch can only be specified for EE type 'a294e36d382649dab2cc6ad64a41b674'"
            }
        ]
    }
}

檢視特定的刪除要求

若要檢視特定的刪除請求,包括詳細資訊(例如其狀態),您可以對端點執行查閱(GET)請求,並在路徑中包含刪除請求的 /system/jobs ID。
API格式
GET /system/jobs/{DELETE_REQUEST_ID}

參數
說明
(必要) ,您要檢視的刪除請求ID。
請求
curl -X POST \
  https://platform.adobe.io/data/core/ups/system/jobs/9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

回應
回應會提供刪除請求的詳細資訊,包括其更新狀態。 回應中刪除請求的ID應與請求路徑中傳送的ID相符。
{
    "id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
    "imsOrgId": "{IMS_ORG}",
    "batchId": "8d075b5a178e48389126b9289dcfd0ac",
    "jobType": "DELETE",
    "status": "COMPLETED",
    "metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
    "createEpoch": 1559026134,
    "updateEpoch": 1559026137
}

屬性
說明
jobType
所建立作業的類型,在這種情況下,它將始終返回"DELETE"。
狀態
刪除請求的狀態。 可能的值:「新」、「處理」、「完成」、「錯誤」。
度量
一個陣列,包含已處理的記錄數(「recordsProcessed」)和請求已處理的時間(以秒為單位),或請求完成所需的時間(「timeTakenInSec」)。
刪除請求狀態為「已完成」後,您可以嘗試使用資料存取API存取已刪除的資料,以確認資料已刪除。 有關如何使用Data Access API存取資料集和批次的指示,請參閱 Data Access檔案

刪除刪除請求

Experience Platform可讓您刪除先前的請求,這在許多原因(包括刪除工作未完成或在處理階段卡住)中可能很有用。 為了刪除刪除請求,您可以對端點執行DELETE請求,並包括 /system/jobs 要刪除到請求路徑的刪除請求的ID。
API格式
DELETE /system/jobs/{DELETE_REQUEST_ID}

參數
說明
您要移除的刪除請求ID。
請求
curl -X POST \
  https://platform.adobe.io/data/core/ups/system/jobs/9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

回應
成功的刪除請求會傳回HTTP狀態200(確定)和空回應主體。 您可以執行GET請求以依其ID檢視刪除請求,以確認刪除請求。 這應該會傳回HTTP狀態404(找不到),表示刪除請求已移除。

後續步驟

現在,您知道從Experience Platform的Profile Store刪除資料集和批次時涉及的步驟,因此您可以安全地刪除已錯誤添加或您的組織不再需要的資料。 請注意,刪除請求無法撤消,因此您只應刪除您確信現在不需要且將來不需要的資料。

附錄

下列資訊是從描述檔儲存區刪除資料集動作的補充。

使用Experience Platform UI刪除資料集

當使用Experience Platform使用者介面刪除已啟用設定檔的資料集時,會開啟對話方塊詢問「您確定要從Experience Data Lake刪除此資料集嗎? 使用'profile systems jobs' API從Profile Service刪除此資料集。"
按一 下UI中的 「刪除」會停用擷取資料集,但「不」會自動刪除後端的資料集。 若要永久刪除資料集,必須使用本指南中建立刪除請求的步驟手動 建立刪除請求
下圖顯示嘗試使用UI刪除啟用設定檔的資料集時的警告。
有關使用資料集的詳細資訊,請首先閱讀資料集 概述