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

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo fornece sugestões para resolver 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 é uma questão transitória do lado do servidor Dynamics.

• Recomendação: Execute novamente o pipeline. Se falhar novamente, tente reduzir o paralelismo. Se o problema persistir, contacte o suporte da 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 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. 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 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 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 com múltiplos 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 válida na coluna de destino de pesquisa múltipla.

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á a apresentar problemas.

• Recomendação: Para mais detalhes, verifique a conectividade da rede ou verifique o registo Dynamics servidor. Para mais ajuda, contacte o suporte da 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
  Está a ver ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. ou caso contrário 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 cumprir todas das seguintes três condições: Estás a ligar-te ao Dynamics 365, Common Data Service ou Dynamics CRM. Está a utilizar a Autenticação do Office365. O seu inquilino e utilizador estão configurados em Microsoft Entra ID para acesso condicional e/ou é necessária autenticação multifator (veja este link para o documento 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 inquilino e utilizador estiverem configurados em Microsoft Entra ID para condicional e/ou for necessária autenticação multifator, deve usar 'Microsoft Entra principal de serviço' para autenticar após 8/6/2021. Consulte este link para obter etapas detalhadas.
  Se vires Office 365 auth with OAuth failed na mensagem de erro, significa que o teu servidor pode ter algumas configurações incompatíveis com o OAuth.	Contacte a equipa de suporte da Dynamics com a mensagem de erro detalhada para obter ajuda. Use a autenticação do principal de serviço e pode consultar este artigo: Exemplo: Dynamics online usando Microsoft Entra principal de serviço e autenticação de certificados.
  Se vires Unable to retrieve authentication parameters from the serviceUri na mensagem de erro, significa que ou introduziste o URL errado do serviço Dynamics ou proxy/firewall para intercetar o tráfego.	Verifique se você colocou o URI de serviço correto no serviço vinculado. Se usares o IR Auto-Hospedado, certifica-te de que o firewall/proxy não interceta os pedidos 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 o seu nome de utilizador e palavra-passe estão corretos se usar 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. Contacte a equipa de suporte da 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. Contacte a equipa de suporte da Dynamics para obter ajuda.
  Se vir 401 Unauthorized e a mensagem de erro relacionada com o Microsoft Entra, 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 fazer conexão. Se o erro persistir, contacte a equipa de suporte da 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 de Dynamics da mensagem de erro: Dynamics operation failed with error code: {code}, e consulte o artigo Códigos de Erro de Serviço Web para informações mais detalhadas. Pode contactar a equipa de suporte da Dynamics, se necessário.

Código de erro: DynamicsInvalidFetchXml

• Mensagem: The Fetch Xml query specified is invalid.

• Causa: existia 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 destino.

• Recomendação: Confirme se colunas-chave estão nos dados fonte 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: 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

• Cause: Ao carregar dados para Dynamics sink, Azure Data Factory impõe validação aos metadados do atributo de pesquisa. No entanto, há o problema conhecido de certas entidades do Dynamics não terem metadados válidos de atributos de pesquisa que contenham uma lista de alvos, o que falharia a validação.

• Recomendação: Contacte Dynamics equipa de suporte 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.

• Cause: O servidor Dynamics 365 indica sempre mais registos disponíveis.

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

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

• Sintomas: Você não pode aceder a 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:

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

A cópia paralela num armazenamento de dados Dynamics CRM

• Sintomas: Não sabes se é possível configurar a cópia paralela num Dynamics CRM data store, e também não sabes o intervalo de valores que podem ser definidos na secçã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 regulação na parte dinâmica do servidor, o que pode reduzir a taxa de transferência, mas agora essa regulação é tratada usando o SDK público.

  

Conversão de tipos Dynamics

• Sintomas: Tenta converter o GUID para uma cadeia na Dynamics fonte, mas encontra um erro.

• Cause: Quando Dynamics é usado como fonte, 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:

• Guia de resolução de problemas do conector
• Blogue do Data Factory
• Solicitações de recursos do Data Factory
• Azure vídeos
• Página de perguntas e respostas da Microsoft
• Fórum Stack Overflow para Data Factory
• X informações sobre Data Factory