# MQTTデータをRedisに取り込む

[Redis](https://redis.io/)は、オープンソースのインメモリデータストアであり、データベース、キャッシュ、ストリーミングエンジン、メッセージブローカーとして数百万の開発者に利用されています。EMQXはRedisとの統合をサポートしており、MQTTメッセージやクライアントイベントをRedisに保存できます。Redisデータ統合により、メッセージのキャッシュやクライアントイベントの統計にRedisを活用できます。

本ページでは、EMQX CloudとRedis間のデータ統合について詳細に解説し、データ統合の作成および検証方法を実践的に説明します。

## 動作概要

Redisデータ統合はEMQX Cloudに標準搭載された機能であり、EMQX Cloudのリアルタイムデータキャプチャと送信能力をRedisの豊富なデータ構造および強力なキー・バリューの読み書き性能と組み合わせています。組み込みの[ルールエンジン](./rules.md)コンポーネントにより、EMQX CloudからRedisへのデータ取り込みを簡素化し、複雑なコーディングを不要にします。

以下の図は、EMQX CloudとRedis間の典型的なデータ統合アーキテクチャを示しています。

![EMQX Cloud Integration Redis](./_assets/data_integration_redis.png)

MQTTデータをRedisに取り込む流れは以下の通りです。

1. **メッセージのパブリッシュと受信**：産業用IoTデバイスはMQTTプロトコルを通じてEMQX Cloudのデプロイメントに正常に接続し、機械やセンサー、製造ラインの稼働状態、計測値、トリガーイベントに基づくリアルタイムMQTTデータをEMQX Cloudにパブリッシュします。EMQX Cloudがこれらのメッセージを受信すると、ルールエンジン内でマッチング処理を開始します。
2. **メッセージデータの処理**：メッセージが到着するとルールエンジンを通過し、EMQX Cloudで定義されたルールにより処理されます。ルールは事前定義された条件に基づき、どのメッセージをRedisにルーティングするかを決定します。ペイロード変換が指定されている場合は、データ形式の変換、特定情報のフィルタリング、追加コンテキストによるペイロードの強化などが適用されます。
3. **Redisへのデータ取り込み**：ルールエンジンがデータを処理した後、設定されたRedisコマンドを実行してキャッシュやカウントなどの操作を行います。
4. **データの保存と活用**：Redisに保存されたデータを読み取ることで、企業はRedisの豊富なデータ操作機能を活用し、様々なユースケースを実現できます。例えば物流分野では、デバイスの最新状態取得やGPS地理位置情報の分析、リアルタイムデータ分析やソートなどの操作が可能となり、リアルタイム追跡やルート推奨などの機能を実現します。

## 特長と利点

Redisとのデータ統合は、効率的なデータ送信、処理、活用を実現するために以下の特長と利点を備えています。

- **高性能かつスケーラブル**：EMQXの分散アーキテクチャとRedisのクラスター機能により、データ量の増加に応じてアプリケーションをシームレスにスケール可能です。大規模データセットでも一貫した性能と応答性を維持します。
- **リアルタイムデータストリーム**：EMQX Cloudはリアルタイムデータストリームの処理に特化しており、デバイスからRedisへの効率的かつ信頼性の高いデータ送信を実現します。Redisは迅速なデータ操作を実行可能であり、リアルタイムデータキャッシュのニーズに応え、EMQX Cloudの理想的なデータストレージコンポーネントとなります。
- **リアルタイムデータ分析**：Redisはデバイス接続数、メッセージパブリッシュ数、特定のビジネス指標などのリアルタイムメトリクス計算に利用可能です。一方、EMQX Cloudはリアルタイムメッセージの送受信と処理を担い、データ分析のためのリアルタイム入力を提供します。
- **地理位置情報分析**：Redisは地理空間データ構造とコマンドを提供し、地理位置情報の保存とクエリが可能です。EMQX Cloudの強力なデバイス接続機能と組み合わせることで、物流、コネクテッドカー、スマートシティなど多様なIoTアプリケーションに広く応用できます。

## はじめる前に

本セクションでは、Redisデータ統合の作成を開始する前に必要な準備、特にRedisサーバーのセットアップ方法について説明します。

### 前提条件

- [データ統合](./introduction.md)に関する知識
- EMQX Cloudデータ統合の[ルール](./rules.md)に関する知識

### ネットワーク設定

<!--@include: ./network-setting.md-->

### Redisサーバーのインストール

#### DockerでRedisをインストール

Dockerを使ってRedisをインストールし、起動します。

```bash
# Redisコンテナを起動
docker run --name redis -p 6379:6379 -d redis

# コンテナにアクセス
docker exec -it redis bash

# Redisサーバーにアクセス
redis-cli

# インストール確認
127.0.0.1:6379> set emqx_cloud "Hello World"
OK
127.0.0.1:6379> get emqx_cloud
"Hello World"
```

これでRedisのインストールが成功し、`SET`および`GET`コマンドで動作確認ができました。Redisのコマンドについては[Redis Commands](https://redis.io/commands/)をご参照ください。

#### Redis CloudでRedisサービスを作成

1. [Redis Cloud](https://redis.com/cloud/overview/)コンソールにログインし、サブスクリプションを作成します。デモではFixed Planを選択可能です。
2. データベースを作成します。
3. データベースの設定ページで、接続に必要なアドレス、ユーザー名、パスワードなどの情報を確認します。
4. 接続ボタンをクリックし、Redis CLIオプションを選択してコマンドをコピーし、コマンドラインで実行してサービスに接続し検証します。

詳細は[Redis Cloud Documentation](https://docs.redis.com/)をご参照ください。

## コネクターの作成

データ統合ルールを作成する前に、RedisサーバーにアクセスするためのRedisコネクターを作成する必要があります。

1. デプロイメントに移動し、左側ナビゲーションメニューから**データ統合**をクリックします。

2. 初めてコネクターを作成する場合は、**データ永続化**カテゴリの下にある**Redis**を選択します。既にコネクターを作成済みの場合は、**新規コネクター**を選択し、続いて**データ永続化**カテゴリの**Redis**を選択します。

3. **コネクター名**はシステムが自動生成します。

4. ビジネスニーズに応じて**Redisモード**を設定します。例：`single`

5. 接続情報を入力します。

   - **サーバーホスト**：サーバーのIPアドレスとポート番号
   - **データベースID**：`0`を入力
   - **ユーザー名とパスワード**：Redis Cloudで作成したサービスの場合、データベースの設定ページからユーザー名とパスワードをコピーして入力します。
   - その他のオプションはビジネスニーズに応じて設定します。
   - 暗号化接続を確立したい場合は、**TLSを有効にする**のトグルスイッチをクリックします。

6. **テスト**ボタンをクリックします。Redisサービスにアクセス可能であれば成功メッセージが表示されます。

7. **新規作成**ボタンをクリックして作成を完了します。

## ルールの作成

次に、書き込むデータを指定するルールを作成し、処理済みデータをRedisに転送するためのアクションをルールに追加します。

1. ルールエリアで**新規ルール**をクリックするか、作成したコネクターの**アクション**列にある新規ルールアイコンをクリックします。

2. 利用したい機能に基づき、**SQLエディター**でルールを設定します。ここでは、クライアントが`temp_hum/emqx`トピックに温度と湿度のメッセージを送信した際にエンジンをトリガーするSQLを例示します。

   ```sql
    SELECT
      timestamp div 1000 as up_timestamp,
      clientid as client_id,
      payload as temp_hum
    FROM
      "temp_hum/emqx"
   ```

   ::: tip

   初心者の方は、**SQL例**をクリックし、**試してみる**でSQLルールを学習・テストできます。

   :::

3. **次へ**をクリックしてアクションを追加します。

4. **コネクター**のドロップダウンから先ほど作成したコネクターを選択します。

5. **Redisコマンドテンプレート**を設定します。トピックから読み取った"up_timestamp"、"client_id"、"temperature"、"humidity"のデータをRedisに保存します。

   ```bash
    HMSET ${client_id} ${up_timestamp} ${temp_hum}
   ```

6. **確認**ボタンをクリックしてルール作成を完了します。

7. **新規ルール成功**のポップアップで**ルールに戻る**をクリックし、データ統合設定の一連の作業を完了します。

## ルールのテスト

[MQTTX](https://mqttx.app/)を使って温度と湿度のデータ送信をシミュレートすることを推奨しますが、他のクライアントでも構いません。

1. MQTTXでデプロイメントに接続し、以下のトピックにメッセージを送信します。

   - トピック：`temp_hum/emqx`
   - クライアントID：`test_client`
   - ペイロード：

     ```json
     {
       "temp": "27.5",
       "hum": "41.8"
     }
     ```

2. 保存された結果を確認します。

   - DockerでインストールしたRedisの場合は、まずコンテナにアクセスし、`redis-cli`を実行してRedisサービスに接続します。
   - Redis Cloudで作成したサービスの場合は、Redis CLI接続オプションを選択し、コマンドをコピーしてコマンドラインで実行しRedisサービスに接続します。

   ```bash
   127.0.0.1:6379> HGETALL test_client
   1) "1710921138"
   2) "{\n  \"temp\": 27.5,\n  \"hum\": 41.8\n}"
   ```

3. コンソールで運用データを確認します。ルール一覧でルールIDをクリックすると、そのルールの統計情報およびルール配下のすべてのアクションの統計を閲覧できます。
