Registos de erros

O Intelligent Recommendations cria um registo de erros para cada objeto de dados que o serviço processa no Azure Data Lake Storage. O registo de erros é escrito de volta para a conta do Data Lake Storage. Se tiver problemas com a configuração de dados, utilize este artigo para compreender os erros reportados no registo e como corrigi-los.

Este artigo lista os tipos de erros no registo encontrados pelo serviço Intelligent Recommendations, o que significam e as sugestões para resolvê-los.

Quando os erros são corrigidos, o Intelligent Recommendations pega nos dados novos automaticamente e processa as alterações durante o próximo ciclo de modelação periódica. Para saber mais sobre este processo, aceda a Acionar manualmente a modelação.

Tipos de erros

Utilize a tabela seguinte para compreender os diferentes tipos de erros que podem ser devolvidos pelo Intelligent Recommendations.

Alguns tipos de erros podem fazer com que uma linha seja largada do processamento, enquanto outros tipos de erros poderão ser fatais e fazer com que o pipeline de preparação deixe de processar totalmente.

Para erros que causaram a largada da linha do processamento, se estiver espalha pelos dados de entrada, poderá resultar em má qualidade do produto ou até em resultados vazios.

Tipo de erro	Descrição	Resolução sugerida
AttributeValueNotAllowed	Um atributo está a utilizar um valor reservado ou inadequado.	O valor "0" está reservado no sistema. Se possível, altere o valor para este atributo. Para mais informações, aceda a Entidades de dados de catálogo.
DataTypeMismatch	O formato de um tipo de dados especificado está incorreto.	Verifique a formatação com cuidado e certifique-se de que não existem carateres nem espaços inadequados no model.json ou no Contrato de Dados. Para mais informações sobre a formatação, consulte as nossas Orientações de Formatação de Contratos de Dados.
EmptyMandatoryAttribute	Um dos atributos obrigatórios numa linha está vazio.	Preencha os dados em falta.
InvalidGuidIdFormat	Se o sistema estiver definido para funcionar com tipos de GUID ItemID, todos os IDs devem ser GUIDs.	Faça com que o tipo de ItemID seja consistente em todas as linhas.
InvalidIdFormat	Se o sistema estiver definido para funcionar com tipos de ItemID alfanuméricos (16), todos os IDs devem ser alfanuméricos (16).	Faça com que o tipo de ItemID seja consistente em todas as linhas.
ImageContentIsEmpty	A imagem transferida está vazia.	Verifica o URL da imagem.
ImageDownloadFailed	As imagens têm de estar no Data Lake Storage e protegidas com autenticação (acesso não anónimo).	Verifica o URL da imagem.
ImageMalwareDetected	O rastreamento de malware detetou um problema com a imagem.	Verifica o URL da imagem.
ImageNotFound	A imagem não foi encontrada no URL especificado.	Verifica o URL da imagem.
ImageSizeLargerThanAllowed	A imagem é maior do que o tamanho máximo permitido.	Verifica o URL da imagem.
ImageUnexpectedContentType	O URL da imagem contém tipo de conteúdo inesperado.	Verifica o URL da imagem.
MalwareDetected	Verifique os ficheiros imagem. Podem estar infetados.	Verifica o URL da imagem.
InvalidListName	Certifique-se de que o Nome da Lista corresponde à documentação.	Para mais informações, aceda a Entidades de dados de Melhoramento de Recomendações.
InvalidDateFormat	Na entrada ItemsAndVariants, a data de lançamento não está no formato de data/hora suportado yyyy-MM-ddTHH:mm:ss.fffZ.	Confirme se o formato de data e hora corresponde aos requisitos no nosso esquema de Contrato de Dados ou deixe a data de lançamento em branco.
InvalidListAvailabilityRange	A Data de Início deve ser anterior à Data de Fim e ambas devem estar não vazias.	Verifique as datas das disponibilidades. Para mais informações, aceda a Entidades de dados de catálogo.
UniqueAttributeCountExceedsThreshold	Alguns atributos estão limitados em termos de valores exclusivos. Este erro significa que o serviço Intelligent Recommendations alcançou o tamanho de dados para além dos limites suportados.	Se este erro ocorrer e não conseguir resolver o problema, aceda a Suporte.
CsvInvalidFormat	A entidade de dados de entrada pode ter o formato CSV errado.	O ficheiro de registo de erros indicará ao cliente a localização do erro e mais detalhes sobre o erro. Para mais informações, consulte as Orientações sobre o Formato de Dados do Contrato de Dados.
MissingAttribute	Uma entidade de dados especificada não contém todos os atributos obrigatórios.	Para mais informações sobre o que são atributos obrigatórios de entidades de dados específicas, consulte a Descrição geral do contrato de dados.
MandatoryInputIsMisssing	O ficheiro model.json está em falta.	Confirme novamente que carregou corretamente os ficheiros model.json para a conta de armazenamento abaixo da pasta ir_root. Em segundo lugar, verifique se a cadeia de ligação de recurso de modelação está a apontar para a pasta que tem o ficheiro model.json. Se o seu ficheiro model.json tiver sido modificado, estiver quebrado ou em falta, pode transferir um novo ficheiro model.json a partir do Contrato de Dados e adicioná-lo à pasta ir_root.
MulitpleFilterTypes	Reco_ItemAndVariantFilters contém um nome de filtro com mais do que um tipo de filtro.	Reveja o Contrato de dados e confirme que todos os valores relacionados com um FilterName específico têm todos o mesmo FilterType. Para mais informações, consulte as nossas Orientações sobre Itens e Filtros de Variantes.
NonNumericFilterValue	Os filtros numéricos assumem que todos os valores são numéricos.	Altere o filtro para dados numéricos.
TotalLineCountExceedsThreshold	As entidades de dados de entrada excedem atualmente o limiar da contagem de linhas.	O serviço tem um limiar predefinido para o número de valores exclusivos e combinações para determinadas entidades de dados e valores. Verifique os ficheiros de registos para ver onde o erro está a ocorrer e siga as Orientações de formatação do Contrato de Dados para identificar os limiares apropriados para cada entidade de dados.
UnexpectedColumnCount	Faltam ou tem mais colunas do que o permitido no Contrato de Dados. Algumas colunas podem ter valores opcionais e podem ser deixadas vazias, mas todas as colunas têm de estar presentes para que o serviço funcione corretamente.	Para colunas não obrigatórias ou indisponíveis, deixe a coluna vazia. Não remova colunas. Devem ser exatamente 12 colunas no esquema de entrada. Cadeias indevidamente escapadas podem conter vírgulas e quebrar a contagem de colunas. Não edite o ficheiro model.json, o que poderá quebrar o seu contrato de dados. Se o seu ficheiro model.json tiver sido modificado ou estiver quebrado, pode transferir um novo ficheiro model.json a partir do Contrato de Dados.
UniqueAttributeCountExceedsThreshold	As entidades de dados de entrada excedem atualmente o limiar da contagem de valores exclusivos/combinações.	O serviço tem um limiar predefinido para o número de valores exclusivos e combinações para determinadas entidades de dados e valores. Verifique os ficheiros de registos para ver onde o erro está a ocorrer e siga as Orientações de formatação do Contrato de Dados para identificar os limiares apropriados para cada entidade de dados.
UnsupportedFilterType	O serviço suspeita que está a utilizar um tipo de filtro não suportado.	Certifique-se de que o tipo de filtro é um dos valores suportados na documentação. Para mais informações, aceda a Entidades de dados de catálogo.
DistinctValueViolation	O ItemsAndVariants.csv tem IDs de variante duplicados. Verifique os registos para o ID de variante de item com duplicados.	Se forem identificados duplicados no contrato de dados, o serviço vai interromper o processamento da entidade de dados relevante para que o cenário que utiliza a entidade de dados não seja processado. Este erro será acionado nos primeiros minutos ou dentro da hora, dependendo da quantidade de dados. Para resolver, remova todos os duplicados e reinicie o ciclo de modelação.
DistinctValueViolation	O Interactions.csv contém dois itens Mestre diferentes com o mesmo ID de variante. Verifique os registos para os IDs de item que têm o mesmo ID de variante.	Se forem identificados duplicados no contrato de dados, o serviço vai interromper o processamento da entidade de dados relevante para que o cenário que utiliza a entidade de dados não seja processado. Este erro será acionado nos primeiros minutos ou dentro da hora, dependendo da quantidade de dados. Para resolver, remova todos os duplicados e reinicie o ciclo de modelação.
UniqueAttributesCombinationExceedsThreshold	Existe uma combinação de dados de entrada que excedeu o limite. Por exemplo: itemId, limite cruzado de contagem exclusiva de variantId.	Verifique os ficheiros de registos para ver onde o erro está a ocorrer e siga as Orientações de formatação do Contrato de Dados para identificar os limiares apropriados para cada entidade de dados.
MaxUniqueAttributeCountPerItemExceedsThreshold	Uma combinação de dados de entrada ultrapassou um limite que é por produto. Por exemplo: o número de imagens diferentes por item está a ultrapassar o limite.	Verifique os ficheiros de registos para ver onde o erro está a ocorrer e siga as Orientações de formatação do Contrato de Dados para identificar os limiares apropriados para cada entidade de dados.
Interna	Erro geral; qualquer erro diferente dos listados que não pôde ser identificado.	Se este erro ocorrer e não conseguir resolver o problema, Contacte a nossa Equipa.

Ficheiro de registo de exemplo

Eis um exemplo de um ficheiro de registo. A resposta contém as seguintes secções:

• TotalRecordCount: o número total de linhas processadas corretamente.
• TotalDroppedRecords: o número total de linhas que foram largadas devido a problemas com a configuração de dados.
• Erros: os tipos de erros detetados e agrupados em categorias. Cada tipo de erro inclui o número total de linhas e uma amostra dos dados mal formatados.

No exemplo fornecido, irá reparar que são devolvidos dois tipos de erros. O primeiro erro "EmptyMandatoryAttribute" mostra que, atualmente, resta um ItemId com uma cadeia vazia. O segundo erro "InvalidIdFormat" referencia um formato inválido para ItemIds e exemplos dos quais ItemIds estão incorretamente configurados.

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

Ainda precisa de ajuda?

Se ocorrerem problemas que não estão incluídos nesta tabela, aceda a Suporte para obter informações sobre como contactar a equipa de suporte do Intelligent Recommendations.

Consulte também

Configurar o registo de erros
Descrição geral do contrato de dados
Referência da API Intelligent Recommendations
Códigos de Estado da API
Guia de Início Rápido: Configurar e executar o Intelligent Recommendations com dados de amostra
Descrição geral da implementação