Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola aliran data untuk AWS IoT SiteWise
Aliran data adalah sumber daya yang berisi data deret waktu historis. Setiap aliran data diidentifikasi oleh alias unik, sehingga lebih mudah untuk melacak asal untuk setiap bagian data. Aliran data secara otomatis dibuat AWS IoT SiteWise ketika data seri pertama kali diterima. Jika data seri pertama kali diidentifikasi dengan alias, AWS IoT SiteWise buat aliran data baru dengan alias tersebut, asalkan tidak ada properti aset yang sudah ditetapkan alias tersebut. Atau, jika data seri pertama kali diidentifikasi dengan ID aset dan ID properti, AWS IoT SiteWise buat aliran data baru dan kaitkan aliran data tersebut dengan properti aset.
Ada dua cara untuk menetapkan alias ke properti aset. Metode yang digunakan tergantung pada apakah data dikirim ke AWS IoT SiteWise pertama, atau aset dibuat terlebih dahulu.
+ Jika data dikirim ke AWS IoT SiteWise pertama, ini secara otomatis membuat aliran data dengan alias yang ditetapkan. Saat aset dibuat nanti, gunakan [ AssociateTimeSeriesToAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateTimeSeriesToAssetProperty.html)API untuk mengaitkan aliran data dan aliasnya ke properti aset.
+ Jika aset dibuat terlebih dahulu, gunakan [ UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html)API untuk menetapkan alias ke properti aset. Ketika data kemudian dikirim ke AWS IoT SiteWise, aliran data secara otomatis dibuat dan dikaitkan dengan properti aset.
Saat ini, Anda hanya dapat mengaitkan aliran data dengan pengukuran. *Pengukuran* adalah jenis properti aset yang mewakili aliran data sensor mentah perangkat, seperti nilai suhu stempel waktu atau nilai rotasi per menit (RPM) stempel waktu.
Ketika pengukuran ini menentukan metrik atau transformasi, data yang masuk memicu perhitungan tertentu. Penting untuk dicatat bahwa properti aset hanya dapat ditautkan ke satu aliran data pada satu waktu.
AWS IoT SiteWise menggunakan `TimeSeries` sumber daya Amazon Resource Name (ARN) untuk menentukan biaya penyimpanan Anda. Untuk informasi selengkapnya, silakan lihat [Harga AWS IoT SiteWise](https://aws.amazon.com/iot-sitewise/pricing/).
Bagian berikut menunjukkan cara menggunakan AWS IoT SiteWise konsol atau API untuk mengelola aliran data.
**Topics**
+ [Konfigurasikan izin dan pengaturan](manage-data-streams-configuration.md)
+ [Kaitkan aliran data ke properti aset](manage-data-streams-method.md)
+ [Memutuskan aliran data dari properti aset](disassociate-data-streams-method.md)
+ [Menghapus aliran data](delete-data-streams-method.md)
+ [Memperbarui alias properti aset](update-data-streams-method.md)
+ [Skenario umum](data-ingestion-scenarios.md)
# Konfigurasikan izin dan pengaturan
Aliran data secara otomatis dibuat AWS IoT SiteWise ketika data seri pertama kali diterima. Jika data yang dicerna tidak terkait dengan properti aset, AWS IoT SiteWise buat aliran data baru yang tidak terkait yang dapat dikonfigurasi untuk dikaitkan dengan properti aset. Konfigurasikan kontrol akses gateway yang mengirim data ke AWS IoT SiteWise, menggunakan kebijakan IAM untuk menentukan jenis data yang akan dicerna.
Kebijakan IAM berikut menonaktifkan konsumsi data yang tidak terkait dari gateway, sambil tetap mengizinkan penyerapan data ke aliran data yang terkait dengan properti aset:
**Example Kebijakan pengguna IAM yang menonaktifkan konsumsi data yang tidak terkait dari gateway**
****
```
{
"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 Kebijakan pengguna IAM yang menonaktifkan semua konsumsi data dari gateway**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DenyPutAssetPropertyValues",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": [
"arn:aws:iotsitewise:*:*:asset/*",
"arn:aws:iotsitewise:*:*:time-series/*"
]
}
]
}
```
# Kaitkan aliran data ke properti aset
Kelola aliran data Anda menggunakan Konsol AWS IoT SiteWise atau AWS CLI.
------
#### [ Console ]
Gunakan AWS IoT SiteWise konsol untuk mengelola aliran data Anda.
**Untuk mengelola aliran data (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aliran data**.
1. Pilih aliran data dengan memfilter alias aliran data, atau memilih **Aliran data yang tidak terkait** di menu tarik-turun filter.
1. Pilih aliran data yang akan diperbarui. Anda dapat memilih beberapa aliran data. Klik **Kelola aliran data** di kanan atas.
1. Pilih aliran data yang akan dikaitkan dari **Perbarui asosiasi aliran data**, dan klik **Pilih pengukuran** tombol.
1. Di bagian **Pilih pengukuran**, temukan properti pengukuran aset yang sesuai. Pilih pengukuran lalu klik **Pilih**.
1. Lakukan langkah 4 dan 5 untuk aliran data lain yang dipilih pada langkah 3. Tetapkan properti aset ke semua aliran data.
1. Pilih **Perbarui** untuk melakukan perubahan. Spanduk konfirmasi yang berhasil ditampilkan untuk mengonfirmasi pembaruan.
------
#### [ AWS CLI ]
Untuk mengaitkan aliran data (diidentifikasi dengan aliasnya) ke properti aset (diidentifikasi olehnya IDs), jalankan perintah berikut:
```
aws iotsitewise associate-time-series-to-asset-property \
--alias \
--assetId \
--propertyId
```
------
# Memutuskan aliran data dari properti aset
------
#### [ Console ]
Gunakan AWS IoT SiteWise konsol untuk memisahkan aliran data Anda dari properti aset.
**Untuk memisahkan aliran data dari properti aset (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aliran data**.
1. Pilih aliran data dengan memfilter alias aliran data, atau memilih **Aliran data terkait** di menu tarik-turun filter.
1. Pilih aliran data untuk memisahkan. Kolom **Alias data stream** harus berisi alias. Kolom **nama aset** **dan nama properti Aset** harus berisi nilai properti aset yang terkait dengan aliran data. Anda dapat memilih beberapa aliran data.
1. Klik **Kelola aliran data** di kanan atas.
1. Di bagian **Perbarui asosiasi aliran data**, klik **X** di kolom **Nama pengukuran**. `submitted`Status akan muncul di kolom **Status**.
1. Pilih **Perbarui** untuk melakukan perubahan. Aliran data sekarang dipisahkan dari properti aset, dan alias sekarang digunakan untuk mengidentifikasi aliran data.
------
#### [ AWS CLI ]
Untuk memisahkan aliran data dari properti aset, (diidentifikasi oleh `ID` s dan aliasnya), jalankan perintah berikut:
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
Aliran data sekarang dipisahkan dari properti aset, dan alias digunakan untuk mengidentifikasi aliran data. Alias tidak lagi terkait dengan properti aset, karena sekarang dikaitkan dengan aliran data.
------
# Menghapus aliran data
Ketika properti dihapus dari model aset, AWS IoT SiteWise menghapus properti dan aliran datanya dari semua aset yang dikelola oleh model aset. Ini juga menghapus semua properti dan aliran data aset mereka ketika aset dihapus. Jika data stream harus dipertahankan, data harus dipisahkan dari properti aset sebelum dihapus.
**Awas**
Ketika properti dihapus dari aset, aliran data terkait juga dihapus. Untuk mempertahankan aliran data, lepaskan dari properti aset terlebih dahulu, sebelum menghapus properti dari model aset, atau menghapus aset.
------
#### [ Console ]
Gunakan AWS IoT SiteWise konsol untuk memisahkan aliran data Anda dari properti aset.
**Untuk menghapus aliran data (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aliran data**.
1. Pilih aliran data dengan memfilter alias aliran data.
1. Pilih aliran data yang akan dihapus. Anda dapat memilih beberapa aliran data.
1. Pilih tombol **Hapus** untuk menghapus aliran data.
------
#### [ AWS CLI ]
Gunakan [ DeleteTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteTimeSeries.html)API untuk menghapus aliran data tertentu, dengan aliasnya.
```
aws iotsitewise delete-time-series \
--alias
```
------
# Memperbarui alias properti aset
Alias harus unik dalam suatu AWS wilayah. Ini termasuk alias properti aset dan aliran data. Jangan menetapkan alias ke properti aset, jika properti atau aliran data lain menggunakan alias tersebut.
------
#### [ Console ]
Gunakan AWS IoT SiteWise konsol untuk memperbarui alias properti aset.
**Untuk memperbarui alias properti aset (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset dari tabel.
1. Klik tombol **Edit**.
1. Pilih **tipe Properti** di tabel **Properties**.
1. Temukan properti, dan ketik alias baru di bidang teks alias properti.
1. Klik tombol **Simpan** untuk menyimpan perubahan.
------
#### [ AWS CLI ]
Untuk memperbarui alias pada properti aset, jalankan perintah berikut:
```
aws iotsitewise update-asset-property \
--asset-id \
--property-id \
--property-alias \
--property-notification-state
```
**catatan**
Jika pemberitahuan properti saat ini diaktifkan, itu harus disediakan lagi untuk memastikannya terus diaktifkan.
------
# Skenario umum
## Memindahkan aliran data
Untuk mengubah asosiasi aliran data ke properti aset lain, pertama-tama lepaskan aliran data dari properti aset saat ini. Saat memisahkan aliran data dari properti aset, harus ada alias yang ditetapkan ke properti aset tersebut.
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
Sekarang tetapkan kembali aliran data ke properti aset baru.
```
aws iotsitewise associate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
## Kesalahan saat menetapkan alias ke properti aset
Saat menggunakan `UpdateAssetProperty` API untuk menetapkan alias ke properti, Anda mungkin melihat pesan galat berikut:
```
Given alias for property with ID already in use by another property or data stream
```
Pesan kesalahan ini menunjukkan alias tidak ditetapkan ke properti, karena saat ini digunakan oleh properti lain atau aliran data.
Ini terjadi jika data sedang dicerna AWS IoT SiteWise dengan alias. Ketika data dikirim dengan alias yang tidak digunakan oleh aliran data lain atau properti aset, aliran data baru dibuat dengan alias itu. Dua opsi di bawah ini menyelesaikan masalah.
+ Gunakan `AssociateTimeSeriesToAssetProperty` API untuk mengaitkan aliran data dengan aliasnya ke properti aset.
+ Hentikan sementara konsumsi data dan hapus aliran data. Gunakan `UpdateAssetProperty` API untuk menetapkan alias ke properti aset, lalu aktifkan kembali konsumsi data.
## Kesalahan saat mengaitkan aliran data ke properti aset
Saat mengaitkan aliran data ke properti aset, pesan galat berikut akan terlihat.
```
assetProperty with assetId propertyId contains data
```
Pesan galat ini menunjukkan properti aset sudah dikaitkan dengan aliran data yang berisi data. Aliran data tersebut harus dipisahkan atau dihapus, sebelum mengaitkan aliran data lain ke properti aset tersebut.
**catatan**
Saat memisahkan aliran data dari properti aset, alias yang ditetapkan ke properti diberikan ke aliran data. Agar alias tersebut tetap ditetapkan ke properti, tetapkan alias baru ke properti tersebut sebelum memisahkan aliran data.
Untuk melestarikan data yang disimpan di properti aset lakukan hal berikut:
+ Pastikan tidak ada data yang dicerna ke properti aset, untuk mencegah pembuatan aliran data baru.
+ Gunakan `UpdateAssetProperty` API untuk menyetel alias baru yang diberikan ke aliran data yang ditetapkan saat ini.
+ Gunakan `DisassociateTimeSeriesFromAssetProperty` API untuk memisahkan aliran data saat ini dari properti aset.
+ Gunakan `AssociateTimeSeriesToAssetProperty` API untuk mengaitkan aliran data yang diinginkan ke properti aset.
Jika data yang disimpan di properti aset harus dihapus, lakukan hal berikut:
+ Pastikan tidak ada data yang dicerna ke properti aset, untuk mencegah pembuatan aliran data baru.
+ Gunakan `DeleteTimeSeries` API untuk menghapus aliran data yang ditetapkan saat ini.
+ Gunakan `AssociateTimeSeriesToAssetProperty` API untuk mengaitkan aliran data yang diinginkan ke properti aset.