# EMQX Cloud V5 から V6 へのアップグレードガイド

EMQX 専用展開ユーザーは、EMQX を V5 から V6 にアップグレードできます。現在の EMQX バージョンを確認するには、展開詳細ページを開き、**設定** をクリックして展開情報を表示してください。

EMQX V6 は、V5 のコアアーキテクチャと利用モデルを維持しつつ、ネームスペース、ログトレース、イベント履歴、BigQuery データ統合、Snowflake ストリーミングデータ統合、および MQTT ソース機能を新たに導入または強化しています。詳細は [新機能](https://docs.emqx.com/en/cloud/latest/new_features.html) をご参照ください。

::: tip 利用可能性

EMQX V6 は専用および専用フレックスブローカー展開でのみ利用可能です。サーバレス展開では EMQX バージョンの選択はサポートされていません。

:::

## アップグレード前の準備

1. クライアントで自動再接続が有効になっていることを確認し、アップグレード中の短時間の接続断に備えてください。
2. アップグレード前に、接続中のクライアント数、メッセージのパブリッシュおよび配信レート、認証成功率、ルールやデータ統合の状態など、主要なビジネスベースラインを記録してください。これらの値はアップグレード後の比較に使用します。
3. アップグレード前に当社の SRE チームが展開状況と特別な設定を確認します。アップグレードに影響を及ぼす可能性がある場合は事前にご連絡いたします。

## データ移行および設定の保持

アップグレード中に以下の設定およびデータは保持されます。

- MQTT エンドポイントおよびポート
- 認証および認可設定
- コネクター、ルール、ソース、シンクを含むデータ統合設定
- TLS 証明書情報
- リテインドメッセージ
- NAT ゲートウェイ、内部エンドポイント、PrivateLink、VPC ピアリングを含むネットワーク管理設定

V5 から V6 へのアップグレードは、V4 アップグレードで必要だった大規模な API、認証・認可、データ統合アーキテクチャの互換性作業を必要としません。サポートチケットを通じて設定された特別なパラメーターは、引き続き SRE チームのアップグレード前評価の対象となります。

## アップグレードの影響

1. アップグレードは 15～25 分程度で完了し、サービスのダウンタイムはありません。
2. アップグレードのために **2時間** のメンテナンスウィンドウが設定されます。この期間中のアップグレードによるサービス停止は SLA の可用性計算から除外されます。
3. アップグレード中にクライアントは 2～3 回の短い切断を経験する可能性があります。デバイスで自動再接続が有効であれば、通常の利用に影響はありません。
4. **ご注意：`clean session` が `false` に設定されている場合、アップグレード後に既存のセッションは破棄されます。セッションを保持する必要がある場合は事前にご連絡ください。**

## アップグレード後の対応

### アップグレード後の検証

1. アップグレード後、EMQX Cloud の SRE チームが展開ログとメトリクスを確認します。
2. アップグレード前に記録したビジネスベースラインに対して以下の点を重点的に検証してください。
   - クライアントが自動的に再接続すること
   - クライアントの認証および認可が正常に動作すること
   - サブスクリプションが復元され、メッセージのパブリッシュおよび配信が正常に行われること
   - ルール、コネクター、ソース、シンクが正常に動作すること
   - TLS 接続およびカスタム証明書が正常に動作すること
   - 監視メトリクスおよびアラートが期待通りであること
3. 問題を発見した場合は、速やかにご連絡ください。

### ロールバック

- アップグレード確定前に 24 時間のロールバック期間があり、この期間中は展開を V6 から V5 に戻すことが可能です。
- ロールバックも 15～25 分程度で完了し、サービスのダウンタイムはありません。
- ロールバック中にクライアント接続は 1～2 回切断されます。
- パーシステンスセッション状態は保持できません。クライアントは再接続後に新しいセッションを作成します。

## V6 のコア機能

### V6 固有の機能

::: tip ご注意

以下の機能は EMQX V6 をサポートする専用および専用フレックス展開でのみ利用可能です。実際の利用可否は V6 のマイナーバージョン、リージョン、およびコンソールに表示されるオプションによって異なります。

:::

| V6 固有の機能 | 実用的な価値 |
| --- | --- |
| ネームスペース | マルチテナントシナリオにおけるリソースと権限の分離を提供します。ルール、コネクター、アクションなどのリソースをテナント、チーム、事業部門ごとに整理でき、テナント間の影響を減らし、共有クラスターでの運用を簡素化します。 |
| ログトレース | 特定のクライアント、トピック、クライアント IP アドレス、またはルール ID に対してデバッグログを収集できます。展開全体の詳細ログを有効にすることなく、対象を絞ったトラブルシューティングに役立ちます。 |
| イベント履歴 | 最近の接続、認証、サブスクリプションイベントを保持し、接続失敗、予期しない切断、認証失敗、サブスクリプションが反映されない問題の診断に利用できます。 |
| BigQuery データ統合 | ルールエンジンと BigQuery シンクを通じて MQTT データを BigQuery に書き込み、SQL 分析やレポートに活用できます。 |
| Snowflake ストリーミングデータ統合 | ルールエンジンと Snowflake ストリーミングシンクを通じて低レイテンシでデータを Snowflake テーブルに書き込みます。 |

### ネームスペース

ネームスペースはマルチテナント管理とリソース分離を強化します。管理者はテナント、部門、事業部門ごとにリソース範囲を分割し、各ネームスペース内でルール、コネクター、アクションを独立して管理できます。複数のチームや顧客が一つの展開を共有する場合、ネームスペースは誤操作やテナント間の影響を減らします。

### ログトレース

ログトレースは、特定の MQTT クライアント、トピック、クライアント IP アドレス、またはルール ID に対してコンソールからデバッグレベルのログを収集できます。展開全体の詳細ログを有効にするよりも影響範囲が限定され、特定のクライアントやトピック、ルール処理経路に関する問題の再現や診断に適しています。

### イベント履歴

イベント履歴は最近のクライアント接続、認証、サブスクリプションイベントを記録します。以下の調査に利用可能です。

- クライアントの接続失敗や予期しない切断
- クライアントの認証失敗
- 作成に失敗した、または反映されないサブスクリプション
- 接続およびサブスクリプションのタイムライン

### BigQuery データ統合

ルールエンジンが MQTT メッセージをフィルタリング・処理し、BigQuery シンクが Google BigQuery に書き込みます。この統合は大規模な IoT データの SQL 分析、データウェアハウジング、レポーティングに適しています。

### Snowflake ストリーミングデータ統合

Snowflake ストリーミングシンクは MQTT データを低レイテンシで Snowflake テーブルに書き込みます。リアルタイムに近いデータ取り込み、分析、ビジネスインサイトに適しています。

### MQTT ソースの強化

V6 の MQTT ソースは重複メッセージを減らす共有サブスクリプショントピックをサポートします。また、MQTT 5.0 のサブスクリプションオプションである **No Local** や **Retain As Published** に対応し、リモート MQTT サービスからのデータブリッジ時に柔軟性を向上させています。

## アップグレードの確定

アップグレードの時間帯を確定し、関連するビジネスおよび運用担当者がアップグレード中に対応可能な状態であることを確認してください。アップグレードの成功を支援するため、プロセス全体を通じて技術サポートを提供いたします。