Tablestore Node.js SDK を使用したテーブルの設定の更新 - Tablestore

このトピックでは、パラメーターとサンプルコードを使用して、Tablestore Node.js SDK を使用してテーブルの設定を更新する方法について説明します。データテーブルの有効期限 (TTL)、最大バージョン数、最大バージョンオフセット、および Stream 設定を更新できます。また、ハイパフォーマンスインスタンスのデータテーブルの予約済み読み書きスループットを更新することもできます。

前提条件

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

API 操作

/**
 * tableOptions、reservedThroughput、または streamSpecification を使用して、データテーブルの設定を更新します。
 */
updateTable(params, callback)

パラメーター

詳細については、パラメーターを参照してください。

サンプルコード

データテーブルの設定の更新

次のサンプルコードは、データテーブルの設定を更新する方法の例を示しています。

var params = {
    // データテーブルの名前を指定します。
    tableName: '<TABLE_NAME>',
    tableOptions: {
        // データテーブル内のデータの TTL を指定します。値 -1 は、データテーブル内のデータが期限切れにならないことを指定します。
        timeToLive: -1,
        // データテーブルの各属性列に保持できる最大バージョン数を指定します。この例では、各属性列に最大 5 つのバージョンのデータを保持できます。
        maxVersions: 5,
        // 現在のシステム時刻と書き込まれたデータのタイムスタンプの最大差を指定します。この例では、最大差は 86,400 秒（1 日）に設定されています。
        maxTimeDeviation: 86400,
        // データテーブルでの UpdateRow 操作を許可することを指定します。
        allowUpdate: true
    },
    // streamSpecification: {
    //     // Stream 機能を有効にします。
    //     enableStream: true,
    //     // ストリームの有効期限を 24 時間に設定します。
    //     expirationTime: 24
    // }
  };
  
client.updateTable(params, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', data);
});

ハイパフォーマンスインスタンスのデータテーブルの予約済みスループットの更新

次のサンプルコードは、ハイパフォーマンスインスタンスのデータテーブルの予約済みスループットを更新する方法の例を示しています。

var params = {
    // データテーブルの名前を指定します。
    tableName: '<TABLE_NAME>',
    tableOptions: {
        // データテーブル内のデータの TTL を指定します。値 -1 は、データテーブル内のデータが期限切れにならないことを指定します。
        timeToLive: -1,
    },
    // 新しい予約済み読み取りスループットを 1 に、新しい予約済み書き込みスループットを 1 に設定します。容量インスタンスのデータテーブルの場合、予約済み読み取りスループットと書き込みスループットは 0 にのみ設定できます。
    reservedThroughput: {
        capacityUnit: {
            read: 1,
            write: 1
        }
    }
};
  
client.updateTable(params, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', data);
});

参照

API 操作の詳細については、UpdateTable を参照してください。
テーブルの設定を更新した後、次の操作を実行できます。
- テーブルに対する操作。詳細については、テーブルに対する操作を参照してください。
- データに対する操作。詳細については、データに対する基本操作を参照してください。