Split Send And Received Combine
デバイス側でファイルを分割し、D2Cメッセージで IoT Hub に送信し、IoT Hub で受信したフラグメントをマージして復元し、Blob として Storage に保存するサンプル。
IoT Hub に送信するデバイスは、256KB以上のファイルを分割し、順番にメッセージのボディとして、以下のプロパティを付与して送信する。
| プロパティ名 | 値 |
|---|---|
| msgtype | split |
| dataid | ブロブとして格納する際の名前 |
| index | 0から初めて、分割の番号 |
| total | 分割数 |
| ext | ブロブとして格納する際の拡張子 |
| unitsize | 送信するデータのバイト数 |
セットアップ
ファイルフラグメントのマージ用 Durable Function
MergeData を、Azure にデプロイし、Function の"設定"→"構成" で、アプリケーション設定、接続文字列を以下の通りに設定する。
| 名前 | 種別 | 設定値 |
|---|---|---|
| outputblobstorage | 接続文字列 | マージしたファイルを保存するストレージアカウントの接続文字列 |
IoT Hub からメッセージを受信し、MergeData を起動する Function
次に、StoreSplittedData を、Azure にデプロイし、Function の"設定"→"構成" で、アプリケーション設定、接続文字列を以下の通りに設定する。
| 名前 | 種別 | 設定値 |
|---|---|---|
| iothubconnectionstring | アプリケーション設定 | IoT Hub の service ロールの接続文字列 |
| webhook_starter | 接続文字列 | MergeData の MergeFragments_HttpStart の URI |
| webhook_notify | 接続文字列 | MergeData の MergeFragments_NotifyFragment の URI |
本関数では、dataidが同じメッセージ群ごとに、Orchestrator インスタンスを MergeFragments_HttpStart を介して作成し、一連の Fragments のマージ処理を行う。
テスト
SplitAndSendLargeFileSimulator を、Visual Studio 2019 もしくは、VS Code でプロジェクトを開き、MainWindow.xaml.cs の26行目付近の
readonly string iothubCS = "<- Device Connection String ->";の文字列の部分を、IoT Hub に登録した IoT Device の接続文字列で置き換える。
プロジェクトを実行する。
IoT Device のシミュレーション
- Connect をクリック
- Select File をクリックし、分割送信するファイルを選択する。
- Send をクリックし、送信を開始する。
フラグメント群のマージのテスト
- Enable をチェック
- Select File をクリックし、分割送信するファイルを選択する。
- BaseUri に、MergeData をデプロイした Function の起動用 URLの、/api より前の部分をコピー＆ペーストする。
- Invoke Start をクリック
- Invoke Notify をフラグメントの数だけクリック
注意
このサンプルは、Function の起動において、ユーザー認証等は考慮していない。実際に利用する場合には、適切なアクセス権の設定等を行うこと。