Crea una versione del tipo

Questa guida descrive come creare una nuova versione di tipo per un tipo esistente in Manufacturing Data Engine (MDE).

Prima di iniziare

Prima di iniziare a creare una nuova versione di un tipo esistente, devi leggere informazioni su come creare un tipo.

Limitazioni del controllo delle versioni

Quando crei nuove versioni di un tipo, tieni presente le seguenti limitazioni:

Le nuove versioni potrebbero:

• Aggiungi nuovi campi facoltativi allo schema dei dati.
• Contrassegnare un campo obbligatorio come facoltativo nello schema dei dati.
• Aggiungi nuovi riferimenti ai bucket di metadati.

Le nuove versioni non possono:

• Rimuovi i campi dallo schema dei dati.
• Modifica il tipo di dati dei campi esistenti nello schema dei dati.
• Contrassegna un attributo facoltativo come obbligatorio nello schema dei dati.
• Rimuovi i riferimenti al bucket dei metadati.

Crea una nuova versione del tipo

Puoi creare una nuova versione del tipo che associa un nuovo bucket di metadati a un tipo esistente che ha già un'associazione di bucket di metadati esistente e applica le specifiche di archiviazione tipiche utilizzando l'API o la console.

REST

Esegui la seguente richiesta API REST:

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"
    }
  ]
}

Sostituisci quanto segue:

• TYPE_NAME: Nome del tipo per cui viene creata una nuova versione.
• EXISTING_BUCKET_NAME: Nome del bucket esistente già associato a questo tipo.
• EXISTING_BUCKET_VERSION: versione del bucket esistente già associata a questo tipo.
• NEW_BUCKET_NAME: il nome del nuovo bucket.
• NEW_BUCKET_VERSION: La versione del nuovo bucket.

Console

1. Per creare una nuova versione del tipo utilizzando la console, apri la scheda della sezione Tipi.

   

2. In questa sezione sono elencati tutti i tipi disponibili nell'istanza MDE. L'elenco mostra la configurazione di base di ogni tipo, tra cui:

• Nome: nome univoco del tipo. Tutti i tipi devono avere nomi univoci diversi.
• Spazio di archiviazione: mostra le specifiche di archiviazione correnti associate al tipo.
• Archetipo: mostra il nome dell'archetipo che definisce il tipo. Ogni tipo è associato a un archetipo unico. L'associazione dell'archetipo non può essere modificata dopo la creazione del tipo.
• Versione: il numero di versione del tipo. Un tipo può essere controllato a livello di versione. La visualizzazione predefinita di questo elenco mostra solo l'ultima versione disponibile per il tipo. È possibile visualizzare le versioni precedenti deselezionando la casella di controllo Mostra più recente.
• Metadati: visualizza un badge codificato per colore per ogni bucket di metadati associato al tipo. I bucket dei metadati dei tag si distinguono dai bucket dei metadati dei record per un'icona specifica all'interno del badge.
  • Trasformazioni: mostra un badge per ogni tipo di trasformazione associato al tipo.
• Attivato: mostra un valore true se il tipo è attivato e un valore false se non lo è. Gli utenti possono attivare o disattivare i tipi in qualsiasi momento.
• Attivo: quando vengono creati, i tipi richiedono un determinato periodo di tempo per il provisioning. Durante il provisioning dei tipi, il loro stato attivo è false. Quando sono pronte, vengono visualizzate come true.

1. Per creare una nuova versione del tipo in questa interfaccia web, fai clic sull'icona Azioni e poi su Crea nuova versione. Verrà visualizzato il seguente modulo:

   

2. Si apre la finestra Crea nuova versione del tipo che mostra un modulo per modificare le impostazioni del tipo selezionato:

   

La sezione superiore del modulo mostra il nome e l'archetipo del tipo. Questi attributi non possono essere modificati. Solo la modifica della specifica dei metadati o dello schema dei dati attiverà una nuova versione del tipo. La modifica degli altri parametri del tipo aggiornerà il tipo, ma non richiederà una nuova versione.

Sia la specifica dei metadati che lo schema dei dati possono essere modificati aggiungendo nuovi elementi. Tuttavia, tutte le nuove versioni del tipo devono essere compatibili con le versioni precedenti. Non è possibile rimuovere i bucket di metadati per creare una nuova versione del tipo. È possibile aggiungere nuovi bucket di metadati aprendo la sezione Bucket di metadati.