翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# のデータストリームを管理する AWS IoT SiteWise
データストリームの管理
データストリームは、履歴時系列データを含むリソースです。各データストリームは一意のエイリアスによって識別されるため、各データのオリジンを簡単に追跡できます。データストリームは、最初の時系列データが受信 AWS IoT SiteWise されると、 に自動的に作成されます。最初の時系列データがエイリアスで識別されると、 はそのエイリアスで新しいデータストリーム AWS IoT SiteWise を作成します。ただし、そのエイリアスにアセットプロパティがまだ割り当てられていない場合です。または、最初の時系列データがアセット ID とプロパティ ID で識別された場合、 は新しいデータストリーム AWS IoT SiteWise を作成し、そのデータストリームをアセットプロパティに関連付けます。
アセットプロパティにエイリアスを割り当てるには、2 つの方法があります。使用する方法は、データが AWS IoT SiteWise 最初に に送信されるか、アセットが最初に作成されるかによって異なります。
+ データを AWS IoT SiteWise 最初に に送信すると、割り当てられたエイリアスを持つデータストリームが自動的に作成されます。後でアセットが作成されたら、[AssociateTimeSeriesToAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateTimeSeriesToAssetProperty.html) API を使用して、データストリームとそのエイリアスをアセットプロパティに関連付けます。
+ アセットが最初に作成された場合は、[UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html) API を使用してアセットプロパティにエイリアスを割り当てます。データが後で に送信されると AWS IoT SiteWise、データストリームが自動的に作成され、アセットプロパティに関連付けられます。
現在、データストリームを関連付けることができるのは、測定値のみです。測定値とは、タイムスタンプ付きの温度値やタイムスタンプ付きの回転数 (RPM) 値など、デバイスの raw センサーデータストリームを表す一種のアセットプロパティです。
これらの測定値がメトリクスまたは変換を定義すると、受信データは特定の計算をトリガーします。アセットプロパティは一度に 1 つのデータストリームにのみリンクできることに注意してください。
AWS IoT SiteWise は `TimeSeries` Amazon リソースネーム (ARN) リソースに を使用してストレージ料金を決定します。詳細については、「[AWS IoT SiteWise 料金](https://aws.amazon.com/iot-sitewise/pricing/)」を参照してください。
以下のセクションでは、 AWS IoT SiteWise コンソールまたは API を使用してデータストリームを管理する方法を示します。
**Topics**
+ [
# アクセス許可と設定を構成する
](manage-data-streams-configuration.md)
+ [
# データストリームをアセットプロパティに関連付ける
](manage-data-streams-method.md)
+ [
# アセットプロパティからデータストリームの関連付けを解除する
](disassociate-data-streams-method.md)
+ [
# データストリームを削除する
](delete-data-streams-method.md)
+ [
# アセットプロパティエイリアスを更新する
](update-data-streams-method.md)
+ [
# 一般的なシナリオ
](data-ingestion-scenarios.md)
# アクセス許可と設定を構成する
アクセス許可と設定を構成する
データストリームは、最初の時系列データが受信 AWS IoT SiteWise されると、 に自動的に作成されます。取り込まれたデータがアセットプロパティに関連付けられていない場合、 は、アセットプロパティに関連付けるように設定可能な、関連付けが解除された新しいデータストリーム AWS IoT SiteWise を作成します。IAM ポリシーを使用して、データを送信するゲートウェイのアクセスコントロールを設定し AWS IoT SiteWise、取り込むデータのタイプを指定します。
次の IAM ポリシーは、アセットプロパティに関連付けられたデータストリームへのデータ取り込みを許可しながら、ゲートウェイからの関連付け解除されたデータ取り込みを無効にします。
**Example ゲートウェイからの関連付け解除されたデータ取り込みを無効にする IAM ユーザーポリシー**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowPutAssetPropertyValuesUsingAssetIdAndPropertyId",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:asset/*"
},
{
"Sid": "AllowPutAssetPropertyValuesUsingAliasWithAssociatedAssetProperty",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:time-series/*",
"Condition": {
"StringLikeIfExists": {
"iotsitewise:isAssociatedWithAssetProperty": "true"
}
}
},
{
"Sid": "DenyPutAssetPropertyValuesUsingAliasWithNoAssociatedAssetProperty",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:time-series/*",
"Condition": {
"StringLikeIfExists": {
"iotsitewise:isAssociatedWithAssetProperty": "false"
}
}
}
]
}
```
**Example ゲートウェイからのすべてのデータ取り込みを無効にする IAM ユーザーポリシー**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DenyPutAssetPropertyValues",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": [
"arn:aws:iotsitewise:*:*:asset/*",
"arn:aws:iotsitewise:*:*:time-series/*"
]
}
]
}
```
# データストリームをアセットプロパティに関連付ける
データストリームをアセットプロパティに関連付ける
AWS IoT SiteWise コンソール または を使用してデータストリームを管理します AWS CLI。
------
#### [ Console ]
AWS IoT SiteWise コンソールを使用してデータストリームを管理します。
**データストリームを管理するには (コンソール)。**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Data streams]** (データストリーム) を選択します。
1. データストリームエイリアスでフィルタリングするか、フィルタードロップダウンメニューで**関連付け解除されたデータストリーム**を選択して、データストリームを選択します。
1. 更新するデータストリームを選択します。複数のデータストリームを選択できます。右上**のデータストリームの管理**をクリックします。
1. データストリームの**関連付けを更新するから関連付けるデータストリーム**を選択し、**測定の選択**ボタンをクリックします。
1. **測定の選択**セクションで、対応するアセット測定プロパティを見つけます。測定値を選択し、**選択**をクリックします。
1. ステップ 3 で選択した他のデータストリームに対してステップ 4 と 5 を実行します。アセットプロパティをすべてのデータストリームに割り当てます。
1. **更新**を選択して変更をコミットします。更新を確認する確認バナーが表示されます。
------
#### [ AWS CLI ]
データストリーム (エイリアスで識別) をアセットプロパティ (IDs で識別) に関連付けるには、次のコマンドを実行します。
```
aws iotsitewise associate-time-series-to-asset-property \
--alias \
--assetId \
--propertyId
```
------
# アセットプロパティからデータストリームの関連付けを解除する
アセットプロパティからデータストリームの関連付けを解除する
------
#### [ Console ]
AWS IoT SiteWise コンソールを使用して、アセットプロパティからデータストリームの関連付けを解除します。
**アセットプロパティからデータストリームの関連付けを解除するには (コンソール)**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Data streams]** (データストリーム) を選択します。
1. データストリームエイリアスでフィルタリングするか、フィルタードロップダウンメニューで**関連付けられたデータストリーム**を選択して、データストリームを選択します。
1. 関連付けを解除するデータストリームを選択します。**データストリームエイリアス**列にはエイリアスが含まれている必要があります。**アセット名**と**アセットプロパティ名の**列には、データストリームが関連付けられているアセットプロパティの値が含まれている必要があります。複数のデータストリームを選択できます。
1. 右上**のデータストリームの管理**をクリックします。
1. **データストリームの関連付けの更新**セクションで、**測定名**列の **X** をクリックします。`submitted` ステータス列に**ステータス**が表示されます。
1. **更新**を選択して変更をコミットします。データストリームとアセットプロパティの関連付けが解除され、エイリアスを使用してデータストリームを識別できるようになりました。
------
#### [ AWS CLI ]
( `ID`とそのエイリアスによって識別される) アセットプロパティからデータストリームの関連付けを解除するには、次のコマンドを実行します。
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
データストリームとアセットプロパティの関連付けが解除され、エイリアスを使用してデータストリームを識別できるようになりました。エイリアスは、データストリームに関連付けられているため、アセットプロパティに関連付けられなくなりました。
------
# データストリームを削除する
データストリームを削除する
プロパティがアセットモデルから削除されると、 はアセットモデルによって管理されるすべてのアセットからプロパティとそのデータストリーム AWS IoT SiteWise を削除します。また、アセットが削除されると、アセットのすべてのプロパティとそのデータストリームも削除されます。データストリームデータを保持する必要がある場合は、削除する前にアセットプロパティとの関連付けを解除する必要があります。
**警告**
プロパティがアセットから削除されると、関連付けられたデータストリームも削除されます。データストリームを保持するには、まずアセットプロパティから関連付けを解除してから、アセットモデルからプロパティを削除するか、アセットを削除します。
------
#### [ Console ]
AWS IoT SiteWise コンソールを使用して、アセットプロパティからデータストリームの関連付けを解除します。
**データストリームを削除するには (コンソール)**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Data streams]** (データストリーム) を選択します。
1. データストリームエイリアスでフィルタリングしてデータストリームを選択します。
1. 削除するデータストリームを選択します。複数のデータストリームを選択できます。
1. データストリームを削除するには、**削除**ボタンを選択します。
------
#### [ AWS CLI ]
[ DeleteTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteTimeSeries.html) API を使用して、エイリアスで特定のデータストリームを削除します。
```
aws iotsitewise delete-time-series \
--alias
```
------
# アセットプロパティエイリアスを更新する
アセットプロパティエイリアスを更新する
エイリアスは AWS リージョン内で一意である必要があります。これには、アセットプロパティとデータストリームの両方のエイリアスが含まれます。別のプロパティまたはデータストリームがそのエイリアスを使用している場合は、アセットプロパティにエイリアスを割り当てないでください。
------
#### [ Console ]
AWS IoT SiteWise コンソールを使用して、アセットプロパティエイリアスを更新します。
**アセットプロパティエイリアスを更新するには (コンソール)**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで [**アセット**] を選択します。
1. テーブルからアセットを選択します。
1. [**Edit**] ボタンをクリックします。
1. プロパティテーブルで**プロパティ****タイプ**を選択します。
1. プロパティを検索し、プロパティエイリアステキストフィールドに新しいエイリアスを入力します。
1. **保存**ボタンをクリックして変更を保存します。
------
#### [ AWS CLI ]
アセットプロパティのエイリアスを更新するには、次のコマンドを実行します。
```
aws iotsitewise update-asset-property \
--asset-id \
--property-id \
--property-alias \
--property-notification-state
```
**注記**
プロパティ通知が現在有効になっている場合は、引き続き有効になるように再度指定する必要があります。
------
# 一般的なシナリオ
一般的なシナリオ
## データストリームを移動する
データストリームを移動する
データストリームの関連付けを別のアセットプロパティに変更するには、まず現在のアセットプロパティからデータストリームの関連付けを解除します。アセットプロパティからデータストリームの関連付けを解除する場合、そのアセットプロパティにエイリアスを割り当てる必要があります。
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
次に、データストリームを新しいアセットプロパティに再割り当てします。
```
aws iotsitewise associate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
## アセットプロパティにエイリアスを割り当てるときのエラー
アセットプロパティにエイリアスを割り当てるときのエラー
`UpdateAssetProperty` API を使用して プロパティにエイリアスを割り当てると、次のエラーメッセージが表示されることがあります。
```
Given alias for property with ID already in use by another property or data stream
```
このエラーメッセージは、現在別のプロパティまたはデータストリームで使用されているため、エイリアスが プロパティに割り当てられていないことを示します。
これは、データがエイリアス AWS IoT SiteWise で に取り込まれている場合に発生します。別のデータストリームまたはアセットプロパティによって使用されていないエイリアスでデータが送信されると、そのエイリアスで新しいデータストリームが作成されます。以下の 2 つのオプションで問題を解決します。
+ `AssociateTimeSeriesToAssetProperty` API を使用して、データストリームとそのエイリアスをアセットプロパティに関連付けます。
+ データ取り込みを一時的に停止し、データストリームを削除します。`UpdateAssetProperty` API を使用してアセットプロパティにエイリアスを割り当て、データ取り込みを再度オンにします。
## データストリームをアセットプロパティに関連付けるときのエラー
データストリームをアセットプロパティに関連付けるときのエラー
データストリームをアセットプロパティに関連付けると、次のエラーメッセージが表示されます。
```
assetProperty with assetId propertyId contains data
```
このエラーメッセージは、アセットプロパティが既にデータを含むデータストリームに関連付けられていることを示します。他のデータストリームをそのアセットプロパティに関連付ける前に、そのデータストリームの関連付けを解除または削除する必要があります。
**注記**
アセットプロパティからデータストリームの関連付けを解除すると、プロパティに割り当てられたエイリアスがデータストリームに割り当てられます。そのエイリアスを プロパティに割り当てたままにするには、データストリームの関連付けを解除する前に、そのプロパティに新しいエイリアスを割り当てます。
アセットプロパティに保存されているデータを保持するには、次の手順を実行します。
+ 新しいデータストリームが作成されないように、アセットプロパティにデータが取り込まれていないことを確認します。
+ `UpdateAssetProperty` API を使用して、現在割り当てられているデータストリームに与えられる新しいエイリアスを設定します。
+ `DisassociateTimeSeriesFromAssetProperty` API を使用して、アセットプロパティから現在のデータストリームの関連付けを解除します。
+ `AssociateTimeSeriesToAssetProperty` API を使用して、目的のデータストリームをアセットプロパティに関連付けます。
アセットプロパティに保存されているデータを削除する必要がある場合は、次の操作を行います。
+ 新しいデータストリームが作成されないように、アセットプロパティにデータが取り込まれていないことを確認します。
+ `DeleteTimeSeries` API を使用して、現在割り当てられているデータストリームを削除します。
+ `AssociateTimeSeriesToAssetProperty` API を使用して、目的のデータストリームをアセットプロパティに関連付けます。