CreateBulkImportJob API - AWS IoT SiteWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateBulkImportJob API

CreateBulkImportJob API を使用して、Amazon S3 から大量のデータをインポートします。Amazon S3 のデータは、CSV 形式で保存されている必要があります。データファイルには、次の列を含めることができます。

注記

1970 年 1 月 1 日 00:00:00 UTC より前のデータはサポートされていません。

アセットプロパティを特定するには、次のいずれかを指定します。

  • データの送信先のアセットプロパティの ASSET_ID および PROPERTY_ID。

  • データストリームのエイリアスである ALIAS (例えば、/company/windfarm/3/turbine/7/temperature)。このオプションを使用するには、最初にアセットプロパティのエイリアスを設定する必要があります。プロパティのエイリアスを設定する方法については、「のデータストリームを管理する AWS IoT SiteWise」を参照してください。

  • ALIAS – OPC UA サーバーのデータストリームパスなど、プロパティを識別するエイリアス (例: /company/windfarm/3/turbine/7/temperature)。詳細については、「のデータストリームを管理する AWS IoT SiteWise」を参照してください。

  • ASSET_ID – アセットの ID。

  • PROPERTY_ID – アセットプロパティの ID。

  • DATA_TYPE – プロパティのデータ型。次のいずれかを指定できます。

    • STRING - 最大 1024 バイトの文字列。

    • INTEGER - [-2,147,483,648, 2,147,483,647] の範囲を持つ 32 ビットの符合付き整数。

    • DOUBLE - [-10 ^ 100、10 ^ 100] の範囲および IEEE 754 倍精度の浮動小数点数。

    • BOOLEAN – true または false

  • TIMESTAMP_SECONDS – データポイントのタイムスタンプ (Unix エポック時間形式)。

  • TIMESTAMP_NANO_OFFSET – TIMESTAMP_SECONDS から変換されたナノ秒オフセット。

  • QUALITY – (オプション) アセットプロパティ値の品質。値には次のいずれかを指定できます。

    • GOOD - (デフォルト) データはいずれの問題による影響も受けません。

    • BAD - データはセンサーの障害などの問題による影響を受けます。

    • UNCERTAIN - データはセンサーの不正確さなどの問題による影響を受けます。

    が計算でデータ品質 AWS IoT SiteWise を処理する方法の詳細については、「数式のデータ品質」を参照してください。

  • VALUE – アセットプロパティの値。

例 .csv 形式のデータファイル
asset_id,property_id,DOUBLE,1635201373,0,GOOD,1.0
asset_id,property_id,DOUBLE,1635201374,0,GOOD,2.0
asset_id,property_id,DOUBLE,1635201375,0,GOOD,3.0
unmodeled_alias1,DOUBLE,1635201373,0,GOOD,1.0
unmodeled_alias1,DOUBLE,1635201374,0,GOOD,2.0
unmodeled_alias1,DOUBLE,1635201375,0,GOOD,3.0
unmodeled_alias1,DOUBLE,1635201376,0,GOOD,4.0
unmodeled_alias1,DOUBLE,1635201377,0,GOOD,5.0
unmodeled_alias1,DOUBLE,1635201378,0,GOOD,6.0
unmodeled_alias1,DOUBLE,1635201379,0,GOOD,7.0
unmodeled_alias1,DOUBLE,1635201380,0,GOOD,8.0
unmodeled_alias1,DOUBLE,1635201381,0,GOOD,9.0
unmodeled_alias1,DOUBLE,1635201382,0,GOOD,10.0

AWS IoT SiteWise には、一括インポートジョブを作成し、既存のジョブに関する情報を取得するための次の API オペレーションが用意されています。

  • CreateBulkImportJob – 新しい一括インポートジョブを作成します。

  • DescribeBulkImportJob – 一括インポートジョブに関する情報を取得します。

  • ListBulkImportJob – すべての一括インポートジョブの概要をまとめたページ番号付きリストを取得します。