Créer une version de type

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

Avant de commencer

Avant de créer une version de type pour un type existant, vous devez lire comment créer un type.

Restrictions concernant la gestion des versions

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

Les nouvelles versions peuvent :

• ajouter des champs facultatifs au schéma de données ;
• marquer un champ obligatoire comme facultatif dans le schéma de données ;
• ajouter des références de bucket de métadonnées.

Les nouvelles versions ne peuvent pas :

• supprimer des champs du schéma de données ;
• modifier le type de données des champs existants dans le schéma de données ;
• marquer un attribut facultatif comme obligatoire dans le schéma de données ;
• supprimer des références de bucket de métadonnées.

Créer une version de type

Vous pouvez créer une version de type qui associe un nouveau bucket de métadonnées à un type existant qui possède déjà une association de bucket de métadonnées et qui applique des spécifications de stockage typiques à l'aide de l'API ou de la console.

REST

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

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

Remplacez les éléments suivants :

• TYPE_NAME : nom du type pour lequel une version est créée.
• EXISTING_BUCKET_NAME: nom du bucket existant déjà associé à ce type.
• EXISTING_BUCKET_VERSION: version du bucket existant déjà associé à ce type.
• NEW_BUCKET_NAME : nom du nouveau bucket.
• NEW_BUCKET_VERSION : version du nouveau bucket.

Console

1. Pour créer une version de type à l'aide de la console, ouvrez l'onglet de section Types.

   

2. Tous les types disponibles dans l'instance MDE sont listés dans cette section. La liste présente la configuration de base de chaque type, y compris :

• Nom : nom unique du type. Tous les types doivent avoir des noms uniques différents.
• Stockage : affiche les spécifications de stockage actuelles associées à le type.
• Archétype : affiche le nom de l'archétype qui définit le type. Chaque type est associé à un archétype unique. L'association d'archétype ne peut pas être modifiée une fois le type créé.
• Version : numéro de version du type. Un type peut être versionné. La vue par défaut de cette liste n'affiche que la dernière version disponible pour le type. Vous pouvez afficher les versions antérieures en décochant la case Afficher la dernière version.
• Métadonnées : affiche un badge codé par couleur pour chaque bucket de métadonnées associé au type. Les buckets de métadonnées de tag sont différenciés des buckets de métadonnées d'enregistrement à l'aide d'une icône spécifique dans le badge.
  • Transformations : affiche un badge pour chaque type de transformation associé au type.
• Activé : affiche la valeur true si le type est activé et la valeur false s'il ne l'est pas. Les utilisateurs peuvent activer ou désactiver des types à tout moment.
• Actif : la création des types prend un certain temps. Pendant la création des types, leur état actif est false. Lorsqu'ils sont prêts, ils s'affichent comme true.

1. Pour créer une version de type dans cette interface Web, cliquez sur l'icône Actions , puis sur Créer une version. Le formulaire suivant s'affiche :

   

2. La fenêtre Créer une version de type s'ouvre et affiche un formulaire permettant de modifier les paramètres du type sélectionné :

   

La partie supérieure du formulaire affiche le nom et l'archétype du type. Ces attributs ne peuvent pas être modifiés. Seule la modification de la spécification des métadonnées ou du schéma de données déclenche une nouvelle version de type. La modification du reste des paramètres de type met à jour le type, mais ne nécessite pas de nouvelle version.

La spécification des métadonnées et le schéma de données peuvent être modifiés en ajoutant de nouveaux éléments. Toutefois, toutes les nouvelles versions de type doivent être rétrocompatibles. Il n'est pas possible de supprimer des buckets de métadonnées pour créer une version du type. Vous pouvez ajouter des buckets de métadonnées en ouvrant la section Bucket de métadonnées.