Massenoperationen mit Anlagen und Modellen - AWS IoT SiteWise
Wichtige Konzepte und TerminologieUnterstützte Funktionen

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 Anlagen und Modellen

Wenn Sie mit einer großen Anzahl von Objekten oder Anlagenmodellen arbeiten möchten, verwenden Sie Massenoperationen, um Ressourcen massenweise zu importieren und an einen anderen Speicherort zu exportieren. Sie können beispielsweise eine Datendatei erstellen, die Assets oder Asset-Modelle in einem Amazon S3 S3-Bucket definiert, und diese mithilfe des Massenimports erstellen oder aktualisieren AWS IoT SiteWise. Wenn Sie über eine große Anzahl von Assets oder Asset-Modellen verfügen AWS IoT SiteWise, können Sie diese alternativ nach Amazon S3 exportieren.

Anmerkung

Sie führen Massenoperationen in AWS IoT SiteWise durch, indem Sie Operationen in der aufrufen AWS IoT TwinMaker API. Sie können dies tun, ohne einen AWS IoT TwinMaker Arbeitsbereich einzurichten AWS IoT TwinMaker oder zu erstellen. Sie benötigen lediglich einen Amazon S3 S3-Bucket, in dem Sie Ihre AWS IoT SiteWise Inhalte platzieren können.

Themen

Wichtige Konzepte und Terminologie

AWS IoT SiteWise Funktionen für Massenimport und -export basieren auf den folgenden Konzepten und Begriffen:

  • Import: Die Aktion, bei der Assets oder Asset-Modelle aus einer Datei in einem Amazon S3 S3-Bucket in verschoben AWS IoT SiteWise werden.

  • Export: Die Aktion, bei der Assets oder Asset-Modelle aus AWS IoT SiteWise einem Amazon S3 S3-Bucket verschoben werden.

  • Quelle: Der Startort, von dem Sie Inhalte verschieben möchten.

    Ein Amazon S3 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 S3-Bucket ist beispielsweise ein Exportziel und AWS IoT SiteWise ein Importziel.

  • AWS IoT SiteWise Schema: Dieses Schema wird verwendet, um Metadaten von zu importieren und zu exportieren AWS IoT SiteWise.

  • Ressource der obersten Ebene: Eine AWS IoT SiteWise Ressource, die Sie individuell erstellen oder aktualisieren können, z. B. ein Asset oder ein Asset-Modell.

  • Unterressource: 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 Asset-Modellen.

  • metadataTransferJob: Das Objekt, das beim Ausführen erstellt wurdeCreateMetadataTransferJob.

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:

  • Erstellung von Ressourcen auf oberster Ebene: Wenn Sie ein Asset oder ein Asset-Modell importieren, das keine ID definiert oder dessen ID nicht mit der einer vorhandenen ID übereinstimmt, wird es als neue Ressource erstellt.

  • Ersetzung von Ressourcen auf oberster Ebene: Wenn Sie ein Asset oder ein Asset-Modell importieren, dessen ID mit einer bereits vorhandenen übereinstimmt, ersetzt es die vorhandene Ressource.

  • Erstellen, Ersetzen oder Löschen von Unterressourcen: Wenn Ihr Import eine Ressource der obersten Ebene ersetzt, z. B. eine Anlage oder ein Anlagenmodell, 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 vorhanden ist, 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 Massenvorgängen wird kein Asset oder Asset-Modell gelöscht. Bei Massenvorgängen werden sie nur erstellt oder aktualisiert.