使用TTL管理資料湖中的體驗事件資料集保留

高效的資料管理對於最佳效能、成本控制及資料完整性至關重要。 使用體驗事件資料集保留存留時間(TTL)強制執行列層級的有效期，自動從資料湖的資料集中移除過時的記錄，同時確保最佳儲存效率和資料關聯性。

本指南說明如何使用目錄服務API來評估、設定和管理TTL。 您將瞭解何時及為何套用TTL、如何使用API呼叫設定和更新TTL值，以及確保有效實施的最佳實務。

為何使用TTL進行列層級資料管理

隨著資料整合長，有效率的資料管理對於保留效能、控制成本以及維持資料相關性的重要性日益提高。 TTL型資料列層級資料到期會移除過時的記錄，自動進行資料清理，無需手動介入，以協助最佳化儲存空間並提升系統效率。

TTL在管理時效性資料時會很有用，因為這類資料會隨著時間推移而失去相關性。 如果您有以下需要，請考慮實作TTL：

使用TTL設定，根據許可權最佳化儲存空間。 雖然在Real-Time CDP中使用的設定檔存放區資料可能會被視為過時，並在30天後移除，但針對分析和資料Distiller使用案例，資料湖中的相同事件資料仍可在12至13個月內可用（或更久則根據權益）。

行業範例 industry-example

例如，考慮使用視訊串流服務來追蹤使用者互動，例如視訊檢視、搜尋和推薦。 雖然最近的參與資料對個人化至關重要，但較舊的活動記錄（例如一年前的互動）會失去相關性。 透過使用列層級的有效期，Experience Platform會自動移除過時的記錄，確保只有目前且有意義的資料才會用於分析和建議。

評估TTL適用性 evaluate-ttl-suitability

在套用保留原則之前，請評估您的資料集是否適合列層級的有效期。 請考量下列事項：

如果歷史記錄對長期分析或業務營運至關重要，則TTL可能不是正確的方法。 檢閱這些因素，可確保TTL符合您的資料保留需求，而不會對資料可用性造成負面影響。

設定TTL的最佳實務 best-practices

選取正確的TTL值，以確保您的體驗事件資料集保留原則可平衡資料保留、儲存效率和分析需求。 太短的TTL可能會導致資料遺失，而太長的TTL可能會增加儲存成本及不必要的資料累積。 考量資料被存取的頻率以及資料的相關性維持多久，確保TTL符合資料集的用途。

下表根據資料集型別和使用模式提供常見的TTL建議：

請定期檢閱TTL設定，以確保其持續符合您的儲存原則、分析需求及業務需求。

設定TTL時的主要考量事項 key-considerations

請遵循下列最佳實務，以確保TTL設定符合您的資料保留策略：

TTL的限制 limitations

使用TTL時，請注意下列限制：

在套用TTL之前分析資料集大小和關聯性 analyze-dataset-size

在套用TTL之前，請使用查詢來分析資料集大小和關聯性。 執行目標查詢（例如計算特定日期範圍內的記錄數）以預覽各種TTL值的影響。 然後使用此資訊來選擇最佳保留期間，以平衡資料公用程式與成本效益。

執行目標查詢可協助判斷在不同TTL設定下會保留或移除多少資料。 例如，下列SQL查詢會計算過去30天內建立的記錄數：

SELECT COUNT(1) FROM [datasetName] WHERE timestamp > date_sub(now(), INTERVAL 30 DAY);

針對不同的時間間隔執行類似的查詢有助於驗證TTL設定，並確保它們在儲存效率和資料可存取性之間取得平衡。

開始使用TTL管理

您必須先瞭解如何正確格式化請求，才能使用目錄服務API評估、設定及管理體驗事件資料集保留。 這包括瞭解API路徑、提供必要的標頭以及格式化要求承載。 如需此重要資訊，請參閱目錄服務API快速入門手冊。

檢查您的TTL限制 check-ttl-constraints

使用資料衛生API /ttl/{DATASET_ID}端點協助規劃TTL設定。 此端點會傳回貴組織支援的最小TTL值和最大TTL值，以及資料集型別的建議值(defaultValue)。

如需詳細資訊，請參閱Adobe Developer 資料衛生API檔案。

若要檢查目前套用至資料集的TTL，請改為向目錄服務API /dataSets/{DATASET_ID}端點發出GET要求。

API格式

GET /ttl/{DATASET_ID}

要求

以下請求會擷取貴組織特定資料集的TTL限制。

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/ttl/{DATASET_ID}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -H 'x-sandbox-id: {SANDBOX_ID}'

回應

成功的回應會根據您組織的權益，傳回建議、最大和最小TTL值，以及資料集的建議TTL (defaultValue)。 此defaultValue為建議的TTL期間，僅供指引使用。 除非您明確設定，否則不會套用它。 回應不包含任何可能已設定的自訂TTL值。 若要檢視資料集的目前TTL，請使用GET /catalog/dataSets/{DATASET_ID}端點。

{
  "extensions": {
    "adobe_lakeHouse": {
      "rowExpiration": {
        "defaultValue": "P12M",
        "maxValue": "P12M",
        "minValue": "P7D"
      }
    }
  }
}

如何檢查套用的TTL值 check-applied-ttl-values

若要檢查已套用至資料集的目前TTL值，請使用以下API呼叫：

GET /dataSets/{DATASET_ID}

此呼叫傳回ttlValue區段中目前的extensions.adobe_lakeHouse.rowExpiration （如果已設定）。

要求

以下請求會擷取貴組織特定資料集的TTL值。

curl -X GET \
https://platform.adobe.io/data/foundation/catalog/dataSets/{DATASET_ID} \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應包含extensions物件，其中包含套用至資料集的目前TTL組態。 為了簡短起見，下面的回應範例會遭截斷。

{
    "{DATASET_ID}": {
        "name": "Acme Sales Data",
        "description": "This dataset contains sales transaction records for Acme Corporation.",
        "imsOrg": "{ORG_ID}",
        "sandboxId": "{SANDBOX_ID}",
        "extensions": {
            "adobe_lakeHouse": {
            "rowExpiration": {
                "ttlValue": "P3M",
            }
            }
        }
        ...
    }
}

設定或更新資料集的TTL set-update-ttl

您可以設定新的TTL或使用相同的API方法更新現有的TTL，以設定體驗事件資料集保留。 使用PATCH要求至/v2/datasets/{DATASET_ID}端點以套用或調整TTL。

API格式

PATCH /v2/datasets/{DATASET_ID}

要求

在下列範例中，ttlValue設定為P3M。 這表示超過三個月的記錄會自動刪除。 調整保留期間以符合您的業務需求（例如，P6M為六個月，P12M為一年）。

curl -X PATCH \
  'https://platform.adobe.io/data/foundation/catalog/v2/datasets/{DATASET_ID}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
    "extensions": {
        "adobe_lakeHouse": {
            "rowExpiration": {
                "ttlValue": "P3M"  // A 3 month retention period
            }
        }
    }
}

回應

成功的回應會傳回已更新資料集的參考，但不會明確包含TTL設定。 若要確認TTL設定，請進行後續的GET /dataSets/{DATASET_ID}要求。

[
  "@/dataSets/{DATASET_ID}"
]

範例情境 example-scenario

考慮使用影片串流平台，該平台最初將TTL設定為三個月，以確保個人化有全新的參與資料。 不過，如果後續分析顯示較舊的互動仍可提供有價值的深入分析，則提出下列請求後，TTL可延長至6個月：

curl -X PATCH \
  'https://platform.adobe.io/data/foundation/catalog/v2/datasets/{DATASET_ID}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
    "extensions": {
        "adobe_lakeHouse": {
            "rowExpiration": {
                "ttlValue": "P6M"  // Extend to 6 months
            }
        }
    }
}

資料集保留原則常見問題集 faqs

此常見問題集涵蓋資料集保留工作、TTL變更的立即影響、復原選項，以及不同Platform服務的保留期間差異等實務問題。

我可以套用保留原則規則到哪些型別的資料集？

資料集保留工作多久會從Data Lake服務中刪除資料？

我可以為資料湖和設定檔服務設定不同的保留原則嗎？

如何檢查我目前的資料集使用情形？

如何驗證資料保留工作是否成功？

我可以復原已刪除的資料嗎？

我可以在資料湖體驗事件資料集上設定的最低TTL是多少？

如果需要保留某些Data Lake欄位的時間超過TTL原則所允許的時間，該怎麼辦？

後續步驟 next-steps

現在您已瞭解如何管理列層級到期的TTL設定，請檢閱下列檔案以進一步瞭解TTL管理：