Устранение неполадок соединителей в Фабрике данных Azure и Azure Synapse Analytics

Статья
10/20/2023

Область применения:Фабрика данных Azure Azure Synapse Analytics

Совет

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

В этой статье описывается, как устранять неполадки соединителей в Фабрике данных Azure и Azure Synapse Analytics.

Проблемы, связанные с соединителями

Сведения о проблемах конкретного соединителя и рекомендации по их устранению можно найти на страницах устранения неполадок для каждого соединителя.

Общие ошибки действия Copy

Приведенные ниже ошибки являются общими для действия Copy и могут быть связаны с любым соединителем.

Код ошибки: JreNotFound

Сообщение.Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.
Причина. Локальной среде IR не удается найти среду выполнения Java. Среда выполнения Java требуется для чтения определенных источников.
Рекомендация. Проверьте среду выполнения интеграции. См. раздел Использование локальной среды выполнения интеграции.

Код ошибки: WildcardPathSinkNotSupported

Сообщение.Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Причина. Набор данных приемника не поддерживает значения с подстановочными знаками.
Рекомендация. Проверьте набор данных приемника и исправьте путь, убрав подстановочные знаки.

Проблема FIPS

Симптомы. Сбой действия копирования на компьютере локальной среды IR с поддержкой FIPS со следующим сообщением об ошибке: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms..
Причина. Эта ошибка может возникать при копировании данных с помощью таких соединителей, как хранилище BLOB-объектов Azure, SFTP и т. д. Стандарт FIPS определяет набор алгоритмов шифрования, разрешенных к использованию. Когда на компьютере включен режим FIPS, некоторые криптографические классы, от которых зависит действие копирования, блокируются в ряде сценариев.
Решение. Узнайте, почему мы больше не рекомендуем использовать режим FIPS, и решите, можно ли отключить FIPS на вашем компьютере с локальной средой IR.

Кроме того, если вы хотите просто обходить требования FIPS и успешно завершать действия, выполните следующее.
1. Откройте папку, в которой установлена локальная среда IR. Обычно путь выглядит так: C:\Program Files\Microsoft Integration Runtime <версия IR>\Shared.
2. Откройте файл diawp.exe.config, а затем в конце раздела <runtime> добавьте <enforceFIPSPolicy enabled="false"/>.
3. Сохраните файл, а затем перезапустите компьютер с локальной средой IR.

Код ошибки: JniException

Сообщение.An error occurred when invoking Java Native Interface.
Причина. Если сообщение об ошибке содержит текст "Не удалось создать виртуальную машину Java: код возврата JNI [-6] [сбой вызова JNI: недопустимые аргументы.]", причина может заключаться в том, что виртуальную машину Java создать не удалось, так как заданы недопустимые (глобальные) аргументы.
Рекомендация. Войдите на компьютер, на котором размещается каждый узел локальной среды выполнения интеграции. Убедитесь в том, что системная переменная задана правильно: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Перезапустите все узлы среды выполнения интеграции, а затем повторно запустите конвейер.

Код ошибки: GetOAuth2AccessTokenErrorResponse

Сообщение.Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Причина. Недопустимый идентификатор клиента или секрет клиента, ошибка проверки подлинности на сервере авторизации.
Рекомендация. Исправьте все параметры потока учетных данных клиента OAuth2 для сервера авторизации.

Код ошибки: FailedToGetOAuth2AccessToken

Сообщение.Failed to get access token from your token endpoint. Error message: %errorMessage;.
Причина. Параметры потока учетных данных клиента OAuth2 некорректны.
Рекомендация. Исправьте все параметры потока учетных данных клиента OAuth2 для сервера авторизации.

Код ошибки: OAuth2AccessTokenTypeNotSupported

Сообщение.The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Причина. Ваш сервер авторизации не поддерживается.
Рекомендация. Используйте сервер авторизации, который может возвращать поддерживаемые типы маркеров.

Код ошибки: OAuth2ClientIdColonNotAllowed

Сообщение.The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Причина. Ваш идентификатор клиента содержит недопустимый символ двоеточия (:).
Рекомендация. Используйте допустимый идентификатор клиента.

Код ошибки: ManagedIdentityCredentialObjectNotSupported

Сообщение.Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Рекомендация. Проверьте поддерживаемую версию и обновите среду выполнения интеграции до более поздней версии.

Код ошибки: QueryMissingFormatSettingsInDataset

Сообщение.The format settings are missing in dataset %dataSetName;.
Причина. Указан неподдерживаемый бинарный тип набора данных.
Рекомендация. Используйте вместо него набор данных DelimitedText, Json, Avro, Orc или Parquet.
Причина. В наборе данных отсутствуют параметры формата для хранилища файлов.
Рекомендация. Снимите флажок "двоичная копия" в наборе данных и задайте правильные параметры формата.

Код ошибки: QueryUnsupportedCommandBehavior

Сообщение.The command behavior "%behavior;" is not supported.
Рекомендация. Не добавляйте поведение команды в качестве параметра предварительного просмотра или URL API-запроса GetSchema.

Код ошибки: DataConsistencyFailedToGetSourceFileMetadata

Сообщение.Failed to retrieve source file ('%name;') metadata to validate data consistency.
Причина. Существует временная проблема в хранилище данных-приемнике, или получение метаданных из хранилища данных-приемника не разрешено.

Код ошибки: DataConsistencyFailedToGetSinkFileMetadata

Сообщение.Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Причина. Существует временная проблема в хранилище данных-приемнике, или получение метаданных из хранилища данных-приемника не разрешено.

Код ошибки: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Сообщение.Data consistency validation is not supported in current copy activity settings.
Причина. Проверка согласованности данных поддерживается только в сценарии прямого двоичного копирования.
Рекомендация. Удалите свойство validateDataConsistency в полезных данных действия копирования.

Код ошибки: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Сообщение.'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Рекомендация. Проверьте поддерживаемую версию среды выполнения интеграции и обновите ее до более поздней версии или удалите свойство validateDataConsistency из действий копирования.

Код ошибки: SkipMissingFileNotSupportedForNonDirectBinaryCopy

Сообщение.Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Рекомендация. Удалите fileMissing в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Сообщение.Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Рекомендация. Удалите dataInconsistency параметра skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Сообщение.Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Рекомендация. Удалите fileForbidden в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipForbiddenFileNotSupportedForThisConnector

Сообщение.Skip forbidden file is not supported for this connector: ('%connectorName;').
Рекомендация. Удалите fileForbidden в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Сообщение.Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Рекомендация. Удалите invalidFileName в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipInvalidFileNameNotSupportedForSource

Сообщение.Skip invalid file name is not supported for '%connectorName;' source.
Рекомендация. Удалите invalidFileName в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipInvalidFileNameNotSupportedForSink

Сообщение.Skip invalid file name is not supported for '%connectorName;' sink.
Рекомендация. Удалите invalidFileName в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: SkipAllErrorFileNotSupportedForNonBinaryCopy

Сообщение.Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Рекомендация. Удалите allErrorFile в параметре skipErrorFile в полезных данных действия копирования.

Код ошибки: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Сообщение.'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Рекомендация. Удалите параметр deleteFilesAfterCompletion или используйте прямую двоичную копию.

Код ошибки: DeleteFilesAfterCompletionNotSupportedForThisConnector

Сообщение.'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Рекомендация. Удалите параметр deleteFilesAfterCompletion в полезных данных действия копирования.

Код ошибки: FailedToDownloadCustomPlugins

Сообщение.Failed to download custom plugins.
Причина. Недопустимые ссылки для скачивания или временные неполадки подключения.
Рекомендация. Повторите попытку, если сообщение покажет, что это временная проблема. Если проблема не исчезла, обратитесь в службу поддержки.

Общие ошибки соединителей

Код ошибки: UserErrorOdbcInvalidQueryString

Сообщение.The following ODBC Query is not valid: '%'.
Причина. Вы предоставляете неправильный или недопустимый запрос для получения данных или схем.
Рекомендация. Убедитесь, что запрос действителен и способен возвращать данные или схемы. Используйте Действие скрипта, если требуется выполнить скрипты, отличные от запросов, и ваше хранилище данных поддерживается. Кроме того, рекомендуется использовать хранимую процедуру, которая возвращает фиктивный результат, для выполнения скриптов, отличных от запросов.

Код ошибки: FailToResolveParametersInExploratoryController

Сообщение.The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Причина: служба имеет ограничение на поддержку связанной службы, которая ссылается на другую связанную службу с параметрами для тестового подключения или предварительной версии данных. Например, передача параметра из Key Vault в связанную службу может возникнуть.
Рекомендация. Удалите параметры в связанной службе, чтобы устранить ошибку. В противном случае запустите конвейер без тестирования подключения или предварительного просмотра данных.

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