Crea una versión del tipo

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

Antes de comenzar

Antes de comenzar a crear una versión de tipo nueva para un tipo existente, debes leer sobre cómo crear un tipo.

Restricciones de versiones

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

Las versiones nuevas pueden hacer lo siguiente:

Agrega campos opcionales nuevos al esquema de datos.
Marcar un campo obligatorio como opcional en el esquema de datos
Agrega nuevas referencias de bucket de metadatos.

Las versiones nuevas no pueden hacer lo siguiente:

Quita campos del esquema de datos.
Cambia el tipo de datos de los campos existentes en el esquema de datos.
Marcar un atributo opcional como obligatorio en el esquema de datos
Quita las referencias de bucket de metadatos.

Crea una versión de tipo nueva

Puedes crear una nueva versión de tipo que asocie un nuevo bucket de metadatos a un tipo existente que ya tenga una asociación de bucket de metadatos existente y aplique especificaciones de almacenamiento típicas con la API o la consola.

REST

Ejecuta la siguiente solicitud de la API de REST:

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

Reemplaza lo siguiente:

TYPE_NAME: Es el nombre del tipo para el que se crea una versión nueva.
EXISTING_BUCKET_NAME: Es el nombre del bucket existente que ya está asociado a este tipo.
EXISTING_BUCKET_VERSION: Es la versión del bucket existente que ya está asociado a este tipo.
NEW_BUCKET_NAME: Nombre del bucket nuevo.
NEW_BUCKET_VERSION: Es la versión del bucket nuevo.

Console

Para crear una nueva versión de tipo con la consola, abre la pestaña de la sección Tipos.
En esta sección, se enumeran todos los tipos disponibles en la instancia de MDE. La lista expone la configuración básica de cada tipo, incluidos los siguientes elementos:

Nombre: Nombre único del tipo. Todos los tipos deben tener nombres únicos diferentes.
Almacenamiento: Muestra las especificaciones de almacenamiento actuales asociadas al tipo.
Arquetipo: Muestra el nombre del arquetipo que define el tipo. Cada tipo se asocia a un arquetipo único. La asociación de arquetipo no se puede modificar después de crear el tipo.
Versión: Es el número de versión del tipo. Un tipo puede tener versiones. La vista predeterminada de esta lista solo muestra la versión más reciente disponible para el tipo. Para mostrar versiones anteriores, desmarca la casilla de verificación Mostrar la más reciente.
Metadatos: Renderiza una insignia codificada por colores para cada bucket de metadatos asociado al tipo. Los buckets de metadatos de etiquetas se diferencian de los buckets de metadatos de registros con un ícono específico dentro de la insignia.
- Transformaciones: Muestra una insignia para cada tipo de transformación asociado al tipo.
Habilitado: Muestra un valor true si el tipo está habilitado y un valor false si no lo está. Los usuarios pueden habilitar o inhabilitar tipos en cualquier momento.
Activo: Cuando se crean tipos, tardan un tiempo en aprovisionarse. Mientras se aprovisionan los tipos, su estado activo es false. Cuando estén listos, se mostrarán como true.

Para crear una nueva versión de tipo en esta interfaz web, haz clic en el ícono de Acciones y, luego, en Crear versión nueva. Aparecerá el siguiente formulario:
Se abrirá la ventana Create New Type Version, en la que se mostrará un formulario para modificar la configuración del tipo seleccionado:

En la sección superior del formulario, se muestran el nombre y el arquetipo del tipo. Estos atributos no se pueden modificar. Solo se activará una nueva versión del tipo si se cambia la especificación de metadatos o se modifica el esquema de datos. Si modificas el resto de los parámetros de tipo, se actualizará el tipo, pero no se requerirá una versión nueva.

Tanto la especificación de metadatos como el esquema de datos se pueden modificar agregando elementos nuevos. Sin embargo, todas las versiones de tipos nuevos deben ser compatibles con versiones anteriores. No es posible quitar buckets de metadatos para crear una versión nueva del tipo. Puedes agregar nuevos buckets de metadatos si abres la sección Bucket de metadatos.