

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Publikasikan pembaruan nilai properti ke Amazon DynamoDB
<a name="publish-to-amazon-dynamodb"></a>

Tutorial ini memperkenalkan cara mudah untuk menyimpan data Anda dengan menggunakan [Amazon DynamoDB](https://aws.amazon.com/dynamodb/), sehingga lebih mudah untuk mengakses data aset historis tanpa berulang kali menanyakan API. AWS IoT SiteWise Setelah Anda menyelesaikan tutorial ini, Anda dapat membuat perangkat lunak khusus yang mengkonsumsi data aset Anda, seperti peta langsung kecepatan angin dan arah di seluruh ladang angin. Jika Anda ingin memantau dan memvisualisasikan data Anda tanpa menerapkan solusi perangkat lunak khusus, lihat[Memantau data dengan AWS IoT SiteWise Monitor](monitor-data.md).

Dalam tutorial ini, Anda membangun AWS IoT SiteWise demo yang menyediakan kumpulan sampel data untuk ladang angin. Anda mengonfigurasi pembaruan nilai properti dari demo ladang angin untuk mengirim data, melalui aturan AWS IoT Core, ke tabel DynamoDB yang Anda buat. Saat Anda mengaktifkan pembaruan nilai properti, AWS IoT SiteWise mengirimkan data Anda ke AWS IoT Core dalam pesan MQTT. Kemudian, tentukan aturan AWS IoT Core yang melakukan tindakan, seperti tindakan DynamoDB, tergantung pada isi pesan tersebut. Untuk informasi selengkapnya, lihat [Berinteraksi dengan AWS layanan lain](interact-with-other-services.md).

**Topics**
+ [Prasyarat](#dynamodb-tutorial-prerequisites)
+ [Langkah 1: Konfigurasikan AWS IoT SiteWise untuk mempublikasikan pembaruan nilai properti](#dynamodb-tutorial-enable-value-notifications)
+ [Langkah 2: Buat aturan di AWS IoT Core](#dynamodb-tutorial-create-iot-rule)
+ [Langkah 3: Konfigurasikan tindakan aturan DynamoDB](#dynamodb-tutorial-configure-rule-action)
+ [Langkah 4: Jelajahi data di DynamoDB](#dynamodb-tutorial-explore-dynamodb-data)
+ [Pembersihan sumber daya](#dynamodb-tutorial-clean-up-resources)
+ [Sumber daya tambahan](#dynamodb-tutorial-additional-resources)

## Prasyarat
<a name="dynamodb-tutorial-prerequisites"></a>

Untuk menyelesaikan tutorial ini, Anda memerlukan hal berikut:
+ Sebuah Akun AWS. Jika Anda tidak memilikinya, lihat [Siapkan AWS akun](getting-started.md#set-up-aws-account).
+ Komputer pengembangan yang menjalankan Windows, macOS, Linux, atau Unix untuk mengakses file. Konsol Manajemen AWS Untuk informasi lebih lanjut, lihat [Apa itu Konsol Manajemen AWS?](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html)
+ Pengguna AWS Identity and Access Management (IAM) dengan izin administrator. Untuk petunjuk mendetail, lihat [Bagaimana AWS IoT SiteWise bekerja dengan IAM](security_iam_service-with-iam.md).
+  AWS IoT SiteWise Demo yang sedang berjalan. Untuk informasi selengkapnya, lihat [Gunakan AWS IoT SiteWise demo](getting-started-demo.md).

**catatan**  
Tutorial ini membutuhkan penggunaan sumber daya yang dibuat di[Gunakan AWS IoT SiteWise demo](getting-started-demo.md). Anda harus menyelesaikannya sebelum melanjutkan dengan tutorial ini.

**penting**  
Simpan semua sumber daya demo sampai Anda menyelesaikan tutorial ini. Menghapus komponen apa pun dapat mengganggu fungsionalitas demo dan memengaruhi kemampuan Anda untuk menyelesaikan tutorial.

## Langkah 1: Konfigurasikan AWS IoT SiteWise untuk mempublikasikan pembaruan nilai properti
<a name="dynamodb-tutorial-enable-value-notifications"></a>

Dalam prosedur ini, Anda mengaktifkan pemberitahuan nilai properti pada properti aset **Wind Speed**turbin demo Anda. Setelah Anda mengaktifkan pemberitahuan nilai properti, AWS IoT SiteWise menerbitkan setiap pembaruan nilai dalam pesan MQTT ke Core. AWS IoT 

**Untuk mengaktifkan pemberitahuan pembaruan nilai properti pada properti aset**

1. Masuk ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. Tinjau [AWS IoT SiteWise titik akhir dan kuota](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) di mana AWS IoT SiteWise didukung dan alihkan AWS Wilayah, jika perlu. Beralih ke Wilayah tempat Anda menjalankan AWS IoT SiteWise demo.

1. Di panel navigasi kiri, pilih **Aset**.

1. Pilih panah di sebelah **Demo Wind Farm Asset**untuk memperluas hierarki aset ladang angin.

1. Pilih turbin demo dan pilih **Edit**.

1. Pilih **Pengukuran**.

1. **Perbarui **status Pemberitahuan MQTT **Wind Speed****properti menjadi AKTIF.**

1. Pilih **Simpan** di bagian bawah halaman.

1. Ulangi langkah 5 hingga 7 untuk setiap aset turbin demo.

1. Pilih turbin demo (misalnya, **Demo Turbine Asset 1**).

1. Pilih **Pengukuran**.

1. Pilih ikon salin di sebelah **Wind Speed**properti untuk menyalin topik notifikasi ke clipboard Anda. Simpan topik notifikasi untuk digunakan nanti dalam tutorial ini. Anda hanya perlu merekam topik notifikasi dari satu turbin.

   Topik notifikasi akan terlihat seperti contoh berikut.

   ```
   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
   ```

## Langkah 2: Buat aturan di AWS IoT Core
<a name="dynamodb-tutorial-create-iot-rule"></a>

Pada langkah ini, buat aturan di AWS IoT Core yang mem-parsing pesan notifikasi nilai properti dan menyisipkan data ke dalam tabel Amazon DynamoDB. AWS IoT Aturan inti mengurai pesan MQTT dan melakukan tindakan berdasarkan konten dan topik setiap pesan. Kemudian, Anda membuat aturan dengan tindakan DynamoDB untuk menyisipkan data ke tabel DynamoDB yang Anda buat sebagai bagian dari tutorial ini.

**Untuk membuat aturan dengan tindakan DynamoDB**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. **Di panel navigasi kiri, pilih **Perutean pesan**, lalu pilih Aturan.**

1. Pilih **Buat aturan**.

1. Di bawah **Tentukan properti aturan**, masukkan nama dan deskripsi untuk aturan tersebut.

1. Temukan topik notifikasi yang Anda simpan sebelumnya dalam tutorial ini.

   ```
   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
   ```

   Ganti ID aset (ID setelah`assets/`) dalam topik dengan a`+`. Ini memilih properti kecepatan angin untuk semua aset turbin angin demo. Filter `+` topik menerima semua node dari satu tingkat dalam suatu topik. Topik Anda akan terlihat seperti contoh berikut.

   ```
   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
   ```

1. Masukkan pernyataan kueri aturan berikut. Ganti topik di `FROM` bagian dengan topik notifikasi Anda.

   ```
   SELECT
     payload.assetId AS asset,
     (SELECT VALUE (value.doubleValue) FROM payload.values) AS windspeed,
     timestamp() AS timestamp
   FROM
     '$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE' 
   WHERE
     type = 'PropertyValueUpdate'
   ```

1. Di bawah **Tindakan aturan**, arahkan ke **Tindakan 1**.

1. Pada halaman **Pilih tindakan**, pilih **Dynamo DBv2**. Ini membagi pesan menjadi beberapa kolom tabel DynamoDB

1. Di bawah **nama Tabel**, pilih **Buat tabel baru**. Anda membuat tabel Amazon DynamoDB untuk menerima data kecepatan angin dari tindakan aturan.

1. Di bawah **nama Tabel** di konsol [DynamoDB](https://console.aws.amazon.com/dynamodb/) masukkan nama untuk tabel Anda.

1. Untuk **kunci Partition**, lakukan hal berikut:

   1. Masukkan **timestamp** sebagai kunci partisi.

   1. Pilih tipe **Number**.

   1. Pilih kotak centang **Add sort key**.

   1. Masukkan **asset** sebagai kunci sortir, dan biarkan tipe kunci sortir default **String**.

1. Pilih **Buat tabel**.

1. Kembali ke tab dengan halaman **Configure action**.

1. Pada halaman **tindakan aturan Lampirkan**, segarkan daftar **nama Tabel**, dan pilih tabel DynamoDB baru yang Anda buat di langkah sebelumnya.

## Langkah 3: Konfigurasikan tindakan aturan DynamoDB
<a name="dynamodb-tutorial-configure-rule-action"></a>

Pada langkah ini, konfigurasikan tindakan aturan Amazon DynamoDB untuk menyisipkan data dari pembaruan nilai properti ke tabel DynamoDB baru Anda.

**Untuk mengkonfigurasi tindakan aturan DynamoDB**

1. Pilih **Buat peran** untuk membuat peran IAM yang memberikan akses AWS IoT Core untuk melakukan tindakan aturan.

1. Masukkan nama peran, misalnya,`WindSpeedDataRole`. Pilih **Buat peran**.

1. Pilih **Berikutnya**.

1. Pilih **Buat** di bagian bawah halaman untuk menyelesaikan pembuatan aturan.

   Data aset demo Anda akan mulai muncul di tabel DynamoDB Anda.

## Langkah 4: Jelajahi data di DynamoDB
<a name="dynamodb-tutorial-explore-dynamodb-data"></a>

Pada langkah ini, jelajahi data kecepatan angin aset demo di tabel Amazon DynamoDB baru Anda.

**Untuk mengeksplorasi data aset di DynamoDB**

1. Kembali ke tab dengan tabel DynamoDB terbuka.

1. Dalam tabel yang Anda buat sebelumnya, pilih tab **Jelajahi item tabel** untuk melihat data dalam tabel. Segarkan halaman jika Anda tidak melihat baris dalam tabel. Jika baris tidak muncul setelah beberapa menit, lihat[Memecahkan masalah aturan (DynamoDB)](troubleshoot-rule.md#dynamodb-tutorial-troubleshoot-rule).

1. Dalam satu baris dalam tabel, pilih ikon edit untuk memperluas data.

1. Pilih panah di sebelah **windspeed**struktur untuk memperluas daftar titik data kecepatan angin. Setiap daftar mencerminkan sekumpulan titik data kecepatan angin yang dikirim AWS IoT SiteWise oleh demo ladang angin. Anda mungkin menginginkan format data yang berbeda jika Anda menyiapkan tindakan aturan untuk Anda gunakan sendiri. Untuk informasi selengkapnya, lihat [Kueri pemberitahuan properti aset di AWS IoT SiteWise](query-notification-messages.md).

Sekarang setelah Anda menyelesaikan tutorial, Anda dapat menonaktifkan atau menghapus aturan dan menghapus tabel DynamoDB Anda untuk menghindari biaya tambahan. Untuk membersihkan sumber daya Anda, lihat[Pembersihan sumber daya](#dynamodb-tutorial-clean-up-resources).

Anda juga dapat mempelajari cara membuat aplikasi khusus untuk mengkonsumsi dan memvisualisasikan data ini. Untuk tutorial terpandu tentang memvisualisasikan AWS IoT SiteWise data, lihat[Visualisasikan dan bagikan data di Grafana](visualize-with-grafana.md).

## Pembersihan sumber daya
<a name="dynamodb-tutorial-clean-up-resources"></a>

Setelah Anda menyelesaikan tutorial, bersihkan sumber daya Anda untuk menghindari biaya tambahan.

**Untuk menghapus AWS IoT SiteWise demo**

1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. **Di sudut kanan atas halaman, pilih Hapus demo.**

1. Pada dialog konfirmasi, masukkan **DELETE** lalu pilih **Hapus**.

Untuk informasi selengkapnya, lihat [Hapus AWS IoT SiteWise demo](getting-started-demo.md#delete-getting-started-demo).

Gunakan prosedur berikut untuk menonaktifkan pemberitahuan pembaruan nilai properti (jika Anda tidak menghapus demo), menonaktifkan atau menghapus AWS IoT aturan Anda, dan menghapus tabel DynamoDB Anda.

**Untuk menonaktifkan pemberitahuan pembaruan nilai properti pada properti aset**

1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. Di panel navigasi kiri, pilih **Aset**.

1. Pilih panah di sebelah **Demo Wind Farm Asset**untuk memperluas hierarki aset ladang angin.

1. Pilih turbin demo dan pilih **Edit**.

1. Perbarui **status Pemberitahuan **Wind Speed****properti menjadi **TIDAK AKTIF**.

1. Pilih **Simpan aset** di bagian bawah halaman.

1. Ulangi langkah 4 hingga 6 untuk setiap aset turbin demo.

**Untuk menonaktifkan atau menghapus aturan di AWS IoT Core**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. **Di panel navigasi kiri, pilih **Perutean pesan**, lalu pilih Aturan.**

1. Pilih aturan Anda dan pilih **Hapus**.

1. Dalam dialog konfirmasi, masukkan nama aturan dan kemudian pilih Hapus.

**Untuk menghapus tabel DynamoDB**

1. Arahkan ke konsol [DynamoDB](https://console.aws.amazon.com/dynamodb/).

1. Di panel navigasi kiri, pilih **Tabel**.

1. Pilih tabel yang Anda buat sebelumnya, misalnya,`WindSpeedData`.

1. Pilih **Hapus**.

1. Dalam dialog konfirmasi, masukkan **confirm** untuk menghapus tabel.

## Sumber daya tambahan
<a name="dynamodb-tutorial-additional-resources"></a>

Untuk informasi selengkapnya tentang bekerja dengan DynamoDB dan memantau data Anda, lihat sumber daya berikut:
+ [Memantau metrik dengan CloudWatch dalam Panduan Pengembang](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) *DynamoDB*
+ [Praktik terbaik untuk merancang dan menggunakan kunci partisi secara efektif dalam Panduan](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) Pengembang *DynamoDB*
+ [Aturan untuk AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) dalam *Panduan AWS IoT Pengembang*
+ [Visualisasikan dan bagikan data di Grafana](visualize-with-grafana.md)