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 le versionnage

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

Les nouvelles versions peuvent :

• Ajoutez de nouveaux champs facultatifs au schéma de données.
• Marquez un champ obligatoire comme facultatif dans le schéma de données.
• Ajoutez de nouvelles références de bucket de métadonnées.

Les nouvelles versions ne doivent pas :

• Supprimez des champs du schéma de données.
• Modifiez le type de données des champs existants dans le schéma de données.
• Marquez un attribut facultatif comme obligatoire dans le schéma de données.
• Supprimez les références au 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 a déjà une association de bucket de métadonnées existante et 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 nouvelle 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 la 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 au type.
• Archétype : affiche le nom de l'archétype définissant le type. Chaque type est associé à un archétype unique. L'association d'archétypes ne peut pas être modifiée une fois le type créé.
• Version : numéro de version du type. Un type peut être versionné. Par défaut, la vue 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 avec un code couleur pour chaque bucket de métadonnées associé au type. Les buckets de métadonnées de tags se distinguent des buckets de métadonnées d'enregistrements par une icône spécifique à l'intérieur du badge.
  • Transformations : affiche un badge pour chaque type de transformation associé au type.
• Activé : affiche une valeur true si le type est activé et une 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 le provisionnement des types, leur état actif est false. Lorsqu'ils sont prêts, ils s'affichent sous la forme 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. Le formulaire Créer une version du type s'ouvre. Il vous permet de modifier les paramètres du type sélectionné :

   

La partie supérieure du formulaire affiche le nom et l'archétype du type. Vous ne pouvez pas modifier ces attributs. Seule la modification de la spécification des métadonnées ou du schéma de données déclenchera une nouvelle version du type. La modification des autres paramètres de type mettra à jour le type, mais ne nécessitera pas de nouvelle version.

Vous pouvez modifier la spécification des métadonnées et le schéma de données 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 nouvelle version du type. Vous pouvez ajouter des buckets de métadonnées en ouvrant la section Bucket de métadonnées.