Node.js 用 Tablestore SDK を使用して、複数のデータ行を同時に、または単一の行を削除する - Tablestore

Tablestore は、単一のデータ行を削除できる DeleteRow 操作と、複数のデータ行を同時に削除できる BatchWriteRow 操作を提供します。

使用上の注意

削除したデータは復元できません。ご注意ください。

前提条件

OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。
データテーブルが作成され、データがデータテーブルに書き込まれていること。詳細については、データテーブルの作成とデータの書き込みを参照してください。

単一のデータ行の削除

DeleteRow 操作を呼び出すことで、単一のデータ行を削除できます。削除しようとする行が存在しない場合、テーブルは変更されません。

API 操作

/**
 * 単一のデータ行を削除します。
 */
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 操作を呼び出してデータを照会し、データのプライマリキー情報を取得します。詳細については、プライマリキー値が特定の範囲内にあるデータの読み取りを参照してください。
- 指定された条件を満たすデータを削除するには、検索インデックスを使用してデータを照会します。次に、データのプライマリキー情報を取得します。詳細については、検索インデックスの作成とTablestore SDK の使用を参照してください。
行のプライマリキー情報に基づいて、BatchWriteRow 操作を呼び出して、複数のデータ行を同時に削除します。詳細については、複数のデータ行の同時書き込みを参照してください。

参照

Time to Live (TTL) は、データの保存期間を指定します。データテーブルに TTL を構成して、期限切れのデータを自動的に削除できます。詳細については、データバージョンと TTLを参照してください。