Harvest Data を利用すると、サーバーやクラウドサービスを用意することなく、デバイスが送信したデータを蓄積したり確認したりできます。
Harvest Data を使用して短い間隔 (1 秒に 1 リクエスト等) でデータ送信することを検討されている場合は、ユースケースを添えて セールスチーム にお問い合わせください。
HTTP/TCP/UDP セッションは切断されることがあります
SORACOM のメンテナンスに伴い、任意のタイミングで HTTP/TCP/UDP セッションが切断される場合があります。メンテナンスに伴うセッション切断は、SORACOM Status Dashboard などで告知されません。ご了承ください。
データ保管の仕様について
データは、リソース ID (*1) ごとに、データの保存日時 (ミリ秒) をキーとして保存されます。そのため、同一リソース ID から同一タイムスタンプでデータを保存した場合、過去のデータは上書きされます。詳しくは、リソース ID とタイムスタンプが一致した場合の処理について を参照してください。
(*1) たとえば、IoT SIM を利用した場合は SIM ID のこと。
データ保存期間: 40 日間。保存期間を経過したファイルは自動的に削除され、復旧できません。
なお、Harvest Data データ保持期間延長オプション を利用することで 731 日間に延長できます。この場合も、保存期間を経過したファイルは自動的に削除され、復旧できません。
Harvest Data 側での暗号化機能: なし。暗号化が必要な場合はクライアント側でご対応ください。
1 回に保存できるデータサイズの最大値: 100 KB
データを保存する
Harvest Data の エントリポイント、または Unified Endpoint にデータを送信すると、Harvest Data にデータを保存できます。詳しくは、デバイスのデータを SORACOM Harvest Data に保存する を参照してください。
Harvest Data データ保持期間延長オプションも利用できます
Harvest Data データ保持期間延長オプション を利用することで、データ保存期間を 731 日間に延長できます。
ユーザーコンソールでデータを確認する
デバイスから送信され Harvest Data に保存されたデータは、ユーザーコンソールで、表、グラフ (折れ線、棒グラフ、積み上げ)、地図で簡易的に可視化できます。詳しくは、Harvest Data に保存したデータを確認する を参照してください。
項目 | イメージ |
---|---|
表 | |
折れ線グラフ | |
棒グラフ | |
積み上げグラフ | |
地図 |
Harvest Data は RDBMS のようなデータ検索に対応していません
Harvest Data は、簡易的なストレージサービスです。Harvest Data におけるデータの検索は、以下の情報を利用したフィルタリングにのみ対応しています。フィルタリングについて詳しくは、DataEntry:getDataEntries を参照してください。
- SIM ID などのリソース ID。
- データの登録日時。
- 取得するデータエントリ数。
Harvest Data では、これ以外のデータ検索機能は提供されていません。たとえば、特定の値に基づくフィルタリング機能 (SQL の
where
句に相当) や、データの集約機能 (SQL のgroup by
句に相当) など、リレーショナルデータベースマネジメントシステム (RDBMS) に見られるような検索操作はサポートされていません。ユーザーコンソールの Harvest Data 画面で提供される折れ線グラフ、棒グラフ、積み上げグラフでは、系列ごとにデータを非表示にできます。これは、リソース ID とデータの登録日時でフィルタリングしたデータを取得したあとで、系列ごとにデータを非表示にしています。
Lagoon 3 を利用すると複数のグラフを組み合わせた Dashboard を作成できます
Lagoon 3 を利用すると、複数のグラフ、テーブル、リスト、地図などを組み合わせた Dashboard を作成し、ほかの Lagoon ユーザーや任意の第三者と共有できます。また、値がしきい値を超えたときに通知することもできます。