API を使用してデータを取り込む CreateBulkImportJob - AWS IoT SiteWise

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

API を使用してデータを取り込む CreateBulkImportJob

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

注記

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

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

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

  • ALIAS – OPC-UA サーバのデータストリームのパスなど、プロパティを識別するエイリアス (例: /company/windfarm/3/turbine/7/temperature)。詳細については、「アセットプロパティへの産業データストリームのマッピング」を参照してください。

  • 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 倍精度の浮動小数点数。

    • BOOLEANtrue または false

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

  • TIMESTAMP_NANO_OFFSETTIMESTAMP_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— すべての一括インポートジョブの概要をページ分割したリストを取得します。