Typversion erstellen

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

Hinweise

Bevor Sie eine neue Typversion für einen vorhandenen Typ erstellen, sollten Sie sich über das Erstellen von Typen informieren.

Einschränkungen bei der Versionsverwaltung

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

Neue Versionen können Folgendes umfassen:

Fügen Sie dem Datenschema neue optionale Felder hinzu.
Pflichtfeld im Datenschema als optional markieren
Fügen Sie neue Metadaten-Bucket-Referenzen hinzu.

Neue Versionen dürfen nicht:

Felder aus dem Datenschema entfernen
Datentyp vorhandener Felder im Datenschema ändern.
Markieren Sie ein optionales Attribut als erforderlich im Datenschema.
Entfernen Sie Metadaten-Bucket-Verweise.

Neue Typversion erstellen

Sie können eine neue Typversion erstellen, die einen neuen Metadaten-Bucket mit einem vorhandenen Typ verknüpft, der bereits eine vorhandene Metadaten-Bucket-Verknüpfung hat, und typische Speicherspezifikationen über die API oder die Console anwendet.

REST

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

POST /configuration/v1/types/TYPE_NAME/versions

{
  "metadataBuckets": [
    {
      "bucketName": "EXISTING_BUCKET_NAME",
      "version": "EXISTING_BUCKET_VERSION"
    },
    {
      "bucketName": "NEW_BUCKET_NAME",
      "version": "NEW_BUCKET_VERSION"
    }
  ],
  "storageSpecs": [
    {
      "sink": "BIG_QUERY",
      "disabled": "false",
      "materializeCloudMetadata": "true"
    },
    {
      "sink": "BIG_TABLE",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "GCS",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_PROTO",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_JSON",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    }
  ]
}

Ersetzen Sie Folgendes:

TYPE_NAME: Name des Typs, für den eine neue Version erstellt wird.
EXISTING_BUCKET_NAME: Name des vorhandenen Buckets, der bereits mit diesem Typ verknüpft ist.
EXISTING_BUCKET_VERSION: Version des vorhandenen Bucket, die bereits diesem Typ zugeordnet ist.
NEW_BUCKET_NAME: Name des neuen Buckets.
NEW_BUCKET_VERSION: Die Version des neuen Buckets.

Console

Wenn Sie über die Console eine neue Type Version erstellen möchten, öffnen Sie den Tab Types.
In diesem Abschnitt sind alle in der MDE-Instanz verfügbaren Typen aufgeführt. Die Liste enthält die grundlegende Konfiguration jedes Typs, einschließlich:

Name: Eindeutiger Name des Typs. Alle Typen müssen unterschiedliche eindeutige Namen haben.
Speicher: Zeigt die aktuellen Speicherspezifikationen an, die dem Typ zugeordnet sind.
Archetype (Archetyp): Hier wird der Name des Archetyps angezeigt, der den Typ definiert. Jeder Typ ist einem eindeutigen Archetyp zugeordnet. Die Zuordnung des Archetyps kann nach dem Erstellen des Typs nicht mehr geändert werden.
Version: Versionsnummer des Typs. Ein Typ kann versioniert werden. In der Standardansicht dieser Liste wird nur die neueste für den Typ verfügbare Version angezeigt. Sie können frühere Versionen anzeigen lassen, indem Sie das Kästchen Show Latest (Neueste anzeigen) deaktivieren.
Metadaten: Rendert für jeden Metadaten-Bucket, der dem Typ zugeordnet ist, ein farbcodiertes Symbol. Tag-Metadaten-Buckets werden durch ein bestimmtes Symbol im Badge von Datensatz-Metadaten-Buckets unterschieden.
- Transformationen: Hier wird für jeden Transformationstyp, der mit dem Typ verknüpft ist, ein Symbol angezeigt.
Aktiviert: Zeigt den Wert true an, wenn der Typ aktiviert ist, und den Wert false, wenn er nicht aktiviert ist. Nutzer können Typen jederzeit aktivieren oder deaktivieren.
Aktiv: Die Bereitstellung von Typen kann einige Zeit in Anspruch nehmen. Während Typen bereitgestellt werden, ist ihr aktiver Status false. Wenn sie bereit sind, werden sie als true angezeigt.

Wenn Sie in dieser Weboberfläche eine neue Type Version erstellen möchten, klicken Sie auf das Symbol Actions (Aktionen) und dann auf Create New Version (Neue Version erstellen). Das folgende Formular wird angezeigt:
Das Fenster Neue Typversion erstellen wird geöffnet und enthält ein Formular zum Ändern der Einstellungen des ausgewählten Typs:

Im oberen Bereich des Formulars werden der Name und der Archetyp des Typs angezeigt. Diese Attribute können nicht geändert werden. Nur wenn Sie die Metadatenspezifikation ändern oder das Datenschema anpassen, wird eine neue Typversion ausgelöst. Wenn Sie die restlichen Typparameter ändern, wird der Typ aktualisiert, aber es ist keine neue Version erforderlich.

Sowohl die Metadatenspezifikation als auch das Datenschema können durch Hinzufügen neuer Elemente geändert werden. Alle neuen Typversionen müssen jedoch abwärtskompatibel sein. Es ist nicht möglich, Metadaten-Buckets zu entfernen, um eine neue Version des Typs zu erstellen. Sie können neue Metadaten-Buckets hinzufügen, indem Sie den Abschnitt Metadaten-Bucket öffnen.