Compartir a través de


Registros de errores

Intelligent Recommendations crea un registro de errores para cada objeto de datos que el servicio procesa en su Azure Data Lake Storage. El registro de errores se vuelve a escribir en la cuenta de Data Lake Storage. Si tiene problemas con la configuración de datos, utilice este artículo para comprender los errores notificados en el registro y saber cómo corregirlos.

En este artículo se indican los tipos de errores en el registro que se encuentra en el servicio de Intelligent Recommendations, qué significan y consejos sobre cómo resolverlos.

Cuando se corrigen los errores, Intelligent Recommendations recoge los nuevos datos automáticamente y procesa los cambios durante el siguiente ciclo de modelado periódico. Para obtener más información sobre este proceso, vaya a Desencadenar manualmente el modelado.

Tipos de errores

Utilice la siguiente tabla para comprender los diferentes tipos de errores que puede generar Intelligent Recommendations.

Algunos tipos de errores hacen que una fila se elimine del procesamiento, mientras que otros tipos de errores pueden ser fatales y hacer que la canalización en marcha detenga el procesamiento por completo.

En el caso de errores que hacen que la fila se quite del procesamiento, si está muy extendido en los datos de entrada, puede dar lugar a una calidad deficiente del producto o incluso a resultados vacíos.

Tipo de error Descripción Resolución sugerida
AttributeValueNotAllowed Un atributo está usando un valor reservado o inadecuado. El valor "0" está reservado en el sistema. Si es posible, cambie el valor para este atributo. Para obtener más información, vaya a Entidades de datos de catálogo.
DataTypeMismatch El formato de un tipo de datos especificado es incorrecto. Compruebe minuciosamente su formato y asegúrese de que no haya caracteres o espacios incorrectos en el model.json o el contrato de datos. Para obtener más información sobre el formato, consulte nuestras Instrucciones de formato del contrato de datos.
EmptyMandatoryAttribute Uno de los atributos obligatorios de una fila está vacío. Complete los datos que faltan.
InvalidGuidIdFormat Si el sistema está configurado para trabajar con tipos GUID ItemID, todos los id. deben ser GUID. Haga que el tipo de ItemID sea uniforme en todas las filas.
InvalidIdFormat Si el sistema está configurado para trabajar con tipos ItemID alphanumeric(16), todos los id. deben ser alphanumeric(16). Haga que el tipo de ItemID sea uniforme en todas las filas.
ImageContentIsEmpty La imagen descargada está vacía. Compruebe la URL de la imagen.
ImageDownloadFailed Las imágenes deben estar en Data Lake Storage y protegidas con autenticación (acceso no anónimo). Compruebe la URL de la imagen.
ImageMalwareDetected El análisis de malware detectó un problema con la imagen. Compruebe la URL de la imagen.
ImageNotFound No se encontró la imagen en la URL especificada. Compruebe la URL de la imagen.
ImageSizeLargerThanAllowed La imagen es más grande que el tamaño máximo permitido. Compruebe la URL de la imagen.
ImageUnexpectedContentType La URL de la imagen contiene un tipo de contenido inesperado. Compruebe la URL de la imagen.
MalwareDetected Compruebe los archivos de imagen. Podrían estar infectados. Compruebe la URL de la imagen.
InvalidListName Asegúrese de que el nombre de la lista coincida con la documentación. Para obtener más información, vaya a Entidades de datos de enriquecimiento de recomendaciones.
InvalidDateFormat En la entrada ItemsAndVariants, la fecha de lanzamiento no tiene el formato de fecha y hora admitido yyyy-MM-ddTHH:mm:ss.fffZ. Confirme que su formato de fecha y hora coincida con los requisitos de nuestro esquema de contrato de datos o deje la fecha de publicación en blanco.
InvalidListAvailabilityRange La fecha de inicio debe ser anterior a la fecha de finalización y ninguna debe estar vacía. Consulte las fechas de las disponibilidades. Para obtener más información, vaya a Entidades de datos de catálogo.
UniqueAttributeCountExceedsThreshold Algunos atributos están limitados en términos de valores únicos. Este error significa que el servicio de Intelligent Recommendations ha alcanzado un tamaño de datos que supera los límites admitidos. Si este error ocurre y no puede resolver el problema, vaya a Soporte.
CsvInvalidFormat La entidad de datos de entrada puede tener un formato CSV incorrecto. El archivo de registro de errores indicará al cliente la ubicación del error y más detalles sobre el error. Para obtener más información, consulte las Instrucciones de formato de datos del contrato de datos.
MissingAttribute Una entidad de datos especificada no contiene todos los atributos requeridos. Para obtener más información sobre cuáles son los atributos requeridos de entidades de datos específicas, consulte la Información general del contrato de datos.
MandatoryInputIsMisssing Falta el archivo model.json. Vuelva a confirmar que cargó correctamente sus archivos model.json en su cuenta de almacenamiento de la carpeta ir_root. En segundo lugar, debe comprobar que la cadena de conexión del recurso de modelado apunte a la carpeta que tiene el archivo model.json. Si su archivo model.json se ha modificado, está dañado o falta, puede descargar un nuevo archivo model.json del contrato de datos y agregarlo a la carpeta ir_root.
MulitpleFilterTypes Reco_ItemAndVariantFilters contiene un nombre de filtro con más de un tipo de filtro. Revise el contrato de datos y confirme que todos los valores relacionados con un FilterName específico tengan el mismo FilterType. Para obtener más información, consulte nuestras Instrucciones de filtros de elementos y variantes.
NonNumericFilterValue Los filtros numéricos asumen que todos los valores son numéricos. Cambie el filtro a datos numéricos.
TotalLineCountExceedsThreshold Las entidades de datos de entrada superan actualmente el umbral de recuento de líneas. El servicio tiene un umbral predeterminado para la cantidad de valores y combinaciones únicos para determinadas entidades y valores de datos. Compruebe los archivos de registro para ver dónde se está produciendo el error y siga las Instrucciones de formato del contrato de datos para identificar los umbrales adecuados para cada entidad de datos.
UnexpectedColumnCount Le faltan o tiene más columnas de las permitidas por el contrato de datos. Algunas columnas pueden tener valores opcionales y pueden dejarse vacías, pero todas las columnas deben estar presentes para que el servicio funcione correctamente. En el caso de columnas no obligatorias o datos no disponibles, deje la columna vacía. No elimine columnas. Debe haber exactamente 12 columnas en el esquema de entrada. Las cadenas con escapes incorrectos pueden contener comas y romper el recuento de columnas. No edite el archivo model.json, lo cual podría romper su contrato de datos. Si su archivo model.json se ha modificado o dañado, puede descargar un nuevo archivo model.json del contrato de datos.
UniqueAttributeCountExceedsThreshold Las entidades de datos de entrada superan actualmente el umbral de recuento de valores/combinaciones únicos. El servicio tiene un umbral predeterminado para la cantidad de valores y combinaciones únicos para determinadas entidades y valores de datos. Compruebe los archivos de registro para ver dónde se está produciendo el error y siga las Instrucciones de formato del contrato de datos para identificar los umbrales adecuados para cada entidad de datos.
UnsupportedFilterType El servicio sospecha que está utilizando un tipo de filtro no admitido. Asegúrese de que el tipo de filtro sea uno de los valores admitidos en la documentación. Para obtener más información, vaya a Entidades de datos de catálogo.
DistinctValueViolation ItemsAndVariants.csv tiene id. de variantes duplicados. Compruebe los registros para el id. de variante del elemento con duplicados. Si se identifican duplicados en el contrato de datos, el servicio dejará de procesar la entidad de datos relevante para que no se procese el escenario que utiliza la entidad de datos. Este error se desencadenará entre los primeros minutos o dentro de una hora dependiendo de la cantidad de datos. Para resolverlo, elimine cualquier duplicado y reinicie el ciclo de modelado.
DistinctValueViolation Interactions.csv contiene dos elementos maestros diferentes con el mismo id. de variante. Compruebe los registros para los id. de elementos que tienen el mismo id. de variante. Si se identifican duplicados en el contrato de datos, el servicio dejará de procesar la entidad de datos relevante para que no se procese el escenario que utiliza la entidad de datos. Este error se desencadenará entre los primeros minutos o dentro de una hora dependiendo de la cantidad de datos. Para resolverlo, elimine cualquier duplicado y reinicie el ciclo de modelado.
UniqueAttributesCombinationExceedsThreshold Hay una combinación de datos de entrada que ha excedido su límite. Por ejemplo: itemId, variantId límite cruzado de conteo único. Compruebe los archivos de registro para ver dónde se está produciendo el error y siga las Instrucciones de formato del contrato de datos para identificar los umbrales adecuados para cada entidad de datos.
MaxUniqueAttributeCountPerItemExceedsThreshold Una combinación de datos de entrada ha cruzado un límite, que es por producto. Por ejemplo: el número de imágenes diferentes por artículo está sobrepasando el límite. Compruebe los archivos de registro para ver dónde se está produciendo el error y siga las Instrucciones de formato del contrato de datos para identificar los umbrales adecuados para cada entidad de datos.
Internal Error general; cualquier error que no esté entre los enumerados y que no se haya podido identificar. Si este error ocurre y no puede resolver el problema, Póngase en contacto con nuestro equipo.

Ejemplo de archivo de registro

A continuación se muestra un ejemplo de archivo de registro. La respuesta contiene las secciones siguientes:

  • TotalRecordCount: el número total de filas procesadas correctamente.
  • TotalDroppedRecords: el número total de filas que se descartaron debido a problemas con la configuración de datos.
  • Errores: los tipos de errores descubiertos y agrupados en categorías. Cada tipo de error incluye el número total de filas y una muestra de los datos mal formateados.

En el ejemplo dado, notará que se devuelven dos tipos de errores. El primer error "EmptyMandatoryAttribute" muestra que actualmente queda un ItemId con una cadena vacía. El segundo error "InvalidIdFormat" hace referencia a un formato no válido para los ItemId y ejemplos en los que los ItemId están configurados incorrectamente.

{
              "TotalRecordCount": 12803,
              "TotalDroppedRecords": 69,
              "Errors": [
                             {
                                           "ErrorCategory": "EmptyMandatoryAttribute",
                                           "ColumnName": "ItemId",
                                           "ErrorCount": 1,
                                           "Samples": [
                                                          ""
                                           ]
                             },
                             {
                                           "ErrorCategory": "InvalidIdFormat",
                                           "ColumnName": "ItemId",
                                           "ErrorCount": 68,
                                           "Samples": [
                                                          "6.92E+13",
                                                          "4.18E+171",
                                                          "5.74E+13",
                                                          "6.70E+36",
                                                          "9.95E+11",
                                                          "5.13E+23",
                                                          "9.26E+14",
                                                          "1.02E+11",
                                                          "5.43E+14",
                                                          "9.07E+80"
                                           ]
                             }
              ]
}

¿Aún necesita ayuda?

Si ocurren problemas que no están incluidos en esta tabla, vaya a Soporte para obtener información sobre cómo ponerse en contacto con el equipo de soporte de Intelligent Recommendations.

Consulte también

Configurar el registro de errores
Descripción general del contrato de datos
Referencia de API de Intelligent Recommendations
Códigos de estado de API
Guía de inicio rápido: configurar y ejecutar Intelligent Recommendations con datos de ejemplo
Descripción general de la implementación