Risolvere l'errore di convalida dello schema non riuscita

Questo articolo consente di correggere tutte le categorie di errori relativi alla convalida degli schemi non riuscita che possono verificarsi dopo l'invio del comando crea o aggiorna per un file YAML durante l'uso dell'interfaccia della riga di comando di Azure Machine Learning v2. L'elenco dei comandi che possono generare questo errore include:

Creazione

• az ml job create
• az ml data create
• az ml datastore create
• az ml compute create
• az ml batch-endpoint create
• az ml batch-deployment create
• az ml online-endpoint create
• az ml online-deployment create
• az ml online-deployment create
• az ml component create
• az ml environment create
• az ml model create
• az ml connection create
• az ml schedule create
• az ml registry create
• az ml workspace create

Aggiornamento

• az ml online-endpoint update
• az online-deployment update
• az batch-deployment update
• az datastore update
• az compute update
• az data update

Sintomi

Quando l'utente invia un file YAML tramite il comando crea o aggiorna usando l'interfaccia della riga di comando di Azure Machine Learning v2 per completare una determinata attività (ad esempio, creare un asset di dati, inviare un processo di training o aggiornare una distribuzione online), è possibile riscontrare l’errore "Convalida dello schema non riuscito".

Causa

Gli errori di “Convalida dello schema non riuscito” si verificano perché il file YAML inviato non corrisponde allo schema prescritto per il tipo di asset (area di lavoro, dati, archivio dati, componente, calcolo, ambiente, modello, processo, endpoint batch, distribuzione batch, endpoint online, distribuzione online, pianificazione, connessione o registro di sistema) che l'utente stava tentando di creare o aggiornare. Le cause possono essere diverse.

La procedura generale per correggere questo errore consiste innanzitutto nel passare al percorso in cui è archiviato il file YAML, aprirlo e apportare le modifiche necessarie, salvare il file YAML, quindi tornare al terminale e inviare di nuovo il comando. Le sezioni seguenti mostrano in dettaglio le modifiche necessarie in base alla causa.

Errore - Valore non valido

Il file YAML inviato contiene uno o più parametri il cui valore è di tipo non corretto. Ad esempio, per la creazione di dati ML (ovvero lo schema dei dati) il parametro "path" prevede un valore URL. Specificare un numero o una stringa che non è un percorso di file, verrà considerato non valido. Il parametro potrebbe anche avere un intervallo di valori possibili e il valore specificato non è incluso in tale intervallo. Ad esempio, per la creazione di dati ml il parametro "type" accetta solo uri_file, uri_folder o ml_table. Qualsiasi altro valore sarà considerato non valido.

Soluzione - Valore non valido

Se il tipo di valore fornito per un parametro non è valido, controllare lo schema prescritto e modificare il valore nel tipo corretto (nota: ciò si riferisce al tipo di dati del valore fornito per il parametro, da non confondere con il parametro "tipo" in molti schemi). Se il valore stesso non è valido, selezionare un valore dall'intervallo di valori previsto (si trova nel messaggio di errore). Salvare il file YAML e inviare di nuovo il comando. Ecco un elenco di schemi per tutti i diversi tipi di asset in Azure Machine Learning v2.

Errore - Campo sconosciuto

Il file YAML inviato contiene uno o più parametri, che non fanno parte dello schema prescritto per quel tipo di asset. Ad esempio, per la creazione di processi ml (ovvero lo schema commandjob), se viene specificato un parametro denominato "nome", questo errore verrà rilevato perché lo schema commandjob non ha tale parametro.

Soluzione - Campo sconosciuto

Nel file YAML inviato eliminare il campo non valido. Salvare il file YAML e inviare di nuovo il comando.

Errore - Impossibile trovare file o cartella

Il file YAML inviato contiene un parametro "path". Il percorso del file o della cartella fornito come valore per tale parametro non è corretto (errore ortografico, estensione mancante e così via) oppure il file o la cartella non esistono.

Soluzione - Impossibile trovare file o cartella

Nel file YAML inviato passare al parametro "path" e verificare se il percorso del file o della cartella specificato è scritto correttamente (ovvero, il percorso è completo, nessun errore di ortografia, nessuna estensione di file mancante, caratteri speciali e così via). Salvare il file YAML e inviare di nuovo il comando. Se l'errore persiste, il file o la cartella non esistono nel percorso specificato.

Errore - Campo mancante

Al file YAML inviato manca un parametro obbligatorio. Ad esempio, per la creazione di processi ml (ovvero lo schema commandjob ), se il parametro "ambiente di calcolo" non viene specificato, questo errore verrà rilevato perché l’ambiente di calcolo è necessario per eseguire il processo di comando.

Soluzione - Campo mancante

Controllare lo schema prescritto per il tipo di asset che si sta tentando di creare o aggiornare. Controllare quali parametri sono necessari e quali sono i tipi di valore corretti. Ecco un Elenco di schemi per diversi tipi di asset in Azure Machine Learning v2. Assicurarsi che il file YAML inviato disponga di tutti i parametri necessari. Assicurarsi anche che i valori specificati per tali parametri siano del tipo corretto e nell'intervallo di valori accettato. Salvare il file YAML e inviare di nuovo il comando.

Errore - Impossibile analizzare

Il file YAML inviato non può essere letto perché la sintassi non è corretta, la formattazione non è corretta o sono presenti caratteri indesiderati nel file. Ad esempio, un carattere speciale (come i due punti o il punto e virgola) immesso per errore nel file YAML.

Soluzione - Impossibile analizzare

Verificare il contenuto del file YAML inviato e controllare che la sintassi e formattazione siano corrette e non siano presenti caratteri indesiderati. Correggere tutti gli errori, salvare il file YAML e inviare di nuovo il comando.

Errore - Risorsa non trovata

Una o più risorse (ad esempio, file/cartella) non esistono o non sono accessibili nel file YAML inviato.

Soluzione - Risorsa non trovata

Verificare che il nome della risorsa è stato specificato correttamente e che si disponga dell'accesso. Apportare le modifiche necessarie, salvare il file YAML e inviare di nuovo il comando.

Errore - Impossibile serializzare

Uno o più campi nel file YAML non possono essere serializzati (convertiti) in oggetti.

Soluzione - Impossibile serializzare

Verificare che il file YAML non sia danneggiato e che il contenuto del file sia formattato correttamente.