Resolver problemas de conectores do Azure Data Factory e do Azure Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Data Factory em Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA incorporada e novas funcionalidades. Se és novo na integração de dados, começa pelo Fabric Data Factory. As cargas de trabalho existentes do ADF podem atualizar para o Fabric para aceder a novas capacidades em ciência de dados, análise em tempo real e relatórios.

Este artigo descreve como resolver problemas com conectores no Azure Data Factory e no Azure Synapse Analytics. Se não vir a sua mensagem de erro específica listada aqui, pode seguir estes passos:

Verifique a mensagem de erro completa. Algumas mensagens de erro fornecem orientação para resolver o problema.
Verifique a página de solução de problemas do conector para obter mais detalhes.
Abra um ticket 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 os problemas específicos com explicações sobre suas 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 as operações de transferência de dados. Isso pode ocorrer quando a parte remota fecha o fluxo de transporte.
Recomendação:
- Verifica a ligação de origem e testa para garantir que está a funcionar corretamente.
- Verifique o método de autenticação usado para a conexão.
- Revise as definições de configuração do firewall para o Azure Cosmos DB para garantir que permitem 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 consegue encontrar Java Runtime. O Java Runtime é necessário para ler fontes específicas.
Recomendação: Verifique o seu ambiente de tempo de execução de integração, consulte Utilizar Tempo de Execução de Integração Autogerido.

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: Inicie sessão na máquina que hospeda cada nó do seu runtime de integração autogerido. Verifique se a variável de sistema está definida corretamente, da seguinte forma: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Reinicie todos os nós do runtime de integração e volte a executar o pipeline.

Código de erro: 20020 - WildcardPathSinkNãoSuportado

Mensagem: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Causa: o conjunto de dados de destino não oferece suporte a valores curinga.
Recomendação: Verifique o conjunto de dados do coletor e reescreva o caminho sem usar um valor curinga.

Problema de FIPS

Symptoms: atividade Copy falha numa máquina IR auto-hospedada, ativada com FIPS, com a seguinte mensagem de erro: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Causa: O modo FIPS bloqueia certas classes criptográficas das quais a atividade de cópia depende. Para uma explicação completa da causa e do contexto, veja problema FIPS em Solucionar problemas de conectores com Data Factory no Fabric.
Resolução: saiba por que não estamos mais recomendando o "Modo FIPS" e avalie se você pode desativar o FIPS em sua máquina de IR auto-hospedada.

Para contornar o FIPS e fazer com que as execuções de atividades tenham sucesso num runtime de integração auto-hospedado, siga os seguintes passos:
1. Abra a pasta onde o IR auto-hospedado está instalado. O caminho é normalmente C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.
2. Abra o arquivo diawp.exe.config e, no final da <runtime> seção, adicione <enforceFIPSPolicy enabled="false"/>, conforme mostrado aqui:
3. Salve o arquivo e, em seguida, reinicie a máquina IR auto-hospedada.
Se usar um gateway de dados local em vez de um IR auto-hospedado, consulte a questão FIPS para passos específicos do gateway.

Código de erro: 20150 - GetOAuth2AccessTokenErrorResponse

Mensagem: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Causa: O 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 seu servidor de autorização.

Código de erro: 20151 - Falha ao Obter o Token de Acesso OAuth2

Mensagem: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Causa: as configurações de fluxo de credenciais do cliente OAuth2 são inválidas.
Recomendação: corrija todas as configurações de fluxo de credenciais do cliente OAuth2 do seu 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 é suportado.
Recomendação: Use um servidor de autorização que possa retornar tokens com tipos de token suportados.

Código de erro: 20153 - OAuth2ClientIdColonNotAllowed

Mensagem: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Causa: O ID do cliente inclui os dois pontos de caracteres inválidos (:).
Recomendação: Use um ID de cliente válido.

Código de erro: 20523 - ManagedIdentityCredentialObjectNãoSuportado

Mensagem: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recomendação: Verifique a versão suportada e atualize o tempo de execução da integração para uma versão superior.

Código de erro: 20551 - QueryMissingFormatSettingsInDataset

Mensagem: The format settings are missing in dataset %dataSetName;.
Causa: o tipo de conjunto de dados é binário, o que não é suportado.
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 conjunto de dados.
Recomendação: Desmarque a opção "Cópia binária" no conjunto de dados e defina 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 de API GetSchema.

Código de erro: 20701 - Falha na Consistência dos Dados ao Obter Metadados do Arquivo Fonte

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 - Falha de Consistência de Dados ao Obter Metadados do Arquivo de Destino

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 - Validação de Consistência de Dados Não Suportada para Cópia Binária Não Direta (DataConsistencyValidationNotSupportedForNonDirectBinaryCopy)

Mensagem: Data consistency validation is not supported in current copy activity settings.
Causa: A validação da consistência de dados só é suportada no cenário de cópia binária direta.
Recomendação: Remova a propriedade 'validateDataConsistency' na carga útil da atividade de cópia.

Código de erro: 20705 - Validação de Consistência de Dados Não Suportada para Integração Local de Versão Baixa Runtime

Mensagem: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recomendação: Verifique a versão de tempo de execução de integração suportada e atualize-a para uma versão superior, ou remova a propriedade 'validateDataConsistency' das atividades de cópia.

Código de erro: 20741 - Omissão de ficheiros ausentes não é suportada para cópia binária não direta

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 de skipErrorFile na carga útil da atividade de cópia.

Código de erro: 20742 - IgnorarDadosInconsistênciaNãoSuportadoParaCópiaBináriaNãoDireta

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 payload da atividade de cópia.

Código de erro: 20743 - Skipping arquivos proibidos não é suportado para cópia binária não direta

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 na carga útil da atividade de cópia.

Código de erro: 20744 - O ficheiro proibido a saltar não é suportado para este conector

Mensagem: Skip forbidden file is not supported for this connector: ('%connectorName;').
Recomendação: Remova 'fileForbidden' da configuração skipErrorFile na carga útil da atividade de cópia.

Código de erro: 20745 - IgnorarNomeDeFicheiroInválidoNãoSuportadoParaCópiaBináriaNãoDireta

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 definição skipErrorFile na carga útil da atividade de cópia.

Código de erro: 20746 - IgnorarNomeDeFicheiroInválidoNãoSuportadoParaFonte

Mensagem: Skip invalid file name is not supported for '%connectorName;' source.
Recomendação: Remova 'invalidFileName' da definição skipErrorFile na carga útil 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 definição skipErrorFile na carga útil da atividade de cópia.

Código de erro: 20748 - SkipAllErroArquivoNãoSuportadoParaCópiaNãoBinária

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' na configuração skipErrorFile na carga útil da atividade de cópia.

Código de erro: 20771 - Eliminação de arquivos após conclusão não suportada para cópia binária não direta

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 cópia binária direta.

Código de erro: 20772 - A eliminação de ficheiros após a conclusão não é suportada para este conector

Mensagem: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Recomendação: Remova a configuração 'deleteFilesAfterCompletion' no pacote de dados da atividade de cópia.

Código de erro: 27002 - Falha ao Transferir Plugins Personalizados

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, entre em contato com 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 errada ou inválida para buscar os dados/esquemas.
Recomendação: Verifique se sua consulta é válida e pode retornar dados/esquemas. Use a atividade de Script se quiser executar scripts de consulta não e se o seu armazenamento de dados for compatível. Como alternativa, considere usar o procedimento armazenado que retorna um resultado fictício para executar seus scripts sem consulta.

Código de erro: 11775

Mensagem: Failed to connect to your instance of Base de Dados do Azure para PostgreSQL flexible server. '%'
Causa: a causa exata depende do texto retornado em '%'. Se for A operação já expirou, pode ser porque a instância do PostgreSQL está parada ou porque o método de conectividade de rede configurado para a sua instância não permite ligações a partir do Integration Runtime selecionado. O usuário ou a senha fornecidos estão incorretos. Se for 28P01: falha na autenticação de senha 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 "<youruser>", banco de dados "<yourdatabase>", 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 à atualmente atribuída a esse usuário. Certifique-se de que o método de criptografia selecionado é aceito por sua instância do PostgreSQL, com base em sua configuração atual. Se o método de conectividade de rede da sua instância estiver configurado para acesso privado (integração de rede virtual), use um Self-Hosted Integration Runtime (IR) para se ligar a ele. Se estiver configurado para acesso público (endereços IP permitidos), recomenda-se usar um Azure IR com rede virtual gerida e implementar um endpoint privado gerido para se ligar à sua instância. Quando está configurado para acesso público (endereços IP permitidos), uma alternativa menos recomendada consiste em criar regras de firewall na sua instância para permitir que o tráfego se origine nos endereços IP usados pelo Azure IR que está a usar.

O meu erro não está aqui

Se não vir a sua mensagem de erro específica listada aqui, pode ser um erro específico do conector, por isso siga estes passos:

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

Para obter mais ajuda na solução de problemas, tente estes recursos:

Comentários

Esta página foi útil?

Last updated on 2026-06-17