Risolvere i problemi relativi ai connettori di Azure Data Factory e Azure Synapse Analytics

Articolo
12/09/2023

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .

Questo articolo descrive come risolvere i problemi dei connettori in Azure Data Factory e Azure Synapse Analytics.

Connessione or problemi specifici

È possibile fare riferimento alle pagine di risoluzione dei problemi per ogni connettore per visualizzare problemi specifici con spiegazioni delle relative cause e raccomandazioni per risolverli.

Errori generali dell'attività di copia

Gli errori seguenti sono generali per l'attività di copia e possono verificarsi con qualsiasi connettore.

Codice errore: JreNotFound

Messaggio: Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.
Causa: il runtime di integrazione self-hosted non riesce a trovare Java Runtime. Java Runtime è necessario per la lettura di origini specifiche.
Raccomandazione: controllare l'ambiente del runtime di integrazione, vedere Usare il runtime di integrazione self-hosted.

Codice errore: WildcardPathSinkNotSupported

Messaggio: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Causa: il set di dati sink non supporta i valori jolly.
Raccomandazione: controllare il set di dati sink e riscrivere il percorso senza usare un valore con caratteri jolly.

Problema FIPS

Sintomi: attività Copy non riesce in un computer del runtime di integrazione self-hosted abilitato per FIPS con il messaggio di errore seguente:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Causa: questo errore può verificarsi quando si copiano dati con connettori come BLOB di Azure, SFTP e così via. Federal Information Processing Standards (FIPS) definisce un determinato set di algoritmi crittografici che possono essere usati. Quando la modalità FIPS è abilitata nel computer, alcune classi crittografiche da cui dipende l'attività di copia vengono bloccate in alcuni scenari.
Soluzione: informazioni sul motivo per cui non è più consigliabile "modalità FIPS" e valutare se è possibile disabilitare FIPS nel computer del runtime di integrazione self-hosted.

In alternativa, se si vuole ignorare solo FIPS e fare in modo che le esecuzioni di attività abbiano esito positivo, eseguire le operazioni seguenti:
1. Aprire la cartella in cui è installato il runtime di integrazione self-hosted. Il percorso è in genere C:\Programmi\Microsoft Integration Runtime <IR version>\Shared.
2. Aprire il file diawp.exe.config e quindi, alla fine della <runtime> sezione, aggiungere <enforceFIPSPolicy enabled="false"/>, come illustrato di seguito:
3. Salvare il file e quindi riavviare il computer del runtime di integrazione self-hosted.

Codice errore: JniException

Messaggio: An error occurred when invoking Java Native Interface.
Causa: se il messaggio di errore contiene "Impossibile creare JVM: codice restituito JNI [-6][chiamata JNI non riuscita: argomenti non validi.]", la causa possibile è che non è possibile creare JVM perché sono impostati alcuni argomenti non validi (globali).
Raccomandazione: accedere al computer che ospita ogni nodo del runtime di integrazione self-hosted. Verificare che la variabile di sistema sia impostata correttamente, come indicato di seguito: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Riavviare tutti i nodi del runtime di integrazione e quindi eseguire di nuovo la pipeline.

Codice errore: GetOAuth2AccessTokenErrorResponse

Messaggio: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Causa: l'ID client o il segreto client non è valido e l'autenticazione non è riuscita nel server di autorizzazione.
Raccomandazione: correggere tutte le impostazioni del flusso di credenziali client OAuth2 del server di autorizzazione.

Codice errore: FailedToGetOAuth2AccessToken

Messaggio: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Causa: le impostazioni del flusso delle credenziali client OAuth2 non sono valide.
Raccomandazione: correggere tutte le impostazioni del flusso di credenziali client OAuth2 del server di autorizzazione.

Codice errore: OAuth2AccessTokenTypeNotSupported

Messaggio: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Causa: il server di autorizzazione non è supportato.
Raccomandazione: usare un server di autorizzazione in grado di restituire token con tipi di token supportati.

Codice errore: OAuth2ClientIdColonNotAllowed

Messaggio: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Causa: l'ID client include i due punti di carattere non validi (:).
Raccomandazione: usare un ID client valido.

Codice errore: ManagedIdentityCredentialObjectNotSupported

Messaggio: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Raccomandazione: controllare la versione supportata e aggiornare il runtime di integrazione a una versione successiva.

Codice errore: QueryMissingFormat Impostazioni InDataset

Messaggio: The format settings are missing in dataset %dataSetName;.
Causa: il tipo di set di dati è Binary, che non è supportato.
Raccomandazione: usare invece il set di dati DelimitedText, Json, Avro, Orc o Parquet.
Causa: per l'archiviazione file, le impostazioni di formato non sono presenti nel set di dati.
Raccomandazione: deselezionare "Copia binaria" nel set di dati e impostare le impostazioni di formato corrette.

Codice errore: QueryUnsupportedCommandBehavior

Messaggio: The command behavior "%behavior;" is not supported.
Raccomandazione: non aggiungere il comportamento del comando come parametro per l'ANTEPRIMA o l'URL della richiesta API GetSchema.

Codice errore: DataConsistencyFailedToGetSourceFileMetadata

Messaggio: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Causa: si verifica un problema temporaneo nell'archivio dati sink o il recupero di metadati dall'archivio dati sink non è consentito.

Codice errore: DataConsistencyFailedToGetSinkFileMetadata

Messaggio: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Causa: si verifica un problema temporaneo nell'archivio dati sink o il recupero di metadati dall'archivio dati sink non è consentito.

Codice errore: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Messaggio: Data consistency validation is not supported in current copy activity settings.
Causa: la convalida della coerenza dei dati è supportata solo nello scenario di copia binaria diretta.
Raccomandazione: rimuovere la proprietà 'validateDataConsistency' nel payload dell'attività di copia.

Codice errore: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Messaggio: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Raccomandazione: controllare la versione del runtime di integrazione supportata e aggiornarla a una versione successiva oppure rimuovere la proprietà "validateDataConsistency" dalle attività di copia.

Codice errore: SkipMissingFileNotSupportedForNonDirectBinaryCopy

Messaggio: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Raccomandazione: rimuovere 'fileMissing' dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Messaggio: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Raccomandazione: rimuovere "dataInconsistency" dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Messaggio: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Raccomandazione: rimuovere "fileForbidden" dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipForbiddenFileNotSupportedForThis Connessione or

Messaggio: Skip forbidden file is not supported for this connector: ('%connectorName;').
Raccomandazione: rimuovere "fileForbidden" dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Messaggio: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Raccomandazione: rimuovere 'invalidFileName' dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipInvalidFileNameNotSupportedForSource

Messaggio: Skip invalid file name is not supported for '%connectorName;' source.
Raccomandazione: rimuovere 'invalidFileName' dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipInvalidFileNameNotSupportedForSink

Messaggio: Skip invalid file name is not supported for '%connectorName;' sink.
Raccomandazione: rimuovere 'invalidFileName' dell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: SkipAllErrorFileNotSupportedForNonBinaryCopy

Messaggio: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Raccomandazione: rimuovere 'allErrorFile' nell'impostazione skipErrorFile nel payload dell'attività di copia.

Codice errore: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Messaggio: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Raccomandazione: rimuovere l'impostazione 'deleteFilesAfterCompletion' o usare la copia binaria diretta.

Codice errore: DeleteFilesAfterCompletionNotSupportedForThis Connessione or

Messaggio: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Raccomandazione: rimuovere l'impostazione 'deleteFilesAfterCompletion' nel payload dell'attività di copia.

Codice errore: FailedToDownloadCustomPlugins

Messaggio: Failed to download custom plugins.
Causa: collegamenti di download non validi o problemi di connettività temporanei.
Raccomandazione: riprovare se il messaggio indica che si tratta di un problema temporaneo. Se il problema persiste, contattare il team di supporto.

Errori generali del connettore

Codice errore: UserErrorOdbcInvalidQueryString

Messaggio: The following ODBC Query is not valid: '%'.
Causa: si specifica una query errata o non valida per recuperare i dati o gli schemi.
Raccomandazione: verificare che la query sia valida e possa restituire dati/schemi. Usare l'attività Script se si desidera eseguire script non di query e l'archivio dati è supportato. In alternativa, prendere in considerazione l'uso di stored procedure che restituisce un risultato fittizio per eseguire gli script non di query.

Codice errore: FailToResolveParametersInExploratoryController

Messaggio: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Causa: il servizio presenta limitazioni per supportare il servizio collegato che fa riferimento a un altro servizio collegato con parametri per la connessione di test o i dati di anteprima. Ad esempio, il passaggio di un parametro da un insieme di credenziali delle chiavi a un servizio collegato può verificarsi il problema.
Raccomandazione: rimuovere i parametri nel servizio collegato di riferimento per eliminare l'errore. In caso contrario, eseguire la pipeline senza testare la connessione o visualizzare in anteprima i dati.

Per altre informazioni sulla risoluzione dei problemi, usare le risorse seguenti: