從特徵群組中刪除記錄

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

您可以透過 Amazon SageMaker Feature Store API 從特徵群組中刪除記錄。特徵群組是包含機器學習 (ML) 資料的物件，其中資料欄由特徵描述，而您的資料則包含在記錄中。記錄包含與特定記錄識別符相關聯的特徵值。

特徵群組有兩種儲存組態：線上儲存和離線儲存。線上儲存只會保留最新事件時間的記錄，通常用於機器學習 (ML) 推論的即時查詢。離線儲存會保留所有記錄，並做為歷史資料庫，通常用於特徵探索、機器學習 (ML) 訓練和批次推論。

若要取得有關特徵商店概念的更多資訊，請參閱擷取圖。

有兩種方法可以從特徵群組中刪除記錄，並且行為會根據儲存組態而有所不同。在下列主題中，我們將說明如何從線上和離線儲存軟刪除和硬刪除記錄，並提供範例。

從線上儲存刪除記錄

您可以使用 DeletionMode 要求參數來指定 SoftDelete (預設) 或 HardDelete，以便使用 DeleteRecord API 從線上儲存中軟刪除或實硬刪除記錄。如需 DeleteRecord API 的詳細資訊，請參閱 Amazon SageMaker API 參考中的 DeleteRecord。

使用線上儲存：

在這兩種情況下，特徵商店都會將已刪除的記錄標記附加至 OfflineStore。刪除的記錄標記是與原始記錄 RecordIdentifer 相同的記錄，但 is_deleted 值設定為 True，EventTime 設定為刪除輸入 EventTime，其他特徵值設定為 null。

請注意，在 DeleteRecord 中指定的 EventTime 應設定晚於相同 RecordIdentifer 的 OnlineStore 記錄中的現有記錄的 EventTime。如果不這樣設定，則不會發生刪除：

下列範例會使用適用於 Python 的 SDK (Boto3) delete_record 操作來刪除特徵群組中的記錄。若要從特徵群組中刪除記錄，您將需要：

線上儲存軟刪除範例

對於軟刪除，您將需要使用 DeleteRecord API，並且可以使用預設 DeletionMode 或將 DeletionMode 設定為 SoftDelete。

import boto3
client = boto3.client('sagemaker-featurestore-runtime')

client.delete_record(
    FeatureGroupName='feature-group-name',
    RecordIdentifierValueAsString='record-identifier-value',
    EventTime='deletion-event-time',
    TargetStores=[
        'OnlineStore',
    ],
    DeletionMode='SoftDelete'
)

線上儲存硬刪除範例

對於硬刪除，您需要使用 DeleteRecord API 並將 DeletionMode 設定為 HardDelete。

import boto3
client = boto3.client('sagemaker-featurestore-runtime')

client.delete_record(
    FeatureGroupName='feature-group-name',
    RecordIdentifierValueAsString='record-identifier-value',
    EventTime='deletion-event-timestamp',
    TargetStores=[
        'OnlineStore',
    ],
    DeletionMode='HardDelete'
)

從離線儲存刪除記錄

您可以使用 Amazon SageMaker Feature Store，OfflineStore Iceberg 資料表格式軟刪除和硬刪除記錄。使用 OfflineStore Iceberg 資料表格式：

取得您的 Iceberg 資料表名稱

要從 OfflineStore Iceberg 資料表中軟刪除，您需要取得您的 Iceberg 資料表名稱 iceberg-table-name。以下指示假設您已使用 Feature Store，使用 Iceberg 資料表格式 DisableGlueTableCreation = False (預設) 透過離線儲存儲存組態來建立特徵群組。如需建立特徵群組的詳細資訊，請參閱開始使用 Amazon SageMaker Feature Store。

若要取得您的 iceberg-table-name，請使用 DescribeFeatureGroup API 來取得 DataCatalogConfig。這包含 Glue 資料表的中繼資料，作為 OfflineStore 的資料型錄。DataCatalogConfig 中的 TableName 是您的 iceberg-table-name。

Amazon Athena 離線儲存軟刪除和硬刪除範例

以下指示如何使用 Amazon Athena 進行軟刪除，然後從 OfflineStore Iceberg 資料表中硬刪除記錄。這假設您要在 OfflineStore 中刪除的記錄是已刪除的記錄標記。如需有關 OfflineStore 中已刪除記錄標記的資訊，請參閱從線上儲存刪除記錄。

Apache Spark 離線儲存軟刪除和硬刪除範例

使用 Apache Spark 從 OfflineStore 中軟刪除記錄，然後再硬刪除記錄，您可以按照如上 Amazon Athena 離線儲存軟刪除和硬刪除範例 中的相同指示操作，但請使用 Spark 程序。如需程序的完整清單，請參閱 Apache Iceberg 文件中的 Spark 程序。