Logs de Erros

O serviço Recomendações Inteligentes cria um log de erros para cada objeto de dados que o serviço processa em seu Azure Data Lake Storage. O log de erros é gravado de volta na conta do Data Lake Storage. Se você tiver problemas com a configuração de dados, use este artigo para entender os erros relatados no log e como corrigi-los.

Este artigo lista os tipos de erros no log encontrados pelo serviço Recomendações Inteligentes, o que eles significam e dicas sobre como resolvê-los.

Quando os erros são corrigidos, o serviço Recomendações Inteligentes coleta os novos dados automaticamente e processa as alterações durante o próximo ciclo de modelagem periódica. Para saber mais sobre esse processo, acesse Acionar manualmente a modelagem.

Tipos de erros

Use a tabela a seguir para entender os diferentes tipos de erros que podem ser retornados pelo serviço Recomendações Inteligentes.

Alguns tipos de erros fazem com que uma linha seja descartada do processamento, enquanto outros tipos de erros podem ser fatais e fazer com que o processamento do pipeline de criação pare completamente.

Para erros que fazem com que a linha seja descartada do processamento, se ela for generalizada nos dados de entrada, isso poderá resultar em baixa qualidade do produto ou até mesmo em resultados vazios.

Tipo de erro	Descrição	Solução sugerida
AttributeValueNotAllowed	Um atributo está usando um valor reservado ou impróprio.	O valor "0" é reservado no sistema. Se possível, altere o valor deste atributo. Para obter mais informações, vá para Entidades de dados do catálogo.
DataTypeMismatch	O formato de um tipo de dados especificado está incorreto.	Verifique sua formatação com cuidado e certifique-se de que não haja caracteres ou espaços incorretos no model.json ou no Contrato de dados. Para obter mais informações sobre formatação, consulte nossas Diretrizes de formatação de contrato de dados.
EmptyMandatoryAttribute	Um dos atributos obrigatórios em uma linha está vazio.	Preencha os dados que estão faltando.
InvalidGuidIdFormat	Se o sistema estiver configurado para trabalhar com tipos de GUID ItemID, todas as IDs devem ser GUIDs.	Torne o tipo ItemID consistente em todas as linhas.
InvalidIdFormat	Se o sistema estiver configurado com tipos de ItemID alfanuméricos(16), todas as IDs devem ser alfanuméricas(16).	Torne o tipo ItemID consistente em todas as linhas.
ImageContentIsEmpty	A imagem baixada está vazia.	Verifique a URL da imagem.
ImageDownloadFailed	As imagens devem estar no Data Lake Storage e protegidas com autenticação (acesso não anônimo).	Verifique a URL da imagem.
ImageMalwareDetected	A verificação de malware detectou um problema com a imagem.	Verifique a URL da imagem.
ImageNotFound	A imagem não foi encontrada na URL especificada.	Verifique a URL da imagem.
ImageSizeLargerThanAllowed	A imagem é maior do que o tamanho máximo permitido.	Verifique a URL da imagem.
ImageUnexpectedContentType	A URL da imagem contém tipo de conteúdo inesperado.	Verifique a URL da imagem.
MalwareDetected	Verifique os arquivos da imagem. Elas podem estar infectadas.	Verifique a URL da imagem.
InvalidListName	Certifique-se de que o nome da lista corresponda à documentação.	Para obter mais informações, vá para Entidades de dados do Recomendações Inteligentes.
InvalidDateFormat	Na entrada ItemsAndVariants, a data de lançamento não está no formato de data e hora compatível yyyy-MM-ddTHH:mm:ss.fffZ.	Confirme se seu formato de data e hora corresponde aos requisitos em 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 Término e ambas devem ser preenchidas.	Consulte as datas das disponibilidades. Para obter mais informações, vá para Entidades de dados do catálogo.
UniqueAttributeCountExceedsThreshold	Alguns atributos são limitados em termos de valores exclusivos. Esse erro significa que o serviço Recomendações Inteligentes atingiu o tamanho de dados além dos limites permitidos.	Se este erro ocorrer e você não conseguir resolver o problema, acesse o Suporte.
CsvInvalidFormat	A entidade de dados de entrada pode ter o formato CSV incorreto.	O arquivo de log de erros indicará ao cliente o local do erro e mais detalhes sobre o erro. Para mais informações, consulte as Diretrizes de formato de dados do contrato de dados.
MissingAttribute	Uma entidade de dados especificada não contém todos os atributos necessários.	Para obter mais informações sobre quais são os atributos necessários de entidades de dados específicas, consulte a Visão geral do contrato de dados.
MandatoryInputIsMisssing	O arquivo model.jso está ausente.	Reconfirme que você carregou corretamente seus arquivos model.json para sua conta de armazenamento na pasta ir_root. Em segundo lugar, verifique se a cadeia de conexão do recurso de modelagem está apontando para a pasta que contém o arquivo model.json. Se o arquivo model.json tiver sido modificado ou estiver corrompido ou ausente, você poderá baixar um novo arquivo model.json do Contrato de Dados e adicioná-lo à sua pasta ir_root.
MulitpleFilterTypes	Reco_ItemAndVariantFilters contém um nome de filtro com mais de um tipo de filtro.	Revise o contrato de dados e confirme se todos os valores relacionados a um FilterName específico têm o mesmo FilterType. Para mais informações, consulte o nossas Diretrizes de filtros de itens e 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 atualmente excedem o limite de contagem de linhas.	O serviço tem um limite padrão para o número de valores e combinações exclusivos para determinadas entidades e valores de dados. Verifique os arquivos de log para ver onde está ocorrendo o erro e siga as Diretrizes de formatação do contrato de dados para identificar os limites adequados para cada entidade de dados.
UnexpectedColumnCount	Você está ausente ou tem mais colunas do que o permitido pelo Contrato de dados. Algumas colunas podem ter valores opcionais e podem ser deixadas vazias, mas todas as colunas devem estar presentes para que o serviço funcione corretamente.	Para colunas não obrigatórias ou dados não disponíveis, deixe a coluna vazia. Não adicione nem remova colunas. Deve haver exatamente 12 colunas no esquema de entrada. Strings com escape incorreto podem conter vírgulas e quebrar a contagem de colunas. Não edite o arquivo model.json, o que pode violar seu contrato de dados. Se o arquivo model.json foi modificado ou corrompido, você pode baixar um novo arquivo model.json do Contrato de Dados.
UniqueAttributeCountExceedsThreshold	As entidades de dados de entrada atualmente excedem o limite de contagem de valores/combinações únicos.	O serviço tem um limite padrão para o número de valores e combinações exclusivos para determinadas entidades e valores de dados. Verifique os arquivos de log para ver onde está ocorrendo o erro e siga as Diretrizes de formatação do contrato de dados para identificar os limites adequados para cada entidade de dados.
UnsupportedFilterType	O serviço suspeita que você esteja usando um tipo de filtro sem suporte.	Certifique-se de que o tipo de filtro seja um dos valores permitidos na documentação. Para obter mais informações, acesse Entidades de dados do catálogo.
DistinctValueViolation	O ItemsAndVariants.csv tem IDs de variante duplicados. Verifique os logs do ID da variante do item com duplicatas.	Se forem identificadas duplicatas no contrato de dados, o serviço interromperá o processamento da entidade de dados relevante para que o cenário que usa a entidade de dados não seja processado. Este erro será acionado entre os primeiros minutos ou dentro de uma hora, dependendo da quantidade de dados. Para resolver, remova quaisquer duplicatas e reinicie o ciclo de modelagem.
DistinctValueViolation	O Interactions.csv contém dois itens mestres diferentes com o mesmo ID de variante. Verifique os logs para os IDs de item que têm o mesmo ID de variante.	Se forem identificadas duplicatas no contrato de dados, o serviço interromperá o processamento da entidade de dados relevante para que o cenário que usa a entidade de dados não seja processado. Este erro será acionado entre os primeiros minutos ou dentro de uma hora, dependendo da quantidade de dados. Para resolver, remova quaisquer duplicatas e reinicie o ciclo de modelagem.
UniqueAttributesCombinationExceedsThreshold	Há uma combinação de dados de entrada que excedeu seu limite. Por exemplo: itemId, limite cruzado de contagem única de variantId	Verifique os arquivos de log para ver onde está ocorrendo o erro e siga as Diretrizes de formatação do contrato de dados para identificar os limites adequados para cada entidade de dados.
MaxUniqueAttributeCountPerItemExceedsThreshold	Uma combinação de dados de entrada ultrapassou um limite por produto. Por exemplo: o número de imagens diferentes por item está ultrapassando o limite.	Verifique os arquivos de log para ver onde está ocorrendo o erro e siga as Diretrizes de formatação do contrato de dados para identificar os limites adequados para cada entidade de dados.
Internos	Erro geral; qualquer erro diferente dos listados que não pôde ser identificado.	Se este erro ocorrer e você não conseguir resolver o problema, entre em contato com nossa equipe.

Exemplo de arquivo de log

Veja a seguir um arquivo de log. A resposta contém as seguintes seções:

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

No exemplo fornecido, você notará que dois tipos de erros são retornados. O primeiro erro "EmptyMandatoryAttribute" mostra que há um ItemId atualmente com uma cadeia de caracteres vazia. O segundo erro "InvalidIdFormat" faz referência a um formato inválido para ItemIds e exemplos dos quais ItemIds estão configurados incorretamente.

{
              "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, acesse o Suporte para obter informações de como entrar em contato com a equipe de suporte do serviço Recomendações Inteligentes.

Confira também

Configurar registros de erros
Visão geral do contrato de dados
Referência de API do Recomendações Inteligentes
Códigos de status da API
Guia de Início Rápido: configurar e executar o Recomendações Inteligentes com dados de exemplo
Visão geral da implantação