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. # Ziele und Pfadfilter Destinationen in AWS IoT SiteWise Edge bieten eine flexible und effiziente Möglichkeit, den Fluss Ihrer Industriedaten von Edge-Geräten in die Cloud zu verwalten. In diesem Abschnitt wird erklärt, wie Sie Ziele konfigurieren, Pfadfilter verwenden, um bestimmte Datenströme weiterzuleiten, und den richtigen Zieltyp für Ihren Anwendungsfall auswählen. Sie können Ziele und Pfadfilter auf selbst gehosteten MQTT-fähigen V3-Gateways und Gateways verwenden, die in Verbindung mit einer Edge-Anwendung verwendet werden, auf der gehostet wird. AWS IoT SiteWise Siemens Industrial Edge Ziele und Pfadfilter funktionieren nicht mit Classic Streams, V2-Gateways. **Topics** + [Verstehen Sie AWS IoT SiteWise Edge-Ziele](#source-destination) + [Machen Sie sich mit Pfadfiltern für AWS IoT SiteWise Edge-Ziele vertraut](#destinations-path-filters) + [Fügen Sie ein AWS IoT SiteWise Edge-Echtzeitziel hinzu](destinations-real-time.md) + [Fügen Sie ein AWS IoT SiteWise gepuffertes Ziel mit Amazon S3 hinzu](destinations-buffered.md) + [Fügen Sie Pfadfilter zu AWS IoT SiteWise Edge-Zielen hinzu](destinations-add-path-filters.md) + [AWS IoT SiteWise Edge-Ziele verwalten](destinations-manage.md) ## Verstehen Sie AWS IoT SiteWise Edge-Ziele Verwenden Sie AWS IoT SiteWise Edge-Ziele, um zu bestimmen, wohin Ihre Quelldaten gesendet werden sollen. Sie können Ihr Datenziel auf der Grundlage bestimmter Merkmale auswählen, die Sie benötigen, wie z. B. Wirtschaftlichkeit, geringe Latenz oder Speicheranforderungen. Integrieren Sie Gerätedaten AWS IoT SiteWise, die von unseren Partnern oder benutzerdefinierten Anwendungen erfasst wurden, um Pfadfilter (Themen) am Netzwerkrand zu veröffentlichen und zu abonnieren. Anschließend können Sie Ihre Gerätedaten modellieren, übertragen und in der Cloud speichern. **Anmerkung** Um alle Zielfunktionen auf selbst gehosteten Gateways in vollem Umfang nutzen zu können, führen Sie ein Upgrade auf die neuesten Versionen des SiteWise IoT-Publishers und des IoT SiteWise OPC UA-Collectors durch. Die Stream-Unterstützung wird auf Classic-Streams und V2-Gateways fortgesetzt, um die Kompatibilität mit bestehenden Setups aufrechtzuerhalten. Weitere Informationen finden Sie unter [Klassische Streams, V2-Gateways für Edge AWS IoT SiteWise](classic-streams-v2-gateway.md). **Topics** + [Wie SiteWise Edge-Ziele das Datenmanagement verbessern](#how-destinations-work) + [Zieltypen](#destination-types) + [Vergleichen Sie die Zielfunktionen zwischen den Gateway-Versionen](#destinations-vs-publisher-component) + [Einschränkungen bei der Destination](#destinations-limitiations) + [Anwendungsfälle für SiteWise Edge-Ziele](#destinations-use-cases) ### Wie SiteWise Edge-Ziele das Datenmanagement verbessern Exportieren Sie Daten vom Edge AWS IoT SiteWise in Echtzeit oder stapelweise mit Amazon S3. Ziele verbessern die Flexibilität und Skalierbarkeit in Ihrer AWS IoT SiteWise Umgebung. Destinations implementieren ein zentralisiertes Datenverwaltungsmodell, bei dem Quellen Daten in einem zentralen System veröffentlichen. Ziele bestimmen mithilfe von Pfadfiltern, wohin Ihre Daten gesendet werden. Ziele können mehrere Pfadfilter abonnieren. MQTT-fähige Gateways, unabhängig davon, ob sie selbst gehostet werden oder auf denen sie laufenSiemens Industrial Edge, verwenden MQTT für die lokale Kommunikation und verfügen über ein standardmäßiges Echtzeitziel, für das Filter eingestellt sind. `#` Das bedeutet, dass standardmäßig alle Nachrichten zu allen Themen im Echtzeitziel veröffentlicht werden. AWS IoT SiteWise Weitere Informationen finden Sie unter [Machen Sie sich mit Pfadfiltern für AWS IoT SiteWise Edge-Ziele vertrautInformationen zu Pfadfiltern](#destinations-path-filters). Sie können in jedem Gateway ein Echtzeitziel hinzufügen. ### Zieltypen Bei der Konfiguration eines Ziels für Ihr Gateway haben Sie zwei Hauptoptionen: Echtzeitkonfiguration mithilfe von AWS IoT SiteWise Amazon S3 und eine gepufferte Konfiguration mit Amazon S3. Jeder Zieltyp hat seine eigenen Einstellungen und Überlegungen. **AWS IoT SiteWise Einstellungen in Echtzeit** Wählen Sie diese Option, um Daten direkt an AWS IoT SiteWise Hot-Tier-Speicher zu senden und so die Erfassung und Überwachung von Daten in Echtzeit zu erleichtern. Die Echtzeiteinstellungen verwalten den Datenfluss, insbesondere wenn bei einem Gateway Verbindungsprobleme mit der Cloud auftreten. Während eines Verbindungsverlusts werden Daten vorübergehend lokal auf dem Gateway gespeichert. Sobald die Verbindung wieder hergestellt ist, werden die gespeicherten Daten automatisch an die Cloud gesendet. Sie können verschiedene Aspekte des Datenveröffentlichungsprozesses anpassen, z. B. die maximale Datenmenge, die lokal gespeichert werden soll, die Geschwindigkeit, mit der Daten bei der erneuten Verbindung an die Cloud gesendet werden, und den Zeitpunkt, zu dem Daten gelöscht werden sollen, wenn der Speicher seine Kapazität erreicht hat. Weitere Informationen zu AWS IoT SiteWise Speicherstufen finden Sie unter. [Datenspeicher verwalten in AWS IoT SiteWise](manage-data-storage.md) **AWS IoT SiteWise mit Amazon S3 S3-Einstellungen gepuffert** Dieser Zieltyp ermöglicht es Ihnen, Daten lokal auf dem Gateway zu puffern und sie regelmäßig stapelweise an einen Amazon S3 S3-Bucket zu senden. Die Daten werden im effizienten Parquet-Format gespeichert, das für analytische Workloads optimiert ist. Sobald sich die Daten in Amazon S3 befinden, können Sie sie AWS IoT SiteWise zur Speicherung, Verarbeitung und Analyse in Amazon S3 importieren. Wählen Sie diese Option, um Daten stapelweise aufzunehmen und historische Daten auf kostengünstige Weise zu speichern. Sie können Ihren bevorzugten Amazon S3-Bucket-Standort und die Häufigkeit, mit der Daten auf Amazon S3 hochgeladen werden sollen, konfigurieren. Sie können auch wählen, was mit den Daten nach der Aufnahme geschehen soll. AWS IoT SiteWise Sie können wählen, ob die Daten SiteWise sowohl in Amazon S3 als auch in Amazon S3 verfügbar sein sollen, oder Sie können wählen, ob sie automatisch aus Amazon S3 gelöscht werden sollen. ### Vergleichen Sie die Zielfunktionen zwischen den Gateway-Versionen Die Zielfunktion in MQTT-fähigen Gateways optimiert das Datenflussmanagement. Ziele vereinfachen das Datenmanagement durch die zentrale Konfiguration des Datenroutings zu verschiedenen Endpunkten. Dieser Ansatz macht komplexe individuelle Stream-Setups überflüssig, wodurch das Gesamtsystem flexibler und einfacher zu verwalten ist. Im Vergleich dazu überträgt das Classic Streams, das V2-Gateway und SiteWise Edge Daten von Datenquellen über AWS IoT Greengrass Streams an Publisher, wobei die Datenziele für jede Datenquelle individuell konfiguriert werden. Mit der AWS IoT SiteWise Zielfunktion wird die Routing-Konfiguration des Herausgebers konsolidiert. Mit der Zielkonfiguration können Sie Ziele und Pfadfilter zentral verwalten. Sie können ganz einfach ein Ziel hinzufügen, Pfadfilter verwalten, unnötige Filter oder Ziele löschen, je nach Ihren Bedürfnissen. Darüber hinaus verwendet die Zielfunktion MQTT (Message Queuing Telemetry Transport), ein Industriestandardprotokoll, das in industriellen IoT-Anwendungen weit verbreitet ist. Diese Einführung von MQTT trägt dazu bei, AWS IoT SiteWise die Integration mit verschiedenen Geräten und Systemen zu vereinfachen. ### Einschränkungen bei der Destination Zu den aktuellen Einschränkungen für Ziele auf SiteWise Edge-Gateways gehören: + Das Datenverarbeitungspaket wird auf MQTT-fähigen Gateways nicht unterstützt. + Die Unterstützung von Datentypen ist auf Datentypen beschränkt. AWS IoT SiteWise Informationen zur Aktivierung der Datentypkonvertierung finden Sie unter[Nicht unterstützte Datentypen werden konvertiert](string-conversion.md). ### Anwendungsfälle für SiteWise Edge-Ziele SiteWise Edge-Destinationen werden in verschiedenen Anwendungen eingesetzt. Hier sind einige wichtige Beispiele: **Industrielle Automatisierung***Überwachung und vorausschauende Wartung in Echtzeit* In industriellen Umgebungen können Sensoren und Geräte in der Fabrik Daten auf SiteWise Edge veröffentlichen. Ziele können so konfiguriert werden, dass relevante Daten gefiltert und weitergeleitet werden, sodass die Maschinenleistung in Echtzeit überwacht und analysiert werden kann. Sie können relevante MQTT-Themen mithilfe von Pfadfiltern abonnieren, die Daten verarbeiten und dann die verarbeiteten Daten veröffentlichen. Auf diese Weise können Sie verarbeitete Daten selektiv an AWS Cloud-Analysedienste oder lokale Systeme weiterleiten. Hersteller können dann Strategien zur vorausschauenden Wartung implementieren, Produktionsprozesse optimieren und Ausfallzeiten reduzieren. **Intelligente Gebäude***Energieeffizienz und Nutzungsoptimierung* Gebäudeautomationssysteme generieren Datenströme zur Überwachung und Steuerung verschiedener Aspekte eines Gebäudes, wie z. B. HLK-Systeme, Beleuchtung und Zutrittskontrolle. Mit SiteWise Edge können diese Datenströme aufgenommen, verarbeitet und an verschiedene Ziele weitergeleitet werden. Facility Manager können Ziele so konfigurieren, dass sie relevante Daten filtern und weiterleiten, was erweiterte Funktionen wie Energieeffizienzmaßnahmen und Belegungsoptimierung ermöglicht und gleichzeitig Datenschutz und Compliance gewährleistet. Diese Anwendungsfälle zeigen, wie die Destinationsfunktion in SiteWise Edge in verschiedenen Branchen genutzt werden kann, um Daten effizient aufzunehmen, zu verarbeiten und weiterzuleiten. Dies ermöglicht erweiterte Funktionen wie Echtzeitüberwachung, vorausschauende Wartung, Energieeffizienz und Ferndiagnose und gewährleistet gleichzeitig Datenschutz und Compliance. ## Machen Sie sich mit Pfadfiltern für AWS IoT SiteWise Edge-Ziele vertraut **Topics** + [Anforderungen an Pfadfilter](#path-filter-requirements) + [Bewährte Methoden für Pfadfilter](#create-effective-path-filters) + [Pfadfilter für OPC UA-Server](#path-filters-opcua) + [Sonderzeichen in Pfadfilternamen](#path-filters-special-characters) Jedes Ziel ist so konfiguriert, dass es Daten an AWS IoT SiteWise oder Amazon S3 weiterleitet. Pfadfilter ermöglichen es Ihnen, bestimmte Daten auszuwählen, die beim Empfang von MQTT-Nachrichten für ein Ziel gefiltert werden sollen. Pfadfilter stellen die logischen Namen Ihrer Datenströme dar und dienen als Abonnements für die gewünschten MQTT-Themen. In MQTT sind Daten in Topics organisiert, bei denen es sich um hierarchische Zeichenketten handelt, die durch Schrägstriche () getrennt sind. `/` Beispielsweise könnte ein Gerät Temperaturdaten zu dem Thema veröffentlichen. `home/livingroom/sensor1/temperature` `home/livingroom/sensor1`Stellt hier den Pfad oder den logischen Namen des Sensors dar und `temperature` ist der Datentyp, der veröffentlicht wird. Sie können Pfadfilter verwenden, um bestimmte Themen oder eine Reihe von Themen mithilfe von Platzhaltern (`+`und`#`) zu abonnieren. Der `+` Platzhalter entspricht einer einzelnen Ebene in der Themenhierarchie. `home/+/sensor1/temperature`Würde zum Beispiel mit `home/livingroom/sensor1/temperature` und `home/bedroom/sensor1/temperature` übereinstimmen. Wenn der `#` Platzhalter am Ende eines Filters verwendet wird, entspricht er mehreren Ebenen. Sie können innerhalb eines Pfadfilternamens auch eine Vielzahl von Zeichen verwenden, die in der MQTT-Spezifikation normalerweise nicht zulässig sind. Diese Zeichen funktionieren nicht als Platzhalter, wenn sie innerhalb eines Namens verwendet werden. AWS IoT SiteWise konvertiert diese Zeichen mithilfe von Kodierung, um die MQTT-Konformität zu gewährleisten und gleichzeitig Ihre ursprüngliche Namensstruktur beizubehalten. Diese Funktion ist besonders nützlich, um bestehende Namenskonventionen aus anderen Systemen zu berücksichtigen. Weitere Informationen finden Sie unter [Sonderzeichen in Pfadfilternamen](#path-filters-special-characters). Durch die sorgfältige Auswahl der entsprechenden Pfadfilter können Sie steuern, welche Daten an ein bestimmtes Ziel gesendet werden. Passen Sie den Datenfluss mithilfe von Pfadfiltern an die Anforderungen Ihres IoT-Systems an. ### Anforderungen an Pfadfilter Beachten Sie bei der AWS-IoT-SiteWise-Konsole Eingabe von Pfadfiltern mithilfe von Folgendes: + Pfadfilter werden durch eine neue Linie begrenzt, wobei jede Zeile einen separaten Pfadfilter darstellt. + Einzelne Pfadfilter können zwischen 1 und 65.535 Byte haben. + Ein Pfadfilter darf nicht leer sein. + Nullwerte (U\$10000) sind nicht zulässig. + Sie können bis zu 100 Pfadfilter oder 65.535 Zeichen gleichzeitig eingeben, je nachdem, welcher Grenzwert zuerst erreicht wird. + Das Gesamtlimit liegt bei 20.000 Pfadfiltern für alle Ziele auf einem Gateway zusammen. + Sie können die `$` Zeichen`%`, `#``+`, und in Pfadfilternamen verwenden, konvertiert sie jedoch AWS IoT SiteWise automatisch in die URI-Kodierung. ### Bewährte Methoden für Pfadfilter Beachten Sie bei der Erstellung von Pfadfiltern für Ihre AWS IoT SiteWise Ziele die folgenden Strategien, um Ihre Daten effektiv zu verwalten. + Strukturieren Sie Ihre Filter so, dass sie Ihre Gerätehierarchie widerspiegeln. Erfasst beispielsweise in einer `factory/+/machine/#` Produktionsumgebung Daten von allen Maschinen in verschiedenen Produktionslinien. + Verwenden Sie spezifische Ebenen für Gerätetypen, Standorte oder Funktionen. Beispiel, `factory/assembly-line/robot/temperature`. Oder, in der intelligenten Landwirtschaft`farm/+/crop/+/moisture`, um den Feuchtigkeitsgehalt verschiedener Nutzpflanzen auf verschiedenen Feldern zu überwachen. + Setzen Sie Platzhalter strategisch ein: Verwenden Sie sie `+` für Variationen auf einer einzelnen Ebene und `#` zur Erfassung aller nachfolgenden Ebenen. Verfolgt `building/+/+/energy-consumption` beispielsweise den Energieverbrauch in verschiedenen Zonen und Stockwerken eines Gebäudes. Dabei wird davon ausgegangen, dass die erste `+` Methode alle Stockwerke und die zweite alle Zonen `+` erfasst. + Sorgen Sie für ein ausgewogenes Verhältnis zwischen Spezifität und Flexibilität, indem Sie Filter erstellen, die spezifisch genug sind, um relevante Daten zu erfassen, aber flexibel genug sind, um future Änderungen Rechnung zu tragen. `site/+/equipment-type/+/measurement`Ermöglicht beispielsweise das Hinzufügen neuer Standorte oder Gerätetypen, ohne die Filterstruktur zu ändern. Testen Sie Ihre Filter gründlich, um sicherzustellen, dass sie die beabsichtigten Daten erfassen und mit der Architektur und den Zielen Ihres IoT-Systems übereinstimmen. ### Pfadfilter für OPC UA-Server Für OPC UA-Server müssen Ihre Pfadfilter den OPC UA-Tagnamen entsprechen. Die letzte Ebene Ihres Pfadfilters muss exakt mit dem OPC UA-Tagnamen übereinstimmen. Wenn Ihr OPC UA-Tag beispielsweise lautet`Device1.Temperature`, könnte es Ihr Pfadfilter sein. `factory/line1/Device1.Temperature` In den vorherigen Ebenen können Sie Platzhalter verwenden, `factory/+/Device1.Temperature` um beispielsweise das Tag über mehrere Produktionslinien hinweg zu erfassen. Falls Ihre Pfadfilternamen Sonderzeichen enthalten, finden Sie [Sonderzeichen in Pfadfilternamen](#path-filters-special-characters) weitere Informationen unter. ### Sonderzeichen in Pfadfilternamen AWS IoT SiteWise berücksichtigt Zeichen, die häufig in Industrieprotokollen wie OPC UA verwendet werden und die normalerweise in Standard-MQTT-Themennamen nicht zulässig sind. Diese Funktion ermöglicht eine reibungslosere Integration von Industriesystemen mit MQTT-basierten Architekturen. **Anmerkung** Unsere Behandlung von Sonderzeichen ist zwar hilfreich für die Integration und Migration, es wird jedoch empfohlen, sich bei neuen Implementierungen nach Möglichkeit an die standardmäßigen MQTT-Namenskonventionen zu halten, um eine umfassendere Kompatibilität zu gewährleisten. AWS IoT SiteWise Normalisiert beim Empfang von Daten aus industriellen Quellen Themennamen mithilfe der URI-Kodierung für Sonderzeichen: + `%`wird `%25` (zuerst als Escape-Zeichen kodiert) + `#`wird `%23` + `+`wird `%2B` + `$`wird `%24` (nur wenn am Anfang eines Themas) Diese Kodierung stellt sicher, dass Quelldaten, die diese speziellen MQTT-Zeichen enthalten, sicher als MQTT-Themennamen verwendet werden können, wobei die ursprünglichen industriellen Namenskonventionen beibehalten werden. **Example : Sonderzeichen in Pfadfilternamen** Im Folgenden finden Sie Beispiele dafür, wie Namen von Industriethemen in AWS IoT SiteWise Pfadfiltern erscheinen könnten: + `Factory1/Line#2/Sensor+3`wird `Factory1/Line%232/Sensor%2B3` + `Plant%A/Unit$1/Temp`wird `Plant%25A/Unit%241/Temp` + `Site1/#Section/+Node`wird `Site1/%23Section/%2BNode` Wenn Sie Abonnements erstellen oder Themennamen in ansehen AWS IoT SiteWise, werden Ihnen die unverschlüsselten Originalversionen angezeigt. Die Kodierung erfolgt automatisch, um die MQTT-Konformität sicherzustellen. # Fügen Sie ein AWS IoT SiteWise Edge-Echtzeitziel hinzu Mit dem Echtzeit-Zieltyp können Sie IoT-Daten in Echtzeit direkt von Ihren Geräten und Gateways in den AWS IoT SiteWise Speicher streamen. Diese Option ist ideal für Anwendungsfälle, bei denen Daten sofort bei der Generierung aufgenommen und verarbeitet werden müssen, ohne dass eine Stapelverarbeitung oder Pufferung erforderlich ist. Sie können in jedem Gateway nur ein Echtzeitziel konfigurieren, da es kontinuierlich Daten streamt. AWS IoT SiteWise **Anmerkung** Ein Duplikat TQVs kann zu einer doppelten Aufladung führen. **Um ein Ziel in Echtzeit hinzuzufügen** Verwenden Sie die AWS IoT SiteWise Konsole oder fügen AWS CLI Sie Ihrem SiteWise Edge-MQTT-fähigen Gateway ein Echtzeitziel hinzu. ------ #### [ Console ] 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 die **AWS IoT SiteWise Echtzeitoption** für den **Zieltyp** aus. 1. Konfigurieren Sie die Veröffentlichungsreihenfolge des Gateways, indem Sie die **Veröffentlichungsreihenfolge** auf „**Ältere Daten zuerst veröffentlichen**“ oder „**Neueste Daten zuerst veröffentlichen**“ festlegen. Standardmäßig veröffentlicht das Gateway die ältesten Daten zuerst. 1. Verwenden Sie **Maximale Batch-Wartezeit**, um eine maximale Wartezeit festzulegen, an die der Herausgeber warten soll, bevor er einen Datenstapel sendet AWS IoT SiteWise. Diese Einstellung gilt für jeden Alias. Die Daten werden lokal gespeichert, bis entweder: + Die eingestellte Zeit ist abgelaufen, oder + Es wurden 10 time-quality-value (TQV) Einträge für den Alias empfangen Unabhängig davon, welche Bedingung zuerst erfüllt ist, wird der Batch an die Cloud gesendet. 1. Um hochgeladene Daten zu komprimieren, **aktivieren Sie das Kontrollkästchen Komprimierung beim Hochladen von Daten** aktivieren. Wenn Sie das Gateway Ihre Daten komprimieren lassen, bevor Sie sie in die Cloud hochladen, wird die Bandbreitennutzung reduziert. 1. Um abgelaufene Herausgeberdaten herauszufiltern, aktivieren Sie das Kontrollkästchen **Abgelaufene Daten ausschließen**. Mit dieser Auswahl werden nur aktive und aktuelle Daten an gesendet AWS IoT SiteWise. 1. Geben Sie im Feld **Stichtag** die Häufigkeit ein, mit der Daten innerhalb Ihres Datensatzes als abgelaufen gelten sollen. Sie können festlegen, ob die Daten in Minuten oder Tagen gezählt werden. Die minimale Sperrfrist beträgt fünf Minuten. Die maximale Ausschlussfrist beträgt sieben Tage. 1. Konfigurieren Sie optional die **Einstellungen für den lokalen Speicher**: 1. Legen Sie die Häufigkeit des **Aufbewahrungszeitraums** fest — Der Zeitraum, für den das Gateway Daten lokal speichert, die älter sind als der Sperrzeitraum. Die Mindestaufbewahrungsdauer beträgt eine Minute. Die maximale Aufbewahrungsdauer beträgt 30 Tage und ist größer oder gleich der Rotationsdauer. 1. Legen Sie den **Rotationszeitraum** fest — Das Zeitintervall, das beim Speichern von Daten angegeben werden soll, die älter sind als der Grenzzeitraum für eine einzelne Datei. Das Gateway überträgt am Ende jeder Rotationsperiode einen Datenstapel in das folgende lokale Verzeichnis:`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. Die Aufbewahrung muss länger als eine Minute sein und der Aufbewahrungsdauer entsprechen. 1. Geben Sie den Wert für die **Speicherkapazität (GB)** an, um die maximale Größe der lokal gespeicherten Daten in GB festzulegen. Wenn die Daten die festgelegte maximale lokale Speichergröße überschreiten, beginnt das Gateway zuerst mit dem Löschen der ältesten Daten. Das Gateway löscht weiter, bis die Größe der lokal gespeicherten Daten dem Kontingent entspricht oder dieses unterschreitet. Die Speicherkapazität muss größer oder gleich einem GB sein. 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). Weitere Informationen finden Sie unter [Zieltypen](gw-destinations.md#destination-types). ------ #### [ AWS CLI ] **Example : Erstelle ein neues Ziel AWS IoT SiteWise in Echtzeit** 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_REALTIME", "name": "your-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Um ein vorhandenes AWS IoT SiteWise Echtzeitziel zu aktualisieren, verwenden Sie zunächst die `DescribeGatewayCapabilityConfiguration` API, um das zu finden`destinationId`. **Example : Aktualisieren Sie ein AWS IoT SiteWise Echtzeit-Ziel** 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": [ { "id": "your-existing-destination-id", "type": "SITEWISE_REALTIME", "name": "your-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "dropPolicy": { "cutoffAge": "7d", "exportPolicy": { "retentionPeriod": "7d", "rotationPeriod": "6h", "exportSizeLimitGB": 10 } }, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Die folgenden Konfigurationsoptionen sind spezifisch für Gateways, die den `iotsitewise:publisher:3` Namespace verwenden. `sources` Definiert Datenquellen, zu denen Daten von Ihren Industrieanlagen übertragen werden sollen. 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 vorhandene Ziel-ID angeben oder das Feld leer lassen. Wenn Sie keine ID angeben, wird standardmäßig eine UUID generiert. Typ: Zeichenfolge Erforderlich: Nein `type` Zieltyp Zu den Optionen gehören: `SITEWISE_REALTIME` und. `SITEWISE_BUFFERED` + `SITEWISE_REALTIME`— Senden Sie Daten in Echtzeit direkt an den AWS IoT SiteWise Speicher. + `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 Reihenfolge der Veröffentlichung Legt die Reihenfolge fest, in der Daten veröffentlicht werden. Daten werden auf der Grundlage ihres Zeitstempels veröffentlicht. Zu den Optionen gehören `TIME_ORDER` und. `RECENT_DATA` + `TIME_ORDER`(Standard) — Veröffentlicht zuerst ältere Daten. + `RECENT_DATA`— Publiziert die neuesten Daten zuerst. Typ: Zeichenfolge Erforderlich: Nein Aktiviert die Komprimierung Wenn auf gesetzt`true`, wird die Datenkomprimierung vor dem Senden an aktiviert. AWS IoT SiteWise Wenn Sie das Gateway Ihre Daten komprimieren lassen, bevor Sie sie in die Cloud hochladen, wird die Bandbreitennutzung reduziert. Der Standardwert ist `true`. Typ: Boolesch Erforderlich: Nein DropPolicy Definiert, wie mit älteren Daten umgegangen werden soll. Typ: Objekt Erforderlich: Nein + `cutoffAge` Das maximale Alter der zu veröffentlichenden Daten, angegeben in Tagen, Stunden und Minuten. Zum Beispiel `7d` oder `1d7h16m`. Daten, die älter sind als die von Ihnen angegebenen, werden nicht gesendet AWS IoT SiteWise. Daten, die vor dem Stichtag liegen, werden nicht in der Cloud veröffentlicht. Das Mindestalter muss zwischen fünf Minuten und sieben Tagen liegen. Sie können, und verwenden `m``h`, `d` wenn Sie ein Mindestalter angeben. Hinweis, `m` der Minuten, `h` Stunden und Tage `d` darstellt. Typ: Zeichenfolge Erforderlich: Ja + `exportPolicy` Definiert, wie mit Daten umgegangen wird, die das Mindestalter überschreiten. Typ: Objekt Erforderlich: Nein + `retentionPeriod` Ihr SiteWise Edge-Gateway löscht alle Daten am Edge, die vor dem Sperrzeitraum liegen, aus dem lokalen Speicher, nachdem sie für den angegebenen Aufbewahrungszeitraum gespeichert wurden. Die Aufbewahrungsdauer muss zwischen einer Minute und 30 Tagen liegen und mindestens dem Rotationszeitraum entsprechen. Sie können`m`, und verwenden`h`, `d` wenn Sie einen Aufbewahrungszeitraum angeben. Hinweis, `m` der Minuten, `h` Stunden und Tage `d` darstellt. Typ: Zeichenfolge Erforderlich: Nein + `rotationPeriod` Das Zeitintervall, über das Daten, die vor dem Stichtag liegen, gebündelt und in einer einzigen Datei gespeichert werden sollen. Das SiteWise Edge-Gateway überträgt am Ende jeder Rotationsperiode einen Datenstapel in das folgende lokale Verzeichnis:`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. Der Rotationszeitraum muss länger als eine Minute und gleich oder kürzer als der Aufbewahrungszeitraum sein. Sie können`m`, und verwenden`h`, `d` wenn Sie einen Rotationszeitraum angeben. Hinweis, `m` der Minuten, `h` Stunden und Tage `d` darstellt. Typ: Zeichenfolge Erforderlich: Nein + `exportSizeLimitGB` Die maximal zulässige Größe der lokal gespeicherten Daten in GB. Wenn dieses Kontingent überschritten wird, beginnt das SiteWise Edge-Gateway mit dem Löschen der frühesten Daten, bis die Größe der lokal gespeicherten Daten dem Kontingent entspricht oder darunter liegt. Der Wert dieses Parameters muss größer oder gleich 1 sein. Typ: Ganzzahl Erforderlich: Nein `maxBatchWaitTime` Legt eine maximale Wartezeit für den Herausgeber fest, bevor er einen Datenstapel an sendet AWS IoT SiteWise. Diese Einstellung gilt für jeden Alias. Die Daten werden lokal gespeichert, bis entweder: + Die eingestellte Zeit ist abgelaufen, oder + Es wurden 10 time-quality-value (TQV) Einträge für den Alias empfangen Verwenden Sie`m`,`h`, und, `d` um einen Annahmeschluss anzugeben. Hinweis, `m` der Minuten, `h` Stunden und Tage `d` darstellt. Typ: Zeichenfolge Erforderlich: Nein `filters` Filter, die auf die Daten angewendet werden sollen. Es ist mindestens ein Filter erforderlich. Typ: Zeichenfolge Erforderlich: Ja `type` Art des Filters. Verwenden Sie `PATH`. Typ: Zeichenfolge Erforderlich: Ja `config` Spezifische Konfiguration für den Filtertyp im JSON-Format. Es ist mindestens ein Objekt erforderlich, aber das Array kann leer sein. Typ: Objekt Erforderlich: Ja + `paths` Ein Array von Pfadfiltern. Weitere Informationen finden Sie unter [Machen Sie sich mit Pfadfiltern für AWS IoT SiteWise Edge-Ziele vertrautInformationen zu Pfadfiltern](gw-destinations.md#destinations-path-filters). Der Standardpfad ist `#`. Typ: Zeichenfolgen-Array Erforderlich: Ja ------ # 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). # Fügen Sie Pfadfilter zu AWS IoT SiteWise Edge-Zielen hinzu Fügen Sie Pfadfilter zu einem Ziel hinzu. Pfadfilter verwenden die MQTT-Themensyntax, wobei `#` es sich um ein Platzhalterzeichen handelt, das einer beliebigen Anzahl von Ebenen entspricht, und `+` um ein Platzhalterzeichen, das einer einzelnen Ebene entspricht. Sie können einem Gateway mehrere Ziele hinzufügen, von denen jedes über einen eigenen Satz von Pfadfiltern verfügt, die Ihre Gerätetelemetrie abonnieren. Siemens Industrial EdgeGateways verwenden aus Kompatibilitätsgründen ein Präfix. Weitere Informationen finden Sie unter [Präfixe für Pfadfilter](sitewise-edge-on-siemens.md#siemens-path-filters). ------ #### [ Console ] **Um Pfadfilter hinzuzufügen** 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, dem Sie Pfadfilter hinzufügen möchten. 1. Wählen Sie im Abschnitt **Pfadfilter** unter **Ziel hinzufügen** die Option **Pfadfilter hinzufügen** aus. 1. Geben Sie den Pfadfilter ein, den dieses Ziel abonnieren soll. Sie können Platzhalterzeichen (`#`und`+`) verwenden, um mehrere Pfade zu abonnieren. 1. Wählen Sie **Pfadfilter** hinzufügen, um den Pfadfilter zur Liste hinzuzufügen. 1. Wiederholen Sie die Schritte, um bei Bedarf weitere Pfadfilter hinzuzufügen. 1. Nachdem Sie alle erforderlichen Pfadfilter hinzugefügt haben, wählen Sie **Erstellen** aus. ------ #### [ AWS CLI for self-hosted gateways ] **Example : Konfiguration des Pfadfilters** ``` { "destinations": [ { ... } ], "filters": [ { "type": "PATH", "config": { "paths": [ "home/+/sensor1/temperature", "home/livingroom/sensor1/temperature", "home/livingroom/sensor1/temperature", "building/#" ] } } ] } ``` ------ #### [ AWS CLI for Siemens IEgateways ] **Example : Präfixkonfiguration für Pfadfilter** Erfassen Sie alle Daten, indem Sie sowohl die Präfixe data (`ie/d`) als auch die metadata (`ie/m`) -Präfixe für jeden Pfadfilter verwenden. ``` { "destinations": [ { ... } ], "filters": [ { "type": "PATH", "config": { "paths": [ "ie/d/home/+/sensor12/temperature", "ie/m/home/livingroom/sensor12/temperature", "ie/d/home/livingroom/sensor13/temperature2", "ie/m/home/livingroom/sensor13/temperature2", "ie/d/building/#", "ie/m/building/#" ] } } ] } ``` ------ **Anmerkung** Kopieren Sie Pfadfilter zwischen Zielen, indem Sie eine Liste der Pfadfilter herunterladen. Weitere Informationen finden Sie unter [Laden Sie alle Pfadfilter in einem Ziel (Konsole) herunter](destinations-manage.md#destinations-download-list). ## Laden Sie Pfadfilter in großen Mengen hoch Verwenden Sie eine CSV- oder Textdatei, um Pfadfilter in großen Mengen hochzuladen. AWS IoT SiteWise entfernt automatisch exakte Duplikate, wenn Sie Dateien hochladen. Zum Beispiel `windfarm/site1/` sind es exakte Duplikate, die AWS IoT SiteWise auffallen, weil die Zeichenfolge exakt dieselbe ist. `windfarm/site1/` Teilweise Duplikate werden nicht entfernt und führen zu zusätzlichen Gebühren. Zum Beispiel, `windfarm/#` und überschneiden `windfarm/site1` sich Themen, weil dies bereits von umfasst `windfarm/site1` ist. `windfarm/#` **Anmerkung** Vermeiden Sie Duplikate, um zusätzliche Gebühren zu vermeiden. Die hochgeladene Datei muss entweder im CSV- oder im TXT-Format vorliegen. Sie darf keine Überschriften enthalten und sollte aus einer einzigen Spalte bestehen. In der Spalte listen Sie Ihre Pfadfilter auf, wobei sich jeder Filter in einer separaten Zeile befindet. Die Datei sollte keine weiteren Informationen enthalten. **Anforderungen für das Hochladen von Dateien** Dies sind zusätzliche Anforderungen an den Pfadfilter. + Sie können eine CSV- oder TXT-Datei hochladen. Andere Dateiformate werden nicht unterstützt. + CSV-Dateien (.csv) können keine Kopfzeilen haben und sollten nur eine Spalte enthalten. + Sie können in jeder Zeile einen Pfadfilter verwenden. + Die hochgeladenen Dateien dürfen nicht leer sein. + Bei Verwendung von `#` als Platzhalter muss dies das letzte Zeichen im Themenfilter sein. Zum Beispiel `topic/#` oder als eigenständiges Zeichen auf einer bestimmten Themenebene. Beachten Sie jedoch, dass `#` dies auch als reguläres Zeichen innerhalb eines Namens einer Themenebene verwenden kann, z. B. `factory/machine#1/topic`. Weitere Informationen finden Sie unter [Sonderzeichen in Pfadfilternamen](gw-destinations.md#path-filters-special-characters) + Sie können den `+` Charakter auch verwenden. Verwenden Sie zum Beispiel, `factory/+/temp` um alle Temperaturen für Fabriken anstelle von `factory/machine2/temp` und `factory/machine3/temp` einzeln abzurufen. # AWS IoT SiteWise Edge-Ziele verwalten Nachdem Sie Ziele hinzugefügt haben, können Sie sie mit verschiedenen Vorgängen verwalten, z. B. Zielkonfigurationen bearbeiten, Ziele löschen und Pfadfilter verwalten. ## Bearbeiten Sie ein Ziel Wählen Sie das Optionsfeld neben dem Ziel in der Tabelle und klicken Sie auf die Schaltfläche **Bearbeiten**, um ein Ziel zu bearbeiten. ------ #### [ Console ] **Um ein Ziel mit der AWS IoT SiteWise Konsole zu bearbeiten** 1. Öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie in der linken Navigationsleiste im Abschnitt ****Edge** die Option Edge-Gateways** aus. 1. Wählen Sie das entsprechende Gateway aus. 1. Wählen Sie im Abschnitt **Ziele** das Ziel aus, das Sie bearbeiten möchten, und klicken Sie dann auf **Bearbeiten**. 1. Ändern Sie das Ziel und wählen Sie dann **Speichern**. ------ #### [ AWS CLI ] **Um ein Ziel zu bearbeiten, verwenden Sie AWS CLI** + Sie können ein Ziel bearbeiten, indem Sie die Informationen zur Konfiguration der JSON-Fähigkeit ändern. ``` aws iotsitewise update-gateway-capability-configuration \ --gateway-id your-gateway-id \ --capability-namespace "iotsitewise:publisher:3" \ --capability-configuration '{ "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "your-existing-destination-id", "type": "SITEWISE_REALTIME", "name": "your-updated-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "dropPolicy": { "cutoffAge": "10d", "exportPolicy": { "retentionPeriod": "10d", "rotationPeriod": "6h", "exportSizeLimitGB": 10 } }, "maxBatchWaitTime": "15s" }, "filters": [ { ... } ] } ] }' ``` **Anmerkung** Sie können das Ziel nicht aktualisieren `type` oder`capability-namespace`. Sie können beispielsweise nicht von einem Typ von `SITEWISE_REALTIME` zu wechseln`SITEWISE_BUFFERED`. Sie können für jedes MQTT-fähige Gateway ein Echtzeitziel einrichten. ------ ## Löschen Sie ein Ziel Wenn Sie ein Ziel nicht mehr benötigen, können Sie es von Ihrem SiteWise Edge-Gateway löschen. ------ #### [ Console ] **Um ein Ziel mit der AWS IoT SiteWise Konsole zu löschen** 1. Öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie in der linken Navigationsleiste im Abschnitt ****Edge** die Option Edge-Gateways** aus. 1. Wählen Sie das entsprechende Gateway aus. 1. Wählen Sie im Abschnitt **Ziele** das Ziel aus, das Sie löschen möchten, und klicken Sie dann auf **Löschen**. Ein Bestätigungsbildschirm wird angezeigt. 1. Um zu bestätigen, dass Sie das Ziel löschen möchten, geben Sie „Löschen“ in das Bestätigungsfeld ein. ------ #### [ AWS CLI ] **Um ein Ziel zu löschen, verwenden Sie AWS CLI** + Löschen Sie die Gateway-Fähigkeitskonfiguration, indem Sie die Gateway-ID angeben und die Funktionskonfiguration so ändern, dass das Ziel, das Sie löschen möchten, entfernt wird. ``` aws iotsitewise update-gateway-capability-configuration \ --gateway-id your-gateway-id \ --capability-namespace "iotsitewise:publisher:3" \ --capability-configuration '{ "sources": [ { "type": "MQTT" } ], "destinations": [] }' ``` **Anmerkung** Das Zielarray kann leer sein (`[]`), aber das Zielobjekt selbst muss in der Funktionskonfiguration enthalten sein. ------ ## Laden Sie alle Pfadfilter in einem Ziel (Konsole) herunter Laden Sie eine CSV-Datei mit all Ihren Pfadfiltern in der AWS IoT SiteWise Konsole herunter. Sie können eine heruntergeladene Liste von Pfadfiltern verwenden, um Pfadfilterlisten einfach zwischen Gateway-Zielen auszutauschen. **Um eine CSV-Datei mit allen Pfadfiltern mithilfe der AWS IoT SiteWise Konsole herunterzuladen** 1. Öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie in der linken Navigationsleiste im Abschnitt ****Edge** die Option Edge-Gateways** aus. 1. Wählen Sie das Gateway aus, das Ihre Pfadfilter enthält. 1. Wählen Sie entweder **Ziel hinzufügen** oder **Ziel bearbeiten**. 1. Navigieren Sie zum Abschnitt **Pfadfilter** und wählen Sie **CSV herunterladen** aus. **Anmerkung** Die CSV-Datei enthält alle Pfadfilter an einem bestimmten Ziel, unabhängig davon, welche Sie aus der Liste der Pfadfilter ausgewählt haben. ## Bearbeiten Sie einen Pfadfilter Sie können einzelne Pfadfilter bearbeiten, um zu verfeinern, welche Daten Ihr Ziel empfängt. ------ #### [ Console ] Mithilfe der AWS IoT SiteWise Konsole können Sie jeden einzelnen Pfadfilter in den jeweiligen Textfeldern bearbeiten. **Um einen Pfadfilter mit der AWS IoT SiteWise Konsole zu bearbeiten** 1. Öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie in der linken Navigationsleiste im Abschnitt ****Edge** die Option Edge-Gateways** aus. 1. Wählen Sie das Gateway aus, das Ihre Pfadfilter enthält. 1. Wählen Sie das entsprechende Ziel aus. 1. Wählen Sie **Bearbeiten** aus. 1. Wählen Sie das Textfeld für die Zeile aus, die den Pfadfilter enthält, den Sie bearbeiten möchten. 1. Aktualisieren Sie den Text des Pfadfilters und stellen Sie sicher, dass das Kontrollkästchen des bearbeiteten Pfadfilters aktiviert ist. 1. Wählen Sie **Speichern**. ------ #### [ AWS CLI ] Um Pfadfilter für ein Ziel mithilfe von zu bearbeiten AWS CLI, rufen Sie zuerst die aktuelle Konfiguration ab, ändern Sie sie und aktualisieren Sie sie dann mit dem `update-gateway-capability-configuration` Befehl. **Um einen Pfadfilter zu bearbeiten, verwenden Sie AWS CLI** 1. Rufen Sie die aktuelle Funktionskonfiguration ab: ``` aws iotsitewise describe-gateway-capability-configuration \ --gateway-id your-gateway-id \ --capability-namespace "iotsitewise:publisher:3" \ --query "capabilityConfiguration" ``` 1. Bearbeiten Sie den JSON-Code, um die Pfadfilter nach Bedarf zu ändern. 1. Aktualisieren Sie die Funktionskonfiguration mit den geänderten Pfadfiltern: ``` aws iotsitewise update-gateway-capability-configuration \ --gateway-id your-gateway-id \ --capability-namespace "iotsitewise:publisher:3" \ --capability-configuration json-containing-your-updated-path-filters ``` ------ ## Löschen Sie einen Pfadfilter Sie können Pfadfilter für ein Ziel löschen, um zu kontrollieren, welche Daten es von MQTT-Quellen und Datenverarbeitungspipelines empfängt. ------ #### [ Console ] **Um einen Pfadfilter mit der Konsole zu löschen AWS IoT SiteWise** 1. Öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie in der linken Navigationsleiste im Abschnitt ****Edge** die Option Edge-Gateways** aus. 1. Wählen Sie das Gateway aus, das Ihre Pfadfilter enthält. 1. Wählen Sie das entsprechende Ziel aus. 1. Wählen Sie **Bearbeiten** aus. 1. Wählen Sie auf dem Bildschirm **Ziel bearbeiten** im Abschnitt **Pfadfilter** einen oder mehrere Pfadfilter aus, die Sie löschen möchten. 1. Wählen Sie **Löschen** aus. Eine Bestätigungsnachricht für den Löschvorgang wird angezeigt. Wenn Sie mit dem Löschen der Pfadfilter fortfahren möchten, wählen Sie auf dem Bestätigungsbildschirm **Löschen** aus. ------ #### [ AWS CLI ] **Um ein Ziel zu löschen, verwenden Sie AWS CLI** + Löschen Sie einen Pfadfilter, indem Sie ihn aus der Funktionskonfiguration entfernen. ``` aws iotsitewise update-gateway-capability-configuration \ --gateway-id your-gateway-id \ --capability-namespace "iotsitewise:publisher:3" \ --capability-configuration '{ "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "your-destination-id", "type": "SITEWISE_REALTIME", "name": "your-destination-name", "config": { ... }, "filters": [ { "type": "PATH", "config": { "paths": [ "/path1", "/path2", "/delete-a-path-to-remove-it" ] } } ] } ] } ``` **Anmerkung** Das Filter-Array kann leer sein (`[]`), aber das Filterobjekt selbst muss in der Funktionskonfiguration enthalten sein. ------