Time Series Database:よくある質問

時系列と時系列カーディナリティ

• モデリングはどのように実行しますか? 注意点はありますか?

• 時系列カーディナリティが重要なのはなぜですか?

管理

• システムの安定性を維持するにはどうすればよいですか?

• メジャーメントのディスク使用量を確認するにはどうすればよいですか?

• 効率的かつ安全にデータを削除するにはどうすればよいですか?

• 変更した保持ポリシーが有効にならないのはなぜですか?

• サービスが頻繁に中断されるのはなぜですか?

• メモリ使用量が多いのはなぜですか? インスタンスの仕様をアップグレードする必要がありますか?

• ストレージ容量をスケールインできますか?

• ディスクのサイズを変更するとサービスは再起動されますか?

• サービスの再起動にはどれくらい時間がかかりますか?

• InfluxDB に事前設定された Grafana はサポートされていますか?

• インスタンスへの接続中に IP ブロックエラーが発生したのはなぜですか?

• TSDB for InfluxDB® のバージョンを確認するにはどうすればよいですか?

• シャードグループ期間と保持ポリシーの関係は何ですか?

• 保持ポリシーを変更した後もデータが失われないのはなぜですか?

• TSDB for InfluxDB® がマイクロ秒単位を解析できないのはなぜですか?

データクエリ

• 遅いクエリのトラブルシューティングを行うにはどうすればよいですか?

• GROUP BY time() クエリによって返される時間間隔を指定するにはどうすればよいですか?

• クエリ応答にデータが含まれていない、または一部のデータしか含まれていないのはなぜですか?

• GROUP BY time() クエリの応答に、now() 関数によって返される時間より後のタイムスタンプを持つデータが含まれていないのはなぜですか?

• タイムスタンプに対して算術演算を実行できますか?

• 返されたタイムスタンプに基づいて、データ書き込みの時間粒度を識別できますか?

• クエリで単一引用符 (') と二重引用符 (") はいつ使用しますか?

• デフォルトの保持ポリシー (DEFAULT) を作成した後、データが失われるのはなぜですか?

• OR 演算子を使用して複数の時間範囲を指定する WHERE OR 句の応答にデータが含まれていないのはなぜですか?

• fill(previous) 関数が値を返さないのはなぜですか?

• INTO クエリを実行するとデータが失われるのはなぜですか?

• タグキーとフィールドキーの名前が同じ場合、データをクエリするにはどうすればよいですか?

• メジャーメントをまたいでデータをクエリするにはどうすればよいですか?

• クエリ文のタイムスタンプフィルターの順序は、応答時間に大きな影響を与えますか?

• 値のないタグをクエリする場合、SELECT 文はどのように指定しますか?

データ書き込み

• 書き込みジッターが定期的に発生するのはなぜですか?

• InfluxDB ラインプロトコルを使用してデータを書き込む際の注意事項

• テーブルに書き込まれたデータが表示されないのはなぜですか?

• ディスク容量の使用量を削減した後も、データがディスクに書き込まれないのはなぜですか?

• INTEGER データ型のフィールド値を書き込むにはどうすればよいですか?

• TSDB for InfluxDB® は重複ポイントをどのように処理しますか?

• HTTP API リクエストで必要な改行は何ですか?

• TSDB for InfluxDB® にデータを書き込む際に推奨されない文字や単語は何ですか?

• データを書き込む際に、単一引用符 (') と二重引用符 (") はいつ使用しますか?

• タイムスタンプの粒度はシステムパフォーマンスに大きな影響を与えますか?

TSDB for InfluxDB® の CLI

• Influx CLI を使用して TSDB for InfluxDB® に接続できないのはなぜですか?

• TSDB for InfluxDB® の CLI が人間が読めるタイムスタンプを返すようにするにはどうすればよいですか?

• 管理者でない場合、USE 文を実行してデータベースを指定するにはどうすればよいですか?

• TSDB for InfluxDB® の CLI を使用して、デフォルト以外の保持ポリシーにデータを書き込むにはどうすればよいですか?

データ型

• BOOLEAN データ型のフィールド値をクエリできないのはなぜですか?

• TSDB for InfluxDB® は、シャード間でのフィールドデータ型の違いをどのように処理しますか?

• TSDB for InfluxDB® が格納できる最小整数と最大整数は何ですか?

• TSDB for InfluxDB® が格納できる最小タイムスタンプと最大タイムスタンプは何ですか?

• フィールドのデータ型を表示するにはどうすればよいですか?

• フィールドのデータ型を変換できますか?

InfluxQL 関数

• 関数内で算術演算を実行するにはどうすればよいですか?

• クエリ応答でエポック 0 がタイムスタンプとして使用されるのはなぜですか?

• どの InfluxQL 関数をネストできますか?

InfluxDB データ移行

• セルフマネージド InfluxDB をクラウドに移行するにはどうすればよいですか?

• クラウド内の異なる InfluxDB インスタンス間でデータを移行するにはどうすればよいですか?

• InfluxDB から LindormTSDB にデータを移行するにはどうすればよいですか?

時系列カーディナリティが重要なのはなぜですか?

TSDB for InfluxDB® は、システム内の各系列のインメモリ インデックスを保持します。 系列数が増加すると、ランダムアクセス メモリ（RAM）の使用量が増加します。 系列カーディナリティが過度に高い場合、オペレーティング システムは TSDB for InfluxDB® プロセスを終了し、メモリ不足（OOM）例外をスローします。InfluxQL リファレンス

モデリングはどのように実行しますか? 注意点はありますか?

100 万個以下の時系列を格納することをお勧めします。多数の時系列を含むシナリオの詳細については、「はじめに」をご参照ください。モデリングを開始する前に、「InfluxDB スキーマ設計とデータレイアウト」をご参照ください。InfluxDB は、クエリを高速化するためにタグに基づいてインデックスを作成します。 タグが多すぎると、大量の時系列データのために読み取り/書き込み速度が低下します。 したがって、時系列の数を制御し、次の項目に注意する必要があります。

• ID、ハッシュ値、時間など、無限に拡張されやすい値をタグとして使用しないでください。

• メジャーメントとタグの名前に情報を格納しないでください。 関連情報をタグまたはフィールドに保存します。

• 1 つのタグに複数の情報を格納しないでください。 それらを複数のタグに分割します。

• フィールドが Group By 操作で頻繁に使用される場合、このフィールドはタグとしてモデル化できます。

TSDB for InfluxDB® のバージョンを確認するにはどうすればよいですか?

次の方法を使用して、TSDB for InfluxDB® のバージョンを確認できます。

• curl path/ping コマンドを実行します。

  $ curl -i 'https://<Endpoint>:3242/ping?u=<Account name>&p=<Password>'
  HTTP/1.1204NoContent
  Content-Type: application/json
  X-Influxdb-Build: OSS
  X-Influxdb-Version:1.7.x

• TSDB for InfluxDB® の CLI を使用します。

  $ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242
  
  Connected to https://<Endpoint>:3242 version 1.7.x

シャードグループ期間と保持ポリシーの関係は何ですか?

TSDB for InfluxDB® は、シャードグループにデータを格納します。 各シャードグループは、指定された時間間隔をカバーします。 TSDB for InfluxDB® で指定された時間間隔を表示するには、保持ポリシーの DURATION 要素の値を確認します。 次の表に、シャードグループの時間間隔と保持ポリシーの DURATION 要素の値のデフォルトの関係を示します。

保持ポリシーのシャードグループ期間を表示するには、SHOW RETENTION POLICIES 文を実行します。

保持ポリシーを変更した後もデータが失われないのはなぜですか?

これは、次の理由による可能性があります。

• デフォルトでは、TSDB for InfluxDB® は 30 分ごとに保持ポリシーをチェックして適用します。 TSDB for InfluxDB® は、次回のチェック時にデータを削除する場合があります。 これは、データが duration から除外された時間範囲内で取得された場合に適用されます。 この場合、期間は新しい保持ポリシーによって指定されます。

• 保持ポリシーの DURATION 値と SHARD DURATION 値の変更により、予期しないデータ保持が発生する可能性があります。 TSDB for InfluxDB® は、シャードグループにデータを格納します。 各シャードグループには、特定の保持ポリシーと時間間隔が含まれています。 TSDB for InfluxDB® が保持ポリシーを適用する場合、TSDB for InfluxDB® はシャードグループ内のすべてのポイントを削除します。 この場合、個々のポイントは削除されません。 TSDB for InfluxDB® はシャードグループを分割できません。 次の 2 つの条件が満たされると、システムはすべてのデータを以前のシャードグループに保存することを強制されます。(1) 新しい保持ポリシーの DURATION 値が以前の保持ポリシーの SHARD DURATION 値よりも小さい、(2) TSDB for InfluxDB® が DURATION 要素で指定された時間間隔よりも長い時間間隔をカバーする以前のシャードグループにデータを書き込んでいる。 この場合、シャードグループ内の一部のポイントが新しい DURATION 値で指定された時間間隔から外れていても、システムはすべてのデータを以前のシャードグループに保存します。 以前のシャードグループ内のすべてのデータポイントが新しい DURATION 値で指定された時間間隔から外れている場合、TSDB for InfluxDB® はシャードグループ全体を削除します。 その後、システムは、SHARD DURATION 要素で指定された新しい短い時間間隔を持つシャードグループにデータの書き込みを開始します。 これにより、予期しないデータ保持を防ぐことができます。

TSDB for InfluxDB® がマイクロ秒単位を解析できないのはなぜですか?

マイクロ秒単位を指定するために使用される構文は、特定のシナリオによって異なります。 これらのシナリオには、データ書き込み、TSDB for InfluxDB® の CLI での時間粒度設定、およびデータクエリが含まれます。 次の表に、各シナリオでサポートされている構文を示します。

例

french_bulldogs メジャーメントには、color タグと name フィールドが含まれています。

> SELECT * FROM "french_bulldogs"
name: french_bulldogs
---------------------
time                  color  name
2016-05-25T00:05:00Z  peach  nugget
2016-05-25T00:05:00Z  grey   rumple
2016-05-25T00:10:00Z  black  prince

INTEGER データ型のフィールド値を書き込むにはどうすればよいですか?

整数データ型のフィールド値を書き込むには、フィールド値の末尾に i を追加します。 i を追加しないと、TSDB for InfluxDB® は値を浮動小数点数として処理します。

整数を書き込む：value=100i。 浮動小数点数を書き込む：value=100。

TSDB for InfluxDB® は重複ポイントをどのように処理しますか?

ポイントは、メジャーメント名、タグセット、およびタイムスタンプによって一意に識別されます。 2 つのポイントのメジャーメント名、タグセット、およびタイムスタンプが同じ場合、それらは重複ポイントと見なされます。 既存のポイントとは異なるフィールドセットを持つ重複ポイントを送信すると、ポイントのフィールドセットは以前のフィールドセットと新しいフィールドセットの合計になります。 競合が発生した場合、新しいフィールドセットが優先されます。 これは予期された結果です。

例：

以前のポイント：cpu_load,hostname=server02,az=us_west val_1=24.5,val_2=7 1234567890000000

新しいポイント：cpu_load,hostname=server02,az=us_west val_1=5.24 1234567890000000

新しいポイントを送信すると、TSDB for InfluxDB® は新しい val_1 値を使用して以前の値 val_1 を上書きします。 値 val_2 は、ポイントのフィールドセットに保持されます。

> SELECT * FROM "cpu_load" WHERE time =1234567890000000
name: cpu_load
--------------
time                      az        hostname   val_1   val_2
1970-01-15T06:56:07.89Z   us_west   server02   5.247

以前のポイントと新しいポイントを格納するには、次の方法を使用できます。

• 新しいタグを導入して一意性を確保します。

  以前のポイント：cpu_load,hostname=server02,az=us_west,uniq=1 val_1=24.5,val_2=7 1234567890000000

  新しいポイント：cpu_load,hostname=server02,az=us_west,uniq=2 val_1=5.24 1234567890000000

  新しいポイントを TSDB for InfluxDB® に書き込むと、次の結果が表示されます。

  > SELECT * FROM "cpu_load" WHERE time =1234567890000000
  name: cpu_load
  --------------
  time                      az        hostname   uniq   val_1   val_2
  1970-01-15T06:56:07.89Z   us_west   server02   124.57
  1970-01-15T06:56:07.89Z   us_west   server02   25.24

• 新しいポイントのタイムスタンプに 1 ナノ秒を追加します。

  以前のポイント：cpu_load,hostname=server02,az=us_west val_1=24.5,val_2=7 1234567890000000

  新しいポイント：cpu_load,hostname=server02,az=us_west val_1=5.24 1234567890000001

  新しいポイントを TSDB for InfluxDB® に書き込むと、次の結果が表示されます。

  > SELECT * FROM "cpu_load" WHERE time >=1234567890000000 and time <=1234567890000001
  name: cpu_load
  --------------
  time                             az        hostname   val_1   val_2
  1970-01-15T06:56:07.89Z          us_west   server02   24.57
  1970-01-15T06:56:07.890000001Z   us_west   server02   5.24

HTTP API リクエストで必要な改行は何ですか?

TSDB for InfluxDB® のラインプロトコルでは、\n 改行は行の終わりと新しい行の始まりを示すために使用されます。 改行の ASCII コードは 0x0A です。 \n 以外の改行がファイルまたはデータで使用されている場合、bad timestamp および unable to parse エラーが発生します。

注：Windows は、\r\n 改行またはキャリッジリターンを使用して、行の終わりと新しい行の始まりを示します。

TSDB for InfluxDB® にデータを書き込む際に推奨されない文字や単語は何ですか?

• InfluxQL キーワード

  InfluxQL キーワードを識別子として使用する場合、クエリでキーワードを二重引用符 (") で囲む必要があります。 そうしないと、エラーが発生する可能性があります。 識別子は、連続クエリ名、データベース名、フィールドキー、メジャーメント名、保持ポリシー名、サブスクリプション名、タグキー、またはユーザー名にすることができます。

• time

  クエリ文では、time キーワードを識別子として使用でき、識別子を二重引用符 (") で囲む必要はありません。 time キーワードは、連続クエリ名、データベース名、メジャーメント名、保持ポリシー名、またはユーザー名として使用できます。 これらの場合、time を二重引用符 (") で囲む必要はありません。 ただし、time キーワードをフィールドキーまたはタグキーとして使用することはできません。 TSDB for InfluxDB® は、time キーワードがフィールドキーまたはタグキーであるデータ書き込みを拒否し、エラーを報告します。 例：

  • time キーワードをメジャーメント名として使用してデータを書き込み、メジャーメントをクエリします。

    > INSERT time value=1
    
    > SELECT * FROM time
    
    name: time
    time                            value
    ---------
    2017-02-07T18:28:27.349785384Z1

    TSDB for InfluxDB® では、time キーワードは有効なメジャーメント名です。

  • time キーワードをフィールドキーとして使用してデータを書き込み、フィールドキーをクエリしようとします。

    > INSERT mymeas time=1
    ERR:{"error":"partial write: invalid field name: input field \"time\" on measurement \"mymeas\" is invalid dropped=1"}

    TSDB for InfluxDB® では、time キーワードは無効なフィールドキーです。 システムはポイントの書き込みに失敗し、400 エラーコードを返します。

  • time キーワードをタグキーとして使用してデータを書き込み、タグキーをクエリしようとします。

    > INSERT mymeas,time=1 value=1
    ERR:{"error":"partial write: invalid tag key: input tag \"time\" on measurement \"mymeas\" is invalid dropped=1"}

    TSDB for InfluxDB® では、time キーワードは無効なタグキーです。 システムはポイントの書き込みに失敗し、400 エラーコードを返します。

• 文字

  単純な正規表現と引用符の使用を維持するために、識別子には次の文字を使用しないことをお勧めします。バックスラッシュ (\)、カレット (^)、ドル記号 ($)、単一引用符 (')、二重引用符 (")、等号 (=)、およびコンマ (,)。

データを書き込む際に、単一引用符 (') と二重引用符 (") はいつ使用しますか?

• ラインプロトコルに基づいてデータを書き込む場合、識別子を囲むために単一引用符 (') または二重引用符 (") を使用しないでください。 次の例では、引用符を使用した後、クエリがより複雑になります。 識別子は、連続クエリ名、データベース名、フィールドキー、メジャーメント名、保持ポリシー名、サブスクリプション名、タグキー、またはユーザー名にすることができます。

  • 二重引用符 (") で囲まれたメジャーメントを書き込む：INSERT "bikes" bikes_available=3。 該当するクエリ：SELECT * FROM "\"bikes\""。

  • 単一引用符 (') で囲まれたメジャーメントを書き込む：INSERT 'bikes' bikes_available=3。 該当するクエリ：SELECT * FROM "\'bikes\'"。

  • 引用符で囲まれていないメジャーメントを書き込む：INSERT bikes bikes_available=3。 該当するクエリ：SELECT * FROM "bikes"。

• 文字列フィールド値を囲むには、二重引用符 (") を使用する必要があります。

  データを書き込む：INSERT bikes happiness="level 2"。 該当するクエリ：SELECT * FROM "bikes" WHERE "happiness"='level 2'。

• 特殊文字を囲むために引用符を使用しないでください。 バックスラッシュ (\) エスケープ文字を使用して特殊文字を書式設定します。

  データを書き込む：INSERT wacky va\"ue=4。 該当するクエリ：SELECT "va\"ue" FROM "wacky"。

ドキュメント行プロトコル リファレンスで詳細をご確認ください。

タイムスタンプの粒度はシステムパフォーマンスに大きな影響を与えますか?

はい、タイムスタンプの粒度はシステムパフォーマンスに大きな影響を与えます。 システムパフォーマンスを最大化するには、粗い時間粒度を使用して TSDB for InfluxDB® にデータを書き込むことをお勧めします。

次の 2 つの例では、最初の要求にデフォルトの時間粒度 (ナノ秒単位) が指定されています。 2 番目の要求には、時間粒度 (秒単位) が指定されています。

curl -i -XPOST "https://<Endpoint>:3242/write?db=weather&u=<Account name>&p=<Password>"--data-binary 'temperature,location=1 value=90 1472666050000000000'

curl -i -XPOST "https://<Endpoint>:3242/write?db=weather&precision=s&u=<Account name>&p=<Password>"--data-binary 'temperature,location=1 value=90 1472666050'

ただし、より粗い時間粒度を使用してデータを書き込むと、同じタイムスタンプを持つ重複ポイントが発生しやすくなります。 この場合、一部のポイントが上書きされる可能性があります。

Influx CLI を使用して TSDB for InfluxDB® に接続できないのはなぜですか?？

次の条件を満たしているかどうかを確認します。

• 実行権限が必要です。 chmod +x ./influx コマンドを実行して権限を追加できます。

• 接続文に -ssl オプションを指定する必要があります。

• -host オプションの接続文字列 (例：ts-bp17j28j2y7pm****.influxdata.rds.aliyuncs.com) のみ指定する必要があります。 プロトコルとポート番号を指定する必要はありません。

TSDB for InfluxDB® の CLI が人間が読めるタイムスタンプを返すようにするにはどうすればよいですか?人間が判読できるタイムスタンプを返すにはどうすればよいですか？

CLI に初めて接続するときは、RFC 3339 に基づいて時間粒度を指定する必要があります。

$ influx -ssl -username <Account name>-password <Password>-host <Endpoint>-port 3242-precision rfc3339

CLI に接続した後に時間粒度を指定することもできます。

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242
Connected to https://<Endpoint>:3242 version 1.7.x
> precision rfc3339

詳細については、「TSDB for InfluxDB® の CLI」をご参照ください。

管理者でない場合、USE 文を実行してデータベースを指定するにはどうすればよいですか?使用管理者でない場合にデータベースを指定する文はありますか？

管理者でない場合は、USE <database_name> 文を実行してデータベースを指定できます。ただし、この場合、データベースに対する READ 権限と WRITE 権限、または READ 権限のみを持っている必要があります。そうでない場合、システムは次のエラーを返します：

ERR:Database<database_name> doesn't exist. Run SHOW DATABASES for a list of existing databases.

TSDB for InfluxDB® の CLI を使用して、デフォルト以外の保持ポリシーにデータを書き込むにはどうすればよいですか?デフォルト以外の保持ポリシーにデータを書き込むにはどうすればよいですか？

INSERT INTO [<database>.]<retention_policy> <line_protocol> 文を実行して、デフォルト以外の保持ポリシーにデータを書き込みます。 この方法は、TSDB for InfluxDB® の CLI でのみ使用して、データベースと保持ポリシーを指定できます。 HTTP 経由でデータを書き込むには、db パラメーターと rp パラメーターを使用して、それぞれデータベースと保持ポリシーを指定する必要があります。 rp パラメーターはオプションです。 例：

> INSERT INTO one_day mortality bool=true
Using retention policy one_day
> SELECT * FROM "mydb"."one_day"."mortality"
name: mortality
---------------
time                             bool
2016-09-13T22:29:43.229530864Z   true

デフォルト以外の保持ポリシーのデータをクエリする場合、メジャーメントを完全修飾する必要があります。 次の構文を使用して、メジャーメントを完全修飾できます。

"<database>"."<retention_policy>"."<measurement>"

BOOLEAN データ型のフィールド値をクエリできないのはなぜですか?

BOOLEAN 値を書き込む構文は、BOOLEAN 値をクエリする構文とは異なります。

たとえば、SELECT * FROM "hamlet" WHERE "bool"=True 文は、bool の値が TRUE であるすべてのポイントを返します。 ただし、SELECT * FROM "hamlet" WHERE "bool"=T 文は結果を返しません。

TSDB for InfluxDB® は、シャード間でのフィールドデータ型の違いをどのように処理しますか?

フィールド値のデータ型は、FLOAT、INTEGER、STRING、または BOOLEAN にすることができます。 フィールド値のデータ型は、各シャードで同じである必要があります。 ただし、フィールド値のデータ型は、シャード間で異なる場合があります。

• SELECT 文

  すべてのフィールド値のデータ型が同じ場合、SELECT 文はすべてのフィールド値を返します。 フィールド値のデータ型がシャード間で異なる場合、TSDB for InfluxDB® はデータ型を変換するために必要な操作を実行します (該当する場合)。 その後、TSDB for InfluxDB® は、FLOAT、INTEGER、STRING、BOOLEAN というデータ型のシーケンスに基づいてすべてのフィールド値を返します。 データに異なるデータ型を持つフィールド値が見つかった場合は、<field_key>::<type> 構文を使用して異なるデータ型をクエリします。 例：

  just_my_type メジャーメントでは、my_field フィールドには 4 つのシャードに 4 つの値があります。 my_field フィールドのこれらの値のデータ型は互いに異なります。 データ型は FLOAT、INTEGER、STRING、および BOOLEAN です。

  SELECT * 文は、FLOAT データ型と INTEGER データ型の値のみを返します。 文への応答で、TSDB for InfluxDB® は INTEGER データ型の値を FLOAT データ型の値に変換します。

  > SELECT * FROM just_my_type
  
  name: just_my_type
  ------------------
  time                      my_field
  2016-06-03T15:45:00Z9.87034
  2016-06-03T16:45:00Z7

  SELECT <field_key>::<type> [...] 文は、すべてのデータ型の値を返します。 TSDB for InfluxDB® は、各型の出力データを別々の列に格納し、列名は my_field、my_field_1、my_field_2 などのようにインクリメントされます。 TSDB for InfluxDB® を使用して、フィールド値のデータ型を別のデータ型に変換できます。 ただし、これは特定の要件に基づいています。 次の例では、TSDB for InfluxDB® は 7 整数を最初の列に含まれる浮動小数点数に変換します。 TSDB for InfluxDB® は、9.879034 浮動小数点数を 2 番目の列に含まれる整数に変換します。 TSDB for InfluxDB® は、浮動小数点数または整数を文字列またはブール値に変換できません。

  > SELECT "my_field"::float,"my_field"::integer,"my_field"::string,"my_field"::boolean FROM just_my_type
  
  name: just_my_type
  ------------------
  time                   my_field  my_field_1  my_field_2  my_field_3
  2016-06-03T15:45:00Z9.870349
  2016-06-03T16:45:00Z77
  2016-06-03T17:45:00Z                         a string
  2016-06-03T18:45:00Z                                     true

• SHOW FIELD KEYS 文

  SHOW FIELD KEYS 文は、指定されたフィールドキーに関連付けられている各シャードのすべてのデータ型を返します。 例：

  just_my_type メジャーメントでは、my_field フィールドには 4 つのシャードに 4 つの値があります。 my_field フィールドのこれらの値のデータ型は互いに異なります。 データ型は FLOAT、INTEGER、STRING、および BOOLEAN です。

  SHOW FIELD KEYS 文は、4 つのデータ型すべてを返します。

  > SHOW FIELD KEYS
  
  name: just_my_type
  fieldKey   fieldType
  -----------------
  my_field   float
  my_field   string
  my_field   integer
  my_field   boolean

TSDB for InfluxDB® が格納できる最小整数と最大整数は何ですか?

TSDB for InfluxDB® は、整数を符号付き Int64 値として格納します。 有効な Int64 値の最小値は -9023372036854775808 です。 有効な Int64 値の最大値は 9023372036854775807 です。 詳細については、「Go builtins」をご参照ください。

格納されている値が最小整数または最大整数に近い場合、予期しない結果が発生する可能性があります。 一部の関数と演算子は、計算中に Int64 値を Float64 値に変換する場合があります。 ただし、これによりオーバーフローの問題が発生する可能性があります。

TSDB for InfluxDB® が格納できる最小タイムスタンプと最大タイムスタンプは何ですか?

最小タイムスタンプは -9223372036854775806 または 1677-09-21T00:12:43.145224194Z です。 最大タイムスタンプは 9223372036854775806 または 2262-04-11T23:47:16.854775806Z です。 タイムスタンプが有効な範囲から外れている場合、解析エラーが発生します。

フィールドのデータ型を表示するにはどうすればよいですか?

SHOW FIELD KEYS 文を実行して、フィールドのデータ型を表示できます。

> SHOW FIELD KEYS FROM all_the_types
name: all_the_types
-------------------
fieldKey  fieldType
blue      string
green     boolean
orange    integer
yellow    float

フィールドのデータ型を変換できますか?

はい、フィールドのデータ型を変更できます。 ただし、TSDB for InfluxDB® を介して他のデータ型に変換できるデータ型は限られています。 <field_key>::<type> 構文を使用して、フィールド値を整数から浮動小数点数に変換できます。 また、フィールド値を浮動小数点数から整数に変換することもできます。 データ型変換の詳細については、「データ探索」をご参照ください。 浮動小数点数または整数を文字列またはブール値に変換することはできません。 同様の場合、文字列またはブール値を浮動小数点数または整数に変換することはできません。

次の代替方法を使用して、データ型を変更できます。

• データを別のフィールドに書き込む

  最も簡単な方法は、新しいデータ型のデータを同じ時系列の別のフィールドに書き込むことです。

• シャードシステムを使用する

  フィールド値のデータ型は、各シャードで同じである必要があります。 ただし、フィールド値のデータ型は、シャード間で異なる場合があります。

  フィールド値のデータ型を変更する場合、SHOW SHARDS 文を実行して、現在のシャードの end_time 値をクエリできます。 TSDB for InfluxDB® を使用して、異なるデータ型のデータを既存のフィールドに書き込むことができます。 これは、ポイントのタイムスタンプが end_time で指定された時間より後の場合に適用されます。 たとえば、データのタイムスタンプが現在のシャードの終了時刻より前の場合、フィールドに整数を書き込むことしかできません。 ただし、データのタイムスタンプが end_time で指定された時間より後の場合、フィールドに浮動小数点数を書き込むことができます。

  このプロセスでは、元のシャードのフィールド値のデータ型は変更されません。

関数内で算術演算を実行するにはどうすればよいですか?

TSDB for InfluxDB® を使用して関数内で算術演算を実行することはできません。 サブクエリを実行して同じ目的を達成することをお勧めします。 例：

InfluxQL は次の構文をサポートしていません。

SELECT MEAN("dogs"-"cats")from"pet_daycare"

ただし、次のサブクエリを実行して同じ目的を達成できます。

> SELECT MEAN("difference") FROM (SELECT "dogs"-"cat" AS "difference" FROM "pet_daycare")

サブクエリの詳細については、「データ探索」をご参照ください。

クエリ応答でエポック 0 がタイムスタンプとして使用されるのはなぜですか?

ほとんどの場合、エポック 0 (1970-01-01T00:00:00Z) は、TSDB for InfluxDB® でヌルタイムスタンプとして使用されます。 クエリでタイムスタンプを返すことができない場合、TSDB for InfluxDB® はエポック 0 をタイムスタンプとして返します。 たとえば、このルールは、集計関数に時間範囲が指定されていない場合に適用されます。

どの InfluxQL 関数をネストできますか?

次の InfluxQL 関数をネストできます。

• DISTINCT() にネストされた COUNT()

• CUMULATIVE_SUM()

• DERIVATIVE()

• DIFFERENCE()

• ELAPSED()

• MOVING_AVERAGE()

• NON_NEGATIVE_DERIVATIVE()

• HOLT_WINTERS() および HOLT_WINTERS_WITH_FIT()

ネストされた関数の代わりにサブクエリを使用する方法の詳細については、「データ探索」をご参照ください。

セルフマネージド InfluxDB をクラウドに移行するにはどうすればよいですか?

InfluxDB が提供する公式の influx_inspect ツールを使用して、セルフマネージド InfluxDB サーバーからラインプロトコルファイルをエクスポートし、「TSDB for InfluxDB® の CLI」を使用してファイルを TSDB for InfluxDB® にインポートできます。

クラウド内の異なる InfluxDB インスタンス間でデータを移行するにはどうすればよいですか?

異なる InfluxDB インスタンス間でデータを移行することはできません。 これを行うには、移行するデータをクエリしてエクスポートし、手動でデータを移行する必要があります。 クエリプロセス中は、システムの安定性に影響を与える大きなクエリを避ける必要があります。 時間または時系列でフィルタリングして、複数のデータを同時に移行できます。

InfluxDB から LindormTSDB にデータを移行するにはどうすればよいですか?

LindormTSDB は、InfluxDB から既存データをインポートするための Lindorm Tunnel Service (LTS) を提供します。 LTS を使用して、InfluxDB から LindormTSDB に完全データを移行できます。