Compartilhar via

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

  • Artigo

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.

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 da atividade Copy

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

Código de erro: 2200

  • 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

  • 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 a origem específica.

  • Recomendação: verifique seu ambiente de tempo de execução de integração, consulte Usar Integration Runtime de hospedagem interna.

Código de erro: 20002

  • 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: entre no computador que hospeda cada nó do runtime de integração auto-hospedada. 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

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

      Captura de tela de uma seção do arquivo diawp.exe.config mostrando FIPS desativado.

    3. Salve o arquivo e reinicie a máquina IR autohospedadohospedada.

Código de erro: 20150

  • 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

  • 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

  • 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

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

  • Causa: seu ID de cliente inclui o caractere inválido dois pontos (:).

  • Recomendação: use uma ID de cliente válida.

Código de erro: 20523

  • 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

  • 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 conjuntos 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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 conteúdo da atividade de cópia.

Código de erro: 20744

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

  • Recomendação: remova "fileForbidden" da configuração skipErrorFile no conteúdo da atividade de cópia.

Código de erro: 20745

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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

  • 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 nonquery e o 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 "<youruser>", banco de dados "<yourdatabase>", sem criptografia, 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 IR (Auto-Hospedado Integration Runtime) para se conectar a ela. Se ele estiver configurado para acesso público (endereços IP permitidos), é recomendável usar um Azure Integration Runtime 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.

Conteúdo relacionado

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