Massenoperationen mit Assets und Modellen

Wenn Sie mit einer großen Anzahl von Anlagen oder Anlagenmodellen arbeiten möchten, verwenden Sie Massenoperationen, um Ressourcen massenweise zu importieren und an einen anderen Ort 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 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 S3-Bucket, in dem Sie Ihre AWS IoT SiteWise Inhalte platzieren können.

Themen

• Wichtige Konzepte und Terminologie
• Unterstützte Funktionen
• Voraussetzungen für Massenoperationen
• Einen Massenimportauftrag ausführen
• Einen Massenexportauftrag ausführen
• Verfolgung des Auftragsfortschritts und Fehlerbehandlung
• Beispiele für den Import von Metadaten
• Beispiele für den Export von Metadaten
• AWS IoT SiteWise Auftragsschema für die Übertragung von Metadaten

Wichtige Konzepte und Terminologie

AWS IoT SiteWise Die 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.