本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon Keyspaces 的存留時間 (TTL) 過期資料 （適用於 Apache Cassandra)
Amazon Keyspaces （適用於 Apache Cassandra) 存留時間 (TTL) 可協助您簡化應用程式邏輯，並透過自動從資料表中過期資料來最佳化儲存體的價格。您不再需要的資料會根據您設定的存留時間值，自動從資料表中刪除。
這可讓您更輕鬆地根據業務、產業或法規要求遵循資料保留政策，以定義資料需要保留多久，或指定何時必須刪除資料。
例如，您可以在 AdTech 應用程式中使用 TTL 來排程特定廣告的資料過期且用戶端不再可見的時間。您也可以使用 TTL 自動淘汰較舊的資料，並節省儲存成本。
您可以為整個資料表設定預設 TTL 值，並覆寫個別資料列和資料欄的該值。TTL 操作不會影響您應用程式的效能。此外，標記為 TTL 過期的資料列和資料欄數量不會影響您資料表的可用性。
Amazon Keyspaces 會自動篩選掉過期的資料，這樣就不會在查詢結果中傳回過期的資料，或可用於資料處理語言 (DML) 陳述式。Amazon Keyspaces 通常會在過期日期的 10 天內從儲存中刪除過期的資料。
在極少數情況下，如果基礎儲存分割區上有持續的活動來保護可用性，Amazon Keyspaces 可能無法在 10 天內刪除資料。在這些情況下，當分割區上的流量減少時，Amazon Keyspaces 會繼續嘗試刪除過期的資料。
從儲存體中永久刪除資料後，您會停止產生儲存費用。
您可以使用主控台、Cassandra 查詢語言 (CQL) 或 來設定、修改或停用新資料表和現有資料表的預設 TTL 設定 AWS CLI。
在已設定預設 TTL 的資料表上，您可以使用 CQL 陳述式覆寫資料表的預設 TTL 設定，並將自訂 TTL 值套用至資料列和資料欄。如需詳細資訊，請參閱[使用 `INSERT`陳述式來設定新資料列的自訂存留時間 (TTL) 值](TTL-how-to-insert-cql.md)及[使用 `UPDATE`陳述式來編輯資料列和資料欄的自訂存留時間 (TTL) 設定](TTL-how-to-update-cql.md)。
TTL 定價是根據使用存留時間刪除或更新的資料列大小。TTL 操作的計量單位為 `TTL deletes`。刪除或更新的每列每 KB 資料會耗用一個 TTL 刪除。
例如，若要更新儲存 2.5 KB 資料的資料列，並同時刪除資料列中的一或多個資料欄，需要刪除三個 TTL。或者，若要刪除包含 3.5 KB 資料的整個資料列，需要刪除四個 TTL。
每列每 KB 的已刪除資料會耗用一個 TTL 刪除。如需定價的詳細資訊，請參閱 [Amazon Keyspaces （適用於 Apache Cassandra) 定價](https://aws.amazon.com/keyspaces/pricing)。
**Topics**
+ [
## Amazon Keyspaces 存留時間以及與 AWS 服務的整合
](#ttl-howitworks_integration)
+ [
# 使用預設存留時間 (TTL) 設定建立新的資料表
](TTL-how-to-create-table.md)
+ [
# 更新資料表的預設存留時間 (TTL) 值
](TTL-how-to-update-default.md)
+ [
# 建立已啟用自訂存留時間 (TTL) 設定的資料表
](TTL-how-to-enable-custom-new.md)
+ [
# 使用自訂存留時間 (TTL) 更新資料表
](TTL-how-to-enable-custom-alter.md)
+ [
# 使用 `INSERT`陳述式來設定新資料列的自訂存留時間 (TTL) 值
](TTL-how-to-insert-cql.md)
+ [
# 使用 `UPDATE`陳述式來編輯資料列和資料欄的自訂存留時間 (TTL) 設定
](TTL-how-to-update-cql.md)
## Amazon Keyspaces 存留時間以及與 AWS 服務的整合
下列 TTL 指標可在 Amazon CloudWatch 中使用，以啟用持續監控。
+ `TTLDeletes` – 使用存留時間 (TTL) 刪除或更新資料的資料所消耗的單位。
如需如何監控 CloudWatch 指標的詳細資訊，請參閱 [使用 Amazon CloudWatch 監控 Amazon Keyspaces](monitoring-cloudwatch.md)。
使用 時 CloudFormation，您可以在建立 Amazon Keyspaces 資料表時開啟 TTL。如需詳細資訊，請參閱[「AWS CloudFormation 使用者指南」](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cassandra-table.html)。
# 使用預設存留時間 (TTL) 設定建立新的資料表
在 Amazon Keyspaces 中，您可以為建立資料表時資料表中的所有資料列設定預設 TTL 值。
資料表的預設 TTL 值為零，這表示資料不會自動過期。如果資料表的預設 TTL 值大於零，則會將過期時間戳記新增至每一列。
TTL 值以秒為單位設定，最大可設定值為 630，720，000 秒，相當於 20 年。
建立資料表後，您可以使用 CQL DML 陳述式覆寫特定資料列或資料欄的資料表預設 TTL 設定。如需詳細資訊，請參閱[使用 `INSERT`陳述式來設定新資料列的自訂存留時間 (TTL) 值](TTL-how-to-insert-cql.md)及[使用 `UPDATE`陳述式來編輯資料列和資料欄的自訂存留時間 (TTL) 設定](TTL-how-to-update-cql.md)。
當您在資料表上啟用 TTL 時，Amazon Keyspaces 會開始儲存每個資料列的其他 TTL 相關中繼資料。此外，TTL 會使用過期時間戳記來追蹤資料列或資料欄何時過期。時間戳記會儲存為資料列中繼資料，並造成資料列的儲存成本。
啟用 TTL 功能之後，您就無法停用資料表的 TTL 功能。將資料表`default_time_to_live`設為 0 會停用新資料的預設過期時間，但不會停用 TTL 功能，或將資料表還原為原始 Amazon Keyspaces 儲存中繼資料或寫入行為。
下列範例示範如何使用預設 TTL 值建立新的資料表。
------
#### [ Console ]
**使用主控台建立具有存留時間預設值的新資料表。**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。
1. 在導覽窗格中，選擇 **Tables** (資料表)，然後選擇 **Create table** (建立資料表)。
1. 在**資料表詳細資訊區段的建立**資料表頁面上，選取金鑰空間，並提供新資料表的名稱。 ****
1. 在**結構描述**區段中，建立資料表的結構描述。
1. 在**資料表設定**區段中，選擇**自訂設定**。
1. 繼續執行**存留時間 (TTL)**。
在此步驟中，您會選取資料表的預設 TTL 設定。
針對**預設 TTL 期間**，輸入過期時間，然後選擇您輸入的時間單位，例如秒、天或年。Amazon Keyspaces 會以秒為單位存放值。
1. 選擇 **Create Table** (建立資料表)。您的資料表會以指定的預設 TTL 值建立。
------
#### [ Cassandra Query Language (CQL) ]
**使用 CQL 建立具有預設 TTL 值的新資料表**
1. 下列陳述式會建立新的資料表，並將預設 TTL 值設為 3，024，000 秒，代表 35 天。
```
CREATE TABLE my_table (
userid uuid,
time timeuuid,
subject text,
body text,
user inet,
PRIMARY KEY (userid, time)
) WITH default_time_to_live = 3024000;
```
1. 若要確認新資料表的 TTL 設定，請使用 `cqlsh``DESCRIBE`陳述式，如下列範例所示。輸出會將資料表的預設 TTL 設定顯示為 `default_time_to_live`。
```
DESC TABLE my_table;
```
```
CREATE TABLE my_keyspace.my_table (
userid uuid,
time timeuuid,
body text,
subject text,
user inet,
PRIMARY KEY (userid, time)
) WITH CLUSTERING ORDER BY (time ASC)
AND bloom_filter_fp_chance = 0.01
AND caching = {'class': 'com.amazonaws.cassandra.DefaultCaching'}
AND comment = ''
AND compaction = {'class': 'com.amazonaws.cassandra.DefaultCompaction'}
AND compression = {'class': 'com.amazonaws.cassandra.DefaultCompression'}
AND crc_check_chance = 1.0
AND dclocal_read_repair_chance = 0.0
AND default_time_to_live = 3024000
AND gc_grace_seconds = 7776000
AND max_index_interval = 2048
AND memtable_flush_period_in_ms = 3600000
AND min_index_interval = 128
AND read_repair_chance = 0.0
AND speculative_retry = '99PERCENTILE';
```
------
#### [ CLI ]
**使用 建立具有預設 TTL 值的新資料表 AWS CLI**
1. 您可以使用下列命令來建立新的資料表，並將預設 TTL 值設為一年。
```
aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable' \
--schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' \
--default-time-to-live '31536000'
```
1. 若要確認資料表的 TTL 狀態，您可以使用下列命令。
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
命令的輸出看起來與下列範例類似
```
{
"keyspaceName": "myKeyspace",
"tableName": "myTable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable",
"creationTimestamp": "2024-09-02T10:52:22.190000+00:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "id",
"type": "int"
},
{
"name": "date",
"type": "timestamp"
},
{
"name": "name",
"type": "text"
}
],
"partitionKeys": [
{
"name": "id"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2024-09-02T10:52:22.190000+00:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "DISABLED"
},
"ttl": {
"status": "ENABLED"
},
"defaultTimeToLive": 31536000,
"comment": {
"message": ""
},
"replicaSpecifications": []
}
```
------
# 更新資料表的預設存留時間 (TTL) 值
您可以使用新的預設 TTL 值更新現有的資料表。TTL 值以秒為單位設定，最大可設定值為 630，720，000 秒，相當於 20 年。
當您在資料表上啟用 TTL 時，Amazon Keyspaces 會開始儲存每個資料列的其他 TTL 相關中繼資料。此外，TTL 會使用過期時間戳記來追蹤資料列或資料欄何時過期。時間戳記會儲存為資料列中繼資料，並造成資料列的儲存成本。
資料表啟用 TTL 後，您可以使用 CQL DML 陳述式覆寫特定資料列或資料欄的資料表預設 TTL 設定。如需詳細資訊，請參閱[使用 `INSERT`陳述式來設定新資料列的自訂存留時間 (TTL) 值](TTL-how-to-insert-cql.md)及[使用 `UPDATE`陳述式來編輯資料列和資料欄的自訂存留時間 (TTL) 設定](TTL-how-to-update-cql.md)。
啟用 TTL 功能之後，您就無法停用資料表的 TTL 功能。將資料表`default_time_to_live`設為 0 會停用新資料的預設過期時間，但不會停用 TTL 功能，或將資料表還原為原始 Amazon Keyspaces 儲存中繼資料或寫入行為。
請依照下列步驟，使用主控台、CQL 或 更新現有資料表的預設存留時間設定 AWS CLI。
------
#### [ Console ]
**使用主控台更新資料表的預設 TTL 值**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。
1. 選擇您要更新的資料表，然後選擇**其他設定**索引標籤。
1. 繼續執行**存留時間 (TTL)**，然後選擇**編輯**。
1. 針對**預設 TTL 期間**，輸入過期時間，然後選擇時間單位，例如秒、天或年。Amazon Keyspaces 會以秒為單位存放值。這不會變更現有資料列的 TTL 值。
1. 定義 TTL 設定時，選擇**儲存變更**。
------
#### [ Cassandra Query Language (CQL) ]
**使用 CQL 更新資料表的預設 TTL 值**
1. 您可以使用 `ALTER TABLE` 編輯資料表的預設存留時間 (TTL) 設定。若要將資料表的預設 TTL 設定更新為 2，592，000 秒，這代表 30 天，您可以使用下列陳述式。
```
ALTER TABLE my_table WITH default_time_to_live = 2592000;
```
1. 若要確認更新資料表的 TTL 設定，請使用 `cqlsh``DESCRIBE`陳述式，如下列範例所示。輸出會將資料表的預設 TTL 設定顯示為 `default_time_to_live`。
```
DESC TABLE my_table;
```
陳述式的輸出看起來應該與此範例類似。
```
CREATE TABLE my_keyspace.my_table (
id int PRIMARY KEY,
date timestamp,
name text
) WITH bloom_filter_fp_chance = 0.01
AND caching = {'class': 'com.amazonaws.cassandra.DefaultCaching'}
AND comment = ''
AND compaction = {'class': 'com.amazonaws.cassandra.DefaultCompaction'}
AND compression = {'class': 'com.amazonaws.cassandra.DefaultCompression'}
AND crc_check_chance = 1.0
AND dclocal_read_repair_chance = 0.0
AND default_time_to_live = 2592000
AND gc_grace_seconds = 7776000
AND max_index_interval = 2048
AND memtable_flush_period_in_ms = 3600000
AND min_index_interval = 128
AND read_repair_chance = 0.0
AND speculative_retry = '99PERCENTILE';
```
------
#### [ CLI ]
**使用 更新資料表的預設 TTL 值 AWS CLI**
1. 您可以使用 `update-table` 編輯資料表的預設 TTL 值。若要將資料表的預設 TTL 設定更新為 2，592，000 秒，這代表 30 天，您可以使用下列陳述式。
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --default-time-to-live '2592000'
```
1. 若要確認更新的預設 TTL 值，您可以使用下列陳述式。
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
陳述式的輸出看起來應該如下例所示。
```
{
"keyspaceName": "myKeyspace",
"tableName": "myTable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable",
"creationTimestamp": "2024-09-02T10:52:22.190000+00:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "id",
"type": "int"
},
{
"name": "date",
"type": "timestamp"
},
{
"name": "name",
"type": "text"
}
],
"partitionKeys": [
{
"name": "id"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2024-09-02T10:52:22.190000+00:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "DISABLED"
},
"ttl": {
"status": "ENABLED"
},
"defaultTimeToLive": 2592000,
"comment": {
"message": ""
},
"replicaSpecifications": []
}
```
------
# 建立已啟用自訂存留時間 (TTL) 設定的資料表
若要使用可套用至資料列和資料欄的存留時間自訂設定建立新的資料表，而不啟用整個資料表的 TTL 預設設定，您可以使用下列命令。
**注意**
如果在啟用`ttl`自訂設定的情況下建立資料表，您稍後無法停用設定。
------
#### [ Cassandra Query Language (CQL) ]
**使用 CQL 建立具有自訂 TTL 設定的新資料表**
+
```
CREATE TABLE my_keyspace.my_table (id int primary key) WITH CUSTOM_PROPERTIES={'ttl':{'status': 'enabled'}};
```
------
#### [ CLI ]
**使用 建立具有自訂 TTL 設定的新資料表 AWS CLI**
1. 您可以使用下列命令，在啟用 TTL 的情況下建立新的資料表。
```
aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable' \
--schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text}, {name=date,type=timestamp}],partitionKeys=[{name=id}]' \
--ttl 'status=ENABLED'
```
1. 若要確認資料表已啟用 TTL，您可以使用下列陳述式。
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
陳述式的輸出看起來應該如下例所示。
```
{
"keyspaceName": "myKeyspace",
"tableName": "myTable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable",
"creationTimestamp": "2024-09-02T10:52:22.190000+00:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "id",
"type": "int"
},
{
"name": "date",
"type": "timestamp"
},
{
"name": "name",
"type": "text"
}
],
"partitionKeys": [
{
"name": "id"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2024-09-02T11:18:55.796000+00:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "DISABLED"
},
"ttl": {
"status": "ENABLED"
},
"defaultTimeToLive": 0,
"comment": {
"message": ""
},
"replicaSpecifications": []
}
```
------
# 使用自訂存留時間 (TTL) 更新資料表
若要啟用資料表的存留時間自訂設定，以便將 TTL 值套用至個別資料列和資料欄，而無需設定整個資料表的 TTL 預設值，您可以使用下列命令。
**注意**
`ttl` 啟用 之後，您就無法為資料表停用它。
------
#### [ Cassandra Query Language (CQL) ]
**使用 CQL 啟用資料表的自訂 TTL 設定**
+
```
ALTER TABLE my_table WITH CUSTOM_PROPERTIES={'ttl':{'status': 'enabled'}};
```
------
#### [ CLI ]
**使用 啟用資料表的自訂 TTL 設定 AWS CLI**
1. 您可以使用下列命令來更新資料表的自訂 TTL 設定。
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --ttl 'status=ENABLED'
```
1. 若要確認資料表現在已啟用 TTL，您可以使用下列陳述式。
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
陳述式的輸出看起來應該如下例所示。
```
{
"keyspaceName": "myKeyspace",
"tableName": "myTable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable",
"creationTimestamp": "2024-09-02T11:32:27.349000+00:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "id",
"type": "int"
},
{
"name": "date",
"type": "timestamp"
},
{
"name": "name",
"type": "text"
}
],
"partitionKeys": [
{
"name": "id"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2024-09-02T11:32:27.349000+00:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "DISABLED"
},
"ttl": {
"status": "ENABLED"
},
"defaultTimeToLive": 0,
"comment": {
"message": ""
},
"replicaSpecifications": []
}
```
------
# 使用 `INSERT`陳述式來設定新資料列的自訂存留時間 (TTL) 值
**注意**
您必須先在資料表上啟用自訂 TTL，才能使用 `INSERT`陳述式設定資料列的自訂 TTL 值。如需詳細資訊，請參閱[使用自訂存留時間 (TTL) 更新資料表](TTL-how-to-enable-custom-alter.md)。
若要透過設定個別資料列的過期日期來覆寫資料表的預設 TTL 值，您可以使用 `INSERT`陳述式：
+ `INSERT` – 插入設定 TTL 值的新資料列。
使用 `INSERT`陳述式設定新列的 TTL 值優先於資料表的預設 TTL 設定。
下列 CQL 陳述式會將資料列插入資料表，並將預設 TTL 設定變更為 259，200 秒 （相當於 3 天）。
```
INSERT INTO my_table (userid, time, subject, body, user)
VALUES (B79CB3BA-745E-5D9A-8903-4A02327A7E09, 96a29100-5e25-11ec-90d7-b5d91eceda0a, 'Message', 'Hello','205.212.123.123')
USING TTL 259200;
```
若要確認插入資料列的 TTL 設定，請使用下列陳述式。
```
SELECT TTL (subject) from my_table;
```
# 使用 `UPDATE`陳述式來編輯資料列和資料欄的自訂存留時間 (TTL) 設定
**注意**
您必須先在資料表上啟用 TTL，才能設定資料列和資料欄的自訂 TTL 值。如需詳細資訊，請參閱[使用自訂存留時間 (TTL) 更新資料表](TTL-how-to-enable-custom-alter.md)。
您可以使用 `UPDATE`陳述式來覆寫資料表的預設 TTL 值，方法是設定個別資料列和資料欄的過期日期：
+ 資料列 – 您可以使用自訂 TTL 值更新現有的資料列。
+ 資料欄 – 您可以使用自訂 TTL 值更新現有資料列中的資料欄子集。
設定資料列和資料欄的 TTL 值優先於資料表的預設 TTL 設定。
若要將先前插入的「主體」資料欄的 TTL 設定從 259，200 秒 (3 天） 變更為 86，400 秒 （一天），請使用下列陳述式。
```
UPDATE my_table USING TTL 86400 set subject = 'Updated Message' WHERE userid = B79CB3BA-745E-5D9A-8903-4A02327A7E09 and time = 96a29100-5e25-11ec-90d7-b5d91eceda0a;
```
您可以執行簡單的選取查詢，在過期時間之前查看更新的記錄。
```
SELECT * from my_table;
```
查詢會顯示下列輸出。
```
userid | time | body | subject | user
--------------------------------------+--------------------------------------+-------+-----------------+-----------------
b79cb3ba-745e-5d9a-8903-4a02327a7e09 | 96a29100-5e25-11ec-90d7-b5d91eceda0a | Hello | Updated Message | 205.212.123.123
50554d6e-29bb-11e5-b345-feff819cdc9f | cf03fb21-59b5-11ec-b371-dff626ab9620 | Hello | Message | 205.212.123.123
```
若要確認過期成功，請在設定的過期時間之後再次執行相同的查詢。
```
SELECT * from my_table;
```
查詢會在「主旨」資料欄過期後顯示下列輸出。
```
userid | time | body | subject | user
--------------------------------------+--------------------------------------+-------+---------+-----------------
b79cb3ba-745e-5d9a-8903-4a02327a7e09 | 96a29100-5e25-11ec-90d7-b5d91eceda0a | Hello | null | 205.212.123.123
50554d6e-29bb-11e5-b345-feff819cdc9f | cf03fb21-59b5-11ec-b371-dff626ab9620 | Hello | Message | 205.212.123.123
```