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.
Massenoperationen mit Assets und Modellen
Wenn Sie mit einer großen Anzahl von Anlagen oder Anlagenmodellen arbeiten möchten, verwenden Sie Massenvorgänge, um Ressourcen massenweise an einen anderen Ort zu importieren und zu exportieren. Sie können beispielsweise eine Datendatei erstellen, die Vermögenswerte oder Anlagenmodelle in einem Amazon S3-Bucket definiert, und sie mithilfe des Massenimports erstellen oder aktualisieren AWS IoT SiteWise. Wenn Sie eine große Anzahl von Assets oder Asset-Modellen gespeichert haben AWS IoT SiteWise, können Sie diese auch nach Amazon S3 exportieren.
Anmerkung
Sie führen Massenoperationen durch, AWS IoT SiteWise indem Sie Operationen in der AWS IoT TwinMaker API aufrufen. Sie können dies tun, ohne einen AWS IoT TwinMaker Workspace einzurichten AWS IoT TwinMaker oder zu erstellen. Sie benötigen lediglich einen Amazon S3-Bucket, in dem Sie Ihre AWS IoT SiteWise Inhalte platzieren können.
Wichtige Konzepte und Terminologie
AWS IoT SiteWise Die Funktionen für den Massenimport und -export basieren auf den folgenden Konzepten und der folgenden Terminologie:
-
Import: Die Aktion, bei der Vermögenswerte oder Anlagenmodelle aus einer Datei in einem Amazon S3-Bucket nach verschoben AWS IoT SiteWise werden.
-
Export: Die Aktion, bei der Vermögenswerte oder Anlagenmodelle von einem Amazon S3-Bucket AWS IoT SiteWise in einen Amazon S3-Bucket verschoben werden.
-
Quelle: Der Startpunkt, von dem aus Sie Inhalte verschieben möchten.
Ein Amazon S3-Bucket ist beispielsweise eine Importquelle und AWS IoT SiteWise eine Exportquelle.
-
Ziel: Der gewünschte Ort, an den Sie Ihre Inhalte verschieben möchten.
Ein Amazon S3-Bucket ist beispielsweise ein Exportziel und AWS IoT SiteWise ein Importziel.
-
AWS IoT SiteWise Schema: Dieses Schema wird verwendet, um Metadaten zu importieren und zu exportieren AWS IoT SiteWise.
-
Top-level Ressource: Eine AWS IoT SiteWise Ressource, die Sie individuell erstellen oder aktualisieren können, z. B. ein Asset oder ein Asset-Modell.
-
Sub-resource: Eine verschachtelte AWS IoT SiteWise Ressource innerhalb einer Ressource der obersten Ebene. Beispiele hierfür sind Eigenschaften, Hierarchien und zusammengesetzte Modelle.
-
Metadaten: Wichtige Informationen, die für den erfolgreichen Import oder Export von Ressourcen erforderlich sind. Beispiele für Metadaten sind Definitionen von Vermögenswerten und Anlagenmodellen.
-
Metadaten TransferJob: Das Objekt, das bei der Ausführung erstellt wird
CreateMetadataTransferJob.
Unterstützte Funktionen
In diesem Thema wird erklärt, was Sie tun können, wenn Sie einen Massenvorgang ausführen. Massenvorgänge unterstützen die folgenden Funktionen:
-
Top-level Ressourcenerstellung: Wenn Sie ein Asset oder Asset-Modell importieren, das keine ID definiert oder dessen ID nicht mit der einer vorhandenen ID übereinstimmt, wird es als neue Ressource erstellt.
-
Top-level Ressourcenersetzung: Wenn Sie ein Asset oder Asset-Modell importieren, dessen ID mit einer bereits vorhandenen übereinstimmt, wird die vorhandene Ressource ersetzt.
-
Erstellung, Ersetzung oder Löschung von Unterressourcen: Wenn Ihr Import eine Ressource der obersten Ebene wie ein Asset oder ein Asset-Modell ersetzt, ersetzt die neue Definition alle Unterressourcen, wie Eigenschaften, Hierarchien oder zusammengesetzte Modelle.
Wenn Sie beispielsweise ein Asset-Modell während eines Massenimports aktualisieren und die aktualisierte Version eine Eigenschaft definiert, die im Original nicht vorhanden war, wird eine neue Eigenschaft erstellt. Wenn sie eine Eigenschaft definiert, die bereits existiert, wird die vorhandene Eigenschaft aktualisiert. Wenn das aktualisierte Objektmodell eine Eigenschaft auslässt, die im Original vorhanden war, wird die Eigenschaft gelöscht.
-
Kein Löschen von Ressourcen auf oberster Ebene: Bei Massenoperationen wird ein Asset oder Asset-Modell nicht gelöscht. Bei Massenoperationen werden sie nur erstellt oder aktualisiert.