Partilhar via

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

  • Artigo

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 fornece sugestões para solucionar problemas comuns com os conectores Dynamics 365, Dataverse (Common Data Service) e Dynamics CRM no 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.

  • Causa: 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, contacte o suporte do Dynamics.

Colunas ausentes ao importar um esquema ou visualizar dados

  • Sintomas: algumas colunas estão ausentes quando você importa um esquema ou visualiza 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 Data Factory e Synapse não conseguem mostrar colunas que não contêm valores nos primeiros 10 registros. Certifique-se de que as colunas adicionadas estão no formato correto.

  • Recomendação: adicione manualmente as colunas na guia de mapeamento. Para obter mais detalhes, 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. Certifique-se de que a origem contém a coluna de destino.
    2. Adicione a coluna de destino no mapeamento de coluna. Verifique se a coluna do coletor 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 errado é fornecido como entidade de destino de um campo de pesquisa de vários destinos.

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

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 destino de pesquisa de vários destinos.

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.

  • Causa: O servidor Dynamics está instável ou inacessível ou a rede está com problemas.

  • Recomendação: Para obter mais detalhes, verifique a conectividade de rede ou verifique o log do servidor do Dynamics. Para obter mais ajuda, contacte o suporte do Dynamics.

Código de erro: DynamicsFailedToConnect

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

  • Causas e recomendações: Diferentes causas podem levar a este erro. Confira abaixo a lista para possível análise de causa e recomendação relacionada.

    Análise de 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 o seu caso de uso atende a todas as três condições a seguir:
  • Você está se conectando ao Dynamics 365, Common Data Service ou Dynamics CRM.
  • Está a utilizar a Autenticação do Office365.
  • Seu locatário e usuário estão configurados no Microsoft Entra ID para acesso condicional e/ou a autenticação multifator é necessária (consulte este link para o documento do Dataverse).
    • Nestas circunstâncias, a ligação costumava ter sucesso antes de 6/8/2021. A partir de 09/06/2021, a conexão começará a falhar devido à descontinuação do Serviço de Descoberta regional (veja este link).    		 Se o seu locatário e usuário estiver configurado no Microsoft Entra ID para acesso condicional e/ou a Autenticação Multifator for necessária, você deverá usar 'Entidade de serviço do Microsoft Entra' para autenticar após 8/6/2021. Consulte este link para obter etapas detalhadas.
    Se você vir Office 365 auth with OAuth failed na mensagem de erro, isso significa que seu servidor pode ter algumas configurações não compatíveis com OAuth.
  • Entre em contato com a equipe de suporte do Dynamics 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 e a autenticação de certificado do Microsoft Entra.
    		•
    Se você vir Unable to retrieve authentication parameters from the serviceUri na mensagem de erro, isso significa que você insere a URL de serviço Dynamics errada ou proxy/firewall para intercetar o tráfego.
  • Verifique se você colocou o URI de serviço correto no serviço vinculado.
  • Se você usar o Self Hosted IR, certifique-se de que o firewall/proxy não intercete as solicitações para o servidor do 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.
  • Certifique-se de que o seu nome de utilizador e palavra-passe estão corretos se utilizar a autenticação do Office 365.
  • Verifique se você inseriu o URI de serviço correto.
  • Se utilizar CRM URL REGIONAL (URL tem um número depois de 'crm'), certifique-se de que utiliza 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, isso significa que o nome da sua organização está errado ou você usou um identificador de região do CRM errado na URL do serviço.
  • Verifique se você inseriu o URI de serviço correto.
  • Se você usar o URL CRM REGIONAL (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 vir 401 Unauthorized uma mensagem de erro relacionada com o Microsoft Entra, significa que existe um problema com a entidade de serviço. Siga as orientações 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 fazer 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: A operação falhou no lado do servidor.

  • Recomendação: Extraia o código de erro da operação dinâmica da mensagem de erro: Dynamics operation failed with error code: {code}, e consulte o artigo Códigos de erro de serviço 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 do coletor.

  • Recomendação: confirme se as colunas de chave estão nos dados de origem ou mapeie uma coluna de origem para a coluna de chave na entidade do coletor.

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: Certifique-se de que 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 errados ou permissões insuficientes.

  • Recomendação:

    • Corrija erros de digitação no nome da chave.
    • Certifique-se de que tem 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 coletor no mapeamento de coluna perdem a propriedade 'type'.

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

Código de erro: UserErrorUnsupportedAttributeType

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

  • Causa: ao carregar dados no coletor do Dynamics, o Azure Data Factory impõe a validação nos metadados do atributo de pesquisa. No entanto, há o problema conhecido de certas entidades do Dynamics não terem metadados de atributos de pesquisa válidos que contenham uma lista de destinos, o que falharia na validação.

  • Recomendação: Entre em contato com a equipe de suporte do Dynamics para mitigar 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.

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

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

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

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

  • Causa: A coluna virtual não é suportada agora.

  • Recomendação: Para o valor Conjunto de opções, siga as opções abaixo para obtê-lo:

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

  • Sintomas: você não sabe se é possível configurar a cópia paralela em um armazenamento de dados do Dynamics CRM e também não sabe o intervalo de valores que pode ser definido 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 de cópia" pode ser definida como valor diferente de zero. Um grande número pode causar limitação no lado do servidor dinâmico, o que pode reduzir a taxa de transferência, mas agora a limitação é tratada usando o SDK público.

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

Conversão de tipo dinâmico

  • Sintomas: Você tenta converter o GUID em uma cadeia de caracteres na fonte do Dynamics, mas encontra um erro.

  • Causa: Quando o Dynamics é usado como origem, a conversão de tipo não é suportada.

  • Recomendação: Habilite o preparo e tente novamente.

Conteúdos relacionados

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