Поделиться через

Устранение неполадок с соединителями Dynamics 365, Dataverse (Common Data Service) и Dynamics CRM в Фабрике данных Azure и Azure Synapse

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

В этой статье приведены рекомендации по устранению распространенных проблем с соединителями Dynamics 365, Dataverse (Common Data Service) и Dynamics CRM в Фабрике данных Azure и Azure Synapse.

Код ошибки: DynamicsCreateServiceClientError

  • Сообщение. This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • Причина. Это временная проблема на стороне сервера Dynamics.

  • Рекомендация. Перезапустите конвейер. Если ошибка сохраняется, попробуйте уменьшить степень параллелизма. Если устранить неполадку не удается, обратитесь в службу поддержки Dynamics.

Отсутствие столбцов при импорте схемы или предварительном просмотре данных

  • Симптомы. При импорте схемы или предварительном просмотре данных некоторые столбцы отсутствуют. Сообщение об ошибке: The valid structure information (column name and type) are required for Dynamics source.

  • Причина. Эта проблема закономерна, так как Фабрика данных и конвейеры Synapse не могут отображать столбцы без значений в первых 10 записях. Убедитесь в том, что добавленные столбцы имеют правильный формат.

  • Рекомендация. Вручную добавьте столбцы на вкладке сопоставления. Дополнительные сведения см. здесь.

Код ошибки: DynamicsMissingTargetForMultiTargetLookupField

  • Сообщение. Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • Причина. Целевого столбца нет в источнике или в сопоставлении столбцов.

  • Рекомендация.

    1. Убедитесь в том, что в источнике есть целевой столбец.
    2. Добавьте целевой столбец в сопоставление столбцов. Убедитесь в том, что столбец в приемнике имеет формат {fieldName}@EntityReference.

Код ошибки: DynamicsInvalidTargetForMultiTargetLookupField

  • Сообщение. The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • Причина. Для целевой сущности поля множественной подстановки указано неверное имя.

  • Рекомендация. Укажите допустимое имя сущности в поле множественной подстановки.

Код ошибки: DynamicsInvalidTypeForMultiTargetLookupField

  • Сообщение. The provided target type is not a valid string. Field: '%fieldName;'.

  • Причина. Значение в целевом столбце не является строкой.

  • Рекомендация. Укажите допустимую строку в целевом столбце множественной подстановки.

Код ошибки: DynamicsFailedToRequestServer

  • Сообщение. The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • Причина. Сервер Dynamics работает нестабильно или недоступен, либо в сети имеются проблемы.

  • Рекомендация. Чтобы получить дополнительные сведения, проверьте сетевое подключение или журнал сервера Dynamics. За дополнительной помощью обратитесь в службу поддержки Dynamics.

Код ошибки: DynamicsFailedToConnect

  • Сообщение. Failed to connect to Dynamics: %message;

  • Причины и рекомендации. К этой ошибке могут привести различные причины. Ниже приведен список возможных причин и соответствующие рекомендации.

    Анализ причин Рекомендация
    Вы видите ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. или иным 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' образом, если ваш вариант использования соответствует всем следующим трем условиям:
  • вы подключаетесь к Dynamics 365, Common Data Service или Dynamics CRM;
  • вы используете проверку подлинности Office 365;
  • Клиент и пользователь настроены в идентификаторе Microsoft Entra для условного доступа и (или) Многофакторной идентификации (см. эту ссылку на документ Dataverse).
    • В этих обстоятельствах соединение будет успешно использоваться до 08.06.2021. После 09.06.2021 подключение начнет сбоить из-за прекращения поддержки службы обнаружения (см. здесь).    		 Если клиент и пользователь настроены в идентификаторе Microsoft Entra для условного доступа и (или) Многофакторной идентификации, необходимо использовать субъект-службу Microsoft Entra для проверки подлинности после 6/8/2021. Подробные инструкции см. здесь.
    Если вы видите Office 365 auth with OAuth failed в сообщении об ошибке, это означает, что у вашего сервера могут быть некоторые конфигурации, несовместимые с OAuth.
  • Обратитесь за помощью в службу поддержки Dynamics, передав подробное сообщение об ошибке.
  • Используйте проверку подлинности субъекта-службы и см. в этой статье: Пример: Dynamics online с помощью субъекта-службы Microsoft Entra и проверки подлинности сертификата.
    		•
    Если вы видите Unable to retrieve authentication parameters from the serviceUri в сообщении об ошибке, это означает, что вы ввели неправильный URL-адрес службы Dynamics или прокси/брандмауэр для перехвата трафика.
  • Укажите правильный универсальный код ресурса (URI) службы в связанной службе.
  • При использовании локальной среды IR убедитесь в том, что брандмауэр или прокси-сервер не перехватывает запросы к серверу Dynamics.
    		•
    Если вы видите An unsecured or incorrectly secured fault was received from the other party в сообщении об ошибке, это означает, что со стороны сервера получены неожиданные ответы.
  • Если используется проверка подлинности Office 365, проверьте правильность имени пользователя и пароля.
  • Убедитесь в том, что введен правильный универсальный код ресурса (URI) службы.
  • Если используется региональный URL-адрес CRM (в нем есть число после crm), проверьте правильность регионального идентификатора.
  • Обратитесь за помощью в службу поддержки Dynamics.
    		•
    Если вы видите No Organizations Found в сообщении об ошибке, это означает, что либо название вашей организации неверно, либо вы использовали неправильный идентификатор региона CRM в URL-адресе службы.
  • Убедитесь в том, что введен правильный универсальный код ресурса (URI) службы.
  • Если используется региональный URL-адрес CRM (в нем есть число после cm), проверьте правильность регионального идентификатора.
  • Обратитесь за помощью в службу поддержки Dynamics.
    		•
    Если вы видите 401 Unauthorized сообщение об ошибке, связанное с Microsoft Entra, это означает, что возникла проблема с субъектом-службой. Следуйте указаниям в сообщении об ошибке, чтобы устранить проблему с принципалом службы.
    Что касается других ошибок, обычно проблема связана с сервером. Используйте XrmToolBox, чтобы установить соединение. Если ошибка сохраняется, обратитесь за помощью в службу поддержки Dynamics.

Код ошибки: DynamicsOperationFailed

  • Сообщение. Dynamics operation failed with error code: %code;, error message: %message;.

  • Причина. Сбой операции на стороне сервера.

  • Рекомендация. Получите код ошибки операции Dynamics из сообщения об ошибке (Dynamics operation failed with error code: {code}) и ознакомьтесь с подробными сведениями в статье Коды ошибок веб-службы. При необходимости можно обратиться в службу поддержки Dynamics.

Код ошибки: DynamicsInvalidFetchXml

  • Сообщение. The Fetch Xml query specified is invalid.

  • Причина. В инструкции получения XML возникла ошибка.

  • Рекомендация. Исправьте ошибку в инструкции получения XML.

Код ошибки: DynamicsMissingKeyColumns

  • Сообщение. Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • Причина. В исходных данных нет ключевого столбца для сущности приемника.

  • Рекомендация. Убедитесь в том, что в исходных данных есть ключевые столбцы, или сопоставьте исходный столбец с ключевым в сущности приемника.

Код ошибки: DynamicsPrimaryKeyMustBeGuid

  • Сообщение. The primary key attribute '%attribute;' must be of type guid.

  • Причина. Первичный ключевой столбец не имеет тип Guid.

  • Рекомендация. Убедитесь в том, что первичный ключевой столбец в исходных данных имеет тип Guid.

Код ошибки: DynamicsAlternateKeyNotFound

  • Сообщение. Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • Причина. Указанный альтернативный ключ не существует. Причиной могут быть неправильные имена ключей или отсутствие необходимых разрешений.

  • Рекомендация:

    • Исправьте опечатки в имени ключа.
    • Убедитесь в том, что у вас есть достаточные разрешения на доступ к сущности.

Код ошибки: DynamicsInvalidSchemaDefinition

  • Сообщение. The valid structure information (column name and type) are required for Dynamics source.

  • Причина. В столбцах приемника в сопоставлении столбцов нет свойства type.

  • Рекомендация. Вы можете добавить свойство type к этим столбцам в сопоставлении столбцов с помощью редактора JSON на портале.

Код ошибки: UserErrorUnsupportedAttributeType

  • Сообщение. The attribute type 'Lookup' of field %attributeName; is not supported

  • Причина. При загрузке данных в приемник Dynamics Фабрика данных Azure применяет проверку метаданных атрибута подстановки. Однако существует известная проблема с определенными сущностями Dynamics, которые не имеют допустимых метаданных атрибута подстановки, содержащих список целевых объектов, из-за которой происходит сбой проверки.

  • Рекомендация. Чтобы устранить проблему, обратитесь в службу поддержки Dynamics.

Действие копирования из Dynamics 365 считывает больше строк, чем их реально существует

  • Симптомы. Действие копирования из Dynamics 365 считывает больше строк, чем их реально существует.

  • Причина. Сервер Dynamics 365 всегда указывает наличие большего числа доступных записей.

  • Рекомендация. Используйте XrmToolBox для проверки FetchXML с разбивкой на страницы. XrmToolBox предоставляет некоторые инструменты для получения количества записей. Дополнительные сведения см. в документации по XrmToolBox.

Не удается получить в действии копирования доступ к виртуальным столбцам из источников Dynamics

  • Симптомы. Не удается получить в действии копирования доступ к виртуальным столбцам из источников Dynamics.

  • Причина. Виртуальный столбец пока не поддерживается.

  • Рекомендация. Выполните следующие действия, чтобы получить значение Option Set.

Параллельное копирование в хранилище данных Dynamics CRM

  • Симптомы. Вы не знаете, можно ли настроить параллельное копирование в хранилище данных Dynamics CRM и не знаете диапазон значений, которые можно настраивать в разделе "Степень параллелизма копирования".

  • Рекомендация. Параллельное копирование управляет параллелизмом, и для него можно указать в разделе "Степень параллелизма копирования" отличное от нуля значение. Большое число может привести к регулированию на стороне сервера Dynamics, что может снизить пропускную способность, но теперь такое регулирование обрабатывается путем применения общедоступного пакета SDK.

    Схема: раздел степени параллелизма копирования.

Преобразование типов Dynamics

  • Симптомы. Вы Пытаетесь преобразовать GUID в строку в источнике Dynamics, но возникает ошибка.

  • Причина. Если Dynamics используется в качестве источника, преобразование типов не поддерживается.

  • Рекомендация. Добавьте промежуточное хранение и повторите попытку.

Связанный контент

Для получения дополнительных сведений об устранении неполадок воспользуйтесь следующими ресурсами: