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

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

In questo articolo viene illustrato come risolvere i problemi dei connettori in Azure Data Factory e Azure Synapse Analytics.

Problemi specifici dei connettori

È possibile fare riferimento alle pagine di risoluzione dei problemi di ogni connettore per esaminare i problemi specifici ad esso correlati, con le relative spiegazioni delle cause e i consigli per risolverli.

• Archiviazione BLOB di Azure
• Azure Cosmos DB (incluso il connettore di Azure Cosmos DB for NoSQL)
• Azure Data Lake (Gen1 e Gen2)
• Database di Azure per PostgreSQL
• Archiviazione di File di Azure
• Azure Synapse Analytics, Database SQL di Azure e SQL Server
• DB2
• Formato di testo delimitato
• Dynamics 365, Dataverse (Common Data Service) e Dynamics CRM
• FTP, SFTP e HTTP
• Hive
• Oracle
• Formato ORC
• Formato Parquet
• REST
• Salesforce e Salesforce Service Cloud
• Elenco di SharePoint Online
• Formato XML

Errori generali dell'attività Copy

I seguenti sono errori generali dell'attività Copy e possono verificarsi con qualsiasi connettore.

Codice errore: 2200

• Messaggio: The underlying connection was closed: An unexpected error occurred on a send.

• Causa: indica in genere un errore di autenticazione durante le operazioni di trasferimento dei dati. Ciò può verificarsi quando la parte remota chiude il flusso di trasporto.

• Reccomendation:

  • Verificare la connessione di origine e testarla per assicurarsi che funzioni correttamente.
  • Controllare il metodo di autenticazione usato per la connessione.
  • Esaminare le impostazioni di configurazione del firewall per Azure Cosmos DB per assicurarsi che consentano il traffico necessario.

Codice errore: 20000

• 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 particolari.

• Raccomandazione: per controllare l'ambiente del runtime di integrazione, vedere Usare il runtime di integrazione self-hosted.

Codice errore: 20002

• Messaggio: An error occurred when invoking Java Native Interface.

• Causa: se il messaggio di errore riporta "Impossibile creare JVM: codice restituito JNI [-6][chiamata JNI non riuscita: argomenti non validi.]", la causa probabile è che non sia possibile creare JVM perché sono impostati alcuni argomenti illegali (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: 20020

• Messaggio: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

• Causa: il set di dati del sink non supporta i caratteri jolly.

• Raccomandazione: controllare il set di dati del sink e riscrivere il percorso senza usare un valore con caratteri jolly.

Problema FIPS

• Sintomi: l'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 potrebbe verificarsi quando si copiano i 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à Copy vengono bloccate in alcuni scenari.

• Risoluzione: informazioni sul motivo per cui non è più consigliata la "Modalità FIPS" e sulla valutazione dell’opportunità di disabilitare la modalità FIPS nel computer del runtime di integrazione self-hosted.

  In alternativa, se si vuole solo aggirare FIPS e fare in modo che le esecuzioni delle 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:\File di programma\Microsoft Integration Runtime< versione IR>\Condiviso.

  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: 20150

• 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: 20151

• Messaggio: Failed to get access token from your token endpoint. Error message: %errorMessage;.

• Causa: le impostazioni del flusso di credenziali client OAuth2 non sono valide.

• Raccomandazione: correggere tutte le impostazioni del flusso di credenziali client OAuth2 del server di autorizzazione.

Codice errore: 20152

• Messaggio: The token 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: 20153

• Messaggio: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

• Causa: l'ID client include il carattere due punti non valido (:).

• Raccomandazione: usare un ID client valido.

Codice errore: 20523

• 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: 20551

• Messaggio: The format settings are missing in dataset %dataSetName;.

• Causa: il tipo di set di dati è Binario, 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 disponibili nel set di dati.

• Raccomandazione: deselezionare la "copia binaria" nel set di dati e impostare il formato corretto.

Codice errore: 20552

• 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: 20701

• Messaggio: Failed to retrieve source file ('%name;') metadata to validate data consistency.

• Causa: si è verificato un problema temporaneo nell'archivio di dati del sink, oppure il recupero dei metadati dall'archivio di dati del sink non è consentito.

Codice errore: 20703

• Messaggio: Failed to retrieve sink file ('%name;') metadata to validate data consistency.

• Causa: si è verificato un problema temporaneo nell'archivio di dati del sink, oppure il recupero dei metadati dall'archivio di dati del sink non è consentito.

Codice errore: 20704

• 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à Copy.

Codice errore: 20705

• 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à Copy.

Codice errore: 20741

• 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à Copy.

Codice errore: 20742

• 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à Copy.

Codice errore: 20743

• 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à Copy.

Codice errore: 20744

• Messaggio: Skip forbidden file is not supported for this connector: ('%connectorName;').

• Raccomandazione: rimuovere "fileForbidden" dell'impostazione skipErrorFile nel payload dell'attività Copy.

Codice errore: 20745

• 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à Copy.

Codice errore: 20746

• Messaggio: Skip invalid file name is not supported for '%connectorName;' source.

• Raccomandazione: rimuovere ''invalidFileName'' dell'impostazione skipErrorFile nel payload dell'attività Copy.

Codice errore: 20747

• Messaggio: Skip invalid file name is not supported for '%connectorName;' sink.

• Raccomandazione: rimuovere ''invalidFileName'' dell'impostazione skipErrorFile nel payload dell'attività Copy.

Codice errore: 20748

• 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à Copy.

Codice errore: 20771

• 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: 20772

• Messaggio: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

• Raccomandazione: rimuovere l'impostazione ''deleteFilesAfterCompletion'' nel payload dell'attività Copy.

Codice errore: 27002

• 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: 9611

• Messaggio: The following ODBC Query is not valid: '%'.

• Causa: è stata fornita una query errata o non valida per recuperare i dati/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 restituiscono un risultato fittizio per eseguire gli script non correlati alle query.

Codice errore: 11775

• Messaggio: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

• Causa: la causa esatta dipende dal testo restituito in '%'. Se si tratta di Timeout dell’operazione, può essere dovuto all'arresto dell'istanza di PostgreSQL o al fatto che il metodo di connettività di rete configurato per l'istanza non consente le connessioni dal runtime di integrazione selezionato. L'utente o la password specificati non sono corretti. Se si tratta di 28P01: l'autenticazione della password non è riuscita per l'utente <youruser>, significa che l'utente specificato non esiste nell'istanza o che la password non è corretta. Se si tratta di 28000: nessuna voce pg_hba.conf per l'host "###.###.###.###", l’utente "<youruser>", il database "<yourdatabase>", nessuna crittografia, significa che il metodo di crittografia selezionato non è compatibile con la configurazione del server.

• Raccomandazione: verificare che l'utente specificato esista nell'istanza di PostgreSQL e che la password corrisponda a quella attualmente assegnata all'utente. Assicurarsi che il metodo di crittografia selezionato sia accettato dall'istanza di PostgreSQL, in base alla sua configurazione corrente. Se il metodo di connettività di rete dell'istanza è configurato per l'accesso privato (integrazione rete virtuale), utilizzare un runtime di integrazione self-hosted per connettersi. Se è configurato per l'accesso pubblico (indirizzi IP consentiti), è consigliabile usare un runtime di integrazione di Azure (Azure Integration Runtime) con rete virtuale gestita e distribuire un endpoint privato gestito per connettersi all'istanza. Quando è configurato per l'accesso pubblico (indirizzi IP consentiti), un'alternativa meno consigliata consiste nel creare regole di firewall nell'istanza per consentire il traffico proveniente dagli indirizzi IP utilizzato dal runtime di integrazione di Azure (Azure Integration Runtime) in uso.

Contenuto correlato

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

• Blog di Data Factory
• Richieste di funzionalità di Data Factory
• Video di Azure
• Pagina Microsoft Q&A
• Forum Stack Overflow per Data Factory
• Informazioni su X su Data Factory