Soracom

Users

ドキュメント

Harvest Data に格納されたデータをダウンロード (バックアップ) する

SORACOM Harvest Data (以下、Harvest Data) に格納されたデータを、期間を指定して一括ダウンロードできます。

  1. ユーザーコンソール にログインし、[メニュー][データ収集・蓄積・可視化][SORACOM Harvest Data] の順にクリックします。

  2. [リソース] をクリックし、ダウンロードするデータを送信していた IoT SIM を 1 つだけ選択します。

    複数のリソースを選択してもまとめてダウンロードできません

    Harvest Data 画面で手順 2 を繰り返すと複数のリソースを選択できます。ただし、ここで複数のリソースを選択しても、まとめてダウンロードすることはできません。

  3. [ダウンロード] をクリックします。

    Harvest Data ダウンロード画面が表示されます。

  4. ダウンロードするデータの条件を指定します。

    項目説明
    [対象期間]ダウンロードするデータを送信した日時を指定して、ダウンロードするデータを絞り込めます。
    [対象]ダウンロードするデータを送信した IoT SIM の SIM ID を 1 つ指定します。複数の IoT SIM を選択することはできません。
    [フォーマット]

    ダウンロードフォーマットを指定します。

    • [データをダウンロード (JSON 形式)]: Harvest Data に格納されたデータをダウンロードします。以下のような JSON 配列形式となります。

      [
        {
          "resourceType": "Subscriber", // リソースの種類。SIM の場合は Subscriber
          "resourceId": "295050910008582", // リソースの ID
          "time": "2021-10-22T06:31:41.468+09:00", // 受信した日付と時刻
          "contentType": "application/json", // Content type
          "content": { "elevation": 17.2, "battery": 2 } // デバイスから送信されたデータ。バイナリ形式の場合は Base64 形式
        },
        {
          "resourceType": "Subscriber",
          "resourceId": "295050910008582",
          "time": "2021-10-22T06:31:41.467+09:00",
          ...
        },
        ...
      ]
      
    • [グラフ用データをダウンロード (JSON 形式)]: グラフ用に変換されたデータ ("値名":数値 となっている部分を抽出したデータ) を JSON 形式でダウンロードします。

      [
        {
          "resourceType": "Subscriber", // リソースの種類。SIM の場合は Subscriber
          "resourceId": "440103213043029", // リソースの ID
          "time": "2021-10-22T06:31:41.468+09:00", // 受信した日付と時刻
          "chartData": { "elevation": 17.2, "battery": 2 }
        },
        {
          "resourceType": "Subscriber",
          "resourceId": "440103213043029",
          "time": "2021-10-22T06:31:41.467+09:00",
          ...
        },
        ...
      ]
      
    • [グラフ用データをダウンロード (CSV 形式)]: グラフ用に変換されたデータを CSV 形式でダウンロードします。

      __resourceType,__resourceId,__time,__iso8601Time,elevation,battery
      "Subscriber","440103213043029","2021/10/22  06:31:41","2021-10-22T06:31:41.468+09:00","17.2","2"
      "Subscriber","440103213043029","2021/10/22  06:31:41","2021-10-22T06:31:41.467+09:00",...
      ...
      
  5. [ダウンロード] をクリックします。

意図しない大容量データのダウンロードを防ぐ機能があります

ダウンロード対象データは 250 MB ごとに分割されます。複数ファイルに分割された場合は、[再開] をクリックすると次のファイルをダウンロードできます。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、データをダウンロードできます。

フォーマットは指定できません

SORACOM CLI / SORACOM API の場合は、ダウンロードするファイルのフォーマットは指定できません。

  • SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールする を参照してください。
  • SIM ID は、soracom sims list (Sim:listSims API) で取得できます。

データをダウンロードする

soracom sims get-data (Sim:getDataFromSim API) を使用します。

$ soracom sims get-data --sim-id ${sim_id} --from ${from} --to ${to}
[
  {
    "content": "{\"elevation\": 17.2, \"battery\": 2 }",
    "contentType": "application/json",
    "time": 1634851840992
  },
  {
    "content": "...",
    "contentType": "application/json",
    "time": 1634851840991
  },
  ...
]

データをダウンロードする

Sim:getDataFromSim API を使用します。

$ curl -v -X GET "https://api.soracom.io/v1/sims/${sim_id}/data?from=${from}&to=${to}" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}"
[
  {
    "content": "{\"elevation\": 17.2, \"battery\": 2 }",
    "contentType": "application/json",
    "time": 1634851840992
  },
  {
    "content": "...",
    "contentType": "application/json",
    "time": 1634851840991
  },
  ...
]