Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Dataflow Gen2 in Fabric Data Factory supporta varie destinazioni dati per l'archiviazione dei dati trasformati. Analogamente alle origini dati, le destinazioni dati hanno regole di convalida specifiche per garantire l'integrità dei dati e che durante le operazioni di aggiornamento i dati vengono scritti correttamente. Questo articolo descrive le regole di convalida per le destinazioni dati supportate da Dataflow Gen2.
Funzionamento della convalida
Quando si configura una destinazione dati per una query in Dataflow Gen2, il sistema esegue controlli di convalida per assicurarsi che:
- La query di destinazione è configurata correttamente e può essere trovata
- Lo script di destinazione restituisce un tipo valido
- I riferimenti all'origine dati nella query di destinazione vengono risolti correttamente
- Esiste una sola query di destinazione per ogni output
Questi controlli di convalida vengono eseguiti durante il processo di pubblicazione e all'inizio di ogni operazione di aggiornamento. Se la convalida non riesce, il flusso di dati non riesce a pubblicare o l'operazione di aggiornamento viene bloccata fino a quando il problema non viene risolto.
Quando si verifica la convalida
La convalida delle destinazioni dati avviene in diversi punti del ciclo di vita del flusso di dati:
| Fase | Descrizione |
|---|---|
| Creazione | La convalida di base viene eseguita durante la configurazione della destinazione dei dati nell'editor di Power Query. |
| Pubblicazione | La convalida completa viene eseguita quando si pubblica il flusso di dati. Eventuali errori di convalida impediscono il completamento della pubblicazione. |
| Aggiorna | La convalida viene eseguita all'inizio di ogni aggiornamento per assicurarsi che la destinazione sia ancora valida e accessibile. |
Creazione di regole di convalida per le destinazioni dei dati
Nella tabella seguente sono elencate le regole di convalida di creazione che si applicano alle destinazioni dei dati in Dataflow Gen2. Queste regole consentono di garantire che le destinazioni dei dati siano configurate correttamente.
| Regola di convalida | Descrizione |
|---|---|
| DestinationQueryNotFound | Impossibile trovare la query di destinazione. Questo errore si verifica quando la query interna che contiene i passaggi di spostamento alla destinazione è mancante o è stata rimossa. |
| DestinationTransformQueryNotFound | Impossibile trovare la query di trasformazione di destinazione. Questo errore si verifica quando è prevista una query di trasformazione di destinazione (come definito nelle impostazioni di destinazione), ma non può essere individuata. Si noti che le destinazioni delle tabelle non hanno una query di trasformazione. |
| DestinationQueryChallenge | La query di destinazione ha incontrato una sfida durante la convalida. Questo indica in genere un problema di autenticazione o autorizzazione durante la connessione alla destinazione. |
| DestinationQueryException | La query di destinazione ha incontrato un'eccezione durante la convalida. Questo errore indica che si è verificato un errore imprevisto durante la convalida della query di destinazione. |
| LaQueryDiDestinazioneContieneUnoScriptNonSupportato | La query di destinazione contiene uno script non supportato. Questo errore può verificarsi quando lo script di destinazione restituisce un tipo non valido (non tabella, binario o Null) o quando la risoluzione dell'origine dati non riesce a causa di più o zero origini dati a cui viene fatto riferimento nella query di destinazione o a un tipo di risorsa non valido. Una limitazione nota consiste nell'usare più tipi di risorse in una singola query di destinazione, ad esempio una query di destinazione warehouse che include un filtro dei passaggi con un parametro i cui valori provengono da una Lakehouse. |
| MultipleDestinationQueries | Sono state trovate più query di destinazione quando ne è prevista una sola. Questa convalida esiste perché il contratto interno supporta una matrice di destinazioni, ma l'esperienza di creazione standard consente solo di configurare una singola destinazione per ogni query. Questo errore può verificarsi quando si modificano le definizioni del flusso di dati direttamente tramite CI/CD. |
| UnknownError | Si è verificato un errore sconosciuto durante la convalida, in genere causato da problemi di rete o errori del servizio. Questo errore non viene visualizzato nell'interfaccia utente e genera un errore invisibile all'utente. |
Risoluzione degli errori di convalida
Quando si verifica un errore di convalida, usare le indicazioni seguenti per risolvere il problema.
DestinationQueryNotFound e DestinationTransformQueryNotFound
Questi errori indicano che mancano le query di destinazione interne. Per risolvere:
- Aprire il flusso di dati nell'editor di Power Query.
- Rimuovere la destinazione dati esistente dalla query interessata.
- Riconfigurare la destinazione dati selezionando Aggiungi destinazione dati dalla barra multifunzione o dalle impostazioni di query.
- Pubblicare di nuovo il flusso di dati.
DestinationQueryChallenge
Questo errore indica in genere un problema di autenticazione. Per risolvere:
- Verificare che le credenziali di connessione siano ancora valide.
- Verificare di disporre delle autorizzazioni appropriate per la destinazione.
- Provare a modificare la connessione e ripetere l'autenticazione.
- Se si utilizza un principale del servizio, verificare che le credenziali non siano scadute.
DestinationQueryException
Questo errore indica che si è verificata un'eccezione imprevista. Per risolvere:
- Controllare lo stato del servizio di destinazione per assicurarsi che sia disponibile.
- Verificare che la tabella di destinazione o il percorso del file esista ancora.
- Esaminare le modifiche recenti apportate allo schema o alle autorizzazioni di destinazione.
- Provare a rimuovere e riconfigurare la destinazione dati.
DestinationQueryHasUnsupportedScript
L'errore può essere determinato da numerose cause. Per risolvere:
- Tipo restituito non valido: verificare che la query di destinazione restituisca una tabella, un valore binario o Null. Funzioni, elenchi e altri tipi non sono supportati come destinazioni.
- Nessuna origine dati: verificare che la query di destinazione disponga di un riferimento valido all'origine dati.
- Più tipi di risorse: evitare di combinare tipi di risorse diversi in una singola query di destinazione. Ad esempio, non usare una query di destinazione warehouse che filtra usando un parametro i cui valori provengono da un Lakehouse. Usare invece le risorse dello stesso tipo o ristrutturare il flusso di dati.
MultipleDestinationQueries
Questo errore si verifica quando una query dispone di più configurazioni di destinazione, che possono verificarsi durante la modifica delle definizioni del flusso di dati direttamente tramite CI/CD. L'esperienza di creazione standard consente solo una destinazione per ogni query. Per risolvere:
- Esaminare la definizione del flusso di dati per identificare le query con più destinazioni configurate.
- Rimuovere le configurazioni di destinazione duplicate dalla definizione.
- Se è necessario caricare i dati in più destinazioni, creare query separate per ogni destinazione.
Errore sconosciuto
Poiché questo errore non viene visualizzato nell'interfaccia utente, è possibile notare che si tratta di un errore di aggiornamento invisibile all'utente. Per risolvere il problema:
- Controllare la cronologia degli aggiornamenti per eventuali dettagli aggiuntivi sull'errore.
- Provare a rimuovere e riconfigurare la destinazione dati.
- Se il problema persiste, valutare la possibilità di ricreare il flusso di dati.
Migliori pratiche per le destinazioni dei dati
Per evitare errori di convalida e garantire un caricamento affidabile dei dati:
- Testare regolarmente le connessioni: verificare periodicamente che le connessioni di destinazione funzionino e che le credenziali siano valide.
- Usare le impostazioni gestite: quando possibile, usare le impostazioni automatiche per le nuove tabelle per consentire a Dataflow Gen2 di gestire automaticamente il mapping.
- Monitorare la cronologia degli aggiornamenti: controllare regolarmente la cronologia degli aggiornamenti del flusso di dati per rilevare eventuali problemi in anticipo.
- Documentare i flussi di dati: tenere traccia delle query caricate nelle destinazioni per semplificare la risoluzione dei problemi.