Conference
Meet EMQ at SPS 2026: Real-Time Data for Industrial AI →

EMQX CLICKHOUSE 統合

MQTT データを ClickHouse にストリーミング

EMQX でデバイステレメトリを取り込み、フィルタリング・変換した後、ClickHouse でクエリしてダッシュボードや分析に活用します。

概要

MQTT テレメトリーを分析に活用

EMQX で処理したテレメトリを使い、デバイスの履歴を検索し、設備の性能を比較して、変化の原因を調査します。

テレメトリーをクエリ可能に

デバイスの測定値やイベントをクエリして時系列の変化を調べ、業務に合わせたダッシュボードを構築できます。

必要なデータだけを保持

EMQX でメッセージをフィルタリングし、必要なフィールドを選択することで、クエリに適した形のデータを ClickHouse に送れます。

一時的な中断に対応

ClickHouse が一時的に中断した場合でも、EMQX はリクエストをキューに保持し、設定したバッファ容量と有効期限の範囲内で配信を再試行します。

アーキテクチャ

MQTT メッセージから ClickHouse のクエリまで

デバイスが EMQX にデータをパブリッシュします。SQL ルールでテレメトリを処理して ClickHouse のテーブルに書き込み、分析ツールからクエリします。

機能

ClickHouse へのデータ取り込みパイプラインを構築

メッセージのフィールドを整え、データベースへの書き込みを調整し、EMQX から ClickHouse への配信を監視します。

SQL でデータを整形

データベースに書き込む前に、SQL ルールでトピックとフィールドを選択し、不要なメッセージを除外して、ペイロードの値を変換します。

ルール SQL リファレンス

フィールドをテーブルにマッピング

INSERT テンプレートで、ルールの結果を ClickHouse のカラムにマッピングします。値とデータ型は対象テーブルに合わせてください。

ClickHouse Sink ガイド

データベースへのバッチ書き込み

複数のレコードをバッチにまとめ、データベースへのリクエスト数を減らします。実際に近いトラフィックでバッチサイズを調整し、レコードがクエリ可能になるタイミングを確認してください。

バッチ設定

クエリモードを選択

EMQX のクエリモードは同期と非同期から選べます。非同期モードでは、データベースの応答を待たずに MQTT のパブリッシュ処理が進みます。

クエリモードガイド

バッファリングとリトライ

ワークロードに合わせてバッファ容量とリクエストの有効期限を設定します。配信の失敗を監視し、中断後にパイプラインがどのように復旧するかをテストしてください。

バッファー設定

取り込み状況を監視

成功、失敗、破棄されたリクエスト数とキューの深さを追跡し、配信の問題を特定してパイプラインを調整します。

監視ガイド

仕組み

3 ステップでパイプラインを構築

EMQX がデータを挿入できる ClickHouse のテーブルと認証情報を用意し、EMQX Dashboard でパイプラインを設定します。

始める前に

  • EMQX から接続可能な ClickHouse エンドポイント。
  • テレメトリを保存する対象テーブル。
  • 対象テーブルへの書き込み権限を持つ認証情報。
  1. 1

    デバイスを接続

    デバイスや MQTT クライアントを EMQX に接続し、分析したいテレメトリーをパブリッシュします。

  2. 2

    メッセージを整形

    メッセージを選択し、ClickHouse テーブル用にフィールドを整える SQL ルールを作成してテストします。

  3. 3

    書き込みと検証

    INSERT テンプレートを指定して ClickHouse のコネクターと Sink を設定します。テストメッセージをパブリッシュし、テーブルをクエリして配信を確認します。

リソース

EMQX と ClickHouse の統合を詳しく見る

FAQ

よくある質問

MQTT から ClickHouse へのパイプラインを構築

MQTT データの取り込み、ClickHouse のスキーマ、分析の目標について、EMQX のエキスパートと一緒に計画を立てましょう。