すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:Jun 05, 2025

TimeSeries モデルは、時系列テーブルを使用して時系列データを格納します。単一の 時系列テーブルは、高並列書き込みとクエリ、そしてペタバイト規模のデータの低コストでの格納をサポートします。このトピックでは、時系列テーブルを作成および管理する方法について説明します。

使用上の注意

  • 1 つのインスタンスに最大 64 個のテーブルを作成できます。テーブルは、データテーブル、セカンダリインデックス、時系列テーブル、Lastpoint インデックス、および分析ストアで構成されます。制限事項の詳細については、「TimeSeries モデルの制限」をご参照ください。

    説明

    時系列テーブルは、時系列メタデータテーブルと時系列データテーブルの 2 つのコンポーネントで構成されます。システムがインスタンス内のテーブルの総数を計算する場合、時系列テーブルは 2 つの別々のテーブルとしてカウントされます。

  • TimeSeries モデルは、中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (ウランチャブ)、中国 (深セン)、中国 (成都)、中国 (香港)、日本 (東京)、マレーシア (クアラルンプール)、ドイツ (フランクフルト)、インドネシア (ジャカルタ)、英国 (ロンドン)、米国 (シリコンバレー)、米国 (バージニア)、SAU (リヤド - パートナー地域)、およびシンガポールでサポートされています。

  • 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口) では、カスタム時系列識別子とカスタムデータフィールドをプライマリキー列として指定し、Lastpoint インデックスと分析ストア機能を使用できます。

機能

次の表に、時系列テーブルでサポートされている機能を示します。

機能

説明

時系列テーブルの作成

時系列テーブルを作成する場合は、時系列テーブルと時系列メタデータに関連する構成情報を指定する必要があります。さらに、ビジネス要件に基づいて、カスタム時系列識別子とカスタムデータフィールドをプライマリキー列として指定し、分析ストアを作成し、Lastpoint インデックスを作成できます。

時系列テーブルの更新

時系列テーブルの Time to Live (TTL) などの構成情報を変更できます。また、時系列メタデータの TTL や時系列メタデータテーブルの属性列を変更できるかどうかなど、時系列メタデータの構成情報を変更することもできます。

時系列テーブルのクエリ

現在のインスタンスにあるすべての 時系列テーブルの名前と構成情報をクエリできます。

時系列テーブルの情報のクエリ

時系列テーブルのステータスと構成情報 (TTL など) をクエリできます。また、時系列メタデータの TTL や時系列メタデータテーブルの属性列を変更できるかどうかなど、時系列メタデータの構成情報をクエリすることもできます。

時系列テーブルの削除

時系列テーブルを削除できます。

手順

時系列テーブルの作成

Tablestore コンソールで 時系列テーブルを作成するには、次の操作を実行します。

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

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

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

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

  2. [インスタンスの詳細] タブで、[時系列テーブル] タブをクリックします。

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

    説明

    [ワンクリックでデモを生成] をクリックして、サンプルデータを含むテストテーブルを作成し、機能をすばやく体験することもできます。新しく作成されたテストテーブルの場合、システムは特定の初期化操作を実行します。時系列が表示されるまで、数十秒ほど待つ必要があります。

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

    パラメータ

    説明

    名前

    インスタンス内で 時系列テーブルを一意に識別するために使用される、時系列テーブルの名前。

    • 名前は 1 ~ 128 文字で、英字、数字、およびアンダースコア (_) のみを含めることができます。名前は英字またはアンダースコア (_) で始める必要があります。

    • 時系列テーブルの名前は、現在のインスタンスにある既存のデータテーブル、セカンダリインデックス、または他の 時系列テーブルの名前とは異なる必要があります。

    生存時間

    時系列テーブル内のデータの保持期間。単位:秒。最小 TTL は 86,400 秒 (1 日) です。生存時間パラメータを -1 に設定することもできます。これは、データの有効期限が切れないことを指定します。

    システムが、現在の時刻とデータ列がテーブルに渡された時刻の差が指定された TTL 値を超えていることを検出した場合、システムは期限切れのデータを自動的に削除します。

    説明

    時系列テーブルでは、システムは、データがテーブルに書き込まれた時刻ではなく、テーブルに渡された時間列に基づいて、データが生成された時刻を決定します。

    時系列識別子

    説明

    このパラメータは、[カスタム時系列識別子とプライマリキー] スイッチをオンにした場合にのみ構成できます。

    デフォルトでは、時系列識別子はメトリック名、データソース、およびタグで構成されます。ビジネス要件に基づいて、カスタム時系列識別子を指定できます。詳細については、「カスタム時系列識別子の指定」をご参照ください。

    • カスタム時系列識別子フィールドの名前には、小文字、数字、およびアンダースコア (_) を含める必要があり、数字で始めることはできません。名前は 1 ~ 128 バイトの長さである必要があります。

    • 最大 6 つのカスタム時系列識別子フィールドを指定できます。

    [時系列識別子の追加] をクリックして、複数のカスタム時系列識別子フィールドを追加できます。カスタム時系列識別子フィールドの横にある fig_20221020_delete アイコンをクリックして、フィールドを削除できます。

    重要

    時系列テーブルを作成した後、カスタム時系列識別子フィールドを変更することはできません。注意して進めてください。

    プライマリキーフィールド

    説明

    このパラメータは、[カスタム時系列識別子とプライマリキー] スイッチをオンにした場合にのみ構成できます。

    同じ時系列識別子とタイムスタンプを持つ時系列データの複数の行を格納する場合、カスタムデータフィールドを 時系列テーブルのプライマリキー列として指定できます。詳細については、「カスタム時系列識別子とカスタムデータフィールドをプライマリキー列として指定する」をご参照ください。

    • プライマリキー列として指定されたデータフィールドの名前は、小文字、数字、およびアンダースコア (_) で構成する必要があり、数字で始めることはできません。名前は 1 ~ 128 バイトの長さである必要があります。

    • 最大 4 つのデータフィールドをプライマリキー列として指定できます。

    • プライマリキー列として指定されたデータフィールドのデータ型は、[STRING] または [INTEGER] にすることができます。

    [プライマリキーフィールドの追加] をクリックして、複数のデータフィールドをプライマリキー列として追加できます。プライマリキー列として指定されたデータフィールドの横にある fig_20221020_delete アイコンをクリックして、フィールドを削除できます。

    重要

    時系列テーブルを作成した後、プライマリキー列として指定されたデータフィールドを変更することはできません。注意して進めてください。

    分析ストアの作成

    分析ストアを使用して、時系列データを低コストで格納し、時系列データをすばやくクエリおよび分析できます。分析ストア機能は、主に時系列データの長期保存と分析に使用されます。詳細については、「時系列の分析ストア」をご参照ください。

    [分析ストアの作成] スイッチはデフォルトでオンになっています。ビジネス要件に基づいてスイッチの設定を構成します。

    • 分析ストア機能を使用しない場合は、[分析ストアの作成] スイッチをオフにします。

    • デフォルトの分析ストアを作成する場合は、[分析ストアの作成] スイッチのデフォルト設定を保持します。

    • カスタム分析ストアを作成する場合は、[分析ストアの作成] スイッチのデフォルト設定を保持し、[詳細設定] スイッチをオンにして、[名前] パラメータと [TTL] パラメータを構成します。

    LastPoint インデックスの作成

    Lastpoint インデックスは、時系列テーブル内の各時系列の最新のステータスをすばやく取得するために特別に設計されています。 Lastpoint インデックスを使用して、時系列テーブル内の時系列の最新時点のデータをすばやく取得できます。詳細については、「Lastpoint インデックス」をご参照ください。

    [LastPoint インデックスの作成] スイッチはデフォルトでオフになっています。ビジネス要件に基づいてスイッチの設定を構成します。

    • Lastpoint インデックスを作成しない場合は、[LastPoint インデックスの作成] スイッチのデフォルト設定を保持します。

    • Lastpoint インデックスを作成する場合は、[LastPoint インデックスの作成] スイッチをオンにして、[LastPoint インデックス名] パラメータを構成します。

      説明
      • Lastpoint インデックスの名前には、英字、数字、およびアンダースコア (_) を含める必要があり、数字で始めることはできません。名前は 1 ~ 128 バイトの長さである必要があります。

      • 時系列テーブルに作成される Lastpoint インデックスと分析ストアの合計数は 10 を超えることはできません。

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

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

時系列テーブルの管理

ビジネス要件に基づいて、対応する操作を実行して 時系列テーブルを管理します。

機能

説明

時系列テーブルの一覧表示

[時系列テーブル] タブで、インスタンス内のすべての 時系列テーブルを表示します。

時系列テーブル内のデータの TTL の変更

  1. [時系列テーブル] タブで、管理する 時系列テーブルの名前をクリックします。

  2. 説明[基本情報] タブの image.pngデータ ライフサイクル セクションで、 パラメータの横にある アイコンをクリックします。

  3. 表示されるダイアログボックスで、TTL 値を変更します。

    TTL 値は、時系列テーブル内のデータの保持期間です。単位:秒。最小 TTL は 86,400 秒 (1 日) です。 TTL を -1 に設定することもできます。これは、データの有効期限が切れないことを指定します。

    説明

    時系列テーブルの TTL を更新すると、Tablestore は、保持期間が時系列テーブルの TTL を超えた時系列データを非同期的に自動的に削除します。

  4. [はい] をクリックします。

時系列メタデータの TTL の変更

  1. [時系列テーブル] タブで、管理する 時系列テーブルの名前をクリックします。

  2. 説明[基本情報] タブの image.png時系列メタデータの TTL セクションで、 パラメータの横にある アイコンをクリックします。

  3. 表示されるダイアログボックスで、時系列メタデータの TTL を変更します。

    TTL 値は、時系列テーブル内の時系列メタデータの保持期間です。単位:秒。最小値は 604,800 秒 (7 日) です。 TTL を -1 に設定することもできます。これは、時系列メタデータの有効期限が切れないことを指定します。

    説明
    • 時系列メタデータの TTL のデフォルト値は -1 です。これは、時系列メタデータの有効期限が切れないことを指定します。

      • 時系列メタデータの TTL の値は、時系列テーブル内のデータの TTL 以上である必要があります。

      • 時系列メタデータの TTL を -1 以外の値 (最小値は 604,800 秒) に変更する場合は、ビジネスロジックで時系列メタデータ属性を更新する必要がないことを確認し、[時系列メタデータの属性を更新するかどうか][いいえ] に設定します。

      • [時系列メタデータの属性を更新するかどうか][はい] に設定する場合は、時系列メタデータの TTL の値が -1 であることを確認してください。

    • 時系列メタデータの TTL を更新すると、Tablestore は、保持期間が TTL を超えた時系列を非同期的に自動削除しますが、対応する時系列データは削除しません。時系列識別子を指定することで、時系列データをクエリできます。

  4. [はい] をクリックします。

時系列メタデータの属性を変更できるかどうかを指定する

  1. [時系列テーブル] タブで、管理する 時系列テーブルの名前をクリックします。

  2. 説明[基本情報] タブの image.png[時系列メタデータの属性を更新するかどうか] セクションで、 の横にある アイコンをクリックします。

  3. 表示されるダイアログボックスで、時系列メタデータの属性の更新を許可するかどうかを選択します。

    説明

    時系列メタデータの属性の更新を許可する場合は、[時系列メタデータの TTL] を -1 に設定する必要があります。これは、時系列メタデータの有効期限が切れないことを指定します。

  4. [はい] をクリックします。

時系列テーブルの情報のクエリ

  1. [時系列テーブル] タブで、管理する 時系列テーブルの名前をクリックします。

  2. [基本情報] タブで、[説明][時系列識別子][プライマリキーフィールド][分析ストア]、および [LastPoint インデックス] セクションで 時系列テーブルの情報を表示します。

時系列テーブルの削除

  1. [時系列テーブル] タブで、削除する 時系列テーブルの [アクション] 列の [削除] をクリックします。

  2. 表示されるメッセージで、[OK] をクリックします。

    重要
    • 時系列テーブルを削除すると、復元できなくなります。注意して進めてください。

    • 時系列テーブルを削除すると、システムは 時系列テーブルに作成された分析ストアと Lastpoint インデックスを自動的に削除します。

開発統合

機能

呼び出し方法

時系列テーブルの作成

時系列テーブルの更新

時系列テーブルの一覧表示

時系列テーブルの情報のクエリ

時系列テーブルの削除