Tablestore:時系列テーブルの操作

Tablestoreコンソールで時系列テーブルを作成します。

1. インスタンス管理ページに移動します。

   1. Tablestoreコンソールにログインします。

   2. 上部のナビゲーションバーで、リソースグループとリージョンを選択します。

   3. 概要ページで、管理するインスタンスの名前をクリックするか、インスタンスのアクション列のインスタンスの管理をクリックします。

2. インスタンスの詳細タブの下部にある時系列テーブルタブをクリックします。

3. 時系列テーブルタブで、時系列テーブルの作成をクリックします。

   説明

   ワンクリックでデモを生成をクリックして、サンプルデータを含むテストテーブルを作成してクイックスタートすることもできます。時系列テーブルを作成すると、システムは特定の初期化操作を実行します。時系列が表示されるまで数十秒待つ必要があります。

4. 時系列テーブルの作成ダイアログボックスで、パラメータを構成します。次の表にパラメータを示します。

   パラメータ	説明
   名前：	インスタンス内で時系列テーブルを一意に識別するために使用される時系列テーブルの名前。 名前は1～128文字で、英字、数字、アンダースコア(_)のみ使用できます。名前は英字またはアンダースコア(_)で始まる必要があります。 重要 時系列テーブルの名前は、既存のデータテーブル、セカンダリインデックステーブル、時系列テーブルの名前とは異なる必要があります。
   有効期間	時系列テーブルのデータの保持期間。単位：秒。システムが、現在の時刻とテーブルに渡された時間列の差が指定されたTTL値を超えていることを検出した場合、システムは期限切れのデータを自動的に削除します。 重要 時系列テーブルでは、システムはデータがテーブルに書き込まれた時刻ではなく、テーブルに渡された時間列に基づいてデータが生成された時刻を判断します。 このパラメータの値は、-1または86400以上の値である必要があります。値-1は、データが期限切れにならないことを指定します。値86400は1日を指定します。

5. 作成をクリックします。

   時系列テーブルを作成した後、時系列テーブルタブで時系列テーブルを表示できます。時系列テーブルが時系列テーブルのリストに表示されない場合は、アイコンをクリックして時系列テーブルのリストを更新します。

時系列テーブルを作成した後、ビジネス要件に基づいて時系列テーブルを管理できます。次の表に、時系列テーブルで実行できる操作を示します。

Tablestore CLIを使用して時系列テーブルを作成するには、createコマンドを実行します。詳細については、時系列テーブルを作成するを参照してください。

次のサンプルコードは、mytableという名前の時系列テーブルを作成する方法の例を示しています。mytableテーブルのデータは期限切れになりません。

create -m timeseries -t mytable --ttl -1

テーブルで操作を実行する前に、useコマンドを実行して、管理するテーブルを選択する必要があります。詳細については、時系列テーブルを使用するを参照してください。

次のサンプルコードは、mytableという名前の時系列テーブルを使用する方法の例を示しています。

use --ts -t mytable

時系列テーブルを作成して選択した後、ビジネス要件に基づいて時系列テーブルを管理できます。次の表に、時系列テーブルで実行できる操作を示します。

list -t

alter --ttl 86400 --ts

desc --ts -t mytable

drop -t mytable --ts -y

Tablestore SDK for JavaとTablestore SDK for Goを使用して、時系列テーブルを作成および管理できます。この例では、Tablestore SDK for Javaを使用します。

ビジネス要件に基づいて時系列テーブルを作成します。

次のサンプルコードは、データが期限切れにならないtest_timeseries_tableという名前の時系列テーブルを作成する方法の例を示しています。

// 時系列テーブルを作成します。
private static void createTimeseriesTable(TimeseriesClient client) {
    String tableName = "test_timeseries_table";
    TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
    int timeToLive = -1;
    timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
    CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
    
    client.createTimeseriesTable(request);
}

時系列テーブルを作成した後、ビジネス要件に基づいて時系列テーブルを管理できます。

// 時系列テーブルの名前をクエリします。
private static void listTimeseriesTable(TimeseriesClient client) {
    ListTimeseriesTableResponse listTimeseriesTableResponse = client.listTimeseriesTable();
    for (String table : listTimeseriesTableResponse.getTimeseriesTableNames()) {
        System.out.println(table);
    }
}

// 時系列テーブルのデータのTTLを変更します。
private static void updateTimeseriesTable(TimeseriesClient client) {
    // 時系列テーブルの名前を指定します。
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // TTLを3年に変更します。
    updateTimeseriesTableRequest.setTimeseriesTableOptions(new TimeseriesTableOptions(86400 * 365 * 3)); 
    client.updateTimeseriesTable(updateTimeseriesTableRequest);

    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // 変更されたTTLを表示します。
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
}

// 時系列テーブルに関する情報をクエリします。
private static void describeTimeseriesTable(TimeseriesClient client) {
    // 時系列テーブルの名前を指定します。
    String tableName = "<TIMESERIES_TABLE>";
    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // 時系列テーブル名を表示します。
    System.out.println(tableMeta.getTimeseriesTableName()); 
    // 時系列テーブルの状態を表示します。
    System.out.println(tableMeta.getStatus()); 
    // 時系列テーブルのデータのTTLを表示します。
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
    // 時系列メタデータのTTLを表示します。
    System.out.println(tableMeta.getTimeseriesMetaOptions().getMetaTimeToLive()); 
    // 時系列メタデータのプロパティ列を変更できるかどうかを確認します。
    System.out.println(tableMeta.getTimeseriesMetaOptions().getAllowUpdateAttributes()); 
}

// 時系列テーブルを削除します。
private static void deleteTimeseriesTable(TimeseriesClient client) {
    // 時系列テーブルの名前を指定します。
    String tableName = "<TIMESERIES_TIME>";
    DeleteTimeseriesTableRequest deleteTimeseriesTableRequest = new DeleteTimeseriesTableRequest(tableName);
    client.deleteTimeseriesTable(deleteTimeseriesTableRequest);
}