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

Time Series Database:用語

最終更新日:Jan 14, 2025

このトピックでは、TSDB for InfluxDB® で使用される用語について説明します。

集計

TSDB for InfluxDB® でサポートされている集計関数。集計関数は、ポイントのグループの値を集計するために使用できます。 TSDB for InfluxDB® でサポートされている、または今後サポートされる予定のすべての集計関数の詳細については、「関数の一般的な構文」をご参照ください。

関連用語: 関数、セレクター、変換

バッチ

Line Protocol 形式で指定され、改行 (0x0A) で区切られたポイントのコレクション。 HTTP リクエストを送信して、データベースにポイントのバッチを書き込むことができます。 これにより、ネットワークのオーバーヘッドが削減され、HTTP API を使用したデータ書き込みのパフォーマンスが向上します。 バッチには 5,000 ~ 10,000 ポイントを指定することをお勧めします。 最適なパフォーマンスを確保するために、ビジネスシナリオに基づいてバッチサイズを指定できます。

関連用語: Line Protocol、ポイント

継続クエリ (CQ)

クエリの一種。 継続クエリは、特定の間隔で TSDB for InfluxDB® データベースに対して自動的に実行されます。 継続クエリを実行するには、SELECT 句に関数を含め、ステートメントに GROUP BY time() 句を指定する必要があります。

関連用語: 関数

データベース

ユーザー、リテンションポリシー、継続クエリ、および時系列データの論理コンテナー。

関連用語: 継続クエリ、リテンションポリシー、ユーザー

期間

データリテンションポリシーの属性。 この属性は、TSDB for InfluxDB® データベースにデータを保持できる期間を指定します。 システムは、指定されたリテンション時間よりも長い期間保存されているデータを自動的に削除します。

関連用語: リテンションポリシー

フィールド

フィールドは、TSDB for InfluxDB® のデータ構造におけるキーと値のペアです。 フィールドは、メタデータと実際のデータを格納するために使用されます。 フィールドは TSDB for InfluxDB® のデータ構造では必須であり、インデックスは作成されません。 クエリのステートメントでフィールドの値をフィルター条件として指定すると、TSDB for InfluxDB® は指定された時間範囲で生成されたすべてのポイントをスキャンします。 フィールドをフィルター条件として使用するクエリのパフォーマンスは、タグをフィルター条件として使用するクエリのパフォーマンスよりも低くなります。

注: TSDB for InfluxDB® は、フィールドに基づいてインデックスを作成しません。 TSDB for InfluxDB® は、タグに基づいてインデックスを作成します。

関連用語: フィールドキー、フィールドセット、フィールド値、タグ

フィールドキー

フィールドのキー。 フィールドキーは、メタデータを格納する文字列です。

関連用語: フィールド、フィールドセット、フィールド値、タグキー

フィールドセット

ポイント内のフィールドキーとフィールド値のコレクション。

関連用語: フィールド、フィールドキー、フィールド値、ポイント

フィールド値

フィールドの値。 フィールド値は実際のデータです。 フィールド値は、文字列、浮動小数点数、整数、またはブール値です。 フィールド値はタイムスタンプに関連付けられています。

TSDB for InfluxDB® は、フィールド値に基づいてインデックスを作成しません。 クエリのステートメントでフィールドの値をフィルター条件として指定すると、TSDB for InfluxDB® は指定された時間範囲で生成されたすべてのポイントをスキャンします。 その結果、クエリのパフォーマンスが低下します。

注: TSDB for InfluxDB® は、フィールド値に基づいてインデックスを作成しません。 TSDB for InfluxDB® は、タグ値に基づいてインデックスを作成します。

関連用語: フィールド、フィールドキー、フィールドセット、タグ値、タイムスタンプ

関数

TSDB for InfluxDB® でサポートされている集計関数、セレクター関数、および変換関数。 TSDB for InfluxDB® でサポートされているすべての関数の詳細については、「関数の一般的な構文」をご参照ください。

関連用語: 集計、セレクター、変換

識別子

フィールドキー、タグキー、ユーザー名、継続クエリ、データベース、メジャーメント、およびリテンションポリシーの名前などのトークン。

関連用語: データベース、フィールドキー、メジャーメント、リテンションポリシー、タグキー、ユーザー

Line Protocol

TSDB for InfluxDB® データベースにインポートするポイントを指定できるテキスト形式。

メジャーメント

TSDB for InfluxDB® のデータ構造の文字列。 メジャーメントは、フィールドに格納されているデータについて説明します。

関連用語: フィールド、シリーズ

メタストア

システムのステータスを含む内部情報を格納するために使用されるサービス。 メタストアは、シャードのメタデータ、およびユーザー、データベース、リテンションポリシー、継続クエリに関する情報を格納します。

関連用語: データベース、リテンションポリシー、ユーザー

ノード

TSDB for InfluxDB® インスタンスのサーバー。

関連用語: サーバー

now()

ローカルサーバーの現在のタイムスタンプを返す関数。 タイムスタンプはナノ秒単位です。

ポイント

ポイントは TSDB For InfluxDB® のデータ構造に含まれています。 ポイントは、シリーズ内のフィールドで構成されます。 ポイントは、ポイントが格納されているシリーズとポイントのタイムスタンプによって識別されます。

タイムスタンプが同じ複数のポイントを 1 つのシリーズに格納することはできません。 タイムスタンプが同じ別のポイントを含むシリーズにポイントを書き込むと、タイムスタンプに対応するフィールドセットは、以前のフィールドセットと新しいフィールドセットの和集合になります。 リクエストがタイムスタンプを含むポイントをクエリすると、新しいフィールドセットが返されます。

関連用語: フィールドセット、シリーズ、タイムスタンプ

1 秒あたりのポイント数

TSDB for InfluxDB® データベースにデータが書き込まれるレート。 TSDB for InfluxDB® のデータスキーマでは、ポイントごとに複数のメトリックの値を書き込むことができるため、この用語は非推奨です。

代わりに、1 秒あたりの値のメトリックを使用して、データ書き込みレートを示します。

関連用語: ポイント、スキーマ、1 秒あたりの値

クエリ

TSDB for InfluxDB® データベースからデータを取得するために行うことができる操作。

リテンションポリシー (RP)

TSDB for InfluxDB® データベースのリテンションポリシーは、データ構造に含まれています。 リテンションポリシーは、データのリテンション期間と、データベースのシャードグループの期間を指定します。 各 TSDB for InfluxDB® データベースは、一意のリテンションポリシーを使用します。 シリーズは、リテンションポリシー、メジャーメント、およびタグセットによって識別できます。

TSDB for InfluxDB® でデータベースを作成すると、システムはデータベースに autogen という名前のリテンションポリシーを自動的に作成します。

関連用語: 期間、メジャーメント、シリーズ、シャード期間、タグセット

スキーマ

TSDB for InfluxDB® データベースに格納されているデータのスキーマ。 スキーマは、TSDB for InfluxDB® データベースでのデータの編成方法について説明します。 スキーマには、データベース、リテンションポリシー、シリーズ、メジャーメント、タグキー、タグ値、およびフィールドキーに関する情報が含まれています。

関連用語: データベース、フィールドキー、メジャーメント、リテンションポリシー、シリーズ、タグキー、タグ値

セレクター

指定されたポイントの範囲からポイントを選択するために使用できるセレクター関数。 TSDB for InfluxDB® でサポートされている、または今後サポートされる予定のすべてのセレクター関数の詳細については、「関数の一般的な構文」をご参照ください。

関連用語: 集計、関数、変換

シリーズ

TSDB for InfluxDB® データベースで同じメジャーメント、タグセット、およびリテンションポリシーを使用するポイントのセット。

説明

フィールドセットを使用してシリーズを識別することはできません。

関連用語: フィールドセット、メジャーメント、リテンションポリシー、タグセット

シリーズカーディナリティ

TSDB for InfluxDB® インスタンス内のデータベース、メジャーメント、タグセット、およびフィールドキーの組み合わせの数。

たとえば、TSDB for InfluxDB® インスタンスにデータベースとメジャーメントが含まれており、メジャーメントに emailstatus の 2 つのタグが含まれているとします。 email タグには 3 つの値があり、status タグには 2 つの値があります。 この場合、各 email アドレスは 2 つのステータス値に関連付けられています。 メジャーメントのシリーズカーディナリティは、次の式を使用して計算されます: 3 × 2 = 6。

email

status

username@alibaba-inc.com

start

username@alibaba-inc.com

finish

username@alibaba-inc.com

start

username@alibaba-inc.com

finish

username@alibaba-inc.com

start

username@alibaba-inc.com

finish

特定のケースでは、依存タグが使用されます。各タグの値の数を乗算すると、推定系列カーディナリティが過剰になる可能性があります。依存タグとは、値の範囲が別のタグの値の範囲に含まれるタグです。依存タグは、系列カーディナリティを増加させません。たとえば、前の例で説明したメジャーメントに firstname タグが追加されています。メジャーメントの系列カーディナリティは 18 (3 x 2 x 3 = 18) ではありません。firstname タグの範囲は email タグの範囲に含まれているため、系列カーディナリティは 6 です。

email

status

firstname

username@alibaba-inc.com

start

amy

username@alibaba-inc.com

finish

amy

username@alibaba-inc.com

start

jeff

username@alibaba-inc.com

finish

jeff

username@alibaba-inc.com

start

john

username@alibaba-inc.com

finish

john

関連用語: フィールドキー、メジャーメント、タグキー、タグセット

サーバー

TSDB for InfluxDB® データベースを実行する仮想サーバーまたは物理サーバー。

関連用語: ノード

シャード

シャードには、シリーズの実際のデータと圧縮データが含まれています。 シャードは、ディスクに格納されている 1 つ以上の Time-Structured Merge Tree (TSM) ファイルで構成されます。 シャードは 1 つのシャードグループにのみ属します。 シャードグループには複数のシャードを含めることができます。 各シャードには、特定のシリーズセットのデータが含まれています。 特定のシャードグループでは、シリーズ内のすべてのポイントは同じシャードに格納されます。 これにより、シリーズ内のすべてのポイントは同じ TSM ファイルに格納されます。

関連用語: シリーズ、シャード期間、シャードグループ、TSM

シャード期間

各シャードグループがカバーする期間。 期間は、データベースのリテンションポリシーの SHARD DURATION パラメーターで指定されます。

たとえば、リテンションポリシーの SHARD DURATION パラメーターの値が 1w に設定されている場合、各シャードグループは 1 週間をカバーし、その週内に生成されたすべてのポイントが含まれます。

関連用語: データベース、リテンションポリシー、シリーズ、シャード、シャードグループ

シャードグループ

シャードグループは、シャードの論理コンテナーです。 シャードグループ内のシャードは、時間とリテンションポリシーによって編成されます。 データを含むデータベースのリテンションポリシーは、少なくとも 1 つのシャードグループに関連付けられている必要があります。 シャードグループ内のシャードには、特定の期間内に生成されたすべてのデータが含まれています。 期間はシャード期間です。

関連用語: データベース、リテンションポリシー、シリーズ、シャード、シャード期間

タグ

タグは、TSDB for InfluxDB® データベースのデータ構造にメタデータを格納するキーと値のペアです。 タグは、TSDB for InfluxDB® データベースのデータ構造ではオプションです。 タグに基づいて実行されるクエリのパフォーマンスは、タグが TSDB for InfluxDB® データベースでインデックス化されているため、高くなります。 タグを使用して、頻繁にアクセスされるメタデータを格納できます。

注: TSDB for InfluxDB® は、タグに基づいてインデックスを作成します。

関連用語: フィールド、タグキー、タグセット、タグ値

タグキー

タグのキー。 タグキーは、メタデータを格納する文字列です。 タグキーに基づいて実行されるクエリのパフォーマンスは、タグキーが TSDB for InfluxDB® データベースでインデックス化されているため、高くなります。

注: TSDB for InfluxDB® は、タグキーに基づいてインデックスを作成します。

関連用語: フィールドキー、タグ、タグセット、タグ値

タグセット

ポイント内のタグキーとタグ値のコレクション。

関連用語: ポイント、シリーズ、タグ、タグキー、タグ値

タグ値

タグの値。 タグ値は、メタデータを格納する文字列です。 タグ値に基づいて実行されるクエリのパフォーマンスは、タグ値が TSDB for InfluxDB® データベースでインデックス化されているため、高くなります。

関連用語: タグ、タグキー、タグセット

タイムスタンプ

ポイントに関連付けられている日付と時刻。 TSDB for InfluxDB® データベースのタイムスタンプは UTC です。

InfluxDB® データベースの TSDB に書き込むデータのタイムスタンプを指定する方法については、「Write Protocol」をご参照ください。[データ探索]

関連用語: ポイント

変換

特定のポイントセットを計算し、値または値のセットを返すために使用できる変換関数。 これらの関数は、ポイントの集計値を返しません。 TSDB for InfluxDB® でサポートされている、または今後サポートされる予定のすべての関数の詳細については、「関数の一般的な構文」をご参照ください。

関連用語: 集計、関数、セレクター

TSM

TSDB for InfluxDB® データベースに格納されているデータの形式。 TSM は、B+ ツリーまたは Log-Structured Merge Tree (LSM) ツリーよりも高い圧縮率と読み取り/書き込みスループットを提供します。

ユーザー

TSDB for InfluxDB® は、管理者と標準ユーザーの 2 種類のデータベースユーザーをサポートしています。

  • 管理者には、インスタンスで作成されたすべてのデータベースに対する読み取りおよび書き込み権限が付与され、クエリとユーザーを管理するために必要な権限も付与されます。

  • 標準ユーザーには、データベースに対する読み取り専用権限、書き込み専用権限、または読み取りおよび書き込み権限を付与できます。

1 秒あたりの値

TSDB for InfluxDB® データベースにデータが書き込まれるレート。 1 秒あたりの値のメトリックは、データ書き込みレートを記述するために使用されます。

1 秒あたりの値を計算するには、書き込まれるポイントの数に各ポイントに格納されている値の数を乗算します。 たとえば、1 秒あたり 10 バッチがデータベースに書き込まれるとします。 各バッチには 5,000 ポイントが含まれており、各ポイントには 4 つのフィールドが含まれています。 この場合、書き込みレートは次の式を使用して計算されます: 4 × 5,000 × 10 = 200,000。

関連用語: バッチ、フィールド、ポイント、1 秒あたりのポイント数

Write Ahead Log (WAL)

ポイントを格納するために使用される一時キャッシュ。 TSDB for InfluxDB® は、データベースに書き込まれた新しいポイントを WAL にキャッシュします。 WAL に格納されているデータの量が特定のしきい値を超えるか、ポイントが指定された期間よりも長く WAL に格納されている場合、ポイントは永続ストレージのためにデータベースにフラッシュされます。 これにより、システムが永続ファイルをスキャンする頻度が減少します。 WAL を使用すると、データを TSM にバッチで効率的に書き込むことができます。

WAL に格納されているポイントはクエリできます。 システムを再起動した後、WAL に格納されているデータは保持されます。 TSDB for InfluxDB® プロセスが開始されると、WAL に格納されているすべてのポイントは、新しい書き込みリクエストが処理される前に永続ストレージにフラッシュされます。

関連用語: TSM