Fluxos de dados de mapeamento de resolução de problemas na Azure Data FactoryTroubleshoot mapping data flows in Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo explora métodos comuns de resolução de problemas para mapear fluxos de dados na Azure Data Factory.This article explores common troubleshooting methods for mapping data flows in Azure Data Factory.

Códigos e mensagens de erro comunsCommon error codes and messages

Código de erro: DF-Executor-SourceInvalidPayloadError code: DF-Executor-SourceInvalidPayload

  • Mensagem: Pré-visualização de dados, depuragem e execução de fluxo de dados do gasoduto falhou porque o contentor não existeMessage: Data preview, debug, and pipeline data flow execution failed because container does not exist
  • Causa: Um conjunto de dados contém um recipiente que não existe no armazenamento.Cause: A dataset contains a container that doesn't exist in storage.
  • Recomendação: Certifique-se de que o recipiente referenciado no seu conjunto de dados existe e pode ser acedido.Recommendation: Make sure that the container referenced in your dataset exists and can be accessed.

Código de erro: DF-Executor-SystemInvalidJsonError code: DF-Executor-SystemInvalidJson

  • Mensagem: Erro de análise JSON, codificação não suportada ou multilineMessage: JSON parsing error, unsupported encoding or multiline
  • Causa: Possíveis problemas com o ficheiro JSON: codificação não suportada, bytes corruptos ou utilização da fonte JSON como um único documento em muitas linhas aninhadas.Cause: Possible problems with the JSON file: unsupported encoding, corrupt bytes, or using JSON source as a single document on many nested lines.
  • Recomendação: Verifique se a codificação do ficheiro JSON é suportada.Recommendation: Verify that the JSON file's encoding is supported. Sobre a transformação de origem que está a utilizar um conjunto de dados JSON, expanda as definições JSON e ligue o Documento Único.On the source transformation that's using a JSON dataset, expand JSON Settings and turn on Single Document.

Código de erro: DF-Executor-BroadcastTimeoutError code: DF-Executor-BroadcastTimeout

  • Mensagem: Transmita erro de tempo limite, certifique-se de que o fluxo de transmissão produz dados dentro de 60 segundos em depuração e 300 segundos em execuções de trabalhoMessage: Broadcast join timeout error, make sure broadcast stream produces data within 60 secs in debug runs and 300 secs in job runs

  • Causa: A transmissão tem um tempo limite de 60 segundos em depuração e 300 segundos em execuções de trabalho.Cause: Broadcast has a default timeout of 60 seconds on debug runs and 300 seconds on job runs. O fluxo escolhido para transmissão é demasiado grande para produzir dados dentro deste limite.The stream chosen for broadcast is too large to produce data within this limit.

  • Recomendação: Verifique o separador Otimize sobre as transformações do fluxo de dados para se juntar, existe e procurar.Recommendation: Check the Optimize tab on your data flow transformations for join, exists, and lookup. A opção padrão para transmissão é Auto. Se o Auto estiver definido, ou se estiver a definir manualmente o lado esquerdo ou direito para transmitir em Fixed, pode definir uma configuração de execução de integração Azure maior (IR) ou desligar a transmissão.The default option for broadcast is Auto. If Auto is set, or if you're manually setting the left or right side to broadcast under Fixed, you can either set a larger Azure integration runtime (IR) configuration or turn off broadcast. Para obter o melhor desempenho nos fluxos de dados, recomendamos que permita que a Spark transmita utilizando o Auto e utilize um Azure IR otimizado para a memória.For the best performance in data flows, we recommend that you allow Spark to broadcast by using Auto and use a memory-optimized Azure IR.

    Se estiver a executar o fluxo de dados numa execução de teste de depuragem a partir de um gasoduto de depuragem, poderá encontrar-se com mais frequência nesta condição.If you're running the data flow in a debug test execution from a debug pipeline run, you might run into this condition more frequently. Isto porque a Azure Data Factory acelera o tempo de transmissão para 60 segundos para manter uma experiência de depuração mais rápida.That's because Azure Data Factory throttles the broadcast timeout to 60 seconds to maintain a faster debugging experience. Pode estender o tempo limite para o tempo limite de 300 segundos de uma corrida desencadeada.You can extend the timeout to the 300-second timeout of a triggered run. Para tal, pode utilizar a opção Debug > Use Activity Runtime para utilizar o Azure IR definido na sua atividade de pipeline Executar fluxo de dados.To do so, you can use the Debug > Use Activity Runtime option to use the Azure IR defined in your Execute Data Flow pipeline activity.

  • Mensagem: Enviar erro de tempo limite de transmissão, pode escolher 'Off' da opção de transmissão na transformação de join/exists/lookup para evitar este problema.Message: Broadcast join timeout error, you can choose 'Off' of broadcast option in join/exists/lookup transformation to avoid this issue. Se pretende transmitir a opção de aderir para melhorar o desempenho, então certifique-se de que o fluxo de transmissão pode produzir dados dentro de 60 segundos em depurações de depurações e 300 segundos em execuções de emprego.If you intend to broadcast join option to improve performance then make sure broadcast stream can produce data within 60 secs in debug runs and 300 secs in job runs.

  • Causa: A transmissão tem um tempo limite de 60 segundos em depuração e 300 segundos em execuções de trabalho.Cause: Broadcast has a default timeout of 60 seconds in debug runs and 300 seconds in job runs. Na transmissão, o fluxo escolhido para transmissão é demasiado grande para produzir dados dentro deste limite.On the broadcast join, the stream chosen for broadcast is too large to produce data within this limit. Se uma junção de transmissão não for utilizada, a transmissão padrão por fluxo de dados pode atingir o mesmo limite.If a broadcast join isn't used, the default broadcast by dataflow can reach the same limit.

  • Recomendação: Desligue a opção de transmissão ou evite transmitir grandes fluxos de dados para os quais o processamento pode demorar mais de 60 segundos.Recommendation: Turn off the broadcast option or avoid broadcasting large data streams for which the processing can take more than 60 seconds. Escolha um fluxo menor para transmitir.Choose a smaller stream to broadcast. As grandes tabelas do Armazém de Dados Azure SQL e os ficheiros de origem não são normalmente boas escolhas.Large Azure SQL Data Warehouse tables and source files aren't typically good choices. Na ausência de uma junção de transmissão, utilize um cluster maior se este erro ocorrer.In the absence of a broadcast join, use a larger cluster if this error occurs.

Código de erro: DF-Executor-ConversãoError code: DF-Executor-Conversion

  • Mensagem: Converter para uma data ou hora falhou devido a um caráter inválidoMessage: Converting to a date or time failed due to an invalid character
  • Causa: Os dados não estão no formato esperado.Cause: Data isn't in the expected format.
  • Recomendação: Utilize o tipo de dados correto.Recommendation: Use the correct data type.

Código de erro: DF-Executor-InvalidColumnError code: DF-Executor-InvalidColumn

  • Mensagem: O nome da coluna tem de ser especificado na consulta, definir um pseudónimo se utilizar uma função SQLMessage: Column name needs to be specified in the query, set an alias if using a SQL function
  • Causa: Não é especificado nenhum nome de coluna.Cause: No column name is specified.
  • Recomendação: Desafine um pseudónimo se estiver a utilizar uma função SQL como min() ou max().Recommendation: Set an alias if you're using a SQL function like min() or max().

Código de erro: DF-Executor-DriverErrorError code: DF-Executor-DriverError

  • Mensagem: INT96 é o tipo de timetamp legado que não é suportado por ADF Dataflow.Message: INT96 is legacy timestamp type which is not supported by ADF Dataflow. Por favor, considere atualizar o tipo de coluna para os tipos mais recentes.Please consider upgrading the column type to the latest types.
  • Causa: Erro do condutor.Cause: Driver error.
  • Recomendação: O INT96 é um tipo de timetamp legado que não é suportado pelo fluxo de dados da Azure Data Factory.Recommendation: INT96 is a legacy timestamp type that's not supported by Azure Data Factory data flow. Considere atualizar o tipo de coluna para o tipo mais recente.Consider upgrading the column type to the latest type.

Código de erro: DF-Executor-BlockCountExceedsLimitErrorError code: DF-Executor-BlockCountExceedsLimitError

  • Mensagem: A contagem de blocos não comprometida não pode exceder o limite máximo de 100.000 blocos.Message: The uncommitted block count cannot exceed the maximum limit of 100,000 blocks. Verifique a configuração do blob.Check blob configuration.
  • Causa: O número máximo de blocos não autorizados numa bolha é de 100.000.Cause: The maximum number of uncommitted blocks in a blob is 100,000.
  • Recomendação: Contacte a equipa de produtos da Microsoft para obter mais detalhes sobre este problema.Recommendation: Contact the Microsoft product team for more details about this problem.

Código de erro: DF-Executor-PartitionDirectoryErrorError code: DF-Executor-PartitionDirectoryError

  • Mensagem: O caminho de origem especificado tem ou vários diretórios divididos (por exemplo/<Diretório raiz de partição 1>/a=10/b=20, /<Diretório raiz de partição 2>/c=10/d=30) ou diretório dividido com outro ficheiro ou diretório não dividido (por exemplo /<Diretório raiz de partição 1>/a=10/b=20, /Diretório 2/file1), remover o diretório de raiz de partição da via de origem e lê-lo através de uma transformação de fonte separada.Message: The specified source path has either multiple partitioned directories (for e.g. /<Partition Root Directory 1>/a=10/b=20, /<Partition Root Directory 2>/c=10/d=30) or partitioned directory with other file or non-partitioned directory (for example /<Partition Root Directory 1>/a=10/b=20, /Directory 2/file1), remove partition root directory from source path and read it through separate source transformation.
  • Causa: O caminho de origem tem vários diretórios divididos ou um diretório dividido que tem outro ficheiro ou diretório não dividido.Cause: The source path has either multiple partitioned directories or a partitioned directory that has another file or non-partitioned directory.
  • Recomendação: Retire o diretório de raiz dividido do caminho da origem e leia-o através de uma transformação de fonte separada.Recommendation: Remove the partitioned root directory from the source path and read it through separate source transformation.

Código de erro: DF-Executor-InvalidTypeError code: DF-Executor-InvalidType

  • Mensagem: Certifique-se de que o tipo de parâmetro coincide com o tipo de valor transmitido.Message: Please make sure that the type of parameter matches with type of value passed in. A passagem de parâmetros flutuantes dos oleodutos não está suportada atualmente.Passing float parameters from pipelines isn't currently supported.
  • Causa: Os tipos de dados são incompatíveis entre o tipo declarado e o valor do parâmetro real.Cause: Data types are incompatible between the declared type and the actual parameter value.
  • Recomendação: Verifique se os valores dos parâmetros transmitidos para o fluxo de dados correspondem ao tipo declarado.Recommendation: Check that the parameter values passed into the data flow match the declared type.

Código de erro: DF-Executor-ParseErrorError code: DF-Executor-ParseError

  • Mensagem: A expressão não pode ser analisada.Message: Expression cannot be parsed.
  • Causa: Uma expressão gerou erros de análise devido a formatação incorreta.Cause: An expression generated parsing errors because of incorrect formatting.
  • Recomendação: Verifique a formatação na expressão.Recommendation: Check the formatting in the expression.

Código de erro: DF-Executor-SystemImplicitCartesianError code: DF-Executor-SystemImplicitCartesian

  • Mensagem: O produto cartesiano implícito para a junção INNER não é suportado, utilize CROSS JOIN em vez disso.Message: Implicit cartesian product for INNER join is not supported, use CROSS JOIN instead. As colunas utilizadas em conjunto devem criar uma chave única para as linhas.Columns used in join should create a unique key for rows.
  • Causa: Os produtos cartesianos implícitos para o INNER unem-se entre planos lógicos não são suportados.Cause: Implicit cartesian products for INNER joins between logical plans aren't supported. Se estiver a usar colunas na junta, crie uma chave única.If you're using columns in the join, create a unique key.
  • Recomendação: Para aderir a não-igualdade, utilize CROSS JOIN.Recommendation: For non-equality based joins, use CROSS JOIN.

Código de erro: GetCommand OutputAsync falhouError code: GetCommand OutputAsync failed

  • Mensagem: Durante o depurador de fluxo de dados e pré-visualização de dados: GetCommand OutputAsync falhou com ...Message: During Data Flow debug and data preview: GetCommand OutputAsync failed with ...
  • Causa: Este erro é um erro de serviço de back-end.Cause: This error is a back-end service error.
  • Recomendação: Revendo a operação e reinicie a sua sessão de depuragem.Recommendation: Retry the operation and restart your debugging session. Se voltar a tentar e reiniciar não resolver o problema, contacte o suporte do cliente.If retrying and restarting doesn't resolve the problem, contact customer support.

Código de erro: DF-Executor-OutOfMemoryErrorError code: DF-Executor-OutOfMemoryError

  • Mensagem: O cluster escorria para o problema de memória durante a execução, por favor, recava o tempo de integração com maior contagem de núcleos e/ou tipo de computação otimizada da memóriaMessage: Cluster ran into out of memory issue during execution, please retry using an integration runtime with bigger core count and/or memory optimized compute type
  • Causa: O aglomerado está a ficar sem memória.Cause: The cluster is running out of memory.
  • Recomendação: Os aglomerados de depurg destinam-se ao desenvolvimento.Recommendation: Debug clusters are meant for development. Utilize a amostragem de dados e um tipo e tamanho de cálculo adequados para executar a carga útil.Use data sampling and an appropriate compute type and size to run the payload. Para obter dicas de desempenho, consulte o guia de desempenho do fluxo de dados de mapeamento.For performance tips, see Mapping data flow performance guide.

Código de erro: DF-Executor-ilegalArgumentError code: DF-Executor-illegalArgument

  • Mensagem: Certifique-se de que a chave de acesso no seu Serviço Linked está corretaMessage: Please make sure that the access key in your Linked Service is correct
  • Causa: O nome da conta ou a chave de acesso estão incorretos.Cause: The account name or access key is incorrect.
  • Recomendação: Certifique-se de que o nome da conta ou a chave de acesso especificada no seu serviço ligado estão corretos.Recommendation: Ensure that the account name or access key specified in your linked service is correct.

Código de erro: DF-Executor-ColumnUn disponívelError code: DF-Executor-ColumnUnavailable

  • Mensagem: O nome da coluna utilizado na expressão não está disponível ou inválido.Message: Column name used in expression is unavailable or invalid.
  • Causa: Um nome de coluna inválido ou indisponível é usado numa expressão.Cause: An invalid or unavailable column name is used in an expression.
  • Recomendação: Verifique os nomes das colunas utilizadas nas expressões.Recommendation: Check the column names used in expressions.

Código de erro: DF-Executor-OutOfDiskSpaceErrorError code: DF-Executor-OutOfDiskSpaceError

  • Mensagem: Erro interno do servidorMessage: Internal server error
  • Causa: O cluster está a ficar sem espaço em disco.Cause: The cluster is running out of disk space.
  • Recomendação: Recandidutar o gasoduto.Recommendation: Retry the pipeline. Se isso não resolver o problema, contacte o apoio ao cliente.If doing so doesn't resolve the problem, contact customer support.

Código de erro: DF-Executor-StoreIsNotDefinedError code: DF-Executor-StoreIsNotDefined

  • Mensagem: A configuração da loja não está definida.Message: The store configuration is not defined. Este erro é potencialmente causado por uma atribuição de parâmetros inválidos no pipeline.This error is potentially caused by invalid parameter assignment in the pipeline.
  • Causa: A configuração da loja inválida é fornecida.Cause: Invalid store configuration is provided.
  • Recomendação: Verifique a atribuição do valor dos parâmetros no oleoduto.Recommendation: Check parameter value assignment in the pipeline. Uma expressão de parâmetro pode conter caracteres inválidos.A parameter expression might contain invalid characters.

Código de erro: 4502Error code: 4502

  • Mensagem: Existem execuções simultâneas de MappingDataflow substanciais que estão a causar falhas devido a estrangulamentos no tempo de execução da integração.Message: There are substantial concurrent MappingDataflow executions that are causing failures due to throttling under Integration Runtime.
  • Causa: Um grande número de execuções de fluxo de dados estão ocorrendo simultaneamente no tempo de integração.Cause: A large number of Data Flow activity runs are occurring concurrently on the integration runtime. Para mais informações, consulte os limites da Azure Data Factory.For more information, see Azure Data Factory limits.
  • Recomendação: Se pretender executar mais atividades de Fluxo de Dados em paralelo, distribua-as através de vários tempos de integração.Recommendation: If you want to run more Data Flow activities in parallel, distribute them across multiple integration runtimes.

Código de erro: InvalidTemplateError code: InvalidTemplate

  • Mensagem: A expressão do gasoduto não pode ser avaliada.Message: The pipeline expression cannot be evaluated.
  • Causa: A expressão do gasoduto passada na atividade do Fluxo de Dados não está a ser processada corretamente devido a um erro de sintaxe.Cause: The pipeline expression passed in the Data Flow activity isn't being processed correctly because of a syntax error.
  • Recomendação: Verifique a sua atividade na monitorização da atividade para verificar a expressão.Recommendation: Check your activity in activity monitoring to verify the expression.

Código de erro: 2011Error code: 2011

  • Mensagem: A atividade estava a decorrer no Tempo de Execução da Integração Azure e não conseguiu desencriptar a credencial de data store ou computação ligada através de um Tempo de Execução de Integração Auto-hospedado.Message: The activity was running on Azure Integration Runtime and failed to decrypt the credential of data store or compute connected via a Self-hosted Integration Runtime. Verifique a configuração dos serviços ligados associados a esta atividade e certifique-se de utilizar o tipo de tempo de execução de integração adequado.Please check the configuration of linked services associated with this activity, and make sure to use the proper integration runtime type.
  • Causa: O fluxo de dados não suporta serviços ligados em tempos de integração auto-hospedados.Cause: Data flow doesn't support linked services on self-hosted integration runtimes.
  • Recomendação: Configurar o fluxo de dados para executar num tempo de integração da rede virtual gerido.Recommendation: Configure data flow to run on a Managed Virtual Network integration runtime.

Código de erro: DF-Xml-InvalidValidationModeError code: DF-Xml-InvalidValidationMode

  • Mensagem: É fornecido o modo de validação de xml inválido.Message: Invalid xml validation mode is provided.
  • Causa: É fornecido um modo de validação XML inválido.Cause: An invalid XML validation mode is provided.
  • Recomendação: Verifique o valor do parâmetro e especifique o modo de validação certo.Recommendation: Check the parameter value and specify the right validation mode.

Código de erro: DF-Xml-InvalidDataFieldError code: DF-Xml-InvalidDataField

  • Mensagem: O campo para registos corruptos deve ser tipo de corda e anulado.Message: The field for corrupt records must be string type and nullable.
  • Causa: Um tipo de dados inválido da coluna \"_corrupt_record\" é fornecido na fonte XML.Cause: An invalid data type of the column \"_corrupt_record\" is provided in the XML source.
  • Recomendação: Certifique-se de que a coluna \"_corrupt_record\" na fonte XML tem um tipo de dados de cadeia e é anulado.Recommendation: Make sure that the column \"_corrupt_record\" in the XML source has a string data type and nullable.

Código de erro: DF-Xml-MalformeFileError code: DF-Xml-MalformedFile

  • Mensagem: Xml mal formado com caminho no modo FAILFAST.Message: Malformed xml with path in FAILFAST mode.
  • Causa: XML mal formado com caminho existe no modo FAILFAST.Cause: Malformed XML with path exists in the FAILFAST mode.
  • Recomendação: Atualizar o conteúdo do ficheiro XML para o formato certo.Recommendation: Update the content of the XML file to the right format.

Código de erro: DF-Xml-InvalidReferenceResourceError code: DF-Xml-InvalidReferenceResource

  • Mensagem: O recurso de referência no ficheiro de dados xml não pode ser resolvido.Message: Reference resource in xml data file cannot be resolved.
  • Causa: O recurso de referência no ficheiro de dados XML não pode ser resolvido.Cause: The reference resource in the XML data file cannot be resolved.
  • Recomendação: Deve verificar o recurso de referência no ficheiro de dados XML.Recommendation: You should check the reference resource in the XML data file.

Código de erro: DF-Xml-InvalidSchemaError code: DF-Xml-InvalidSchema

  • Mensagem: A validação do esquema falhou.Message: Schema validation failed.
  • Causa: O esquema inválido é fornecido na fonte XML.Cause: The invalid schema is provided on the XML source.
  • Recomendação: Verifique as definições de esquema na fonte XML para se certificar de que se trata do esquema do subconjunto dos dados de origem.Recommendation: Check the schema settings on the XML source to make sure that it is the subset schema of the source data.

Código de erro: DF-Xml-Não-SuportadoExponalReferênciaReferresourceError code: DF-Xml-UnsupportedExternalReferenceResource

  • Mensagem: O recurso de referência externo no ficheiro de dados xml não é suportado.Message: External reference resource in xml data file is not supported.
  • Causa: O recurso de referência externo no ficheiro de dados XML não é suportado.Cause: The external reference resource in the XML data file is not supported.
  • Recomendação: Atualize o conteúdo do ficheiro XML quando o recurso de referência externo não for suportado agora.Recommendation: Update the XML file content when the external reference resource is not supported now.

Código de erro: DF-GEN2-InvalidAccountConfigurationError code: DF-GEN2-InvalidAccountConfiguration

  • Mensagem: Deve ser especificado um dos elementos da chave da conta ou inquilino/spnIde/spnCredentialType ou miServiceUri/miServiceToken.Message: Either one of account key or tenant/spnId/spnCredential/spnCredentialType or miServiceUri/miServiceToken should be specified.
  • Causa: Uma credencial inválida é fornecida no serviço ligado à ADLS Gen2.Cause: An invalid credential is provided in the ADLS Gen2 linked service.
  • Recomendação: Atualize o serviço ligado à ADLS Gen2 para ter a configuração credencial certa.Recommendation: Update the ADLS Gen2 linked service to have the right credential configuration.

Código de erro: DF-GEN2-InvalidAuthConfigurationError code: DF-GEN2-InvalidAuthConfiguration

  • Mensagem: Apenas um dos três métodos auth (Key, ServicePrincipal e MI) pode ser especificado.Message: Only one of the three auth methods (Key, ServicePrincipal and MI) can be specified.
  • Causa: O método de auth inválido é fornecido no serviço ligado à gen2 ADLS.Cause: Invalid auth method is provided in ADLS gen2 linked service.
  • Recomendação: Atualize o serviço ligado à ADLS Gen2 para ter um dos três métodos de autenticação que são Key, ServicePrincipal e MI.Recommendation: Update the ADLS Gen2 linked service to have one of three authentication methods that are Key, ServicePrincipal and MI.

Código de erro: DF-GEN2-InvalidServicePrincipalCredentialTypeError code: DF-GEN2-InvalidServicePrincipalCredentialType

  • Mensagem: O tipo de credencial principal de serviço é inválido.Message: Service principal credential type is invalid.
  • Causa: O tipo principal de credencial de serviço é inválido.Cause: The service principal credential type is invalid.
  • Recomendação: Por favor, atualize o serviço ligado à ADLS Gen2 para definir o tipo de credencial principal de serviço certo.Recommendation: Please update the ADLS Gen2 linked service to set the right service principal credential type.

Código de erro: DF-Blob-InvalidAccountConfigurationError code: DF-Blob-InvalidAccountConfiguration

  • Mensagem: Uma das chaves da conta ou o sinal de sas devem ser especificados.Message: Either one of account key or sas token should be specified.
  • Causa: Uma credencial inválida é fornecida no serviço ligado a Azure Blob.Cause: An invalid credential is provided in the Azure Blob linked service.
  • Recomendação: Utilize a chave de conta ou o token SAS para o serviço ligado a Azure Blob.Recommendation: Use either account key or SAS token for the Azure Blob linked service.

Código de erro: DF-Blob-InvalidAuthConfigurationError code: DF-Blob-InvalidAuthConfiguration

  • Mensagem: Apenas um dos dois métodos de auth (Chave, SAS) pode ser especificado.Message: Only one of the two auth methods (Key, SAS) can be specified.
  • Causa: Um método de autenticação inválido é fornecido no serviço ligado.Cause: An invalid authentication method is provided in the linked service.
  • Recomendação: Utilize a autenticação da chave ou SAS para o serviço ligado a Azure Blob.Recommendation: Use key or SAS authentication for the Azure Blob linked service.

Código de erro: DF-Cosmos-PartitionKeyMissedError code: DF-Cosmos-PartitionKeyMissed

  • Mensagem: O caminho chave da partição deve ser especificado para atualizações e eliminação de operações.Message: Partition key path should be specified for update and delete operations.
  • Causa: O caminho chave da partição é perdido na pia Azure Cosmos DB.Cause: The partition key path is missed in the Azure Cosmos DB sink.
  • Recomendação: Utilize a chave de partição de fornecimento nas definições do lavatório Azure Cosmos DB.Recommendation: Use the providing partition key in the Azure Cosmos DB sink settings.

Código de erro: DF-Cosmos-InvalidPartitionKeyError code: DF-Cosmos-InvalidPartitionKey

  • Mensagem: O caminho da chave da partição não pode ser vazio para atualização e eliminação de operações.Message: Partition key path cannot be empty for update and delete operations.
  • Causa: O caminho da chave da partição está vazio para atualização e eliminação de operações.Cause: The partition key path is empty for update and delete operations.
  • Recomendação: Utilize a chave de partição de fornecimento nas definições do lavatório Azure Cosmos DB.Recommendation: Use the providing partition key in the Azure Cosmos DB sink settings.

Código de erro: DF-Cosmos-IdPropertyMissedError code: DF-Cosmos-IdPropertyMissed

  • Mensagem: propriedade 'id' deve ser mapeada para apagar e atualizar operações.Message: 'id' property should be mapped for delete and update operations.
  • Causa: A id propriedade é perdida para atualização e apagar operações.Cause: The id property is missed for update and delete operations.
  • Recomendação: Certifique-se de que os dados de entrada têm uma id coluna nas definições de pias Cosmos DB.Recommendation: Make sure that the input data has an id column in Cosmos DB sink settings. Se não, utilize uma transformação selecionada ou derivada para gerar esta coluna antes de afundar.If no, use select or derive transformation to generate this column before sink.

Código de erro: DF-Cosmos-InvalidPartitionKeyContentError code: DF-Cosmos-InvalidPartitionKeyContent

  • Mensagem: a tecla de partição deve começar com /.Message: partition key should start with /.
  • Causa: É fornecida uma chave de partição inválida.Cause: An invalid partition key is provided.
  • Recomendação: Certifique-se de que a chave de partição começa com / as definições do lavatório Cosmos DB, por exemplo: /movieId .Recommendation: Ensure that the partition key start with / in Cosmos DB sink settings, for example: /movieId.

Código de erro: DF-Cosmos-InvalidPartitionKeyError code: DF-Cosmos-InvalidPartitionKey

  • Mensagem: A tecla de partição não está mapeada na pia para as operações de eliminação e atualização.Message: Partition key is not mapped in sink for delete and update operations.
  • Causa: É fornecida uma chave de partição inválida.Cause: An invalid partition key is provided.
  • Recomendação: Nas definições de piaS Cosmos DB, utilize a chave de partição certa que é igual à chave de partição do seu recipiente.Recommendation: In Cosmos DB sink settings, use the right partition key that is same as your container's partition key.

Código de erro: DF-Cosmos-InvalidConnectionModeError code: DF-Cosmos-InvalidConnectionMode

  • Mensagem: Modo de ligação inválido.Message: Invalid connection mode.
  • Causa: É fornecido um modo de ligação inválido.Cause: An invalid connection mode is provided.
  • Recomendação: Confirme que o modo suportado é Gateway e DirectHttps nas definições de Cosmos DB.Recommendation: Confirm that the supported mode is Gateway and DirectHttps in Cosmos DB settings.

Código de erro: DF-Cosmos-InvalidAccountConfigurationError code: DF-Cosmos-InvalidAccountConfiguration

  • Mensagem: Ou o nome da conta ou o ponto de contaende deve ser especificado.Message: Either accountName or accountEndpoint should be specified.
  • Causa: Informações inválidas da conta são fornecidas.Cause: Invalid account information is provided.
  • Recomendação: No serviço ligado ao Cosmos DB, especifique o nome da conta ou o ponto final da conta.Recommendation: In the Cosmos DB linked service, specify the account name or account endpoint.

Código de erro: DF-Github-WriteNotSupportoError code: DF-Github-WriteNotSupported

  • Mensagem: A loja Github não permite escritas.Message: Github store does not allow writes.
  • Causa: A loja GitHub é lida apenas.Cause: The GitHub store is read only.
  • Recomendação: A definição da entidade da loja encontra-se noutro local.Recommendation: The store entity definition is in some other place.

Código de erro: DF-PGSQL-InvalidCredentialError code: DF-PGSQL-InvalidCredential

  • Mensagem: O utilizador/palavra-passe deve ser especificado.Message: User/password should be specified.
  • Causa: Falta-lhe o Utilizador/palavra-passe.Cause: The User/password is missed.
  • Recomendação: Certifique-se de que tem as definições credenciais certas no serviço relacionado com a Ligação PostgreSQL.Recommendation: Make sure that you have right credential settings in the related PostgreSQL linked service.

Código de erro: DF-Snowflake-InvalidStageConfigurationError code: DF-Snowflake-InvalidStageConfiguration

  • Mensagem: Só o tipo de armazenamento de bolhas pode ser utilizado como palco na operação de leitura/escrita de flocos de neve.Message: Only blob storage type can be used as stage in snowflake read/write operation.
  • Causa: Uma configuração de encenação inválida é fornecida no Floco de Neve.Cause: An invalid staging configuration is provided in the Snowflake.
  • Recomendação: Atualize as definições de preparação do Floco de Neve para garantir que apenas o serviço ligado a Azure Blob é utilizado.Recommendation: Update Snowflake staging settings to ensure that only Azure Blob linked service is used.

Código de erro: DF-Snowflake-InvalidStageConfigurationError code: DF-Snowflake-InvalidStageConfiguration

  • Mensagem: As propriedades do estágio do floco de neve devem ser especificadas com a autenticação de blob + sas azul.Message: Snowflake stage properties should be specified with azure blob + sas authentication.
  • Causa: Uma configuração de encenação inválida é fornecida no Floco de Neve.Cause: An invalid staging configuration is provided in the Snowflake.
  • Recomendação: Certifique-se de que apenas a autenticação Azure Blob + SAS é especificada nas definições de preparação do Floco de Neve.Recommendation: Ensure that only the Azure Blob + SAS authentication is specified in the Snowflake staging settings.

Código de erro: DF-Snowflake-InvalidDataTypeError code: DF-Snowflake-InvalidDataType

  • Mensagem: O tipo de faísca não é suportado em floco de neve.Message: The spark type is not supported in snowflake.
  • Causa: Um tipo de dados inválido é fornecido no Floco de Neve.Cause: An invalid data type is provided in the Snowflake.
  • Recomendação: Utilize a transformação derivada antes de aplicar a pia Snowflake para atualizar a coluna relacionada dos dados de entrada no tipo de corda.Recommendation: Please use the derive transformation before applying the Snowflake sink to update the related column of the input data into the string type.

Código de erro: DF-Hive-InvalidBlobStagingConfigurationError code: DF-Hive-InvalidBlobStagingConfiguration

  • Mensagem: Devem ser especificadas as propriedades de paragem de armazenamento de bolhas.Message: Blob storage staging properties should be specified.
  • Causa: Uma configuração de encenação inválida é fornecida na Colmeia.Cause: An invalid staging configuration is provided in the Hive.
  • Recomendação: Verifique se a chave da conta, o nome da conta e o recipiente estão corretamente definidos no serviço relacionado com a Blob, que é utilizado como encenação.Recommendation: Please check if the account key, account name and container are set properly in the related Blob linked service which is used as staging.

Código de erro: DF-Hive-InvalidGen2StagingConfigurationError code: DF-Hive-InvalidGen2StagingConfiguration

  • Mensagem: AdLS Gen2 storage staging apenas suporte principal credencial principal do serviço.Message: ADLS Gen2 storage staging only support service principal key credential.
  • Causa: Uma configuração de encenação inválida é fornecida na Colmeia.Cause: An invalid staging configuration is provided in the Hive.
  • Recomendação: Por favor, atualize o serviço relacionado com a ADLS Gen2 que é utilizado como encenação.Recommendation: Please update the related ADLS Gen2 linked service that is used as staging. Atualmente, apenas a credencial principal do serviço é suportada.Currently, only the service principal key credential is supported.

Código de erro: DF-Hive-InvalidGen2StagingConfigurationError code: DF-Hive-InvalidGen2StagingConfiguration

  • Mensagem: As propriedades de armazenamento da ADLS Gen2 devem ser especificadas.Message: ADLS Gen2 storage staging properties should be specified. Seja necessário um dos chaves ou inquilino/spnId/spnKey ou miServiceUri/miServiceToken.Either one of key or tenant/spnId/spnKey or miServiceUri/miServiceToken is required.
  • Causa: Uma configuração de encenação inválida é fornecida na Colmeia.Cause: An invalid staging configuration is provided in the Hive.
  • Recomendação: Atualizar o serviço relacionado com a ADLS Gen2 com credenciais certas que são usadas como encenação na Colmeia.Recommendation: Update the related ADLS Gen2 linked service with right credentials that are used as staging in the Hive.

Código de erro: DF-Hive-InvalidDataTypeError code: DF-Hive-InvalidDataType

  • Mensagem: Colunas não apoiadas.Message: Unsupported Column(s).
  • Causa: São fornecidas colunas não apoiadas.Cause: Unsupported Column(s) are provided.
  • Recomendação: Atualizar a coluna de dados de entrada para corresponder ao tipo de dados suportado pela Colmeia.Recommendation: Update the column of input data to match the data type supported by the Hive.

Código de erro: DF-Hive-InvalidStorageTypeError code: DF-Hive-InvalidStorageType

  • Mensagem: O tipo de armazenamento pode ser blob ou gen2.Message: Storage type can either be blob or gen2.
  • Causa: Apenas o tipo de armazenamento Azure Blob ou ADLS Gen2 é suportado.Cause: Only Azure Blob or ADLS Gen2 storage type is supported.
  • Recomendação: Escolha o tipo de armazenamento certo da Azure Blob ou da ADLS Gen2.Recommendation: Choose the right storage type from Azure Blob or ADLS Gen2.

Código de erro: Df-Delimited-InvalidConfigurationError code: DF-Delimited-InvalidConfiguration

  • Mensagem: Uma das linhas vazias ou do cabeçalho personalizado deve ser especificada.Message: Either one of empty lines or custom header should be specified.
  • Causa: É fornecida uma configuração delimitada inválida.Cause: An invalid delimited configuration is provided.
  • Recomendação: Por favor, atualize as definições de CSV para especificar uma das linhas vazias ou o cabeçalho personalizado.Recommendation: Please update the CSV settings to specify one of empty lines or the custom header.

Código de erro: DF-Delimitado-ColunaDelimiterMissedError code: DF-Delimited-ColumnDelimiterMissed

  • Mensagem: O delimiter de coluna é necessário para analisar.Message: Column delimiter is required for parse.
  • Causa: O delimiter da coluna é perdido.Cause: The column delimiter is missed.
  • Recomendação: Nas suas definições de CSV, confirme que tem o delimiter de coluna que é necessário para analisar.Recommendation: In your CSV settings, confirm that you have the column delimiter which is required for parse.

Código de erro: DF-MSSQL-InvalidCredentialError code: DF-MSSQL-InvalidCredential

  • Mensagem: Deve ser especificado um dos utilizadores/pwd ou inquilino/spnId/spnKey ou miServiceUri/miServiceToken.Message: Either one of user/pwd or tenant/spnId/spnKey or miServiceUri/miServiceToken should be specified.
  • Causa: Uma credencial inválida é fornecida no serviço ligado à MSSQL.Cause: An invalid credential is provided in the MSSQL linked service.
  • Recomendação: Por favor, atualize o serviço relacionado com a MSSQL com credenciais certas, e deve ser especificado um dos clientes/pwd ou inquilino/spnId/spnKey ou miServiceUri/miServiceToken.Recommendation: Please update the related MSSQL linked service with right credentials, and one of user/pwd or tenant/spnId/spnKey or miServiceUri/miServiceToken should be specified.

Código de erro: DF-MSSQL-InvalidDataTypeError code: DF-MSSQL-InvalidDataType

  • Mensagem: Campo não suportado.Message: Unsupported field(s).
  • Porções: São fornecidos campos não apoiados.Cause: Unsupported field(s) are provided.
  • Recomendação: Modificar a coluna de dados de entrada para corresponder ao tipo de dados suportado pelo MSSQL.Recommendation: Modify the input data column to match the data type supported by MSSQL.

Código de erro: DF-MSSQL-InvalidAuthConfigurationError code: DF-MSSQL-InvalidAuthConfiguration

  • Mensagem: Apenas um dos três métodos auth (Key, ServicePrincipal e MI) pode ser especificado.Message: Only one of the three auth methods (Key, ServicePrincipal and MI) can be specified.
  • Causa: Um método de autenticação inválido é fornecido no serviço ligado à MSSQL.Cause: An invalid authentication method is provided in the MSSQL linked service.
  • Recomendação: Só é possível especificar um dos três métodos de autenticação (Key, ServicePrincipal e MI) no serviço relacionado com a MSSQL.Recommendation: You can only specify one of the three authentication methods (Key, ServicePrincipal and MI) in the related MSSQL linked service.

Código de erro: DF-MSSQL-InvalidCloudTypeError code: DF-MSSQL-InvalidCloudType

  • Mensagem: O tipo de nuvem é inválido.Message: Cloud type is invalid.
  • Causa: É fornecido um tipo de nuvem inválida.Cause: An invalid cloud type is provided.
  • Recomendação: Verifique o seu tipo de nuvem no serviço relacionado com a MSSQL.Recommendation: Check your cloud type in the related MSSQL linked service.

Código de erro: DF-SQLDW-InvalidBlobStagingConfigurationError code: DF-SQLDW-InvalidBlobStagingConfiguration

  • Mensagem: Devem ser especificadas as propriedades de paragem de armazenamento de bolhas.Message: Blob storage staging properties should be specified.
  • Causa: São fornecidas configurações de armazenamento de bolhas inválidasCause: Invalid blob storage staging settings are provided
  • Recomendação: Verifique se o serviço ligado à Blob utilizado para a encenação tem propriedades corretas.Recommendation: Please check if the Blob linked service used for staging has correct properties.

Código de erro: DF-SQLDW-InvalidStorageTypeError code: DF-SQLDW-InvalidStorageType

  • Mensagem: O tipo de armazenamento pode ser blob ou gen2.Message: Storage type can either be blob or gen2.
  • Causa: É fornecido um tipo de armazenamento inválido para a encenação.Cause: An invalid storage type is provided for staging.
  • Recomendação: Verifique o tipo de armazenamento do serviço ligado utilizado para a encenação e certifique-se de que se trata de Blob ou Gen2.Recommendation: Check the storage type of the linked service used for staging and make sure that it is Blob or Gen2.

Código de erro: DF-SQLDW-InvalidGen2StagingConfigurationError code: DF-SQLDW-InvalidGen2StagingConfiguration

  • Mensagem: AdLS Gen2 storage staging apenas suporte principal credencial principal do serviço.Message: ADLS Gen2 storage staging only support service principal key credential.
  • Causa: Está prevista uma credencial inválida para a fase de armazenamento do gen2 ADLS.Cause: An invalid credential is provided for the ADLS gen2 storage staging.
  • Recomendação: Utilize a credencial principal de serviço do serviço ligado à Gen2 utilizado para a encenação.Recommendation: Use the service principal key credential of the Gen2 linked service used for staging.

Código de erro: DF-SQLDW-InvalidConfigurationError code: DF-SQLDW-InvalidConfiguration

  • Mensagem: As propriedades de armazenamento da ADLS Gen2 devem ser especificadas.Message: ADLS Gen2 storage staging properties should be specified. É necessário um dos principais ou inquilinos/spnId/spnCredentialType ou miServiceUri/miServiceToken.Either one of key or tenant/spnId/spnCredential/spnCredentialType or miServiceUri/miServiceToken is required.
  • Causa: São fornecidas propriedades de encenação inválidas da ADLS Gen2.Cause: Invalid ADLS Gen2 staging properties are provided.
  • Recomendação: Por favor, atualize as definições de armazenamento da ADLS Gen2 para ter uma das configurações de chave ou inquilino/spnIde/spnCredentialType ou miServiceUri/miServiceToken.Recommendation: Please update ADLS Gen2 storage staging settings to have one of key or tenant/spnId/spnCredential/spnCredentialType or miServiceUri/miServiceToken.

Código de erro: Df-DELTA-InvalidConfigurationError code: DF-DELTA-InvalidConfiguration

  • Mensagem: A etiqueta de tempo e a versão não podem ser definidas ao mesmo tempo.Message: Timestamp and version can't be set at the same time.
  • Causa: A estada de tempo e a versão não podem ser definidas ao mesmo tempo.Cause: The timestamp and version can't be set at the same time.
  • Recomendação: Defina a marca de tempo ou a versão nas definições delta.Recommendation: Set the timestamp or version in the delta settings.

Código de erro: DF-DELTA-KeyColumnMissedError code: DF-DELTA-KeyColumnMissed

  • Mensagem: As colunas de chaves devem ser especificadas para operações não inseríveis.Message: Key column(s) should be specified for non-insertable operations.
  • Causas: As colunas de chaves são perdidas para operações não inseríveis.Cause: Key column(s) are missed for non-insertable operations.
  • Recomendação: Especifique as colunas-chave na pia delta para ter operações não inseríveis.Recommendation: Specify key column(s) on delta sink to have non-insertable operations.

Código de erro: DF-DELTA-InvalidTableOperationSettingsError code: DF-DELTA-InvalidTableOperationSettings

  • Mensagem: As opções de recriação e truncado não podem ser especificadas.Message: Recreate and truncate options can't be both specified.
  • Causa: As opções de recrie e truncado não podem ser especificadas simultaneamente.Cause: Recreate and truncate options can't be specified simultaneously.
  • Recomendação: Atualize as definições delta para que a operação seja recriada ou truncada.Recommendation: Update delta settings to have either recreate or truncate operation.

Código de erro: DF-Excel-Folha de cálculoConfigMissedError code: DF-Excel-WorksheetConfigMissed

  • Mensagem: É necessário o nome ou índice da folha excel.Message: Excel sheet name or index is required.
  • Causa: É fornecida uma configuração de folha de cálculo excel inválida.Cause: An invalid Excel worksheet configuration is provided.
  • Recomendação: Verifique o valor do parâmetro e especifique o nome ou índice da folha para ler os dados do Excel.Recommendation: Check the parameter value and specify the sheet name or index to read the Excel data.

Código de erro: DF-Excel-InvalidWorksheetConfigurationError code: DF-Excel-InvalidWorksheetConfiguration

  • Mensagem: O nome e o índice da folha de excel não podem existir ao mesmo tempo.Message: Excel sheet name and index cannot exist at the same time.
  • Causa: O nome e o índice da folha Excel são fornecidos ao mesmo tempo.Cause: The Excel sheet name and index are provided at the same time.
  • Recomendação: Verifique o valor do parâmetro e especifique o nome ou índice da folha para ler os dados do Excel.Recommendation: Check the parameter value and specify the sheet name or index to read the Excel data.

Código de erro: DF-Excel-InvalidRangeError code: DF-Excel-InvalidRange

Código de erro: DF-Excel-Folha de CálculoNotExistError code: DF-Excel-WorksheetNotExist

  • Mensagem: A folha de cálculo do Excel não existe.Message: Excel worksheet does not exist.
  • Causa: É fornecido um nome ou índice de folha de cálculo inválido.Cause: An invalid worksheet name or index is provided.
  • Recomendação: Verifique o valor do parâmetro e especifique um nome ou índice de folha válido para ler os dados do Excel.Recommendation: Check the parameter value and specify a valid sheet name or index to read the Excel data.

Código de erro: DF-Excel-DifferentSchemaNotSupportError code: DF-Excel-DifferentSchemaNotSupport

  • Mensagem: Leia os ficheiros excel com esquemas diferentes não é suportado agora.Message: Read excel files with different schema is not supported now.
  • Causa: Ler ficheiros excel com esquemas diferentes não é suportado agora.Cause: Reading excel files with different schemas is not supported now.
  • Recomendação: Por favor, aplique uma das seguintes opções para resolver este problema:Recommendation: Please apply one of following options to solve this problem:
    1. Utilize a atividade de fluxo de dados ForEach + para ler as folhas de cálculo do Excel, uma a uma.Use ForEach + data flow activity to read Excel worksheets one by one.
    2. Atualize cada esquema de folha de cálculo para ter as mesmas colunas manualmente antes de ler dados.Update each worksheet schema to have the same columns manually before reading data.

Código de erro: DF-Excel-InvalidDataTypeError code: DF-Excel-InvalidDataType

  • Mensagem: O tipo de dados não é suportado.Message: Data type is not supported.
  • Causa: O tipo de dados não é suportado.Cause: The data type is not supported.
  • Recomendação: Altere o tipo de dados para 'string' para colunas de dados de entrada relacionadas.Recommendation: Please change the data type to 'string' for related input data columns.

Código de erro: DF-Excel-InvalidFileError code: DF-Excel-InvalidFile

  • Mensagem: O ficheiro excel inválido é fornecido enquanto apenas .xlsx e .xls são suportados.Message: Invalid excel file is provided while only .xlsx and .xls are supported.
  • Causa: São fornecidos ficheiros Inválidos do Excel.Cause: Invalid Excel files are provided.
  • Recomendação: Utilize o wildcard para filtrar e obtenha .xls .xlsx ficheiros Excel antes de ler dados.Recommendation: Use the wildcard to filter, and get .xls and .xlsx Excel files before reading data.

Código de erro: DF-Executor-OutOfMemorySparkBroadcastErrorError code: DF-Executor-OutOfMemorySparkBroadcastError

  • Mensagem: Conjunto de dados explicitamente transmitido utilizando a opção esquerda/direita deve ser pequeno o suficiente para caber na memória do nó.Message: Explicitly broadcasted dataset using left/right option should be small enough to fit in node's memory. Pode escolher a opção de transmissão 'Off' na transformação de join/exists/lookup para evitar este problema ou utilizar um tempo de integração com memória superior.You can choose broadcast option 'Off' in join/exists/lookup transformation to avoid this issue or use an integration runtime with higher memory.
  • Causa: O tamanho da tabela transmitida excede em muito a limitação da memória do nó.Cause: The size of the broadcasted table far exceeds the limitation of the node memory.
  • Recomendação: A opção de transmissão esquerda/direita deve ser utilizada apenas para um tamanho de conjunto de dados menor que possa caber na memória do nó, por isso certifique-se de configurar o tamanho do nó adequadamente ou desligar a opção de transmissão.Recommendation: The broadcast left/right option should be used only for smaller dataset size which can fit into node's memory, so make sure to configure the node size appropriately or turn off the broadcast option.

Código de erro: DF-MSSQL-InvalidFirewallSettingError code: DF-MSSQL-InvalidFirewallSetting

  • Mensagem: A ligação TCP/IP ao anfitrião falhou.Message: The TCP/IP connection to the host has failed. Certifique-se de que uma instância do SQL Server está a ser executada no anfitrião e aceitando ligações TCP/IP na porta.Make sure that an instance of SQL Server is running on the host and accepting TCP/IP connections at the port. Certifique-se de que as ligações TCP à porta não estão bloqueadas por uma firewall.Make sure that TCP connections to the port are not blocked by a firewall.
  • Causa: A definição de firewall da base de dados SQL bloqueia o fluxo de dados para aceder.Cause: The SQL database's firewall setting blocks the data flow to access.
  • Recomendação: Verifique a definição de firewall para a sua base de dados SQL e permita que os serviços e recursos da Azure acedam a este servidor.Recommendation: Please check the firewall setting for your SQL database, and allow Azure services and resources to access this server.

Código de erro: DF-Executor-AcquireStorageMemoryFailedError code: DF-Executor-AcquireStorageMemoryFailed

  • Mensagem: A transferência da memória desenrolada para a memória de armazenamento falhou.Message: Transferring unroll memory to storage memory failed. O aglomerado ficou sem memória durante a execução.Cluster ran out of memory during execution. Por favor, ressalta usando um tempo de integração com mais núcleos e/ou tipo de cálculo otimizado de memória.Please retry using an integration runtime with more cores and/or memory optimized compute type.
  • Causa: O aglomerado tem memória insuficiente.Cause: The cluster has insufficient memory.
  • Recomendação: Utilize um tempo de integração com mais núcleos e/ou o tipo de cálculo otimizado da memória.Recommendation: Please use an integration runtime with more cores and/or the memory optimized compute type.

Código de erro: DF-Cosmos-DeleteDataFailedError code: DF-Cosmos-DeleteDataFailed

  • Mensagem: Falhou em eliminar dados do cosmos após 3 tentativas de repetição.Message: Failed to delete data from cosmos after 3 times retry.
  • Causa: A produção na coleção Cosmos é pequena e leva a encontrar dados de estrangulamento ou linha que não existem no Cosmo.Cause: The throughput on the Cosmos collection is small and leads to meet throttling or row data not existing in Cosmo.
  • Recomendação: Por favor, tome as seguintes ações para resolver este problema:Recommendation: Please take the following actions to solve this problem:
    1. Se o erro for 404, certifique-se de que os dados da linha relacionadas existem na coleção Cosmos.If the error is 404, make sure that the related row data exist in the Cosmos collection.
    2. Se o erro estiver a estrangular, aumente a produção da coleção Cosmos ou coloque-a na escala automática.If the error is throttling, please increase the Cosmos collection throughput or set it to the automatic scale.

Código de erro: DF-SQLDW-ErrorRowsFoundError code: DF-SQLDW-ErrorRowsFound

  • Mensagem: Error/Inválidas linhas encontradas enquanto escrevem para afundar.Message: Error/Invalid rows found while writing to sql sink. As linhas Error/Invalid são escritas para o local de armazenamento de dados rejeitado se configurado.Error/Invalid rows are written to the rejected data storage location if configured.
  • Causa: Erros ou linhas inválidas são encontradas ao escrever na pia SQL.Cause: Error or invalid rows are found when writing to the SQL sink.
  • Recomendação: Encontre as linhas de erro no local de armazenamento de dados rejeitado se estiver configurado.Recommendation: Please find the error rows in the rejected data storage location if it is configured.

Código de erro: DF-SQLDW-ExportErrorRowFailedError code: DF-SQLDW-ExportErrorRowFailed

  • Mensagem: A exceção acontece enquanto se escreve linhas de erro para o armazenamento.Message: Exception is happened while writing error rows to storage.
  • Causa: Uma exceção acontece ao escrever linhas de erro para armazenamento.Cause: An exception is happened while writing error rows to storage.
  • Recomendação: Verifique a configuração do serviço de dados rejeitados.Recommendation: Please check your rejected data linked service configuration.

Código de erro: DF-Executor-FieldNotExistError code: DF-Executor-FieldNotExist

  • Mensagem: Campo de estrutura não existe.Message: Field in struct does not exist.
  • Causa: Nomes de campo inválidos ou indisponíveis são utilizados em expressões.Cause: Invalid or unavailable field names are used in expressions.
  • Recomendação: Verifique os nomes de campo utilizados nas expressões.Recommendation: Check field names used in expressions.

Código de erro: DF-Xml-InvalidElementError code: DF-Xml-InvalidElement

  • Mensagem: Elemento XML tem sub elementos ou atributos que não podem ser convertidos.Message: XML Element has sub elements or attributes which can't be converted.
  • Causa: O elemento XML tem sub elementos ou atributos que não podem ser convertidos.Cause: The XML element has sub elements or attributes which can't be converted.
  • Recomendação: Atualize o ficheiro XML para que o elemento XML tenha sub elementos ou atributos certos.Recommendation: Update the XML file to make the XML element has right sub elements or attributes.

Código de erro: DF-GEN2-InvalidCloudTypeError code: DF-GEN2-InvalidCloudType

  • Mensagem: O tipo de nuvem é inválido.Message: Cloud type is invalid.
  • Causa: É fornecido um tipo de nuvem inválida.Cause: An invalid cloud type is provided.
  • Recomendação: Verifique o tipo de nuvem no seu serviço relacionado com a ADLS Gen2.Recommendation: Check the cloud type in your related ADLS Gen2 linked service.

Código de erro: DF-Blob-InvalidCloudTypeError code: DF-Blob-InvalidCloudType

  • Mensagem: O tipo de nuvem é inválido.Message: Cloud type is invalid.
  • Causa: É fornecido um tipo de nuvem inválida.Cause: An invalid cloud type is provided.
  • Recomendação: Verifique o tipo de nuvem no seu serviço relacionado com a Azure Blob.Recommendation: Please check the cloud type in your related Azure Blob linked service.

Código de erro: DF-Cosmos-FailToResetThroughputError code: DF-Cosmos-FailToResetThroughput

  • Mensagem: A operação de escala de produção do Cosmos DB não pode ser executada porque outra operação de escala está em andamento, por favor, recívar depois de algum tempo.Message: Cosmos DB throughput scale operation cannot be performed because another scale operation is in progress, please retry after sometime.
  • Causa: A operação de escala de produção do Cosmos DB não pode ser realizada porque outra operação de escala está em curso.Cause: The throughput scale operation of the Cosmos DB cannot be performed because another scale operation is in progress.
  • Recomendação: Faça login na sua conta Cosmos e altere manualmente a produção do seu recipiente para ser de escala automática ou adicione atividades personalizadas após fluxos de dados para redefinir a produção.Recommendation: Please log in your Cosmos account, and manually change its container's throughput to be auto scale or add custom activities after data flows to reset the throughput.

Código de erro: DF-Executor-InvalidPathError code: DF-Executor-InvalidPath

  • Mensagem: O caminho não se resolve a nenhum ficheiro.s.Message: Path does not resolve to any file(s). Certifique-se de que o ficheiro/pasta existe e não está escondido.Please make sure the file/folder exists and is not hidden.
  • Causa: É fornecido um percurso inválido de ficheiro/pasta, que não pode ser encontrado ou acedido.Cause: An invalid file/folder path is provided, which cannot be found or accessed.
  • Recomendação: Verifique o percurso ficheiro/pasta e certifique-se de que existe e pode ser acedido no seu armazenamento.Recommendation: Please check the file/folder path, and make sure it is existed and can be accessed in your storage.

Código de erro: DF-Executor-InvalidPartitionFileNamesError code: DF-Executor-InvalidPartitionFileNames

  • Mensagem: Os nomes dos ficheiros não podem ter valor(s) vazio enquanto a opção de nome de ficheiro é definida de acordo com a partição.Message: File names cannot have empty value(s) while file name option is set as per partition.
  • Causa: São fornecidos nomes de ficheiros de partição inválidos.Cause: Invalid partition file names are provided.
  • Recomendação: Verifique as definições da pia para ter o valor certo dos nomes dos ficheiros.Recommendation: Please check your sink settings to have the right value of file names.

Código de erro: DF-Executor-InvalidOutputColumnsError code: DF-Executor-InvalidOutputColumns

  • Mensagem: O resultado tem 0 colunas de saída.Message: The result has 0 output columns. Certifique-se de que pelo menos uma coluna está mapeada.Please ensure at least one column is mapped.
  • Causa: Nenhuma coluna está mapeada.Cause: No column is mapped.
  • Recomendação: Verifique o esquema da pia para se certificar de que pelo menos uma coluna está mapeada.Recommendation: Please check the sink schema to ensure that at least one column is mapped.

Código de erro: DF-Executor-InvalidInputColumnsError code: DF-Executor-InvalidInputColumns

  • Mensagem: A coluna na configuração da fonte não pode ser encontrada no esquema dos dados de origem.Message: The column in source configuration cannot be found in source data's schema.
  • Causa: As colunas inválidas são fornecidas na fonte.Cause: Invalid columns are provided on the source.
  • Recomendação: Verifique as colunas na configuração da origem e certifique-se de que se trata do subconjunto dos esquemas dos dados de origem.Recommendation: Check columns in the source configuration and make sure that it is the subset of the source data's schemas.

Código de erro: DF-AdobeIntegration-InvalidMapToFilterError code: DF-AdobeIntegration-InvalidMapToFilter

  • Mensagem: O recurso personalizado só pode ter uma chave/Id mapeada para filtrar.Message: Custom resource can only have one Key/Id mapped to filter.
  • Causa: São fornecidas configurações inválidas.Cause: Invalid configurations are provided.
  • Recomendação: Nas definições de AdobeIntegration, certifique-se de que o recurso personalizado só pode ter uma Chave/Id mapeada para filtrar.Recommendation: In your AdobeIntegration settings, make sure that the custom resource can only have one Key/Id mapped to filter.

Código de erro: DF-AdobeIntegration-InvalidPartitionConfigurationError code: DF-AdobeIntegration-InvalidPartitionConfiguration

  • Mensagem: Apenas uma única partição é suportada.Message: Only single partition is supported. O esquema de partição pode ser RoundRobin ou Hash.Partition schema may be RoundRobin or Hash.
  • Causa: São fornecidas configurações de partição inválidas.Cause: Invalid partition configurations are provided.
  • Recomendação: Nas definições de AdobeIntegration, confirme que apenas a partição única está definida e os esquemas de partição podem ser RoundRobin ou Hash.Recommendation: In AdobeIntegration settings, confirm that only the single partition is set and partition schemas may be RoundRobin or Hash.

Código de erro: DF-AdobeIntegration-KeyColumnMissedError code: DF-AdobeIntegration-KeyColumnMissed

  • Mensagem: A chave deve ser especificada para operações não inseríveis.Message: Key must be specified for non-insertable operations.
  • Causa: Falhas nas colunas-chave.Cause: Key columns are missed.
  • Recomendação: Atualizar as definições de AdobeIntegration para garantir que as colunas-chave são especificadas para operações não inseríveis.Recommendation: Update AdobeIntegration settings to ensure key columns are specified for non-insertable operations.

Código de erro: DF-AdobeIntegration-InvalidPartitionTypeError code: DF-AdobeIntegration-InvalidPartitionType

  • Mensagem: O tipo de partição tem de ser redondoRobin.Message: Partition type has to be roundRobin.
  • Causa: São fornecidos tipos de partição inválidos.Cause: Invalid partition types are provided.
  • Recomendação: Por favor, atualize as definições de AdobeIntegration para que o seu tipo de partição seja RoundRobin.Recommendation: Please update AdobeIntegration settings to make your partition type is RoundRobin.

Código de erro: DF-AdobeIntegration-InvalidPrivacyRegulationError code: DF-AdobeIntegration-InvalidPrivacyRegulation

  • Mensagem: Apenas a regulação de privacidade suportada atualmente é o RGPD.Message: Only privacy regulation supported currently is gdpr.
  • Causa: São fornecidas configurações de privacidade inválidas.Cause: Invalid privacy configurations are provided.
  • Recomendação: Por favor, atualize as definições da AdobeIntegration enquanto apenas a privacidade 'RGPD' é suportada.Recommendation: Please update AdobeIntegration settings while only privacy 'GDPR' is supported.

Dicas de resolução de problemas diversosMiscellaneous troubleshooting tips

  • Emissão: Ocorreu uma exceção inesperada e a execução falhou.Issue: Unexpected exception occurred and execution failed.

    • Mensagem: Durante a execução da atividade do Fluxo de Dados: Acerte uma exceção inesperada e a execução falhou.Message: During Data Flow activity execution: Hit unexpected exception and execution failed.
    • Causa: Este erro é um erro de serviço de back-end.Cause: This error is a back-end service error. Recompôs a operação e reinicie a sua sessão de depuragem.Retry the operation and restart your debugging session.
    • Recomendação: Se voltar a tentar e reiniciar não resolver o problema, contacte o suporte do cliente.Recommendation: If retrying and restarting doesn't resolve the problem, contact customer support.
  • Emissão: Não há dados de saída sobre a união durante a pré-visualização dos dados de depuração.Issue: No output data on join during debug data preview.

    • Mensagem: Há um elevado número de valores nulos ou valores em falta que podem ser causados por terem poucas linhas amostradas.Message: There are a high number of null values or missing values which may be caused by having too few rows sampled. Tente atualizar o limite da linha de depuragem e refrescar os dados.Try updating the debug row limit and refreshing the data.
    • Causa: A condição de junção ou não corresponde a nenhuma linha ou resultou num grande número de valores nulos durante a pré-visualização dos dados.Cause: The join condition either didn't match any rows or resulted in a large number of null values during the data preview.
    • Recomendação: Em Definições de Debug, aumente o número de linhas no limite da linha de origem.Recommendation: In Debug Settings, increase the number of rows in the source row limit. Certifique-se de selecionar um Azure IR que tenha um cluster de fluxo de dados que é grande o suficiente para lidar com mais dados.Be sure to select an Azure IR that has a data flow cluster that's large enough to handle more data.
  • Emissão: Erro de validação na fonte com ficheiros CSV multiline.Issue: Validation error at source with multiline CSV files.

    • Mensagem: Pode ver uma destas mensagens de erro:Message: You might see one of these error messages:
      • A última coluna é nula ou desaparecida.The last column is null or missing.
      • A validação do esquema na fonte falha.Schema validation at source fails.
      • A importação de schema não aparece corretamente no UX e a última coluna tem um novo carácter de linha no nome.Schema import fails to show correctly in the UX and the last column has a new line character in the name.
    • Causa: No fluxo de dados de mapeamento, os ficheiros de origem CSV multiline não funcionam atualmente quando \r\n é usado como o delimiter de linha.Cause: In the Mapping data flow, multiline CSV source files don't currently work when \r\n is used as the row delimiter. Às vezes, linhas extras nas devoluções de transporte podem causar erros.Sometimes extra lines at carriage returns can cause errors.
    • Recomendação: Gere o ficheiro na fonte utilizando \n como delimiter de linha em vez de \r\n.Recommendation: Generate the file at the source by using \n as the row delimiter rather than \r\n. Ou utilize a atividade Copy para converter o ficheiro CSV para utilizar \n como umlimiter de linha.Or use the Copy activity to convert the CSV file to use \n as a row delimiter.

Orientação geral de resolução de problemasGeneral troubleshooting guidance

  1. Verifique o estado das suas ligações de conjunto de dados.Check the status of your dataset connections. Em cada origem e transformação de pia, vá ao serviço ligado para cada conjunto de dados que está a usar e teste as ligações.In each source and sink transformation, go to the linked service for each dataset that you're using and test the connections.
  2. Verifique o estado do seu ficheiro e ligações de tabela no designer de fluxo de dados.Check the status of your file and table connections in the data flow designer. No modo de depurar, selecione Data Preview nas suas transformações de origem para garantir que pode aceder aos seus dados.In debug mode, select Data Preview on your source transformations to ensure that you can access your data.
  3. Se tudo parecer correto na pré-visualização de dados, vá ao designer pipeline e coloque o seu fluxo de dados numa atividade pipeline.If everything looks correct in data preview, go into the Pipeline designer and put your data flow in a Pipeline activity. Depurar o oleoduto para um teste de ponta a ponta.Debug the pipeline for an end-to-end test.

Melhoria do formato CSV/CDM no Fluxo de DadosImprovement on CSV/CDM format in Data Flow

Se utilizar o texto delimitado ou o formatação CDM para mapear o fluxo de dados na Azure Data Factory V2, poderá enfrentar as alterações de comportamento nos seus oleodutos existentes devido à melhoria do texto/CDM delimitado no fluxo de dados a partir de 1 de maio de 2021.If you use the Delimited Text or CDM formatting for mapping data flow in Azure Data Factory V2, you may face the behavior changes to your existing pipelines because of the improvement for Delimited Text/CDM in data flow starting from 1 May 2021.

Pode encontrar os seguintes problemas antes da melhoria, mas após a melhoria, as questões foram corrigidas.You may encounter the following issues before the improvement, but after the improvement, the issues were fixed. Leia o seguinte conteúdo para determinar se esta melhoria o afeta.Read the following content to determine whether this improvement affects you.

Cenário 1: Encontrar a emissão inesperada dolimiter da linhaScenario 1: Encounter the unexpected row delimiter issue

Você é afetado se estiver nas seguintes condições:You are affected if you are in the following conditions:

  • Utilizando o Texto Delimitado com a definição multiline definida para True ou CDM como fonte.Using the Delimited Text with the Multiline setting set to True or CDM as the source.
  • A primeira linha tem mais de 128 caracteres.The first row has more than 128 characters.
  • O delimiter de linha nos ficheiros de dados não é \n .The row delimiter in data files is not \n.

Antes da melhoria, olimiter de linha padrão \n pode ser inesperadamente utilizado para analisar ficheiros de texto delimitados, porque quando a definição multiline é definida para True, invalida a definição delimiter de linha, e o delimiter de linha é automaticamente detetado com base nos primeiros 128 caracteres.Before the improvement, the default row delimiter \n may be unexpectedly used to parse delimited text files, because when Multiline setting is set to True, it invalidates the row delimiter setting, and the row delimiter is automatically detected based on the first 128 characters. Se não detetar o delimiter de linha real, ele recuará para \n .If you fail to detect the actual row delimiter, it would fall back to \n.

Após a melhoria, qualquer um dos delimiters de três linhas: \r , \n deve ser \r\n trabalhado.After the improvement, any one of the three row delimiters: \r, \n, \r\n should be worked.

O exemplo a seguir mostra uma mudança de comportamento do pipeline após a melhoria:The following example shows you one pipeline behavior change after the improvement:

Exemplo:Example:
Para a seguinte coluna:For the following column:
C1, C2, {long first row}, C128\r\n
V1, V2, {values………………….}, V128\r\n 

Antes da melhoria, \r é mantido no valor da coluna.Before the improvement, \r is kept in the column value. O resultado da coluna analisada é:The parsed column result is:
C1 C2 {long first row} C128\r
V1 V2 {values………………….} V128\r

Após a melhoria, o resultado da coluna de análise deve ser:After the improvement, the parsed column result should be:
C1 C2 {long first row} C128
V1 V2 {values………………….} V128

Cenário 2: Encontrar um problema de valores de coluna de leitura incorreta que contenham '\r\n'Scenario 2: Encounter an issue of incorrectly reading column values containing '\r\n'

Você é afetado se estiver nas seguintes condições:You are affected if you are in the following conditions:

  • Utilizar o Texto Delimitado com a definição multiline definida para True ou CDM como fonte.Using the Delimited Text with the Multiline setting set to True or CDM as a source.
  • O delimiter de linha \r\n é.The row delimiter is \r\n.

Antes da melhoria, ao ler o valor da coluna, o \r\n interior pode ser substituído incorretamente por \n .Before the improvement, when reading the column value, the \r\n in it may be incorrectly replaced by \n.

Após a melhoria, \r\n o valor da coluna não será substituído por \n .After the improvement, \r\n in the column value will not be replaced by \n.

O exemplo a seguir mostra uma mudança de comportamento do pipeline após a melhoria:The following example shows you one pipeline behavior change after the improvement:

Exemplo:Example:

Para a seguinte coluna:For the following column:
"A\r\n", B, C\r\n

Antes da melhoria, o resultado da coluna analisada é:Before the improvement, the parsed column result is:
A\n B C

Após a melhoria, o resultado da coluna de análise deve ser:After the improvement, the parsed column result should be:
A\r\n B C

Cenário 3: Encontrar uma questão de escrever incorretamente valores de colunas contendo '\n'Scenario 3: Encounter an issue of incorrectly writing column values containing '\n'

Você é afetado se estiver nas seguintes condições:You are affected if you are in the following conditions:

  • Utilizando o Texto Delimitado como pia.Using the Delimited Text as a sink.
  • O valor da coluna \n contém.The column value contains \n.
  • O delimiter de linha está definido para \r\n .The row delimiter is set to \r\n.

Antes da melhoria, ao escrever o valor da coluna, o \n in pode ser substituído incorretamente por \r\n .Before the improvement, when writing the column value, the \n in it may be incorrectly replaced by \r\n.

Após a melhoria, \n o valor da coluna não será substituído por \r\n .After the improvement, \n in the column value will not be replaced by \r\n.

O exemplo a seguir mostra uma mudança de comportamento do pipeline após a melhoria:The following example shows you one pipeline behavior change after the improvement:

Exemplo:Example:

Para a seguinte coluna:For the following column:
A\n B C

Antes da melhoria, o lavatório CSV é:Before the improvement, the CSV sink is:
"A\r\n", B, C\r\n

Após a melhoria, o lavatório CSV deve ser:After the improvement, the CSV sink should be:
"A\n", B, C\r\n

Cenário 4: Encontre uma questão de ler incorretamente a corda vazia como NULOScenario 4: Encounter an issue of incorrectly reading empty string as NULL

Você é afetado se estiver nas seguintes condições:You are affected if you are in the following conditions:

  • Utilizar o Texto Delimitado como fonte.Using the Delimited Text as a source.
  • O valor NULO é definido para valor não vazio.NULL value is set to non-empty value.
  • O valor da coluna é de corda vazia e não é citado.The column value is empty string and is unquoted.

Antes da melhoria, o valor da coluna da corda vazia não citada é lido como NU.Before the improvement, the column value of unquoted empty string is read as NULL.

Após a melhoria, a corda vazia não será analisada como valor NU.After the improvement, empty string will not be parsed as NULL value.

O exemplo a seguir mostra uma mudança de comportamento do pipeline após a melhoria:The following example shows you one pipeline behavior change after the improvement:

Exemplo:Example:

Para a seguinte coluna:For the following column:
A, ,B,

Antes da melhoria, o resultado da coluna analisada é:Before the improvement, the parsed column result is:
A null B null

Após a melhoria, o resultado da coluna de análise deve ser:After the improvement, the parsed column result should be:
A "" (empty string) B "" (empty string)

Passos seguintesNext steps

Para obter mais ajuda na resolução de problemas, consulte estes recursos:For more help with troubleshooting, see these resources: