データストリームの管理

AWS IoT SiteWise コンソール AWS CLIまたはを使用してデータストリームを管理します。

Console

AWS IoT SiteWise コンソールを使用してデータストリームを管理します。

データストリームを管理するには (コンソール)。

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインで、[Data streams] (データストリーム) を選択します。

3. (オプション) タグを追加または更新するには、編集するデータストリームを選択し、[タグの管理] を選択します。

   [タグの編集] ページで、[タグの追加] を選択します。[キー] フィールドに、使用するタグの名前を入力します。

   [保存] を選択します。

4. (オプション) [Data stream] (データストリーム) 表では、次の方法でデータストリームをフィルタリングすることができます。

   • 最初のドロップダウンメニューで、エイリアスプレフィックスまたはアセット ID を選択します。

     • [Alias prefix] (エイリアスプレフィックス) - データストリームのエイリアスのプレフィックス。ターゲットデータストリームにエイリアスのプレフィックスがある場合、このオプションを選択することができます。

     • [Asset ID] (アセット ID) - アセットプロパティが作成されたアセットの ID。ターゲットデータストリームがアセットプロパティと関連付けられている場合、このオプションを選択することができます。

   • 2 番目のドロップダウンメニューで、[すべてのデータストリーム]、[関連するデータストリーム]、または [関連付けられていないデータストリーム] を選択します。

     • [All data streams] (すべてのデータストリーム) - アセットプロパティに関連する、または関連しないデータストリーム。

     • [Associated data streams] (関連するデータストリーム) - アセットプロパティに関連するデータストリーム。

     • Disassociated data streams (関連付けられていないデータストリーム) - アセットプロパティと関連付けられていないデータストリーム。

5. 管理しているデータストリームを選択します。 AWS IoT SiteWise 選択したデータストリームがページ下部のグラフに表示されます。10 個以上選択した場合、グラフは最初に選択した 10 個のみが表示されます。

6. (オプション) 以下の方法でグラフを設定します。

   1. [集計機能] で次のいずれかを選択してください。

      • [Data point count] (データ点数コンピューティング) - 現在の時間間隔における指定された変数のデータポイントの合計数を返します。

      • [Average] (平均) – 現在の時間間隔における指定された変数値の平均を返します。

      • [Sum] (合計) – 現在の時間間隔における指定された変数値の合計を返します。

      • [Minimum] (最小値) – 現在の時間間隔における指定された変数の最小値を返します。

      • [Maximum] (最大値) – 現在の時間間隔における指定された変数の最大値を返します。

      詳細については、「式での集計関数の使用」を参照してください。

   2. [時間範囲] で次のいずれかを選択します。

      • [Last 1 hour] (過去 1 時間) - グラフは過去 1 時間のデータを集計して表示します。

      • [Last 2 hour] (過去 2 時間) - グラフは過去 2 時間のデータを集計して表示します。

      • [Last 3 hour] (過去 3 時間) - グラフは過去 3 時間のデータを集計して表示します。

      • [Last 4 hour] (過去 4 時間) - グラフは過去 4 時間のデータを集計して表示します。

   3. [時間間隔] で次のいずれかを選択します。

      • [1 minute] (1 分) - 指定した時間範囲のデータを 1 分ごとに集計します。

      • [1 hour] (1 時間) - 指定した時間範囲のデータを 1 時間ごとに集計します。

7. [Manage data streams] (データストリームの管理) を選択します。

8. [データストリームの関連付けの更新] セクションの [測定名] 列で、次のいずれかを実行します。

   • データストリームが測定値と関連付けられている場合、閉じるアイコンを選択して関連付けを削除します。

   • データストリームが測定値に関連付けられていない場合、[Choose measurement] (測定値の選択) を選択します。

9. [Choose measurement] (測定値の選択) の表で、対象アセットに移動し、関連付ける測定を選択します。

10. (オプション) [Update asset property aliases] (アセットプロパティエイリアスの更新) セクションで、各測定に対して一意のエイリアスを入力します。

11. [Update (更新) ] を選択します。

[ステータス] 列には、次のいずれかの値が表示されます。

• [Pending] (保留中) - データストリームの関連付けまたはアセットプロパティのエイリアスを更新しているところです。

• [Submit] (送信) - 関連付けまたはアセットプロパティのエイリアスへの変更が保存されます。

• エラー — AWS IoT SiteWise 測定のデータストリームの関連付けまたはエイリアスを更新するリクエストを処理できませんでした。

• [Success] (成功) - データストリームのアソシエーションまたは測定のエイリアスを正常に更新しました。

AWS CLI

次の API オペレーションを使用してデータストリームを管理してください。コード例では、 AWS CLIを使用しています。

• AssociateTimeSeriesToAssetProperty— データストリーム (時系列) をアセットプロパティに関連付けます。

• DisassociateTimeSeriesFromAssetProperty— データストリームとアセットプロパティの関連付けを解除します。

• DeleteTimeSeries— データストリームを削除します。

• DescribeTimeSeries— データストリームに関する情報を取得します。

• ListTimeSeries— ページ分割されたデータストリームのリストを取得します。

AssociateTimeSeriesToAssetProperty

データストリームとアセットプロパティを関連付けるには、次のコマンドを実行します。

重要

指定されたアセットプロパティは、現在どのデータストリームにも関連付けられてはならない。

• data-stream-alias関連付けるデータストリームのエイリアスに置き換えます。

• asset-ID をアセットプロパティが作成されたアセットの ID に置き換えてください。

• property-ID をアセットプロパティの ID に置き換えてください。

aws iotsitewise associate-time-series-to-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DisassociateTimeSeriesFromAssetProperty

データストリームとアセットプロパティの関連付けを解除するには、次のコマンドを実行します。

• data-stream-alias関連付けを解除するデータストリームのエイリアスに置き換えます。

• asset-ID をアセットプロパティが作成されたアセットの ID に置き換えてください。

• property-ID をアセットプロパティの ID に置き換えてください。

aws iotsitewise disassociate-time-series-from-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DeleteTimeSeries

データストリームを削除するには、次のコマンドを実行します。

data-stream-alias削除するデータストリームのエイリアスに置き換えます。

aws iotsitewise delete-time-series --alias data-stream-alias

データストリームを特定するには、次のいずれかを行います。

• データストリームがアセットプロパティと関連付けられていない場合、データストリームの alias を指定します。

• データストリームがアセットプロパティと関連付けられている場合、次のいずれかを指定します。

  • データストリームの alias。

  • アセットプロパティを識別する assetId、propertyId です。

DescribeTimeSeries

DescribeTimeSeriesAPI オペレーションを使用して、データストリームを正常に関連付けたか、関連付けを解除したかを確認します。

データストリームの情報を取得するには、次のコマンドを実行します。

aws iotsitewise describe-time-series --alias data-stream-alias

データストリームを特定するには、次のいずれかを行います。

• データストリームがアセットプロパティと関連付けられていない場合、データストリームの alias を指定します。

• データストリームがアセットプロパティと関連付けられている場合、次のいずれかを指定します。

  • データストリームの alias。

  • アセットプロパティを識別する assetId、propertyId です。

ListTimeSeries

ListTimeSeriesAPI オペレーションを使用して、データストリームを正常に削除したかどうかを確認します。

データストリームのページ割りされたリストを取得するには、次のコマンドを実行します。

aws iotsitewise list-time-series