Lindorm:データのクエリ

アクセス方法

SQL クエリには、以下の 3 つのアクセス方法が利用可能です。

SAMPLE BY 句と GROUP BY 句の連携動作

LindormTSDB では、時系列データのダウンサンプリングに SAMPLE BY 句、複数の時系列に対する集約処理に GROUP BY 句を使用します。ただし、これらの 2 つの句は同一クエリレベルで併用できません。代わりに、GROUP BY を含む外部クエリで、SAMPLE BY を含むサブクエリをラップしてください。

単一の時系列をダウンサンプリングする

以下のクエリは、特定のデバイスの湿度測定値を 8 時間間隔でダウンサンプリングします：

SELECT device_id, region, time, count(humidity) AS count_humidity
FROM sensor
WHERE device_id = 'F07A1260'
SAMPLE BY 8h;

複数の時系列をダウンサンプリングした後、集約する

以下のクエリは、サブクエリ内で全デバイスのデータを 8 時間間隔でダウンサンプリングし、外部クエリでデバイス ID ごとに結果を集約します：

SELECT device_id, max(avg_humidity) AS max_humidity
FROM (
  SELECT device_id, region, time, avg(humidity) AS avg_humidity
  FROM sensor
  SAMPLE BY 8h
)
GROUP BY device_id;

詳細については、以下をご参照ください。

• ダウンサンプリングクエリ

• 最新値のクエリ

• 一般的な時系列関数

メトリックとテーブルのマッピング

TSDB では、データはメトリック名で整理されます。一方、LindormTSDB では、メトリックはテーブルに対応付けられます。HTTP SQL API、Java Native SDK、InfluxDB line protocol、または TSDB 互換のマルチ値オペレーションを介して書き込まれたデータをクエリする場合、metric@field 形式でメトリックを指定します：

• metric — テーブル名

• field — 対象データを格納するカラム名

マルチ値データのクエリ

以下のいずれかの方法で書き込まれたマルチ値データは、TSDB 互換のオペレーションでクエリできます：

• TSDB 互換 API オペレーション

• HTTP SQL API

• Java Native SDK

• InfluxDB line protocol

手順については、以下をご参照ください。

• 多変量データポイントのクエリ — API オペレーションを使用する場合

• SDK のマルチ値データモデルを使用したデータ読み取り — SDK を使用する場合

シングル値データのクエリ

TSDB 互換 API オペレーションで書き込まれたシングル値データは、同じ TSDB 互換 API オペレーションでクエリできます。ただし、新規開発ではこの方法は推奨されません。代わりに、SQL クエリをご利用ください。

参考情報については、以下をご参照ください。

• シングル値データポイントのクエリ — API オペレーションを使用する場合

• データのクエリ — SDK を使用する場合

Alibaba Cloud Lindorm データソースプラグイン

Alibaba Cloud Lindorm データソースプラグインでは、Grafana のクエリエディター内で自動生成またはカスタムの SQL ステートメントを直接使用して LindormTSDB をクエリできます。「Grafana を使用した LindormTSDB へのアクセス」をご参照ください。

OpenTSDB データソースプラグイン

LindormTSDB は OpenTSDB 互換の API オペレーションを公開しているため、Grafana 内の OpenTSDB データソースプラグインを接続して、Lindorm の時系列データをクエリできます。

このプラグインを介して、HTTP SQL API、Java Native SDK、InfluxDB line protocol、または TSDB 互換のマルチ値オペレーションで書き込まれたデータをクエリする場合、前述の「メトリックとテーブルのマッピング」で説明した通り、metric@field 形式でメトリックを指定してください。