Log degli errori

Raccomandazioni intelligenti crea un log degli errori per ogni oggetto dati che il servizio elabora nel tuo Azure Data Lake Storage. Il log degli errori viene scritto nuovamente nell'account Data Lake Storage. In caso di problemi con la configurazione dei dati, utilizza questo articolo per comprendere gli errori segnalati nel log e correggerli.

Questo articolo elenca i tipi di errori nel log trovati dal servizio Raccomandazioni intelligenti, il loro significato e i suggerimenti per risolverli.

Una volta corretti gli errori, Raccomandazioni intelligenti raccoglie automaticamente i nuovi dati ed elabora le modifiche durante il successivo ciclo periodico di modellazione. Per saperne di più su questo processo, vai ad Attivare manualmente la modellazione.

Tipi di errori

Utilizza la tabella seguente per comprendere i diversi tipi di errori che possono essere restituiti da Raccomandazioni intelligenti.

Alcuni tipi di errori causano l'eliminazione di una riga dall'elaborazione, mentre altri tipi di errori possono essere fatali e interrompere completamente l'elaborazione della pipeline di cottura.

Per gli errori che causano l'eliminazione della riga dall'elaborazione, se è diffusa nei dati di input, potrebbe causare una scarsa qualità del prodotto o addirittura risultati vuoti.

Tipo di errore Descrizione Risoluzione suggerita
AttributeValueNotAllowed Un attributo utilizza un valore riservato o improprio. Il valore "0" è riservato nel sistema. Se possibile, modifica il valore per questo attributo. Per altre informazioni vai a Entità di dati del catalogo.
DataTypeMismatch Il formato di un tipo di dati specificato non è corretto. Controlla attentamente la formattazione e assicurati che non siano presenti caratteri o spazi impropri in model.json o nel contratto dati. Per ulteriori informazioni sulla formattazione, vedi le Linee guida per la formattazione del contratto dati.
EmptyMandatoryAttribute Uno degli attributi obbligatori in una riga è vuoto. Inserisci i dati mancanti.
InvalidGuidIdFormat Se il sistema è impostato per funzionare con i tipi di GUID ItemID, tutti gli ID dovrebbero essere GUID. Rendi il tipo ItemID coerente su tutte le righe.
InvalidIdFormat Se il sistema è impostato per funzionare con i tipi ItemID alfanumerici(16), tutti gli ID dovrebbero essere alfanumerici(16). Rendi il tipo ItemID coerente su tutte le righe.
ImageContentIsEmpty L'immagine scaricata è vuota. Controlla l'URL dell'immagine.
ImageDownloadFailed Le immagini devono essere su Data Lake Storage e protette con autenticazione (accesso non anonimo). Controlla l'URL dell'immagine.
ImageMalwareDetected La scansione malware ha rilevato un problema con l'immagine. Controlla l'URL dell'immagine.
ImageNotFound Immagine non trovata nell'URL specificato. Controlla l'URL dell'immagine.
ImageSizeLargerThanAllowed L'immagine è più grande della dimensione massima consentita. Controlla l'URL dell'immagine.
ImageUnexpectedContentType L'URL dell'immagine contiene tipo di contenuto imprevisto. Controlla l'URL dell'immagine.
MalwareDetected Controlla i file dell'immagine. Potrebbero essere infetti. Controlla l'URL dell'immagine.
InvalidListName Assicurati che il nome dell'elenco corrisponda alla documentazione. Per altre informazioni vai a Entità di dati di arricchimento delle raccomandazioni.
InvalidDateFormat Nell'input ItemsAndVariants, la data di rilascio non è nel formato data-ora supportato yyyy-MM-ddTHH:mm:ss.fffZ. Verifica che il formato data-ora corrisponda ai requisiti nel nostro schema del contratto dati o lascia vuota la data di rilascio.
InvalidListAvailabilityRange La data di inizio deve essere precedente alla data di fine ed entrambe non devono essere vuote. Verifica le date delle disponibilità. Per altre informazioni vai a Entità di dati del catalogo.
UniqueAttributeCountExceedsThreshold Alcuni attributi sono limitati in termini di valori univoci. Questo errore indica che il servizio Raccomandazioni intelligenti ha raggiunto la dimensione dei dati oltre i limiti supportati. Se si verifica questo errore e non è possibile risolvere il problema, vai a Supporto.
CsvInvalidFormat L'entità dei dati di input può avere il formato CSV errato. Il file di registro degli errori indicherà al client la posizione dell'errore e maggiori dettagli sull'errore. Per ulteriori informazioni, vedi le Linee guida sul formato dei dati del contratto dati.
MissingAttribute Un'entità dati specificata non contiene tutti gli attributi richiesti. Per ulteriori informazioni su quali sono gli attributi richiesti di entità di dati specifici, vedi la Panoramica del contratto dati.
MandatoryInputIsMisssing Il file model.json è mancante. Riconferma di aver caricato correttamente i file model.json nel tuo account di archiviazione sotto la cartella ir_root. In secondo luogo, potrebbe essere necessario verificare che la stringa di connessione della risorsa di modellazione punti alla cartella che contiene il file model.json. Se il tuo file model.json è stato modificato o danneggiato o mancante, puoi scaricarne un nuovo file model.json dal Contratto dati e aggiungerlo alla cartella ir_root.
MulitpleFilterTypes Reco_ItemAndVariantFilters contiene un nome di filtro con più di un tipo di filtro. Esamina il contratto data e conferma che tutti i valori relativi a un FilterName specifico hanno tutti lo stesso FilterType. Per ulteriori informazioni, consulta le Linee guida sui filtri degli articoli e delle varianti.
NonNumericFilterValue I filtri numerici presuppongono che tutti i valori siano numerici. Cambia il filtro in dati numerici.
TotalLineCountExceedsThreshold Le entità di dati di input attualmente superano la soglia di conteggio delle righe. Il servizio ha una soglia predefinita per il numero di valori e combinazioni univoci per determinate entità e valori di dati. Controlla i file di registro per vedere dove si sta verificando l'errore e segui le Linee guida per la formattazione del contratto dati per identificare le soglie appropriate per ciascuna entità di dati.
UnexpectedColumnCount Mancano o hai più colonne di quelle consentite dal contratto dati. Alcune colonne possono avere valori facoltativi e possono essere lasciate vuote, ma tutte le colonne devono essere presenti affinché il servizio funzioni correttamente. Per le colonne non obbligatorie o per i dati non disponibili, lascia la colonna vuota. Non rimuovere le colonne. Devono esserci esattamente 12 colonne nello schema di input. Le stringhe con escape non corretto potrebbero contenere virgole e interrompere il conteggio delle colonne. Non modificare il file model.json, poiché ciò potrebbe interrompere il contratto dati. Se il tuo file model.json è stato modificato o danneggiato, puoi scaricarne un nuovo file model.json dal Contratto dati.
UniqueAttributeCountExceedsThreshold Le entità di dati di input attualmente superano la soglia di conteggio di valori/combinazioni univoci. Il servizio ha una soglia predefinita per il numero di valori e combinazioni univoci per determinate entità e valori di dati. Controlla i file di registro per vedere dove si sta verificando l'errore e segui le Linee guida per la formattazione del contratto dati per identificare le soglie appropriate per ciascuna entità di dati.
UnsupportedFilterType Il servizio sospetta che tu stia utilizzando un tipo di filtro non supportato. Assicurati che il tipo di filtro sia uno dei valori supportati nella documentazione. Per ulteriori informazioni, vai a Entità di dati del catalogo.
DistinctValueViolation ItemsAndVariants.csv ha ID variante duplicati. Controlla i registri per l'ID variante articolo con duplicati. Se vengono identificati duplicati nel contratto dati, il servizio interromperà l'elaborazione dell'entità di dati pertinente in modo che lo scenario che utilizza l'entità di dati non verrà elaborato. Questo errore si attiverà nei primi minuti o entro un'ora a seconda della quantità di dati. Per risolvere, rimuovi eventuali duplicati e riavvia il ciclo di modellazione.
DistinctValueViolation Interactions.csv contiene due diversi articoli principali con lo stesso ID variante. Controlla i registri per gli ID articolo che hanno lo stesso ID variante. Se vengono identificati duplicati nel contratto dati, il servizio interromperà l'elaborazione dell'entità di dati pertinente in modo che lo scenario che utilizza l'entità di dati non verrà elaborato. Questo errore si attiverà nei primi minuti o entro un'ora a seconda della quantità di dati. Per risolvere, rimuovi eventuali duplicati e riavvia il ciclo di modellazione.
UniqueAttributesCombinationExceedsThreshold È presente una combinazione di dati di input che ha superato il limite. Ad esempio: limite di conteggio univoco itemId, variantId. Controlla i file di registro per vedere dove si sta verificando l'errore e segui le Linee guida per la formattazione del contratto dati per identificare le soglie appropriate per ciascuna entità di dati.
MaxUniqueAttributeCountPerItemExceedsThreshold Una combinazione di dati di input ha superato un limite che è per prodotto. Ad esempio: il numero di immagini diverse per articolo supera il limite. Controlla i file di registro per vedere dove si sta verificando l'errore e segui le Linee guida per la formattazione del contratto dati per identificare le soglie appropriate per ciascuna entità di dati.
Internal Errore generale; qualsiasi errore diverso da quello precedente che non è stato possibile identificare. Se si verifica questo errore e non è possibile risolvere il problema, contatta il supporto.

File di log di esempio

Di seguito è riportato un file di registro. La risposta contiene le seguenti sezioni:

  • TotalRecordCount: il numero totale di righe elaborate correttamente.
  • TotalDroppedRecords: il numero totale di righe eliminate a causa di problemi con la configurazione dei dati.
  • Errori: i tipi di errori rilevati e raggruppati in categorie. Ogni tipo di errore include il numero totale di righe e un esempio dei dati formattati in modo errato.

Nell'esempio riportata di seguito, noterai che vengono restituiti due tipi di errori. Il primo errore "EmptyMandatoryAttribute" mostra che al momento è rimasto un ItemId con una stringa vuota. Il secondo errore "InvalidIdFormat" fa riferimento a un formato non valido per ItemIds ed esempi di cui ItemIds sono configurati in modo errato.

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

Ti serve ancora aiuto?

Se si verificano problemi che non sono inclusi in questa tabella, vai in Supporto per informazioni su come contattare il team di supporto di Raccomandazioni intelligenti.

Vedi anche

Impostazione del log degli errori
Panoramica del contratto dati
Riferimento dell'API di Raccomandazioni intelligenti
Codici di stato API
Guida rapida: impostare ed eseguire Raccomandazioni intelligenti con dati di esempio
Panoramica della distribuzione