Typ erstellen

In diesem Leitfaden wird beschrieben, wie Sie einen neuen Typ in Manufacturing Data Engine (MDE) erstellen. Sie können einen Typ über die Konfigurations-API oder die MDE-Weboberfläche erstellen.

Hinweise

Mit Typen können Sie unter anderem den Kontextualisierungsbereich für Datensätze dieses Typs definieren, also die Metadaten-Buckets, die zum Kontextualisieren von Datensätzen verwendet werden können oder müssen. Wenn Sie einem Typ einen Metadaten-Bucket zuordnen möchten, müssen Sie den Bucket zuerst erstellen. Weitere Informationen finden Sie unter Metadaten-Bucket erstellen.

Benennung von Typen

Wenn Sie einen Typ erstellen, muss der Name in einer MDE-Bereitstellung eindeutig sein. Typnamen dürfen keine Leerzeichen oder Sonderzeichen wie &, @ oder % enthalten.

Typ erstellen

Wenn Sie einen Typ mit einer Metadaten-Bucket-Zuordnung und typischen Speicherspezifikationen erstellen möchten, können Sie entweder das Terminal oder die Console-Oberfläche verwenden.

REST

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

POST /configuration/v1/types

{
  "archetype": "ARCHETYPE NAME",
  "name": "TYPE_NAME",
  "metadataBuckets": [
    {
      "bucketName": "BUCKET_NAME",
      "version": "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:

ARCHETYPE: Name des Archetyps. Einer der folgenden Werte: DISCRETE_DATA_SERIES, CLUSTERED_DISCRETE_DATA_SERIES, NUMERIC_DATA_SERIES, CLUSTERED_NUMERIC_DATA_SERIES, CONTINUOUS_DATA_SERIES, CLUSTERED_CONTINUOUS_DATA_SERIES.
TYPE_NAME: Name des zu erstellenden Typs.
BUCKET_NAME: Name des Buckets, der mit diesem Typ verknüpft werden soll.
BUCKET_VERSION: Version des Buckets, der diesem Typ zugeordnet werden soll.

Console

Wenn Sie in der Console einen neuen Typ erstellen möchten, öffnen Sie den Tab Typ.
Alle in der MDE-Instanz verfügbaren Typen sind in diesem Abschnitt aufgeführt. In der Liste wird die grundlegende Konfiguration jedes Typs angezeigt, einschließlich:

Name: Eindeutiger Name des Typs. Alle Typen müssen unterschiedliche eindeutige Namen haben.
Speicher: Zeigt die aktuellen Speicherspezifikationen an, die mit dem Typ verknüpft 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 ältere Versionen anzeigen lassen, indem Sie das Kästchen Show Latest (Letzte 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. Sie 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.

Für jeden neuen Typ wird bei der Erstellung eine eigene Infrastruktur bereitgestellt, in der die Tags und Datensätze für alle Datensenken gespeichert werden. Wenn Sie beispielsweise einen neuen Typ erstellen, wird in BigQuery eine neue Tabelle mit dem Namen des Typs erstellt und das Schema, das dem Archetyp entspricht, wird automatisch in die Tabelle eingefügt. Während der Typ bereitgestellt wird, wird er als Non Active angezeigt.

Wenn Sie einen neuen Typ erstellen möchten, klicken Sie auf Neuen Typ hinzufügen. Das folgende Formular wird angezeigt:
Wenn Sie einen neuen Typ definieren möchten, geben Sie seinen Namen und seinen Archetyp an. Nachdem der Typ erstellt wurde, können sein Name und Archetyp nicht mehr geändert werden. Alle Typen müssen unterschiedliche eindeutige Namen haben. Archetypen müssen aus der Liste der verfügbaren Archetypen ausgewählt werden. Sie können keine Archetypen erstellen oder ändern, da sie Teil der Systemkonfiguration sind.
Öffnen Sie den Bereich Datenschema, um bei Bedarf die JSON schema zu definieren, die das Datenfeld des neuen Typs definiert:
Das Datenschema muss ein gültiges JSON Schema sein, da es sonst nicht akzeptiert wird. Dieses Datenschema wird nicht im Rahmen der Erfassungspipelines erzwungen. In zukünftigen MDE-Versionen wird das Datenobjekt in den eingehenden Nachrichten anhand des Datenschemas seines Typs validiert. Das Datenschema bietet einen Überblick über die Struktur des Datenfelds, das in den verschiedenen Datensenken verfügbar ist. Jede Datenschema-Spezifikation muss auch gemäß den Merkmalen des Archetyps definiert werden.
Schließen Sie die Definition des neuen Typs ab, indem Sie die Metadaten-Buckets definieren, die mit dem Typ verknüpft sind. Öffnen Sie dazu den Bereich Metadaten-Buckets:
Klicken Sie auf HINZUFÜGEN, um dem Typ einen Metadaten-Bucket hinzuzufügen.
Wählen Sie aus der Liste der verfügbaren Metadaten-Buckets die Buckets aus, die Sie hinzufügen möchten. Es wird nur die letzte Version dieser Buckets angezeigt. Versionen von Metadaten-Buckets können später aktualisiert werden, indem eine neue Version des Typs erstellt wird. Nachdem die Buckets hinzugefügt wurden, wird im Abschnitt „Metadaten“ ein neues Symbol angezeigt.
Legen Sie die Standardeinstellungen für den Speicher fest, indem Sie den Abschnitt Speichereinstellungen des Formulars öffnen. In diesem Abschnitt befindet sich für jede in dieser MDE-Instanz verfügbare Datensenke eine Ein/Aus-Schaltfläche.
Wählen Sie jede Senke aus, in der die Tags dieses Typs standardmäßig gespeichert werden sollen. Die Speicherspezifikation wird von den Tags übernommen, wenn sie erstellt werden. Die Speicherspezifikation kann jederzeit auf Tag-Ebene geändert werden.
Um die Definition eines neuen Typs abzuschließen, wählen Sie im Bereich Transformieren und verbinden aus, welche Transformationen mit diesem Typ verknüpft sind.
Wählen Sie die Transformationen aus, die dem Typ zugeordnet werden sollen, und definieren Sie die Parameter gemäß Transformation konfigurieren.
Nachdem Sie alle Parameter hinzugefügt haben, speichern Sie den neuen Typ, indem Sie auf ERSTELLEN klicken. Wenn einer der Parameter falsch ist, wird eine Fehlermeldung angezeigt. Wenn der Vorgang erfolgreich ist, wird eine Bestätigungsmeldung angezeigt.