Compartilhar 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

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!

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

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

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: adicionar manualmente as colunas na guia de mapeamento. Para obter mais detalhes, confira 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 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 incorreto é 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á tendo problemas.

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

Código de erro: DynamicsFailedToConnect

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

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

    Análise da causa Recomendação
    Você está vendo ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. ou 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 abaixo:
  • Você está se conectando ao Dynamics 365, Common Data Service ou Dynamics CRM.
  • Você está usando a Autenticação do Office365.
  • O locatário e o usuário estão configurados na ID do Microsoft Entra para acesso condicional e/ou a Autenticação Multifator é necessária (consulte este link para o documento do Dataverse).
    • Nessas circunstâncias, a conexão costumava ser bem-sucedida antes de 8/6/2021. A partir de 9/06/2021, a conexão começará a falhar devido à reprovação do Serviço de Descoberta regional (consulte este link).    		 Se o locatário e o usuário estiverem configurados na ID do Microsoft Entra para acesso condicional e/ou a Autenticação Multifator for necessária, você deverá usar a "entidade de serviço do Microsoft Entra" para autenticar após 8/06/2021. Consulte este link para ver as etapas detalhadas.
    Se você vir Office 365 auth with OAuth failed na mensagem de erro, significa que seu servidor pode ter algumas configurações incompatí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 do Microsoft Entra e a autenticação decertificado.
    		•
    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 do Dynamics ou proxy/firewall incorretos 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 hospedado automaticamente, certifique-se de que o firewall/proxy não intercepte 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.
  • Certifique-se de que seu nome de usuário e senha estejam corretos se você usar a autenticação do 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 a mensagem de erro relacionada ao Microsoft Entra, isso significa que há 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 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 do Dynamics da mensagem de erro: Dynamics operation failed with error code: {code} e confira o artigo Códigos de erro do 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: há 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: confirme se as colunas de chave estão nos dados de origem ou mapeiam uma coluna de origem para a coluna-chave na entidade 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: verifique se a coluna de chave primária nos dados de origem são 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 coletor no mapeamento de coluna perdem 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 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 determinadas entidades do Dynamics não terem metadados de atributo de pesquisa válidos que contenham uma lista de destinos, o que falharia na validação.

  • Recomendação: 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.

  • Causa: o servidor do 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 podem obter a contagem de registros. Para obter mais informações, confira 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: 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:

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 nem conhece o intervalo de valores que podem ser definidos na seção "Grau de paralelismo de cópia".

  • Recomendação: o paralelismo de controles de cópia paralela e a seção "Grau de paralelismo de cópia" podem ser definidos como 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 de cópia.

Conversão de tipo do Dynamics

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

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

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

Conteúdo relacionado

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