Solucionar problemas de conectores Dynamics 365, Dataverse (Common Data Service) e CRM Dynamics em Azure Data Factory e Azure Synapse

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Data Factory no Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA interna e novos recursos. Se você não estiver familiarizado com a integração de dados, comece com Fabric Data Factory. As cargas de trabalho existentes do ADF podem ser atualizadas para Fabric para acessar novos recursos em ciência de dados, análise em tempo real e relatórios.

Este artigo fornece sugestões para solucionar problemas comuns com os conectores Dynamics 365, Dataverse (Common Data Service) e Dynamics CRM em Azure Data Factory e Azure Synapse.

Código de erro: DynamicsCreateServiceClientError

  • Mensagem: This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • Cause: o problema é um problema transitório no lado do servidor Dynamics.

  • Recomendação: execute novamente o pipeline. Se falhar novamente, tente reduzir o paralelismo. Se o problema persistir, entre em contato com Dynamics suporte.

Colunas ausentes ao importar um esquema ou Visualizar dados

  • Sintomas: algumas colunas estão faltando ao importar um esquema ou visualizar dados. Mensagem de erro: The valid structure information (column name and type) are required for Dynamics source.

  • Causa: esse problema ocorre por design, porque os pipelines do Synapse e do Data Factory não podem mostrar colunas que não contenham valores nos primeiros 10 registros. Certifique-se de que as colunas que você adicionou estão no formato correto.

  • Recomendação: adicione manualmente as colunas na guia mapeamento. Para obter mais informações, consulte mapeamento explícito.

Código de erro: DynamicsMissingTargetForMultiTargetLookupField

  • Mensagem: Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • Causa: a coluna de destino não existe na origem ou no mapeamento de coluna.

  • Recomendação:

    1. Verifique se a origem contém a coluna de destino.
    2. Adicione a coluna de destino no mapeamento de coluna. Verifique se a coluna de destino está no formato {fieldName}@EntityReference.

Código de erro: DynamicsInvalidTargetForMultiTargetLookupField

  • Mensagem: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • Causa: um nome de entidade incorreto é fornecido como entidade de destino de um campo de pesquisa com múltiplos destinos.

  • Recomendação: forneça um nome de entidade válido para o campo de pesquisa de vários alvos.

Código de erro: DynamicsInvalidTypeForMultiTargetLookupField

  • Mensagem: The provided target type is not a valid string. Field: '%fieldName;'.

  • Causa: o valor na coluna de destino não é uma cadeia de caracteres.

  • Recomendação: forneça uma cadeia de caracteres válida na coluna de múltiplos alvos de pesquisa.

Código de erro: DynamicsFailedToRequestServer

  • Mensagem: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • Cause: o servidor Dynamics é instaível ou inacessível ou a rede está enfrentando problemas.

  • Recommendation: para obter mais detalhes, verifique a conectividade de rede ou verifique o log do servidor Dynamics. Para obter mais ajuda, entre em contato com Dynamics suporte.

Código de erro: DynamicsFailedToConnect

  • Mensagem: Failed to connect to Dynamics: %message;

  • Causas e recomendações: causas diferentes podem levar a esse erro. Considere a lista abaixo para análise das possíveis causas e recomendações relacionadas.

    Análise da causa Recomendação
    Você está vendo ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. ou de outra forma Unable to Login to Dynamics CRM, message:ERROR REQUESTING Token FROM THE Authentication context - USER intervention required but not permitted by prompt behavior AADSTS50079: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multi-factor authentication to access '00000007-0000-0000-c000-000000000000' se seu caso de uso atender a todas as três condições a seguir:
  • Você está se conectando a Dynamics 365, Common Data Service ou Dynamics CRM.
  • Você está usando a Autenticação do Office365.
  • Seu locatário e usuário estão configurados no Microsoft Entra ID para acesso condicional e/ou é necessária a autenticação multifatorial (consulte este link para a documentação do Dataverse).
    • Nessas circunstâncias, a conexão costumava ser bem-sucedida antes de 06/08/2021. A partir de 09/06/2021, a conexão começará a falhar devido à substituição do Serviço de Descoberta regional (consulte este link).    		 Se seu locatário e usuário estiverem configurados no Microsoft Entra ID para acesso condicional e/ou a autenticação multifator for obrigatória, você deverá usar 'entidade de serviço do Microsoft Entra' para autenticar após 08/06/2021. Consulte este link para ver as etapas detalhadas.
    Se você vir Office 365 auth with OAuth failed na mensagem de erro, isso significa que o servidor pode ter algumas configurações não compatíveis com o OAuth.
  • Entre em contato com Dynamics equipe de suporte com a mensagem de erro detalhada para obter ajuda.
  • Use a autenticação da entidade de serviço, e você pode consultar este artigo: Exemplo: Dynamics online usando a entidade de serviço do Microsoft Entra e a autenticação de certificado.
    		•
    Se você vir Unable to retrieve authentication parameters from the serviceUri na mensagem de erro, isso significa que você inseriu a URL de serviço Dynamics incorreta ou que o proxy/firewall está configurado para interceptar o tráfego.
  • Certifique-se de ter colocado o URI de serviço correto no serviço vinculado.
  • Se você usar o IR auto-hospedado, verifique se o firewall/proxy não intercepta as solicitações para o servidor Dynamics.
    		•
    Se você vir An unsecured or incorrectly secured fault was received from the other party na mensagem de erro, isso significa que respostas inesperadas foram obtidas do lado do servidor.
  • Verifique se o nome de usuário e a senha estão corretos se você usar a autenticação Office 365.
  • Certifique-se de inserir o URI de serviço correto.
  • Se você usar o URL regional do CRM (o URL tem um número após 'crm'), certifique-se de usar o identificador regional correto.
  • Entre em contato com a equipe de suporte do Dynamics para obter ajuda.
    		•
    Se você vir No Organizations Found na mensagem de erro, significa que o nome da sua organização está errado ou você usou um identificador de região CRM incorreto no URL do serviço.
  • Certifique-se de inserir o URI de serviço correto.
  • Se você usar a URL regional do CRM (a URL tem um número após 'crm'), certifique-se de usar o identificador regional correto.
  • Entre em contato com a equipe de suporte do Dynamics para obter ajuda.
    		•
    Se você vir 401 Unauthorized e uma mensagem de erro relacionada ao Microsoft Entra, isso significa que há um problema com a entidade de serviço. Siga as diretrizes na mensagem de erro para corrigir o problema da entidade de serviço.
    Para outros erros, geralmente o problema está no lado do servidor. Use XrmToolBox para estabelecer a conexão. Se o erro persistir, entre em contato com a equipe de suporte do Dynamics para obter ajuda.

Código de erro: DynamicsOperationFailed

  • Mensagem: Dynamics operation failed with error code: %code;, error message: %message;.

  • Causa: falha na operação no lado do servidor.

  • Recomendação: extraia o código de erro da operação de dinâmica da mensagem de erro: Dynamics operation failed with error code: {code}, e consulte o artigo Códigos de erro de serviços web para obter informações mais detalhadas. Você pode entrar em contato com a equipe de suporte do Dynamics, se necessário.

Código de erro: DynamicsInvalidFetchXml

  • Mensagem: The Fetch Xml query specified is invalid.

  • Causa: existe um erro no XML de busca.

  • Recomendação: corrija o erro no XML de busca.

Código de erro: DynamicsMissingKeyColumns

  • Mensagem: Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • Causa: os dados de origem não contêm a coluna de chave para a entidade de coletor.

  • Recomendação: verifique se as colunas-chave estão presentes nos dados de origem ou mapeie uma coluna de origem para a coluna-chave na entidade de destino.

Código de erro: DynamicsPrimaryKeyMustBeGuid

  • Mensagem: The primary key attribute '%attribute;' must be of type guid.

  • Causa: o tipo da coluna de chave primária não é “Guid”.

  • Recomendação: verifique se a coluna de chave primária nos dados de origem é do tipo 'Guid'.

Código de erro: DynamicsAlternateKeyNotFound

  • Mensagem: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • Causa: a chave alternativa fornecida não existe, o que pode ser causado por nomes de chave incorretos ou permissões insuficientes.

  • Recomendação:

    • Corrija os erros de digitação no nome da chave.
    • Certifique-se de ter permissões suficientes na entidade.

Código de erro: DynamicsInvalidSchemaDefinition

  • Mensagem: The valid structure information (column name and type) are required for Dynamics source.

  • Causa: as colunas do mapeamento de colunas não possuem a propriedade ‘type’.

  • Recomendação: você pode adicionar a propriedade 'type' a essas colunas no mapeamento de coluna usando o editor de JSON no portal.

Código de erro: UserErrorUnsupportedAttributeType

  • Mensagem: The attribute type 'Lookup' of field %attributeName; is not supported

  • Causa: ao carregar dados no destino do Dynamics, o Azure Data Factory realiza uma validação dos metadados dos atributos de pesquisa. No entanto, há um problema conhecido em certas entidades do Dynamics que não possuem metadados válidos de atributos de pesquisa que armazenam uma lista de alvos, o que resultaria em falha na validação.

  • Recommendation: contate a equipe de suporte do Dynamics para atenuar o problema.

A atividade de cópia do Dynamics 365 lê mais linhas do que o número real

  • Sintomas: a atividade de cópia do Dynamics 365 lê mais linhas do que o número real.

  • Cause: o servidor Dynamics 365 sempre indica mais registros disponíveis.

  • Recomendação: use o XrmToolBox para testar o FetchXML com a paginação. XrmToolBox com algumas ferramentas instaladas pode obter a contagem de registros. Para obter mais informações, confira XrmToolBox.

Não é possível acessar colunas virtuais de fontes de Dynamics na atividade de cópia

  • Sintomas: não é possível acessar colunas virtuais de fontes do Dynamics na atividade de cópia.

  • Causa: não há suporte para a coluna virtual no momento.

  • Recomendação: siga as opções abaixo para obter o valor Conjunto de Opções:

    • Você pode vincular a entidade StringMap à sua entidade de destino e obter os valores associados.

A cópia paralela em um repositório de dados do Dynamics CRM

  • Symptoms: você não sabe se é possível configurar a cópia paralela em um repositório de dados do CRM Dynamics e também não sabe o intervalo de valores que podem ser definidos na seção "Grau de paralelismo de cópia".

  • Recomendação: a cópia paralela controla o paralelismo, e a seção “Grau de paralelismo da cópia” pode ser definida com um valor diferente de zero. Um número grande pode causar limitação no servidor do Dynamics, o que pode reduzir a taxa de transferência, mas agora a limitação é tratada por meio do SDK público.

    Diagrama da seção Grau de paralelismo da cópia.

conversão de tipo Dynamics

  • Symptoms: você tenta converter o GUID em uma cadeia de caracteres na origem do Dynamics, mas encontra um erro.

  • Cause: quando Dynamics é usado como origem, não há suporte para a conversão de tipo.

  • Recomendação: ative o processamento intermediário e a repetição.

Conteúdo relacionado

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

  • Last updated on