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. # Fügen Sie ein AWS IoT SiteWise gepuffertes Ziel mit Amazon S3 hinzu Der Zieltyp „Gepuffert“ ermöglicht es Ihnen, Aufnahmekosten zu sparen, AWS IoT SiteWise wenn Sie die Daten nicht in Echtzeit benötigen. Es ermöglicht Ihnen, Ihre IoT-Daten vorübergehend in einem Amazon S3 S3-Bucket zu speichern, bevor Sie sie importieren AWS IoT SiteWise. Oder Sie können Ihre Daten einfach zur Speicherung auf S3 hochladen, unabhängig davon, ob Sie sie importieren möchten AWS IoT SiteWise. Dies ist nützlich, um Daten von Ihren Geräten und Gateways zu stapeln und zu puffern, bevor Sie sie in sie aufnehmen. AWS IoT SiteWise Mit dieser Option werden Daten mit einer konfigurierten Frequenz im Parquet-Format in den angegebenen S3-Bucket hochgeladen. Sie können diese Daten dann zur weiteren Analyse und Verarbeitung in den AWS IoT SiteWise Speicher importieren. **Um ein mit Amazon S3 gepuffertes Ziel hinzuzufügen** Verwenden Sie die AWS IoT SiteWise Konsole oder fügen AWS CLI Sie Ihrem SiteWise Edge-Gateway ein Ziel hinzu, das Daten mithilfe von Amazon S3 zwischenspeichert. ------ #### [ Console ] Verwenden Sie den AWS-Managementkonsole , um ein AWS IoT SiteWise Ziel hinzuzufügen, das mit Amazon S3 gepuffert wurde. 1. Öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie im Navigationsbereich **Edge-Gateways** aus. 1. Wählen Sie das Gateway aus, zu dem Sie ein Ziel hinzufügen möchten. 1. Wählen Sie im Abschnitt **Ziele** die Option **Ziel hinzufügen** aus. 1. Geben Sie auf der Seite **Ziel hinzufügen** die **Zieldetails** ein: 1. Geben Sie im Feld Zielname einen **Namen für Ihr Ziel** ein. 1. Wählen Sie unter **Zieltyp** die Option **Mit Amazon S3 AWS IoT SiteWise gepuffert** aus. AWS IoT SiteWise gepuffert mit Amazon S3 sendet Daten stapelweise im Parquet-Format an Amazon Simple Storage Service und importiert die Daten anschließend in AWS IoT SiteWise den Speicher. 1. Geben Sie die Amazon S3 S3-URL für den Standort ein, an dem Sie Ihre Gateway-Daten speichern möchten. Sie können nach dem Pfad suchen, indem **Sie Browse S3** wählen. Sobald ein Bucket hinzugefügt wurde, können Sie den Bucket auch anzeigen, indem Sie **View** wählen. 1. Geben Sie an, wie oft Ihr Gateway Daten auf Amazon S3 hochladen soll, indem Sie einen Zeitrahmen eingeben und eine Zeitspanne für die **Häufigkeit des Daten-Uploads** auswählen. Der Frequenzwert sollte größer als 0 und kleiner als oder gleich 30 Tagen sein. 1. Legen Sie in den **Datenspeichereinstellungen** fest, was mit Ihren Gateway-Daten geschehen soll, nachdem Sie sie importiert haben AWS IoT SiteWise. In Bezug auf die Datenspeicherung müssen zwei Entscheidungen getroffen werden: + Wenn Sie importierte Daten in den AWS IoT SiteWise Speicher kopieren möchten, aktivieren Sie das Kontrollkästchen **Daten in den Speicher kopieren**. Diese Option dupliziert die importierten Daten aus Ihrem konfigurierten Amazon S3 S3-Bucket in den AWS IoT SiteWise Speicher. + Wenn Sie Ihre Daten aus Ihrem Amazon S3 S3-Bucket in den AWS IoT SiteWise Speicher importieren möchten, können Sie auch angeben, ob die importierten Daten nach Abschluss des Imports gelöscht werden sollen. Aktivieren Sie das Kontrollkästchen **Daten aus Amazon S3 löschen**, um das importierte Datum nach dem Import in den AWS IoT SiteWise Speicher aus dem konfigurierten Amazon S3 S3-Bucket zu löschen. 1. Fügen Sie Ihrem Ziel Pfadfilter hinzu. Weitere Informationen finden Sie unter [Fügen Sie Pfadfilter zu AWS IoT SiteWise Edge-Zielen hinzu](destinations-add-path-filters.md). ------ #### [ AWS CLI ] **Example : Erstellen Sie ein neues AWS IoT SiteWise Ziel, das mit Amazon S3 gepuffert wird** Verwenden Sie die [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API, um den Herausgeber zu konfigurieren. Stellen Sie den Parameter `capabilityNamespace` auf `iotsitewise:publisher:3` ein. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_BUFFERED", "name": "your-s3-destination-name", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder", "publishPolicy": { "publishFrequency": "15m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` **Example : Ein mit Amazon AWS IoT SiteWise S3 gepuffertes Ziel aktualisieren** Um ein vorhandenes AWS IoT SiteWise Echtzeit-Ziel zu aktualisieren, verwenden Sie zunächst die `DescribeGatewayCapabilityConfiguration` API, um das `destinationId` zu finden. Der Publisher-Namespace: `iotsitewise:publisher:3` ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "your-existing-destination-id", "type": "SITEWISE_BUFFERED", "name": "your-s3-destination-name", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder", "publishPolicy": { "publishFrequency": "15m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Die folgenden Konfigurationsoptionen sind spezifisch für MQTT-fähige Gateways, die den Namespace verwenden. `iotsitewise:publisher:3` `sources` Definiert Datenquellen für die Übertragung von Daten von Ihren Industrieanlagen zu. AWS IoT SiteWise Verwenden Sie für MQTT-fähige Gateways. `MQTT` Typ: Array von -Objekten Erforderlich: Ja `destinations` Definiert, wohin Daten gesendet werden sollen. Ziele werden entweder in Echtzeit oder mit Amazon S3 gepuffert. Es ist mindestens ein Zielobjekt erforderlich, aber Sie können ein leeres Array hinzufügen. Sie können für jedes Gateway ein Echtzeitziel einrichten. Weitere Informationen finden Sie unter [Verstehen Sie AWS IoT SiteWise Edge-Ziele](gw-destinations.md#source-destination). Typ: Array von -Objekten Erforderlich: Ja `id` Die eindeutige Kennung für das Ziel. Sie können entweder eine bestehende Ziel-ID angeben oder das Feld leer lassen, damit automatisch eine neue ID für das Ziel generiert wird. Typ: Zeichenfolge Erforderlich: Nein `type` Zieltyp Zu den Optionen gehören: `SITEWISE_REALTIME` und`SITEWISE_BUFFERED`. Wählen Sie `SITEWISE_BUFFERED`. + `SITEWISE_REALTIME`(Standard) — Daten werden in Echtzeit direkt an den AWS IoT SiteWise Speicher gesendet. Weitere Informationen finden Sie unter [Fügen Sie ein AWS IoT SiteWise Edge-Echtzeitziel hinzu](destinations-real-time.md). + `SITEWISE_BUFFERED`— Senden Sie Daten stapelweise im Parquet-Format an Amazon S3 und importieren Sie sie dann in den AWS IoT SiteWise Speicher. Typ: Zeichenfolge Erforderlich: Ja `name` Ein eindeutiger Name für das Ziel. Typ: Zeichenfolge Erforderlich: Ja `config` Spezifische Konfiguration für den Zieltyp im JSON-Format. Die Konfiguration variiert zwischen Echtzeit- und gepufferten Zielen. Typ: Objekt Erforderlich: Ja `targetBucketArn` Der BucketARN, in dem veröffentlicht werden soll. Wählen Sie dasselbe AWS-Region für beide AWS IoT SiteWise und Amazon S3. Wenn ein Präfix ausgewählt wird, muss es zwischen 1 und 255 Zeichen lang sein. AWS IoT SiteWise, einschließlich des Gateways, wird Zugriff auf den gesamten angegebenen S3-Bucket haben. Wir empfehlen die Verwendung eines speziellen Buckets für die gepufferte Datenaufnahme. Typ: Zeichenfolge Erforderlich: Ja `publishPolicy` Einzelheiten der Veröffentlichungsrichtlinie. Typ: Objekt Erforderlich: Ja `publishFrequency` Die Häufigkeit, mit der das SiteWise Edge-Gateway im Amazon S3 S3-Bucket veröffentlicht. Die Häufigkeit, mit der Daten auf Amazon S3 hochgeladen werden, muss mehr als 0 Minuten und weniger als 30 Tage oder weniger als 30 Tage betragen. Sie können, und verwenden `m``h`, `d` wenn Sie ein Alter für die Veröffentlichungshäufigkeit angeben. Hinweis, `m` der Minuten, `h` Stunden und Tage `d` darstellt. Der Standardwert ist 15 Minuten. Typ: Zeichenfolge Erforderlich: Ja `localSizeLimitGB` Die maximale Größe der auf die lokale Festplatte geschriebenen Dateien in GB. Wenn dieser Schwellenwert überschritten wird, veröffentlicht der Herausgeber alle gepufferten Daten an seinem Ziel. Typ: Ganzzahl Erforderlich: Ja `siteWiseImportPolicy` Einzelheiten der Importrichtlinie für den Import von Daten in. AWS IoT SiteWise Typ: Objekt Erforderlich: Ja `enableSiteWiseStorageImport` Stellen Sie dies auf ein`true`, um Daten aus einem Amazon S3 S3-Bucket in den AWS IoT SiteWise Speicher zu importieren. Es erstellt zunächst eine Kopie der Daten in AWS IoT SiteWise. Wenn Sie dann `enableDeleteAfterImport` auf true setzen, werden die Daten in S3 nach dem Kopieren nach AWS IoT SiteWise gelöscht. Dies hat Auswirkungen auf die Preisgestaltung. Der Standardwert ist `true`. Typ: Boolescher Wert Erforderlich: Ja `enableDeleteAfterImport` Stellen Sie diese Option ein`true`, um die Datei im Amazon S3 S3-Bucket nach der Aufnahme in den AWS IoT SiteWise Speicher zu löschen. Der Standardwert ist `true`. Typ: Boolescher Wert Erforderlich: Ja `bulkImportJobRoleArn` Der ARN der IAM-Rolle, die AWS IoT SiteWise davon ausgeht, während der Datenaufnahme gepufferte Daten aus Amazon S3 zu lesen. Diese Rolle wird verwendet, wenn ein Edge-Gerät anruft, um den AWS IoT SiteWise APIs Massenimportprozess einzuleiten. Wenn auf gesetzt `enableSiteWiseStorageImport` ist`true`, ist dieser Parameter erforderlich. Typ: Zeichenfolge Erforderlich: Nein ------ Fügen Sie Pfadfilter für Ihr Ziel hinzu. Weitere Informationen finden Sie unter [Fügen Sie Pfadfilter zu AWS IoT SiteWise Edge-Zielen hinzu](destinations-add-path-filters.md).