Crea una versione del bucket di metadati

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

Le versioni del bucket di metadati consentono di evolvere lo schema del bucket. I tipi e i parser fanno sempre riferimento a una versione specifica del bucket, quindi quando crei una nuova versione, non influisce sulle pipeline di elaborazione dei dati esistenti. Per utilizzare la nuova versione del bucket, devi eseguire l'upgrade dei tipi e dei parser o crearne di nuovi. Puoi creare una versione del bucket dei metadati utilizzando l'API di configurazione o l'interfaccia web MDE.

Prima di iniziare

Questa guida richiede che tu abbia già creato un bucket di metadati per MDE.

Limitazioni del controllo delle versioni

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

Le nuove versioni potrebbero:

• Aggiungi nuovi campi facoltativi.
• Contrassegnare un campo obbligatorio come facoltativo.

Le nuove versioni non possono:

• Rimuovi i campi.
• Modifica il tipo di dati dei campi esistenti.
• Contrassegna un attributo facoltativo come obbligatorio.

Crea una nuova versione del bucket dei metadati

Puoi creare una versione del bucket dei metadati utilizzando il terminale o la console.

REST

Esegui la seguente richiesta API REST:

POST /metadata/v1/buckets/BUCKET_NAME/versions

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

Sostituisci quanto segue:

• BUCKET_NAME: il nome del bucket da creare.
• BUCKET_TYPE: il tipo di bucket da creare. Deve essere uno dei seguenti valori: TAG, RECORD o LOOKUP. Il natural_key di un'istanza di metadati in un bucket TAG deve essere un nome tag. natural_key di un'istanza di metadati in un bucket RECORD può essere qualsiasi chiave. La natural_key di un'istanza di metadati in un bucket LOOKUP può essere qualsiasi chiave, ma i record non possono fare riferimento a istanze in un bucket di ricerca e le istanze non vengono scritte in alcun sink di dati. I bucket di ricerca fungono solo da origine di dati di riferimento che possono essere recuperati da un parser utilizzando la funzione Whistle lookupByKey e utilizzati per arricchire i record.
• BUCKET_SCHEMA: schema JSON del bucket. Lo schema vincola le istanze che possono essere create nel bucket.
• INSTANCE_OVERWRITE_MODE: TRUE o FALSE. Determina se le nuove istanze vengono create unendo l'istanza fornita con l'ultima istanza per una determinata chiave naturale o se vengono create come fornite.

Console

1. Per creare una nuova versione del bucket di metadati, fai clic su Crea nuova versione nella sezione METADATI dell'interfaccia web Cloud Management MC:

   

2. Viene visualizzato un pannello di configurazione con un modulo per aggiornare i parametri della nuova versione del bucket dei metadati:

   

   Per le nuove versioni sono consentite solo modifiche compatibili con le versioni precedenti. Le novità, le interruzioni e le modifiche richiedono la creazione di un nuovo bucket. Nel riquadro puoi aggiornare quanto segue:

   • Modalità di aggiornamento dell'istanza: modifica il comportamento di importazione dell'istanza del bucket.
   • Schema dei metadati: aggiungi nuovi attributi allo schema esistente del bucket.

3. Dopo aver implementato le modifiche, fai clic su CREA per salvare la nuova versione del bucket dei metadati.

4. Se la modifica non va a buon fine, viene visualizzato un messaggio di errore. Se la modifica va a buon fine, viene visualizzato un messaggio di operazione riuscita. Il nuovo numero di versione è sequenziale e viene assegnato automaticamente al bucket.