Metadaten-Bucket-Version erstellen

In dieser Anleitung wird beschrieben, wie Sie eine neue Metadaten-Bucket-Version für einen vorhandenen Bucket in Manufacturing Data Engine (MDE) erstellen.

Mit Metadaten-Bucket-Versionen können Sie das Bucket-Schema weiterentwickeln. Typen und Parser verweisen immer auf eine bestimmte Bucket-Version. Wenn Sie also eine neue Version erstellen, hat das keine Auswirkungen auf die vorhandenen Pipelines für die Datenverarbeitung. Sie müssen Ihre Typen und Parser aktualisieren oder neue Typen und Parser erstellen, um die neue Bucket-Version zu verwenden. Sie können eine Metadaten-Bucket-Version über die Konfigurations-API oder die MDE-Weboberfläche erstellen.

Hinweis

Für diese Anleitung müssen Sie bereits einen Metadaten-Bucket für die MDE erstellt haben.

Einschränkungen bei der Versionsverwaltung

Beachten Sie beim Erstellen neuer Versionen eines Buckets die folgenden Einschränkungen:

Neue Versionen können Folgendes umfassen:

• Fügen Sie neue optionale Felder hinzu.
• Pflichtfeld als optional markieren

Neue Versionen dürfen nicht:

• Felder entfernen
• Datentyp vorhandener Felder ändern.
• Ein optionales Attribut als erforderlich markieren

Neue Metadaten-Bucket-Version erstellen

Sie können eine Metadaten-Bucket-Version über das Terminal oder die Console erstellen.

REST

Führen Sie die folgende REST API-Anfrage aus:

POST /metadata/v1/buckets/BUCKET_NAME/versions

{
  "schema": "BUCKET_SCHEMA",
  "provider": "local"
}

Ersetzen Sie Folgendes:

• BUCKET_NAME: Name des zu erstellenden Buckets.
• BUCKET_TYPE: Typ des zu erstellenden Buckets. Muss TAG, RECORD oder LOOKUP sein. Die natural_key einer Metadateninstanz in einem TAG-Bucket muss ein Tag-Name sein. Der natural_key einer Metadateninstanz in einem RECORD-Bucket kann ein beliebiger Schlüssel sein. Die natural_key einer Metadateninstanz in einem LOOKUP-Bucket kann ein beliebiger Schlüssel sein. Datensätze können jedoch nicht auf Instanzen in einem Lookup-Bucket verweisen und die Instanzen werden nicht in eine Datensenke geschrieben. Lookup-Buckets dienen nur als Quelle für Referenzdaten, die von einem Parser mit der Whistle-Funktion lookupByKey abgerufen und zum Anreichern von Datensätzen verwendet werden können.
• BUCKET_SCHEMA: JSON-Schema des Buckets. Das Schema schränkt die Instanzen ein, die im Bucket erstellt werden können.
• INSTANCE_OVERWRITE_MODE: entweder TRUE oder FALSE. Gibt an, ob neue Instanzen durch Zusammenführen der bereitgestellten Instanz mit der neuesten Instanz für einen bestimmten natürlichen Schlüssel erstellt werden oder ob neue Instanzen wie angegeben erstellt werden.

Console

1. Wenn Sie eine neue Version des Metadaten-Buckets erstellen möchten, klicken Sie im Bereich METADATA der Weboberfläche Cloud Management MC auf Neue Version erstellen:

   

2. Ein Konfigurationsbereich wird mit einem Formular zum Aktualisieren der Parameter der neuen Metadaten-Bucket-Version angezeigt:

   

   Für neue Versionen sind nur abwärtskompatible Änderungen zulässig. Bei neuen, funktionsgefährdenden und anderen Änderungen muss ein neuer Bucket erstellt werden. Im Bereich können Sie Folgendes aktualisieren:

   • Modus für Instanzaktualisierung: Ändern Sie das Verhalten beim Erfassen von Instanzen für den Bucket.
   • Metadatenschema: Fügen Sie dem vorhandenen Schema des Buckets neue Attribute hinzu.

3. Klicken Sie nach der Implementierung der Änderungen auf ERSTELLEN, um die neue Version des Metadaten-Buckets zu speichern.

4. Wenn die Änderung nicht erfolgreich ist, wird eine Fehlermeldung angezeigt. Bei Erfolg wird eine Erfolgsmeldung angezeigt. Die neue Versionsnummer ist fortlaufend und wird dem Bucket automatisch zugewiesen.