使用資料生命週期 - Tablestore

資料生命週期（Time To Live，簡稱TTL）是多元索引的一個屬性，即資料的儲存時間。多元索引會自動清理超過儲存時間的資料，減少使用者的資料存放區空間，降低儲存成本。

注意事項

使用生命週期管理功能，必須禁用資料表的UpdateRow更新寫入功能，避免一些語義上的問題：
由於資料表TTL是屬性列層級生效的，而多元索引TTL是整行生效的，如果存在UpdateRow寫入操作，當系統清理資料表中資料時，資料表中部分欄位值已刪除而部分欄位值未刪除，但是多元索引中整行資料均未刪除，則會造成資料表和多元索引中的資料不一致。
如果業務有UpdateRow更新寫入操作，請查看是否能改為PutRow覆蓋寫入操作。
多元索引的TTL取值範圍為-1或者int32的正整數（單位為秒），其中-1表示永久儲存，int32最大值換算為年大約為68年。
多元索引的TTL和資料表的TTL是獨立的，多元索引的TTL值必須小於或等於資料表的TTL值。當需要同時調小多元索引TTL和資料表TTL時，請先調整多元索引TTL，再調整資料表TTL。
多元索引每天會自動清理已到期的資料，到期資料的清理粒度為“天”，因此您仍然可以查詢到某一時刻已到期但是還未及時清理的資料，多元索引會在下一次清理到期資料時自動清理這些到期資料。
資料表和多元索引的TTL更新後，系統會在下一次清理到期資料時自動清理資料表和多元索引中的存量到期資料。

使用方式

通過控制台或者SDK設定多元索引生命週期。使用多元索引生命週期，您必須始終保持資料表UpdateRow更新寫入操作為禁止狀態。

使用控制台

禁用資料表UpdateRow更新寫入操作。
1. 在資料表的基本詳情頁簽，單擊修改表屬性。
2. 在修改表屬性對話方塊，設定是否允許更新為否並選中風險提示資訊，然後單擊確定。
設定多元索引生命週期。
禁用資料表UpdateRow更新寫入操作後，您可以在建立多元索引時指定TTL或為已有多元索引指定TTL。
建立多元索引時指定TTL
1. 在資料表的索引管理頁簽，單擊建立多元索引。
2. 在建立索引對話方塊，設定索引名和資料生命週期和Schema產生方式。
3. 開啟進階選項開關後，設定資料生命週期，單擊確定。
為已有多元索引指定TTL
1. 在資料表的索引管理頁簽，單擊目標多元索引操作列的索引詳情。
2. 在索引詳情對話方塊，單擊表徵圖，修改資料生命週期，然後單擊修改ttl。
多元索引的TTL和資料表的TTL是獨立的。如果需要使用資料表TTL，請為資料表設定TTL。
1. 在資料表的基本詳情頁簽中基本資料地區，單擊修改表屬性。
2. 在修改表屬性對話方塊，根據需要設定資料生命週期，然後單擊確定。

使用SDK

您可以通過Java SDK或者Go SDK使用生命週期管理。此處以Java SDK為例介紹資料生命週期的管理。

禁用資料表UpdateRow更新寫入操作。

以下樣本用于禁用資料表的UpdateRow更新寫入操作。

public static void disableTableUpdate(SyncClient client) {
    UpdateTableRequest updateTableRequest = new UpdateTableRequest("<TABLE_NAME>");
    TableOptions options = new TableOptions();
    // 禁用資料表UpdateRow更新寫入操作，請確保資料表無UpdateRow寫入操作，避免影響業務。
    options.setAllowUpdate(false);
    updateTableRequest.setTableOptionsForUpdate(options);
    client.updateTable(updateTableRequest);
}

設定多元索引生命週期。

禁用資料表UpdateRow更新寫入操作後，您可以在建立多元索引時指定TTL或者為已有多元索引指定TTL。

建立多元索引時指定TTL

以下樣本用於建立一個多元索引，多元索引包含Col_Keyword和Col_Long兩列，類型分別設定為字串（String）和整型（Long）。同時指定多元索引生命週期為7天。

// 請使用5.12.0及以上版本的Java SDK。
public static void createIndexWithTTL(SyncClient client) {
    int days = 7;
    CreateSearchIndexRequest createRequest = new CreateSearchIndexRequest();
    //設定資料表名稱。
    createRequest.setTableName("<TABLE_NAME>");
    //設定多元索引名稱。
    createRequest.setIndexName("<SEARCH_INDEX_NAME>");
    IndexSchema indexSchema = new IndexSchema();
    indexSchema.setFieldSchemas(Arrays.asList(
            //設定欄位名和類型。
            new FieldSchema("Col_Keyword", FieldType.KEYWORD), 
            new FieldSchema("Col_Long", FieldType.LONG)));
    createRequest.setIndexSchema(indexSchema);
    //設定多元索引TTL。
    createRequest.setTimeToLiveInDays(days);
    //調用client建立多元索引。
    client.createSearchIndex(createRequest);
}

為已有多元索引指定TTL

以下樣本用於指定已有多元索引的生命週期為7天。

// 請使用5.12.0及以上版本的Java SDK。
public static void updateIndexWithTTL(SyncClient client) {
    int days = 7;
    UpdateSearchIndexRequest updateSearchIndexRequest = new UpdateSearchIndexRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>");
    // 更新多元索引TTL。
    updateSearchIndexRequest.setTimeToLiveInDays(days);
    client.updateSearchIndex(updateSearchIndexRequest);
}

多元索引的TTL和資料表的TTL是獨立的。如果需要使用資料表TTL，請為資料表設定TTL。

以下樣本用於指定資料表的生命週期為7天。

public static void updateTableTTL(SyncClient client) {
    int days = 7;
    UpdateTableRequest updateTableRequest = new UpdateTableRequest("<TABLE_NAME>");
    TableOptions options = new TableOptions();
    options.setTimeToLiveInDays(days);
    updateTableRequest.setTableOptionsForUpdate(options);
    client.updateTable(updateTableRequest);
}