

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Aktualisierungen von Immobilienwerten in Amazon DynamoDB veröffentlichen
<a name="publish-to-amazon-dynamodb"></a>

In diesem Tutorial wird eine bequeme Methode zum Speichern Ihrer Daten mithilfe von [Amazon DynamoDB](https://aws.amazon.com/dynamodb/) vorgestellt, sodass Sie einfacher auf historische Asset-Daten zugreifen können, ohne die API wiederholt abfragen zu müssen. AWS IoT SiteWise Nachdem Sie dieses Tutorial abgeschlossen haben, können Sie benutzerdefinierte Software erstellen, die Ihre Anlagendaten nutzt, z. B. eine Live-Karte der Windgeschwindigkeit und -richtung in einem gesamten Windpark. Wenn Sie Ihre Daten überwachen und visualisieren möchten, ohne eine benutzerdefinierte Softwarelösung zu implementieren, finden Sie weitere Informationen unter[Überwachen Sie Daten mit AWS IoT SiteWise Monitor](monitor-data.md).

In diesem Tutorial bauen Sie auf der AWS IoT SiteWise Demo auf, die einen Beispieldatensatz für einen Windpark enthält. Sie konfigurieren Eigenschaftswertaktualisierungen aus der Windpark-Demo, um Daten über AWS IoT Kernregeln an eine von Ihnen DynamoDB DynamoDB-Tabelle zu senden. Wenn Sie Eigenschaftswertaktualisierungen aktivieren, AWS IoT SiteWise sendet Ihre Daten AWS IoT Core in MQTT-Nachrichten an. Definieren Sie dann AWS IoT Core-Regeln, die je nach Inhalt dieser Nachrichten Aktionen ausführen, z. B. die DynamoDB-Aktion. Weitere Informationen finden Sie unter [Interagiere mit anderen AWS Diensten](interact-with-other-services.md).

**Topics**
+ [Voraussetzungen](#dynamodb-tutorial-prerequisites)
+ [Schritt 1: Konfigurieren Sie die Konfiguration AWS IoT SiteWise , um Aktualisierungen von Eigenschaftswerten zu veröffentlichen](#dynamodb-tutorial-enable-value-notifications)
+ [Schritt 2: Erstellen Sie eine Regel in Core AWS IoT](#dynamodb-tutorial-create-iot-rule)
+ [Schritt 3: Konfiguration der DynamoDB-Regelaktion](#dynamodb-tutorial-configure-rule-action)
+ [Schritt 4: Erkunden Sie Daten in DynamoDB](#dynamodb-tutorial-explore-dynamodb-data)
+ [Bereinigen von Ressourcen](#dynamodb-tutorial-clean-up-resources)
+ [Weitere Ressourcen](#dynamodb-tutorial-additional-resources)

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

Zum Durcharbeiten dieses Tutorials ist Folgendes erforderlich:
+ Ein. AWS-Konto Falls Sie noch keines haben, beachten Sie die Informationen unter [Richten Sie ein Konto ein AWS](getting-started.md#set-up-aws-account).
+ Ein Entwicklungscomputer, auf dem Windows, macOS, Linux oder Unix ausgeführt wird, um auf die zuzugreifen AWS-Managementkonsole. Weitere Informationen finden Sie unter [Was ist der AWS-Managementkonsole?](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html)
+ Ein AWS Identity and Access Management (IAM-) Benutzer mit Administratorrechten. Detaillierte Anweisungen finden Sie unter [Wie AWS IoT SiteWise funktioniert mit IAM](security_iam_service-with-iam.md).
+ Eine laufende AWS IoT SiteWise Demo. Weitere Informationen finden Sie unter [Benutze die AWS IoT SiteWise Demo](getting-started-demo.md).

**Anmerkung**  
Dieses Tutorial erfordert die Verwendung von Ressourcen, die in der erstellt wurden[Benutze die AWS IoT SiteWise Demo](getting-started-demo.md). Sie müssen es abschließen, bevor Sie mit diesem Tutorial fortfahren können.

**Wichtig**  
Behalten Sie alle Demo-Ressourcen, bis Sie dieses Tutorial abgeschlossen haben. Das Löschen von Komponenten kann die Funktionalität der Demo beeinträchtigen und Ihre Fähigkeit, das Tutorial abzuschließen, beeinträchtigen.

## Schritt 1: Konfigurieren Sie die Konfiguration AWS IoT SiteWise , um Aktualisierungen von Eigenschaftswerten zu veröffentlichen
<a name="dynamodb-tutorial-enable-value-notifications"></a>

In diesem Verfahren aktivieren Sie Benachrichtigungen über Eigenschaftswerte für die Eigenschaften **Wind Speed** Ihrer Demo-Turbinenkomponenten. Nachdem Sie Benachrichtigungen über Eigenschaftswerte aktiviert haben, AWS IoT SiteWise veröffentlicht Sie jede Wertaktualisierung in einer MQTT-Nachricht in AWS IoT Core.

**So aktivieren Sie Benachrichtigungen über Eigenschaftswerte für Komponenteneigenschaften:**

1. Melden Sie sich bei der [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/) an.

1. Überprüfen Sie die [AWS IoT SiteWise Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html), auf denen dies unterstützt AWS IoT SiteWise wird, und wechseln Sie AWS gegebenenfalls zwischen den Regionen. Wechseln Sie zu einer Region, in der Sie die AWS IoT SiteWise Demo ausführen.

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wählen Sie den Pfeil neben **Demo Wind Farm Asset** aus, um die Hierarchie der Windparkkomponente zu erweitern.

1. Wählen Sie eine Demoturbine und **Edit (Bearbeiten)** aus.

1. Wählen Sie **Measurements (Messungen)**.

1. Aktualisieren Sie den **MQTT-Benachrichtigungsstatus** der **Wind Speed**Immobilie auf **AKTIV**.

1. Wählen Sie unten auf der Seite die Option **Save** aus.

1. Wiederholen Sie die Schritte 5 bis 7 für jede Demo-Turbinenkomponente.

1. Wählen Sie eine Demoturbine aus (z. B. **Demo Turbine Asset 1**).

1. Wählen Sie **Measurements (Messungen)**.

1. Wählen Sie das Kopiersymbol neben der Eigenschaft **Wind Speed** aus, um das Benachrichtigungsthema in die Zwischenablage zu kopieren. Speichern Sie das Benachrichtigungsthema zur späteren zu verwendende Verwendung in diesem Tutorial. Sie müssen nur das Benachrichtigungsthema einer Turbine aufzeichnen.

   Das Benachrichtigungsthema sollte wie im folgenden Beispiel aussehen.

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

## Schritt 2: Erstellen Sie eine Regel in Core AWS IoT
<a name="dynamodb-tutorial-create-iot-rule"></a>

In diesem Schritt erstellen Sie eine Regel in AWS IoT Core, die die Benachrichtigungen über den Eigenschaftswert analysiert und Daten in eine Amazon DynamoDB-Tabelle einfügt. AWS IoT Kernregeln analysieren MQTT-Nachrichten und führen Aktionen aus, die auf dem Inhalt und dem Thema jeder Nachricht basieren. Anschließend erstellen Sie eine Regel mit einer DynamoDB-Aktion, um Daten in eine DynamoDB-Tabelle einzufügen, die Sie im Rahmen dieses Tutorials erstellen.

**So erstellen Sie eine Regel mit einer DynamoDB-Aktion**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. **Wählen Sie im linken Navigationsbereich **Message Routing** und dann Rules aus.**

1. Wählen Sie **Regel erstellen** aus.

1. **Geben Sie unter Regeleigenschaften angeben** einen Namen und eine Beschreibung für die Regel ein.

1. Suchen Sie das Benachrichtigungsthema, das Sie zuvor in diesem Tutorial gespeichert haben.

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

   Ersetzen Sie die Asset-ID (die ID danach`assets/`) im Thema durch eine`+`. Dadurch wird die Windgeschwindigkeit-Eigenschaft für alle Demo-Windturbinenanlagen ausgewählt. Der `+`-Themenfilter akzeptiert alle Knoten einer einzelnen Ebene in einem Thema. Ihr Thema sollte wie das folgende Beispiel aussehen.

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

1. Geben Sie die folgende Regelabfrageanweisung ein. Ersetzen Sie das Thema im `FROM`-Abschnitt durch Ihr Benachrichtigungsthema.

   ```
   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. Navigieren Sie unter **Regelaktionen** zu **Aktion 1.**

1. **Wählen Sie auf der Seite Aktion auswählen** die Option **Dynamo DBv2** aus. Dadurch wird die Nachricht in mehrere Spalten einer DynamoDB-Tabelle aufgeteilt

1. Wählen Sie unter **Tabellenname** die Option Neue Tabelle **erstellen** aus. Sie erstellen eine Amazon DynamoDB-Tabelle, um Windgeschwindigkeitsdaten aus der Regelaktion zu erhalten.

1. Geben Sie in der [DynamoDB-Konsole](https://console.aws.amazon.com/dynamodb/) unter **Tabellenname** einen Namen für Ihre Tabelle ein.

1. Gehen Sie für den **Partitionsschlüssel** wie folgt vor:

   1. Geben Sie „**timestamp**“ als Partitionsschlüssel ein.

   1. Wählen Sie den Typ **Number (Nummer)** aus.

   1. Aktivieren Sie das Kontrollkästchen **Add sort key (Sortierschlüssel hinzufügen)**.

   1. Geben Sie **asset** als Sortierschlüssel ein, und belassen Sie den Standardsortierschlüsseltyp auf **String (Zeichenfolge)**.

1. Wählen Sie **Create table** (Tabelle erstellen) aus.

1. Kehren Sie mit der Seite **Configure action (Aktion konfigurieren)** zur Registerkarte zurück.

1. Aktualisieren Sie auf der **Aktionsseite „Regel anhängen**“ die Liste mit den **Tabellennamen** und wählen Sie Ihre neue DynamoDB-Tabelle aus, die Sie im vorherigen Schritt erstellt haben.

## Schritt 3: Konfiguration der DynamoDB-Regelaktion
<a name="dynamodb-tutorial-configure-rule-action"></a>

In diesem Schritt konfigurieren Sie die Amazon DynamoDB DynamoDB-Regelaktion, um Daten aus Eigenschaftswertaktualisierungen in Ihre neue DynamoDB-Tabelle einzufügen.

**So konfigurieren Sie die DynamoDB-Regelaktion**

1. Wählen Sie **Rolle erstellen** aus, um eine IAM-Rolle zu erstellen, die AWS IoT Core-Zugriff zur Ausführung der Regelaktion gewährt.

1. Geben Sie einen Rollennamen ein, zum Beispiel. `WindSpeedDataRole` Wählen Sie **Rolle erstellen** aus.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie unten auf der Seite **Erstellen** aus, um die Erstellung der Regel abzuschließen.

   Ihre Demo-Asset-Daten sollten nun in Ihrer DynamoDB-Tabelle erscheinen.

## Schritt 4: Erkunden Sie Daten in DynamoDB
<a name="dynamodb-tutorial-explore-dynamodb-data"></a>

Erkunden Sie in diesem Schritt die Windgeschwindigkeitsdaten der Demo-Assets in Ihrer neuen Amazon DynamoDB-Tabelle.

**Um Asset-Daten in DynamoDB zu untersuchen**

1. Kehren Sie zu der Registerkarte mit der geöffneten DynamoDB-Tabelle zurück.

1. Wählen Sie in der Tabelle, die Sie zuvor erstellt haben, die Registerkarte **Tabellenelemente durchsuchen**, um die Daten in der Tabelle anzuzeigen. Aktualisieren Sie die Seite, wenn keine Zeilen in der Tabelle angezeigt werden. Wenn nach einigen Minuten keine Zeilen angezeigt werden, finden Sie weitere Informationen unter [Problembehandlung bei einer Regel (DynamoDB)](troubleshoot-rule.md#dynamodb-tutorial-troubleshoot-rule).

1. Wählen Sie in einer Zeile in der Tabelle das Bearbeitungssymbol aus, um die Daten zu erweitern.

1. Wählen Sie den Pfeil neben der Struktur **windspeed** aus, um die Liste der Datenpunkte für die Windgeschwindigkeit zu erweitern. Jede Liste enthält eine Reihe von Datenpunkten zur AWS IoT SiteWise Windgeschwindigkeit, an die die Windpark-Demo gesendet hat. Möglicherweise benötigen Sie ein anderes Datenformat, wenn Sie eine Regelaktion für Ihre eigene Verwendung einrichten. Weitere Informationen finden Sie unter [Benachrichtigungen über Vermögenseigenschaften abfragen in AWS IoT SiteWise](query-notification-messages.md).

Nachdem Sie das Tutorial abgeschlossen haben, können Sie die Regel deaktivieren oder löschen und Ihre DynamoDB-Tabelle löschen, um zusätzliche Gebühren zu vermeiden. Informationen zum Bereinigen Ihrer Ressourcen finden Sie unter. [Bereinigen von Ressourcen](#dynamodb-tutorial-clean-up-resources)

Sie können auch lernen, wie Sie benutzerdefinierte Anwendungen erstellen, um diese Daten zu nutzen und zu visualisieren. Eine Anleitung zur Visualisierung von AWS IoT SiteWise Daten finden Sie unter[Daten in Grafana visualisieren und teilen](visualize-with-grafana.md).

## Bereinigen von Ressourcen
<a name="dynamodb-tutorial-clean-up-resources"></a>

Nachdem Sie das Tutorial abgeschlossen haben, bereinigen Sie Ihre Ressourcen, um zusätzliche Kosten zu vermeiden.

**Um die Demo zu löschen AWS IoT SiteWise **

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie in der oberen rechten Ecke der Seite die Option Demo **löschen** aus.

1. Geben Sie in das Bestätigungsfeld **DELETE** ein, und wählen Sie dann **Delete (Löschen)**.

Weitere Informationen finden Sie unter [Löschen Sie die AWS IoT SiteWise Demo](getting-started-demo.md#delete-getting-started-demo).

Gehen Sie wie folgt vor, um Benachrichtigungen zur Aktualisierung von Eigenschaftswerten zu deaktivieren (falls Sie die Demo nicht gelöscht haben), Ihre AWS IoT Regel zu deaktivieren oder zu löschen und Ihre DynamoDB-Tabelle zu löschen.

**So deaktivieren Sie Aktualisierungsbenachrichtigungen für Komponenteneigenschaften:**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wählen Sie den Pfeil neben **Demo Wind Farm Asset** aus, um die Hierarchie der Windparkkomponente zu erweitern.

1. Wählen Sie eine Demoturbine und **Edit (Bearbeiten)** aus.

1. **Ändern Sie den **Benachrichtigungsstatus der **Wind Speed**Immobilie auf INAKTIV**.**

1. Wählen Sie unten auf der Seite die Option **Save asset (Komponente speichern)** aus.

1. Wiederholen Sie die Schritte 4 bis 6 für jede Demo-Turbinenkomponente.

**Um eine Regel zu deaktivieren oder zu löschen AWS IoT Core**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Nachrichtenweiterleitung** und dann **Regeln** aus.

1. Wählen Sie Ihre Regel aus und klicken Sie auf **Löschen**.

1. Geben Sie im Bestätigungsdialogfeld den Namen der Regel ein und wählen Sie dann Löschen.

**So löschen Sie eine DynamoDB-Tabelle**

1. Navigieren Sie zur [DynamoDB-Konsole](https://console.aws.amazon.com/dynamodb/).

1. Wählen Sie im linken Navigationsbereich **Tables (Tabellen)** aus.

1. Wählen Sie die Tabelle aus, die Sie zuvor erstellt haben, z. B. `WindSpeedData`

1. Wählen Sie **Löschen** aus.

1. Geben Sie im Bestätigungsdialogfeld ein, **confirm** um die Tabelle zu löschen.

## Weitere Ressourcen
<a name="dynamodb-tutorial-additional-resources"></a>

Weitere Informationen zur Arbeit mit DynamoDB und zur Überwachung Ihrer Daten finden Sie in den folgenden Ressourcen:
+ [Inklusive Monitoring-Metriken CloudWatch im](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) *DynamoDB Developer Guide*
+ [Bewährte Methoden für das Entwerfen und effektive Verwenden von Partitionsschlüsseln finden Sie im](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) *DynamoDB-Entwicklerhandbuch*
+ [Regeln für AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) *im Entwicklerhandbuch AWS IoT *
+ [Daten in Grafana visualisieren und teilen](visualize-with-grafana.md)