Resolver problemas dos conectores do Azure Data Factory e do Azure Synapse Analytics
APLICA-SE A: Azure Data Factory Azure Synapse Analytics
Gorjeta
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!
Este artigo descreve como solucionar problemas de 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 os problemas específicos com explicações sobre suas causas e recomendações para resolvê-los.
- Armazenamento de Blobs do Azure
- Azure Cosmos DB (incluindo o conector do Azure Cosmos DB para NoSQL)
- Azure Data Lake (Gen1 e Gen2)
- Base de Dados do Azure para PostgreSQL
- Armazenamento de arquivos do Azure
- Azure Synapse Analytics, Banco de Dados SQL do Azure e SQL Server
- DB2
- Formato de texto delimitado
- 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
- Lista do SharePoint Online
- Formato XML
Erros gerais de atividade de cópia
Os erros abaixo são gerais para a atividade de cópia e podem ocorrer com qualquer conector.
Código de erro: 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 o Java Runtime. O Java Runtime é necessário para ler fontes específicas.
Recomendação: Verifique seu ambiente de tempo de execução de integração, consulte Usar o tempo de execução de integração auto-hospedado.
Código de erro: WildcardPathSinkNotSupported
Mensagem:
Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Causa: o conjunto de dados do coletor 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.
Emissão de FIPS
Sintomas: A atividade de cópia falha em uma máquina de IR auto-hospedada 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. As normas FIPS (Federal Information Processing Standards) definem um determinado conjunto de algoritmos criptográficos que podem ser utilizados. 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 estamos mais recomendando o "Modo FIPS" e avalie se você pode desativar o FIPS em sua máquina de IR auto-hospedada.
Como alternativa, se você quiser ignorar apenas o FIPS e fazer com que a execução da atividade seja bem-sucedida, faça o seguinte:
Abra a pasta onde o IR auto-hospedado está instalado. O caminho é geralmente C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.
Abra o arquivo diawp.exe.config e, no final da
<runtime>
seção, adicione<enforceFIPSPolicy enabled="false"/>
, conforme mostrado aqui:Salve o arquivo e, em seguida, reinicie a máquina IR auto-hospedada.
Código de erro: 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][JNI call failed: Invalid arguments.]", a causa possível é que a JVM não pode ser criada porque alguns argumentos ilegais (globais) estão definidos.
Recomendação: Faça login na máquina que hospeda cada nó do seu tempo de execução de integração auto-hospedado. 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 de tempo de execução de integração e execute novamente o pipeline.
Código de erro: 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: FailedToGetOAuth2AccessToken
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: OAuth2AccessTokenTypeNotSupported
Mensagem:
The toke 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: 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: ManagedIdentityCredentialObjectNotSupported
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: 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: 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: 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: 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: 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: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
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: 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 na carga útil da atividade de cópia.
Código de erro: 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 na carga útil da atividade de cópia.
Código de erro: 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 na carga útil da atividade de cópia.
Código de erro: SkipForbiddenFileNotSupportedForThisConnector
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: 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 na carga útil da atividade de cópia.
Código de erro: SkipInvalidFileNameNotSupportedForSource
Mensagem:
Skip invalid file name is not supported for '%connectorName;' source.
Recomendação: Remova 'invalidFileName' da configuração skipErrorFile na carga útil da atividade de cópia.
Código de erro: SkipInvalidFileNameNotSupportedForSink
Mensagem:
Skip invalid file name is not supported for '%connectorName;' sink.
Recomendação: Remova 'invalidFileName' da configuração skipErrorFile na carga útil da atividade de cópia.
Código de erro: 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' na configuração skipErrorFile na carga útil da atividade de cópia.
Código de erro: 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 cópia binária direta.
Código de erro: DeleteFilesAfterCompletionNotSupportedForThisConnector
Mensagem:
'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Recomendação: Remova a configuração 'deleteFilesAfterCompletion' na carga útil da atividade de cópia.
Código de erro: 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, entre em contato com a equipe de suporte.
Erros gerais do conector
Código de erro: 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 Script se quiser executar scripts que não sejam de consulta e seu armazenamento de dados for suportado. Como alternativa, considere usar o procedimento armazenado que retorna um resultado fictício para executar seus scripts que não sejam de consulta.
Código de erro: FailToResolveParametersInExploratoryController
Mensagem:
The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Causa: O serviço tem limitação para suportar o serviço vinculado que faz referência a outro serviço vinculado com parâmetros para conexão de teste ou visualização de dados. Por exemplo, passar um parâmetro de um Cofre de Chaves para um serviço vinculado pode ocorrer o problema.
Recomendação: Remova os parâmetros no serviço vinculado referido para eliminar o erro. Caso contrário, execute o pipeline sem testar a conexão ou visualizar dados.
Conteúdos relacionados
Para obter mais ajuda na solução de problemas, tente estes recursos: