Crea una versión del bucket de metadatos

En esta guía, se describe cómo crear una nueva versión del bucket de metadatos para un bucket existente en Manufacturing Data Engine (MDE).

Las versiones del bucket de metadatos te permiten desarrollar el esquema del bucket. Los tipos y los analizadores siempre hacen referencia a una versión específica del bucket, por lo que, cuando creas una versión nueva, no se ven afectadas las canalizaciones de procesamiento de datos existentes. Debes actualizar tus tipos y analizadores, o bien crear tipos y analizadores nuevos para usar la nueva versión del bucket. Puedes crear una versión del bucket de metadatos con la API de configuración o la interfaz web de MDE.

Antes de comenzar

En esta guía, se supone que ya creaste un bucket de metadatos para el MDE.

Restricciones de versiones

Cuando crees versiones nuevas de un bucket, ten en cuenta las siguientes limitaciones:

Las versiones nuevas pueden hacer lo siguiente:

• Se agregaron campos opcionales nuevos.
• Marcar un campo obligatorio como opcional

Las versiones nuevas no pueden hacer lo siguiente:

• Quita campos.
• Cambiar el tipo de datos de los campos existentes
• Marcar un atributo opcional como obligatorio

Crea una versión nueva del bucket de metadatos

Puedes crear una versión del bucket de metadatos con la terminal o la consola.

REST

Ejecuta la siguiente solicitud a la API de REST:

POST /metadata/v1/buckets/BUCKET_NAME/versions

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

Reemplaza lo siguiente:

• BUCKET_NAME: Nombre del bucket que se creará.
• BUCKET_TYPE: Es el tipo de bucket que se creará. Debe ser TAG, RECORD o LOOKUP. El natural_key de una instancia de metadatos en un bucket TAG debe ser un nombre de etiqueta. El natural_key de una instancia de metadatos en un bucket de RECORD puede ser cualquier clave. El natural_key de una instancia de metadatos en un bucket de LOOKUP puede ser cualquier clave, pero los registros no pueden hacer referencia a instancias en un bucket de búsqueda, y las instancias no se escriben en ningún receptor de datos. Los buckets de búsqueda solo sirven como fuente de datos de referencia que un analizador puede recuperar con la función lookupByKey de Whistle y que se puede usar para enriquecer registros.
• BUCKET_SCHEMA: Es el esquema JSON del bucket. El esquema restringe las instancias que se pueden crear en el bucket.
• INSTANCE_OVERWRITE_MODE por TRUE o FALSE. Determina si se crean instancias nuevas combinando la instancia proporcionada con la instancia más reciente para una clave natural determinada o si se crean instancias nuevas según lo proporcionado.

Console

1. Para crear una nueva versión del bucket de metadatos, haz clic en Crear versión nueva en la sección METADATOS de la interfaz web de Cloud Management MC:

   

2. Se muestra un panel de configuración con un formulario para actualizar los parámetros de la nueva versión del bucket de metadatos:

   

   Solo se permiten cambios retrocompatibles para las versiones nuevas. Los cambios nuevos, los cambios que generan interrupciones y los cambios requieren la creación de un bucket nuevo. En el panel, puedes actualizar lo siguiente:

   • Modo de actualización de la instancia: Cambia el comportamiento de la transferencia de la instancia del bucket.
   • Esquema de metadatos: Agrega atributos nuevos al esquema existente del bucket.

3. Después de implementar los cambios, haz clic en CREAR para guardar la nueva versión del bucket de metadatos.

4. Si el cambio no se realiza correctamente, se mostrará un mensaje de error. Si el cambio se realiza correctamente, se muestra un mensaje de éxito. El nuevo número de versión es secuencial y se asigna automáticamente al bucket.