Solucionar problemas de conectores no Azure Data Factory e no Azure Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!

Este artigo descreve como solucionar problemas dos conectores no Azure Data Factory e no Azure Synapse Analytics. Se você não vir sua mensagem de erro específica listada aqui, poderá seguir estas etapas:

Verifique a mensagem de erro completa. Algumas mensagens de erro fornecem diretrizes para resolver o problema.
Verifique a página de solução de problemas do conector para obter mais detalhes.
Abra um tíquete com suporte para solucionar o problema.

Problemas específicos do conector

Você pode consultar as páginas de solução de problemas de cada conector para ver problemas específicos, com explicações sobre as causas e recomendações para resolvê-los.

Erros gerais de atividade de cópia

Os erros a seguir são gerais para a atividade de cópia e podem ocorrer com qualquer conector.

Código de erro: 2200 – UserErrorOdbcOperationFailed

Mensagem: The underlying connection was closed: An unexpected error occurred on a send.
Causa: isso normalmente indica uma falha de autenticação durante operações de transferência de dados. Isso pode ocorrer quando a parte remota fecha o fluxo de transporte.
Recomendação:
- Verifique a conexão de origem e teste-a para garantir que ela esteja funcionando corretamente.
- Verifique o método de autenticação usado para a conexão.
- Examine as configurações de firewall do Azure Cosmos DB para garantir que elas permitam o tráfego necessário.

Código de erro: 20000 – JreNotFound

Mensagem: 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: o IR auto-hospedado não pode localizar o Java Runtime. O Java Runtime é necessário para ler determinadas fontes.
Recomendação: verifique seu ambiente de runtime de integração, consulte Usar Runtime de integração auto-hospedada.

Código de erro: 20002 - JniException

Mensagem: An error occurred when invoking Java Native Interface.
Causa: se a mensagem de erro contiver "Não é possível criar JVM: código de retorno JNI [-6][falha na chamada JNI: argumentos inválidos.]", a causa possível é que a JVM não pode ser criada porque alguns argumentos ilegais (globais) estão definidos.
Recomendação: Conecte-se ao computador que hospeda cada nó do runtime de integração hospedado por você mesmo. Verifique se a variável do sistema está definida corretamente, da seguinte maneira: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Reinicie todos os nós de runtime de integração e execute novamente o pipeline.

Código de erro: 20020 – WildcardPathSinkNotSupported

Mensagem: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Causa: o conjunto de coleta não dá suporte a valores curinga.
Recomendação: verifique o conjunto de dados do coletor e corrija o caminho sem o valor de curinga.

Problema de FIPS

Sintomas: a atividade de cópia falha em uma máquina do IR auto-hospedado habilitada para FIPS com a seguinte mensagem de erro: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Causa: esse erro pode ocorrer quando você copia dados com conectores como blob do Azure, SFTP e assim por diante. O FIPS (Federal Information Processing Standards) define um determinado conjunto de algoritmos de criptografia que podem ser usados. Quando o modo FIPS está habilitado na máquina, algumas classes criptográficas das quais a atividade de cópia depende são bloqueadas em alguns cenários.
Resolução: saiba por que não recomendamos mais o "Modo FIPS" e avalie se você pode desabilitar o FIPS em seu computador IR auto-hospedado.

Como alternativa, se você quiser ignorar apenas o FIPS e fazer com que a atividade seja executada com êxito, execute as seguintes etapas:
1. Abra a pasta na qual o IR auto-hospedado está instalado. O caminho geralmente é C:\Arquivos de programas\Microsoft Integration Runtime<IR version>\Shared.
2. Abra o arquivo diawp.exe.config e, no final da seção <runtime>, adicione <enforceFIPSPolicy enabled="false"/>, conforme mostrado aqui:
3. Salve o arquivo e, em seguida, reinicie a máquina IR autohospedada.

Código de erro: 20150 - GetOAuth2AccessTokenErrorResponse

Mensagem: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Causa: a ID do cliente ou o segredo do cliente é inválido e a autenticação falhou no servidor de autorização.
Recomendação: corrija todas as configurações de fluxo de credenciais do cliente OAuth2 do servidor de autorização.

Código de erro: 20151 – FailedToGetOAuth2AccessToken

Mensagem: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Causa: as configurações de fluxo de credencial do cliente OAuth2 são inválidas.
Recomendação: corrija todas as configurações de fluxo de credenciais do cliente OAuth2 do servidor de autorização.

Código de erro: 20152 – Tipo de Token de Acesso OAuth2 Não Suportado

Mensagem: The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Causa: o servidor de autorização não tem suporte.
Recomendação: use um servidor de autorização que possa retornar tokens com os tipos de token com suporte.

Código de erro: 20153 – OAuth2ClientIdColonNotAllowed

Mensagem: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Causa: sua ID de cliente inclui o caractere inválido dois pontos (:).
Recomendação: use uma ID de cliente válida.

Código de erro: 20523 – ManagedIdentityCredentialObjectNotSupported (Objeto de Credencial de Identidade Gerenciado não suportado)

Mensagem: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recomendação: verifique a versão com suporte e atualize o runtime de integração para uma versão superior.

Código de erro: 20551 - Configurações de formato ausentes na consulta do conjunto de dados (QueryMissingFormatSettingsInDataset)

Mensagem: The format settings are missing in dataset %dataSetName;.
Causa: o tipo de conjunto de dados é Binário, que não tem suporte.
Recomendação: use o conjunto de dados DelimitedText, JSON, Avro, Orc ou Parquet.
Causa: para o armazenamento de arquivos, as configurações de formato estão ausentes no conjuntos de dados.
Recomendação: desmarque a "Cópia binária" no conjunto de dados e marque as configurações de formato corretas.

Código de erro: 20552 – QueryUnsupportedCommandBehavior

Mensagem: The command behavior "%behavior;" is not supported.
Recomendação: não adicione o comportamento do comando como um parâmetro para visualização ou URL de solicitação da API GetSchema.

Código de erro: 20701 – DataConsistencyFailedToGetSourceFileMetadata

Mensagem: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Causa: há um problema transitório no armazenamento de dados do coletor ou a recuperação de metadados do armazenamento de dados do coletor não é permitida.

Código de erro: 20703 – DataConsistencyFailedToGetSinkFileMetadata

Mensagem: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Causa: há um problema transitório no armazenamento de dados do coletor ou a recuperação de metadados do armazenamento de dados do coletor não é permitida.

Código de erro: 20704 – DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Mensagem: Data consistency validation is not supported in current copy activity settings.
Causa: a validação de consistência de dados só tem suporte no cenário de cópia binária direta.
Recomendação: remova a propriedade "validateDataConsistency" no conteúdo da atividade de cópia.

Código de erro: 20705 – DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Mensagem: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recomendação: verifique a versão do runtime de integração com suporte e atualize-a para uma versão superior ou remova a propriedade "validateDataConsistency" das atividades de cópia.

Código de erro: 20741 – SkipMissingFileNotSupportedForNonDirectBinaryCopy

Mensagem: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recomendação: remova "fileMissing" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20742 – SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Mensagem: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Recomendação: remova "dataInconsistency" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20743 – SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Mensagem: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recomendação: remova "fileForbidden" da configuração skipErrorFile no payload da atividade de cópia.

Código de erro: 20744 – SkipForbiddenFileNotSupportedForThisConnector

Mensagem: Skip forbidden file is not supported for this connector: ('%connectorName;').
Recomendação: remova "fileForbidden" da configuração skipErrorFile no payload da atividade de cópia.

Código de erro: 20745 – SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Mensagem: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recomendação: remova "invalidFileName" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20746 – SkipInvalidFileNameNotSupportedForSource

Mensagem: Skip invalid file name is not supported for '%connectorName;' source.
Recomendação: remova "invalidFileName" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20747 – SkipInvalidFileNameNotSupportedForSink

Mensagem: Skip invalid file name is not supported for '%connectorName;' sink.
Recomendação: remova "invalidFileName" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20748 – SkipAllErrorFileNotSupportedForNonBinaryCopy

Mensagem: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Recomendação: remova "allErrorFile" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20771 – DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Mensagem: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Recomendação: remova a configuração "deleteFilesAfterCompletion" ou use a cópia binária direta.

Código de erro: 20772 – DeleteFilesAfterCompletionNotSupportedForThisConnector

Mensagem: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Recomendação: remova a configuração "deleteFilesAfterCompletion" no conteúdo da atividade de cópia.

Código de erro: 27002 – FailedToDownloadCustomPlugins

Mensagem: Failed to download custom plugins.
Causa: links de download inválidos ou problemas transitórios de conectividade.
Recomendação: tente novamente se a mensagem mostrar que é um problema transitório. Se o problema persistir, contate a equipe de suporte.

Erros gerais do conector

Código de erro: 9611 – UserErrorOdbcInvalidQueryString

Mensagem: The following ODBC Query is not valid: '%'.
Causa: você fornece uma consulta incorreta ou inválida para buscar os dados e esquemas.
Recomendação: verifique se sua consulta é válida e pode retornar dados e esquemas. Use a Atividade Script se você quiser executar scripts que não sejam de consulta e seu armazenamento de dados tiver suporte. Como alternativa, considere usar o procedimento armazenado que retorna um resultado fictício para executar seus scripts nonquery.

Código de erro: 11775

Mensagem: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'
Causa: A causa exata depende do texto retornado em '%'. Se for O tempo limite da operação, pode ser porque a instância do PostgreSQL foi interrompida ou porque o método de conectividade de rede configurado para sua instância não permite conexões do Integration Runtime selecionado. O usuário ou a senha fornecida está incorreto. Se for 28P01: a autenticação de senha falhou para o usuário <youruser>, isso significa que o usuário fornecido não existe na instância ou que a senha está incorreta. Se for 28000: nenhuma entrada pg_hba.conf para o host "###.###.###.###", usuário "<seuusuario>", banco de dados "<seubanco>", sem criptografia, isso significa que o método de criptografia selecionado não é compatível com a configuração do servidor.
Recomendação: confirme se o usuário fornecido existe em sua instância do PostgreSQL e se a senha corresponde à atribuída atualmente a esse usuário. Verifique se o método de criptografia selecionado é aceito pela instância do PostgreSQL, de acordo com a sua configuração atual. Se o método de conectividade de rede da instância estiver configurado para acesso privado (integração de rede virtual), use um Runtime de Integração Auto-Hospedado (IR) para se conectar a ela. Se estiver configurado para acesso público (endereços IP permitidos), é recomendável usar um Azure IR com rede virtual gerenciada e implantar um ponto de extremidade privado gerenciado para se conectar à sua instância. Quando ele é configurado para acesso público (endereços IP permitidos), uma alternativa menos recomendada consiste na criação de regras de firewall em sua instância para permitir que o tráfego seja originado nos endereços IP usados pelo Azure Integration Runtime que você está usando.

Meu erro não está aqui

Se você não vir sua mensagem de erro específica listada aqui, pode ser um erro específico do conector, portanto, siga estas etapas:

Verifique a mensagem de erro completa. Algumas mensagens de erro fornecem diretrizes para resolver o problema.
Verifique a página de solução de problemas do conector para obter mais detalhes.
Abra um tíquete com suporte para solucionar o problema.

Para obter mais ajuda com a solução de problemas, experimente estes recursos:

Comentários

Esta página foi útil?

Last updated on 2025-07-21