を使用したデータの取り込み CreateBulkImportJob API - AWS IoT SiteWise

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

を使用したデータの取り込み CreateBulkImportJob API

CreateBulkImportJob API を使用して、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] および 754 IEEE 倍精度の浮動小数点数。

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