Créer une version de bucket de métadonnées

Ce guide explique comment créer une version de bucket de métadonnées pour un bucket existant dans Manufacturing Data Engine (MDE).

Les versions de bucket de métadonnées vous permettent de faire évoluer le schéma de bucket. Les types et les analyseurs font toujours référence à une version de bucket spécifique. Par conséquent, lorsque vous créez une version, cela n'affecte pas les pipelines de traitement de données existants. Vous devez mettre à niveau vos types et analyseurs ou en créer de nouveaux pour utiliser la nouvelle version de bucket. Vous pouvez créer une version de bucket de métadonnées à l'aide de l'API de configuration ou de l'interface Web MDE.

Avant de commencer

Ce guide suppose que vous avez déjà créé un bucket de métadonnées pour MDE.

Restrictions relatives au contrôle des versions

Lorsque vous créez des versions d'un bucket, tenez compte des limites suivantes :

Les nouvelles versions peuvent :

• ajouter de nouveaux champs facultatifs ;
• marquer un champ obligatoire comme facultatif.

Les nouvelles versions ne peuvent pas :

• supprimer des champs ;
• modifier le type de données des champs existants ;
• marquer un attribut facultatif comme obligatoire.

Créer une version de bucket de métadonnées

Vous pouvez créer une version de bucket de métadonnées à l'aide du terminal ou de la console.

REST

Exécutez la requête d'API REST suivante :

POST /metadata/v1/buckets/BUCKET_NAME/versions

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

Remplacez les éléments suivants :

• BUCKET_NAME : nom du bucket à créer.
• BUCKET_TYPE : type de bucket à créer. Doit être l'un des éléments suivants : TAG, RECORD ou LOOKUP. La natural_key d'une instance de métadonnées dans un bucket TAG doit être un nom de tag. La natural_key d'une instance de métadonnées dans un bucket RECORD peut être n'importe quelle clé. La natural_key d'une instance de métadonnées dans un bucket LOOKUP peut être n'importe quelle clé, mais les enregistrements ne peuvent pas faire référence à des instances dans un bucket de recherche, et les instances ne sont écrites dans aucun récepteur de données. Les buckets de recherche ne servent que de source de données de référence qui peuvent être récupérées par un analyseur à l'aide de la fonction Whistle lookupByKey et utilisées pour enrichir les enregistrements.
• BUCKET_SCHEMA : schéma JSON du bucket. Le schéma contraint les instances qui peuvent être créées dans le bucket.
• INSTANCE_OVERWRITE_MODE : TRUE ou FALSE. Détermine si les nouvelles instances sont créées en fusionnant l'instance fournie avec la dernière instance pour une clé naturelle donnée ou si les nouvelles instances sont créées telles qu'elles sont fournies.

Console

1. Pour créer une version de bucket de métadonnées , cliquez sur Create New Version (Créer une version) dans la section METADATA (MÉTADONNÉES) de l'interface Web Cloud Management MC :

   

2. Un panneau de configuration s'affiche avec un formulaire permettant de mettre à jour les paramètres de la nouvelle version de bucket de métadonnées:

   

   Seules les modifications rétrocompatibles sont autorisées pour les nouvelles versions. Les nouvelles modifications et les modifications destructives nécessitent la création d'un bucket. Dans le panneau, vous pouvez modifier les éléments suivants :

   • Instance update mode (Mode de mise à jour de l'instance) : modifiez le comportement d'ingestion des instances de le bucket.
   • Schéma de métadonnées : ajoutez de nouveaux attributs au schéma existant du bucket.

3. Une fois les modifications implémentées, cliquez sur CREATE (CRÉER) pour enregistrer la nouvelle version du bucket de métadonnées.

4. Un message d'erreur s'affiche si la modification échoue. Un message de réussite s'affiche si la modification réussit. Le nouveau numéro de version est séquentiel et est automatiquement attribué au bucket.