Crea una versión de 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:

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

Las versiones nuevas no pueden:

• Quitar campos del esquema de datos
• Cambiar el tipo de datos de los campos existentes en el esquema de datos
• Marcar un atributo opcional como obligatorio en el esquema de datos
• Quitar referencias de bucket de metadatos

Crea una versión de tipo nueva

Puedes crear una versión de tipo nueva que asocie un bucket de metadatos nuevo 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 a 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á asociada a este tipo.
• NEW_BUCKET_NAME: Es el nombre del bucket nuevo.
• NEW_BUCKET_VERSION: Es la versión del bucket nuevo.

Console

1. Para crear una versión de tipo nueva con la consola, abre la pestaña de la sección Tipos.

   

2. 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:

• Nombre: Es el nombre único del tipo. Todos los tipos deben tener nombres únicos diferentes.
• Almacenamiento: Muestra las especificaciones de almacenamiento actuales asociadas a el tipo.
• Arquetipo: Muestra el nombre del arquetipo que define el tipo. Cada tipo está asociado a un arquetipo único. La asociación de arquetipos no se puede modificar después de crear el tipo.
• Versión: Es el número de versión del tipo. Se puede crear una versión de un tipo. 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, se tarda un tiempo en aprovisionarlos. Mientras se aprovisionan los tipos, su estado activo es false. Cuando están listos, se muestran como true.

1. Para crear una versión de tipo nueva en esta interfaz web, haz clic en el ícono Acciones y, luego, en Crear versión nueva. Aparecerá el siguiente formulario:

   

2. Se abrirá la opción Crear versión de tipo nueva y se mostrará un formulario para modificar la configuración del tipo:

   

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

La especificación de metadatos y el esquema de datos se pueden modificar agregando elementos nuevos. Sin embargo, todas las versiones de tipo nuevas deben ser compatibles con versiones anteriores. No es posible quitar buckets de metadatos para crear una versión nueva del tipo. Para agregar buckets de metadatos nuevos, abre la sección Bucket de metadatos.