表格存儲提供了DeleteRow接口用于刪除單行數據以及BatchWriteRow接口用于批量刪除數據。
注意事項
刪除表數據，將導致數據不可恢復，請謹慎操作。
前提條件
刪除單行數據
調用DeleteRow接口刪除一行數據。如果刪除的行不存在，則不會發生任何變化。
接口
/**
* 刪除一行數據。
*/
deleteRow(params, callback) 參數
參數 | 是否必選 | 說明 |
tableName | 是 | 數據表名稱。 |
primaryKey | 是 | 行的主鍵。主鍵包括主鍵列名、主鍵類型和主鍵值。 重要 設置的主鍵個數和類型必須和數據表的主鍵個數和類型一致。 |
condition | 是 | 使用條件更新，可以設置原行的存在性條件或者原行中某列的列值條件。更多信息，請參見條件更新。 |
示例
以下示例用于刪除數據表中的指定行。
var TableStore = require('../index.js');
var Long = TableStore.Long;
var client = require('./client');
var params = {
tableName: "sampleTable",
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(8) }, { 'uid': Long.fromNumber(80) }]
};
client.deleteRow(params, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', data);
});
詳細代碼請參見DeleteRow@GitHub。
批量刪除數據
根據實際選擇合適的方式查詢待刪除數據的主鍵信息。
如果要刪除指定主鍵范圍內的數據，請調用GetRange接口，查詢指定主鍵范圍內的數據，并獲取待刪除數據的主鍵信息。具體操作，請參見范圍讀取數據。
如果要刪除滿足指定條件的數據，請創建多元索引后，使用多元索引查詢滿足指定條件的數據，并獲取待刪除數據的主鍵信息。具體操作，請參見創建多元索引和通過SDK使用多元索引。
調用BatchWriteRow接口，根據主鍵信息批量刪除數據。更多信息，請參見批量寫入數據。
相關文檔
如果要刪除指定天數之前的數據，您可以通過為數據表配置數據生命周期的方式自動清理過期數據。具體操作，請參見數據版本和生命周期。
文檔內容是否對您有幫助？