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

ПРИМЕНИМО К: Фабрика данных Azure Azure Synapse Analytics

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

Коннектор и операция копирования

Для получения сведений о проблемах соединителя, таких как ошибка при работе с использованием действия копирования, см. статью Устранение неполадок соединителей.

Azure Databricks

Код ошибки: 3200

• Сообщение: ошибка 403.

• Причина.The Databricks access token has expired.

• Recommendation: по умолчанию маркер доступа Azure Databricks действителен в течение 90 дней. Создайте новый токен и обновите связанную службу.

Код ошибки: 3201

• Сообщение.Missing required field: settings.task.notebook_task.notebook_path.

• Причина.Bad authoring: Notebook path not specified correctly.

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

• Сообщение.Cluster... does not exist.

• Причина.Authoring error: Databricks cluster does not exist or has been deleted.

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

• Сообщение.Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.

• Причина.Bad authoring.

• Рекомендация: Укажите абсолютные пути с схемами адресации рабочей области, либо dbfs:/folder/subfolder/foo.py файлы, хранящиеся в файловой системе Databricks (DFS).

• Сообщение.{0} LinkedService should have domain and accessToken as required properties.

• Причина.Bad authoring.

• Рекомендация. Проверка определения связанной службы.

• Сообщение.{0} LinkedService should specify either existing cluster ID or new cluster information for creation.

• Причина.Bad authoring.

• Рекомендация. Проверка определения связанной службы.

• Сообщение.Node type Standard_D16S_v3 is not supported. Supported node types: Standard_DS3_v2, Standard_DS4_v2, Standard_DS5_v2, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D64s_v3, Standard_D3_v2, Standard_D8_v3, Standard_D16_v3, Standard_D32_v3, Standard_D64_v3, Standard_D12_v2, Standard_D13_v2, Standard_D14_v2, Standard_D15_v2, Standard_DS12_v2, Standard_DS13_v2, Standard_DS14_v2, Standard_DS15_v2, Standard_E8s_v3, Standard_E16s_v3, Standard_E32s_v3, Standard_E64s_v3, Standard_L4s, Standard_L8s, Standard_L16s, Standard_L32s, Standard_F4s, Standard_F8s, Standard_F16s, Standard_H16, Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_NC12, Standard_NC24, Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_L8s_v2, Standard_L16s_v2, Standard_L32s_v2, Standard_L64s_v2, Standard_L80s_v2.

• Причина.Bad authoring.

• Рекомендация. Обратитесь к сообщению об ошибке.

Код ошибки: 3202

• Сообщение.There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.

• Причина.Too many Databricks runs in an hour.

• Рекомендация: Проверьте все конвейеры, которые используют эту рабочую область Databricks, на скорость создания заданий. Если конвейеры запустили слишком много Databricks, работающих в статистическом выражении, перенесите некоторые конвейеры в новую рабочую область.

• Сообщение.Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.

• Причина.Authoring error: No value provided for the parameter.

• Рекомендация: Проверьте JSON конвейера и убедитесь, что все параметры в ноуте baseParameters указывают ненепустое значение.

• Сообщение.User: 'SimpleUserContext{userId=..., name=user@company.com, orgId=...}' is not authorized to access cluster.

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

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

• Сообщение.Job is not fully initialized yet. Please retry later.

• Причина: задание не инициализировано.

• Рекомендация: подождите и повторите попытку позже.

Код ошибки: 3203

• Сообщение.The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.

• Причина: кластер был завершен. В случае с интерактивными кластерами эта проблема может быть состоянием гонки.

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

Код ошибки: 3204

• Сообщение.Job execution failed.

• Причина. Сообщения об ошибках указывают на различные проблемы, такие как непредвиденное состояние кластера или определенное действие. Зачастую сообщение об ошибке не отображается.

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

Код ошибки 3208

• Сообщение.An error occurred while sending the request.

• Причина: прервано сетевое подключение к службе Databricks.

• Рекомендация. Если вы используете локальную среду выполнения интеграции, убедитесь в надежности сетевого подключения от узлов среды выполнения интеграции. Если вы используете среду выполнения интеграции Azure, повторная попытка обычно успешна.

В начале результат запуска логического оператора имеет вид строки, а не целого числа

• Симптомы: в начале результат запуска логического оператора имеет вид строки (например, "0" или "1"), а не целого числа (например, 0 или 1).

  

  Вы заметили это изменение 28 сентября 2021 года около 9:00 по IST, когда ваш поток данных, зависящий от этого вывода, начал выдавать ошибки. Изменений в конвейере не было, и логические данные вывода поступили, как ожидалось, до сбоя.

  

• Причина: эта проблема связана с недавним структурным изменением. После изменения, если результатом является число, начинающееся с нуля, Фабрика данных Azure преобразует число в восьмеричное значение, которое является ошибкой. Это число всегда равно 0 или 1, что никогда не вызывало проблем до внедрения изменения. Чтобы исправить преобразование в восьмеричное значение, необходимо передавать строковые результаты из записной книжки в состоянии "как есть".

• Рекомендация: измените условие If на нечто вроде if(value=="0").

Azure Data Lake Analytics

Приведенная ниже таблица относится к U-SQL.

Код ошибки: 2709

• Сообщение.The access token is from the wrong tenant.

• Cause: неверный клиент Microsoft Entra.

• Recommendation: неверный клиент Microsoft Entra.

• Сообщение.We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.

• Cause: Эта ошибка вызвана ограничением скорости в Data Lake Analytics.

• Recommendation: уменьшите количество отправленных заданий в Data Lake Analytics. Либо измените триггеры и параметры параллелизма для действий, либо увеличьте ограничения на Data Lake Analytics.

• Сообщение.This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.

• Cause: Эта ошибка вызвана ограничением скорости в Data Lake Analytics.

• Recommendation: уменьшите количество отправленных заданий в Data Lake Analytics. Либо измените триггеры и параметры параллелизма для действий, либо увеличьте ограничения на Data Lake Analytics.

Код ошибки: 2705

• Сообщение.Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Озеро данных Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

• Причина. Субъект-служба или сертификат не имеют доступа к файлу в хранилище.

• Recommendation. Убедитесь, что субъект-служба или сертификат, которые пользователь предоставляет для заданий Data Lake Analytics, имеет доступ как к учетной записи Data Lake Analytics, так и к экземпляру Data Lake Storage по умолчанию из корневой папки.

Код ошибки: 2711

• Сообщение.Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Озеро данных Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

• Причина. Субъект-служба или сертификат не имеют доступа к файлу в хранилище.

• Recommendation. Убедитесь, что субъект-служба или сертификат, которые пользователь предоставляет для заданий Data Lake Analytics, имеет доступ как к учетной записи Data Lake Analytics, так и к экземпляру Data Lake Storage по умолчанию из корневой папки.

• Сообщение.Cannot find the 'Azure Data Lake Store' file or folder.

• Причина. Путь к U-SQL-файлу неправильный, или учетные данные связанной службы не имеют доступа.

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

Код ошибки: 2704

• Сообщение.Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Озеро данных Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

• Причина. Субъект-служба или сертификат не имеют доступа к файлу в хранилище.

• Recommendation. Убедитесь, что субъект-служба или сертификат, которые пользователь предоставляет для заданий Data Lake Analytics, имеет доступ как к учетной записи Data Lake Analytics, так и к экземпляру Data Lake Storage по умолчанию из корневой папки.

Код ошибки: 2707

• Сообщение.Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.

• Cause: учетная запись Data Lake Analytics в связанной службе неправильная.

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

Код ошибки: 2703

• Сообщение.Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").

• Cause: ошибка происходит из Data Lake Analytics.

• Recommendation: задание было отправлено в Data Lake Analytics, и сценарий там завершился ошибкой. Изучите Data Lake Analytics. На портале откройте учетную запись Data Lake Analytics и найдите задание, используя ID выполнения задачи активности Data Factory (не используйте ID выполнения конвейера). Задание там содержит больше сведений об ошибке и поможет устранить неполадки.

  Если решение не ясно, обратитесь в службу поддержки Data Lake Analytics и предоставьте универсальный указатель ресурсов (URL) задания, включающий имя учетной записи и идентификатор задания.

функции Azure

Код ошибки: 3602

• Сообщение.Invalid HttpMethod: '%method;'.

• Cause: HTTP-метод, указанный в полезных данных активности, не поддерживается активностью функции Azure.

• Рекомендация: Поддерживаемые HTTP-методы: PUT, POST, GET, DELETE, OPTIONS, HEAD и TRACE.

Код ошибки: 3603

• Сообщение.Response Content is not a valid JObject.

• Cause: вызываемая функция Azure не возвращала полезные данные JSON в ответе. Фабрика данных Azure и конвейеры Azure Synapse поддерживают в действиях функции только содержимое ответа JSON.

• Recommendation: обновите функцию Azure для возврата допустимой полезной нагрузки JSON, например, как это может делать функция C# (ActionResult)new OkObjectResult("{\"Id\":\"123\"}");

Код ошибки: 3606

• Message: в активности функции Azure отсутствует ключ функции.

• Cause: определение действия функции Azure не завершено.

• Recommendation: Убедитесь, что в определении JSON активности функции Azure для ввода есть свойство с именем functionKey.

Код ошибки: 3607

• Сообщение.Azure function activity missing function name.

• Cause: определение действия функции Azure не завершено.

• Recommendation: Убедитесь, что в определении JSON активности функции Azure для ввода есть свойство с именем functionName.

Код ошибки: 3608

• Сообщение.Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.

• Cause: сведения о функции Azure в определении действия могут быть неверными.

• Recommendation: исправьте сведения о функции Azure и повторите попытку.

Код ошибки: 3609

• Сообщение.Azure function activity missing functionAppUrl.

• Cause: определение действия функции Azure не завершено.

• Recommendation: Убедитесь, что определение JSON входной активности функции Azure имеет свойство functionAppUrl.

Код ошибки: 3610

• Сообщение.There was an error while calling endpoint.

• Причина: URL-адрес функции может быть неверным.

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

Код ошибки: 3611

• Сообщение.Azure function activity missing Method in JSON.

• Cause: определение действия функции Azure не завершено.

• Recommendation: Убедитесь, что в определении JSON активности функции Azure для ввода есть свойство с именем method.

Код ошибки: 3612

• Сообщение.Azure function activity missing LinkedService definition in JSON.

• Cause: определение действия функции Azure не завершено.

• Recommendation. Убедитесь, что определение входной функции Azure в формате JSON содержит сведения о связанной службе.

Машинное обучение Azure

Код ошибки: 4101

• Сообщение.AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.

• Причина: недопустимый формат или отсутствует определение свойства %propertyName;.

• Рекомендация. Проверьте, имеет ли действие %activityName; свойство %propertyName; , определенное с правильными данными.

Код ошибки: 4110

• Сообщение.AzureMLExecutePipeline activity missing LinkedService definition in JSON.

• Причина. Определение действия AzureMLExecutePipeline не завершено.

• Рекомендация: Убедитесь, что JSON-определение действия AzureMLExecutePipeline корректно связано с данными службы.

Код ошибки: 4111

• Сообщение.AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.

• Причина: неправильное определение действия.

• Рекомендация: Убедитесь, что JSON-определение действия AzureMLExecutePipeline корректно связано с данными службы.

Код ошибки: 4112

• Сообщение.AzureMLService linked service has invalid value for property '%propertyName;'.

• Причина: недопустимый формат или отсутствует определение свойства "%propertyName;".

• Рекомендация. Проверьте, имеет ли связанная служба свойство %propertyName; , определенное с правильными данными.

Код ошибки: 4121

• Сообщение.Request sent to Машинное обучение Azure for operation '%operation;' failed with http status code '%statusCode;'. Error message from Машинное обучение Azure: '%externalMessage;'.

• Cause: срок действия учетных данных, используемых для доступа к Машинное обучение Azure истек.

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

Код ошибки: 4122

• Сообщение.Request sent to Машинное обучение Azure for operation '%operation;' failed with http status code '%statusCode;'. Error message from Машинное обучение Azure: '%externalMessage;'.

• Cause: учетные данные, предоставленные в связанной службе Машинное обучение Azure, недействительны или не имеют разрешения на осуществление операции.

• Recommendation. Убедитесь, что учетные данные в связанной службе действительны и имеют разрешение на доступ к Машинное обучение Azure.

Код ошибки: 4123

• Сообщение.Request sent to Машинное обучение Azure for operation '%operation;' failed with http status code '%statusCode;'. Error message from Машинное обучение Azure: '%externalMessage;'.

• Cause: Свойства активности, например pipelineParameters, недопустимы для конвейера Машинное обучение Azure (ML).

• Recommendation: Убедитесь, что значения свойств активности соответствуют ожидаемой полезной нагрузке опубликованного конвейера Машинное обучение Azure, указанного в связанной службе.

Код ошибки: 4124

• Сообщение.Request sent to Машинное обучение Azure for operation '%operation;' failed with http status code '%statusCode;'. Error message from Машинное обучение Azure: '%externalMessage;'.

• Cause: опубликованная конечная точка конвейера Машинное обучение Azure не существует.

• Recommendation. Убедитесь, что опубликованная конечная точка конвейера Машинное обучение Azure, указанная в связанной службе, существует в Машинное обучение Azure.

Код ошибки: 4125

• Сообщение.Request sent to Машинное обучение Azure for operation '%operation;' failed with http status code '%statusCode;'. Error message from Машинное обучение Azure: '%externalMessage;'.

• Cause: в Машинное обучение Azure возникает ошибка сервера.

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

Код ошибки: 4126

• Сообщение.Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Машинное обучение Azure for more error logs.

• Cause: сбой выполнения конвейера Машинное обучение Azure.

• Recommendation: проверьте Машинное обучение Azure для получения дополнительных журналов ошибок, а затем исправьте конвейер машинного обучения.

Azure Synapse Analytics

Код ошибки: 3250

• Сообщение.There are not enough resources available in the workspace, details: '%errorMessage;'

• Причина. Нехватка ресурсов.

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

Код ошибки: 3251

• Сообщение.There are not enough resources available in the pool, details: '%errorMessage;'

• Причина. Нехватка ресурсов.

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

Код ошибки: 3252

• Сообщение.There are not enough vcores available for your spark job, details: '%errorMessage;'

• Причина: недостаточно виртуальных ядер

• Рекомендация. Попробуйте уменьшить количество запрошенных виртуальных ядер или увеличить квоту виртуальных ядер. Дополнительные сведения см. в статье Основные понятия Apache Spark.

Код ошибки: 3253

• Сообщение.There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.

• Причина: Достигнут порог регулирования.

• Рекомендация. Повторите запрос после периода ожидания.

Код ошибки: 3254

• Сообщение.AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.

• Причина: недопустимый формат или отсутствует определение свойства "%propertyName;".

• Рекомендация. Проверьте, имеет ли связанная служба свойство %propertyName; с правильными данными.

Распространенный почтовый сервис

Код ошибки: 2103

• Сообщение.Please provide value for the required property '%propertyName;'.

• Причина. Необходимое значение для свойства не было предоставлено.

• Рекомендация. Укажите значение из сообщения и повторите попытку.

Код ошибки: 2104

• Сообщение.The type of the property '%propertyName;' is incorrect.

• Причина: указанный тип свойства не является правильным.

• Рекомендация. Исправьте тип свойства и повторите попытку.

Код ошибки: 2105

• Сообщение.An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.

• Причина. Значение свойства недопустимо или не в ожидаемом формате.

• Рекомендация. Ознакомьтесь с документацией по свойству и убедитесь, что указанное значение содержит правильный формат и тип.

Код ошибки: 2106

• Сообщение.The storage строка подключения is invalid. %errorMessage;

• Причина: Строка подключения к хранилищу недопустима или имеет неправильный формат.

• Recommendation: перейдите на портал Azure и найдите свое хранилище, а затем скопируйте и вставьте строка подключения в связанную службу и повторите попытку.

Код ошибки: 2110

• Сообщение.The linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.

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

• Рекомендация. Убедитесь, что связанный тип службы является одним из поддерживаемых типов для действия. Например, тип подключённой службы для деятельности HDI может быть HDInsight или HDInsightOnDemand.

Код ошибки: 2111

• Сообщение.The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.

• Причина. Тип предоставленного свойства не является правильным.

• Рекомендация: Исправьте тип свойства и повторите попытку.

Код ошибки: 2112

• Сообщение.The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.

• Причина. Тип облака не поддерживается или не может быть определен для хранилища из EndpointSuffix.

• Рекомендация. Используйте хранилище в другом облаке и повторите попытку.

Настраиваемое

Следующая таблица относится к пакетная служба Azure.

Код ошибки: 2500

• Сообщение.Hit unexpected exception and execution failed.

• Причина.Can't launch command, or the program returned an error code.

• Рекомендация. Убедитесь, что исполняемый файл существует. Если программа запущена, убедитесь, что stdout.txt и stderr.txt переданы в учетную запись хранения. Рекомендуется включить журналы в код для отладки.

Код ошибки: 2501

• Сообщение.Cannot access user batch account; please check batch account settings.

• Причина: Неправильный ключ доступа к пакету или имя пула.

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

Код ошибки: 2502

• Сообщение.Cannot access user storage account; please check storage account settings.

• Причина: неправильное имя учетной записи хранения или ключ доступа.

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

Код ошибки: 2504

• Сообщение.Operation returned an invalid status code 'BadRequest'.

• Причина: слишком много файлов в folderPath разделе пользовательского действия. Общий размер resourceFiles не может превышать 32 768 символов.

• Рекомендация. Удалите ненужные файлы или zip-файл и добавьте команду распаки для их извлечения.

  Например, используйте powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe.

Код ошибки: 2505

• Сообщение.Cannot create Shared Access Signature unless Account Key credentials are used.

• Причина: Настраиваемые действия поддерживают только учетные записи хранения, использующие ключ доступа.

• Рекомендация. Ознакомьтесь с описанием ошибки.

Код ошибки: 2507

• Сообщение.The folder path does not exist or is empty: ...

• Причина. Файлы не находятся в учетной записи хранения по указанному пути.

• Рекомендация. Путь к папке должен содержать исполняемые файлы, которые требуется запустить.

Код ошибки: 2508

• Сообщение.There are duplicate files in the resource folder.

• Причина. Несколько файлов с одинаковыми именами находятся в разных вложенных папках в folderPath.

• Рекомендация: Специальные действия упрощают структуру папок в папке folderPath. Если необходимо сохранить структуру папок, запакуйте файлы и извлеките их в пакетная служба Azure с помощью команды распаки.

  Например, используйте powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe.

Код ошибки: 2509

• Сообщение.Batch url ... is invalid; it must be in Uri format.

• Причина: URL-адреса пакетной службы должны быть похожими на https://mybatchaccount.eastus.batch.azure.com

• Рекомендация. Ознакомьтесь с описанием ошибки.

Код ошибки: 2510

• Сообщение.An error occurred while sending the request.

• Причина: Недопустимый пакетный URL-адрес.

• Рекомендация: Проверить URL-адрес пакета.

HDInsight

Код ошибки: 206

• Сообщение.The batch ID for Spark job is invalid. Please retry your job.

• Причина. Возникла внутренняя проблема со службой, вызвавшей эту ошибку.

• Рекомендация. Эта проблема может быть временной. Повторите задание через некоторое время.

Код ошибки: 207

• Сообщение.Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.

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

• Рекомендация. Попробуйте другое хранилище.

Код ошибки: 208

• Сообщение.Service Principal or the MSI authenticator are not instantiated. Please consider providing a Service Principal in the HDI on demand linked service which has permissions to create an HDInsight cluster in the provided subscription and try again.

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

• Рекомендация: Рассмотрите возможность предоставления служебного принципала, имеющего разрешения на создание кластера HDInsight в предоставленной подписке и повторите попытку. Проверьте, что идентификации настроены правильно.

Код ошибки: 2300

• Сообщение.Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.

• Причина: сообщение об ошибке содержит сообщение, аналогичное The remote name could not be resolved.. Указанный URI кластера может быть недопустимым.

• Рекомендация. Убедитесь, что кластер не был удален и указан правильный универсальный код ресурса (URI). Когда вы открываете URI в браузере, должен отобразиться пользовательский интерфейс Ambari. Если кластер находится в виртуальной сети, URI должен быть частным. Чтобы открыть его, используйте виртуальную машину, которая является частью той же виртуальной сети.

  Дополнительные сведения см. в разделе Прямое соединение со службами Apache Hadoop.

• Причина. Если сообщение об ошибке содержит сообщение, аналогичное A task was canceled., время ожидания отправки задания истекло.

• Рекомендация. Проблема может быть либо общим подключением HDInsight, либо сетевым подключением. Сначала убедитесь, что пользовательский интерфейс Ambari в HDInsight доступен из любого браузера. Затем проверьте, действительны ли учетные данные.

  Если вы используете локальную среду выполнения интеграции (IR), выполните этот шаг из виртуальной машины или компьютера, на котором установлена локальная среда IR. Затем попробуйте отправить задание еще раз.

  Дополнительные сведения см. в разделе Веб-интерфейс Ambari.

• Причина. Если сообщение об ошибке содержит сообщение, User admin is locked out in Ambari аналогичное или Unauthorized: Ambari user name or password is incorrect, учетные данные hdInsight неверны или истекли.

• Рекомендация. Исправьте учетные данные и повторно разверните связанную службу. Сначала убедитесь, что учетные данные работают в HDInsight. Для этого откройте URI кластера в любом браузере и попытайтесь выполнить вход. Если учетные данные не работают, их можно сбросить с портала Azure.

  Для кластера ESP сбросьте пароль с помощью функции самостоятельного сброса пароля.

• Причина. Если сообщение об ошибке содержит сообщение аналогично 502 - Web server received an invalid response while acting as a gateway or proxy server, эта ошибка возвращается службой HDInsight.

• Рекомендация. Ошибка 502 часто возникает при завершении процесса сервера Ambari. Службы Ambari можно перезапустить, перезагрузив головной узел.

  1. Подключитесь к одному из узлов в HDInsight, используя SSH.

  2. Определите активный узел головного узла, запустив ping headnodehost.

  3. Подключитесь к активному головному узлу, так как сервер Ambari находится на активном головном узле, используя SSH.

  4. Перезагрузите активный головной узел.

     Дополнительные сведения см. в документации по устранению неполадок Azure HDInsight. Например:

     • Ambari UI 502 error (Ошибка 502 интерфейса Ambari)
     • RpcTimeoutException для Thrift-сервера Apache Spark
     • Устранение ошибки "ошибка шлюза" в Шлюзе приложений

• Причина: Если сообщение об ошибке содержит сообщение, аналогичное Unable to service the submit job request as templeton service is busy with too many submit job requests или Queue root.joblauncher already has 500 applications, cannot accept submission of application, слишком много заданий отправляется одновременно в HDInsight.

• Рекомендация. Ограничение количества одновременных заданий, отправленных в HDInsight. Ознакомьтесь со сведениями о параллелизме действий, если задания отправляются при выполнении одного и того же действия. Измените триггеры так, чтобы параллельные запуски конвейера распределялись по времени.

  Обратитесь к документации HDInsight, чтобы настроить templeton.parallellism.job.submit в соответствии с указанием ошибки.

Код ошибки: 2301

• Сообщение.Could not get the status of the application '%physicalJobId;' from the HDInsight service. Received the following error: %message;. Please refer to HDInsight troubleshooting documentation or contact their support for further assistance.

• Причина: кластер или служба HDInsight имеют проблемы.

• Рекомендация. Эта ошибка возникает, если при попытке запросить состояние выполняемого задания служба не получает ответ от кластера HDInsight. Эта проблема может быть связана с самим кластером, или это следствие сбоя службы HDInsight.

  Дополнительные сведения см. в документации по устранению неполадок HDInsight или обратитесь в службу поддержки Microsoft.

Код ошибки: 2302

• Сообщение.Hadoop job failed with exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Contact HDInsight team for further support.

• Причина. Задание было отправлено в кластер HDI и завершилось сбоем.

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

1. Проверьте пользовательский интерфейс Ambari:
   1. Убедитесь, что все службы по-прежнему работают.
   2. В пользовательском интерфейсе Ambari на панели мониторинга проверьте раздел оповещений.
      1. Дополнительные сведения об оповещениях и разрешениях для них см. на странице Мониторинг кластера и управление им.
   3. Проверьте память YARN. Если у вас большой объем памяти YARN, обработка заданий может быть отложена. Если у вас недостаточно ресурсов для размещения приложения или задания Spark, увеличьте масштаб кластера, чтобы в нем было достаточно памяти и процессорных ядер.
2. Выполните пример тестового задания.
   1. Если вы выполняете то же задание на серверной части HDInsight, убедитесь, что оно выполнено успешно. Дополнительные сведения см. в статье Выполнение примеров MapReduce, включенных в HDInsight.
3. Если задание по-прежнему завершилось сбоем в HDInsight, проверьте журналы приложений и сведения, которые необходимо предоставить для поддержки:
   1. Проверьте, было ли задание отправлено в YARN. Если задание не было отправлено в YARN, используйте --master yarn.
   2. Если приложение завершило выполнение, соберите данные о времени начала и окончания приложения YARN. Если приложение не завершило выполнение, соберите данные о времени начала или запуска.
   3. Проверьте журнал приложений и соберите данные с помощью yarn logs -applicationId <Insert_Your_Application_ID>.
   4. Проверьте и соберите журналы Yarn Resource Manager в каталоге /var/log/hadoop-yarn/yarn.
   5. Если этих шагов недостаточно для устранения проблемы, свяжитесь с командой Azure HDInsight для поддержки и предоставьте приведенные выше журналы и метки времени.

Код ошибки: 2303

• Сообщение.Hadoop job failed with transient exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Try again or contact HDInsight team for further support.

• Причина. Задание было отправлено в кластер HDI и завершилось сбоем.

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

1. Проверьте пользовательский интерфейс Ambari:
   1. Убедитесь, что все службы по-прежнему работают.
   2. В пользовательском интерфейсе Ambari на панели мониторинга проверьте раздел оповещений.
      1. Дополнительные сведения об оповещениях и разрешениях для них см. на странице Мониторинг кластера и управление им.
   3. Проверьте память YARN. Если у вас большой объем памяти YARN, обработка заданий может быть отложена. Если у вас недостаточно ресурсов для размещения приложения или задания Spark, увеличьте масштаб кластера, чтобы в нем было достаточно памяти и процессорных ядер.
2. Выполните пример тестового задания.
   1. Если вы выполняете то же задание на серверной части HDInsight, убедитесь, что оно выполнено успешно. Дополнительные сведения см. в статье Выполнение примеров MapReduce, включенных в HDInsight.
3. Если задание по-прежнему завершилось сбоем в HDInsight, проверьте журналы приложений и сведения, которые необходимо предоставить для поддержки:
   1. Проверьте, было ли задание отправлено в YARN. Если задание не было отправлено в YARN, используйте --master yarn.
   2. Если приложение завершило выполнение, соберите данные о времени начала и окончания приложения YARN. Если приложение не завершило выполнение, соберите данные о времени начала или запуска.
   3. Проверьте журнал приложений и соберите данные с помощью yarn logs -applicationId <Insert_Your_Application_ID>.
   4. Проверьте и соберите журналы Yarn Resource Manager в каталоге /var/log/hadoop-yarn/yarn.
   5. Если этих шагов недостаточно для устранения проблемы, свяжитесь с командой Azure HDInsight для поддержки и предоставьте приведенные выше журналы и метки времени.

Код ошибки: 2304

• Сообщение.MSI authentication is not supported on storages for HDI activities.

• Причина: Связанные службы хранилища, используемые в связанной службе HDInsight (HDI) или операции HDI, настраиваются с проверкой подлинности MSI, которая не поддерживается.

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

Код ошибки: 2305

• Сообщение.Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'

• Причина. Сведения о подключении для кластера HDI неверны, у представленного пользователя нет прав на выполнение требуемого действия или у службы HDInsight есть проблемы с ответами на запросы от службы.

• Recommendation. Убедитесь, что сведения о пользователе верны, и что пользовательский интерфейс Ambari для кластера HDI можно открыть в браузере с виртуальной машины, где установлена среда ir (для локальной среды ir) или открыться с любого компьютера (для Azure IR).

Код ошибки: 2306

• Сообщение.An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'

• Причина: json, предоставленный для действия скрипта, недопустим.

• Рекомендация. Сообщение об ошибке должно помочь определить проблему. Исправьте конфигурацию JSON и повторите попытку.

  См. в разделе связанная служба Azure HDInsight по запросу для получения дополнительной информации.

Код ошибки: 2310

• Сообщение.Failed to submit Spark job. Error: '%message;'

• Причина. Служба попыталась создать пакет в кластере Spark с помощью API Livy (livy/batch), но произошла ошибка.

• Рекомендация. Чтобы устранить проблему, следуйте сообщению об ошибке. Если нет достаточной информации для разрешения, обратитесь в команду HDI и предоставьте им идентификатор партии и идентификатор задания, которые можно найти в выходных данных выполнения активности на странице мониторинга. Для дальнейшего устранения неполадок, соберите полный журнал пакетного задания.

  Дополнительные сведения о сборе данных полного журнала см. в разделе Получение полного журнала пакетного задания.

Код ошибки: 2312

• Сообщение.Spark job failed, batch id:%batchId;. Please follow the links in the activity run Output from the service Monitoring page to troubleshoot the run on HDInsight Spark cluster. Please contact HDInsight support team for further assistance.

• Причина: задание завершилось сбоем в кластере HDInsight Spark.

• Рекомендация: Следуйте ссылкам в результатах выполнения на странице мониторинга службы, чтобы устранить неполадки в работе кластера HDInsight Spark. Обратитесь в службу поддержки HDInsight за дополнительной помощью.

  Дополнительные сведения о сборе данных полного журнала см. в разделе Получение полного журнала пакетного задания.

Код ошибки: 2313

• Сообщение.The batch with ID '%batchId;' was not found on Spark cluster. Open the Spark History UI and try to find it there. Contact HDInsight support for further assistance.

• Причина. Пакет был удален в кластере HDInsight Spark.

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

  Дополнительные сведения о том, как собрать данные полного журнала, см. в разделе Получение полного журнала пакетного задания. Предоставьте общий доступ к полному журналу службе поддержки HDInsight для получения дополнительной помощи.

Код ошибки: 2328

• Сообщение.Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

• Причина: сообщение об ошибке должно отображать сведения о том, что пошло не так.

• Рекомендация. Сообщение об ошибке должно помочь устранить проблему.

Код ошибки: 2329

• Сообщение.Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

• Причина: сообщение об ошибке должно отображать сведения о том, что пошло не так.

• Рекомендация. Сообщение об ошибке должно помочь устранить проблему.

Код ошибки: 2331

• Сообщение.The file path should not be null or empty.

• Причина: предоставленный путь к файлу пуст.

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

Код ошибки: 2340

• Сообщение.HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.

• Причина: Связанная служба HDInsightOnDemand не поддерживает выполнение через SelfHosted IR.

• Recommendation: выберите Azure IR и повторите попытку.

Код ошибки: 2341

• Сообщение.HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.

• Причина. Указанный URL-адрес не указан в правильном формате.

• Рекомендация. Исправьте URL-адрес кластера и повторите попытку.

Код ошибки: 2342

• Сообщение.Failed to connect to HDInsight cluster: '%errorMessage;'.

• Причина: Либо указанные учетные данные неверны для кластера, либо возникла проблема с конфигурацией сети или подключением, либо IR испытывает трудности с подключением к кластеру.

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

  1. Проверьте правильность учетных данных, открыв в браузере пользовательский интерфейс Ambari кластера HDInsight.

  2. Если кластер находится в виртуальная сеть (виртуальной сети) и используется самостоятельно размещенная среда выполнения (IR), URL-адрес HDI должен быть частным URL-адресом в виртуальных сетях и должен иметь -int в списке после имени кластера.

     Например, измените https://mycluster.azurehdinsight.net/ на https://mycluster-int.azurehdinsight.net/. Обратите внимание на -int после mycluster, но перед .azurehdinsight.net.

  3. Если кластер находится в виртуальной сети, используется локальная среда IR, а также использовался частный URL-адрес, но выполнить подключение все равно не удалось, значит у виртуальной машины, на которой установлена среда IR, возникли проблемы с подключением к HDI.

     Подключитесь к виртуальной машине, на которой установлена среда IR, и откройте в браузере пользовательский интерфейс Ambari. Используйте частный URL-адрес для кластера. Это подключение должно работать из браузера. В противном случае обратитесь в службу поддержки HDInsight за дополнительной помощью.

  4. Если локальная среда IR не используется, кластер HDI должен быть общедоступным. Откройте в браузере пользовательский интерфейс Ambari и убедитесь, что он открывается. Если с кластером или службами на нем возникают какие-либо проблемы, обратитесь за помощью в службу поддержки HDInsight.

     URL-адрес кластера HDI, используемый в связанной службе, должен быть доступен для среды выполнения IR (локальная или Azure), чтобы тестовое подключение прошло, и чтобы процессы выполнялись. Это состояние можно проверить, открыв URL-адрес из браузера с виртуальной машины или с любого общедоступного компьютера.

Код ошибки: 2343

• Сообщение.User name and password cannot be null or empty to connect to the HDInsight cluster.

• Причина. Не введено имя пользователя или пароль.

• Рекомендация. Укажите правильные учетные данные для подключения к HDI и повторите попытку.

Код ошибки: 2345

• Сообщение.Failed to read the content of the hive script. Error: '%message;'

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

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

Код ошибки: 2346

• Сообщение.Failed to create ODBC connection to the HDI cluster with error message '%message;'.

• Причина. Служба попыталась установить подключение ODBC к кластеру HDI, но произошла ошибка.

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

  1. Убедитесь, что вы правильно настроили подключение ODBC/JDBC.
     1. Если в JDBC вы используете ту же виртуальную сеть, это подключение можно получить из:
        Hive -> Summary -> HIVESERVER2 JDBC URL
     2. Чтобы убедиться, что вы правильно настроили JDBC, ознакомьтесь со статьей Отправка запросов в Apache Hive с помощью драйвера JDBC в HDInsight.
     3. Для открытия базы данных (ODB) см. в руководстве: Запрос Apache Hive с помощью ODBC и PowerShell, чтобы убедиться, что у вас правильная настройка.
  2. Убедитесь, что Hiveserver2, хранилище метаданных Hive и Hiveserver2 Interactive активны и работают.
  3. Проверьте пользовательский интерфейс Ambari:
     1. Убедитесь, что все службы по-прежнему работают.
     2. В пользовательском интерфейсе Ambari на панели мониторинга проверьте раздел оповещений.
        1. Дополнительные сведения об оповещениях и разрешениях для них см. на странице Мониторинг кластера и управление им.
  4. Если эти действия недостаточно для устранения проблемы, обратитесь к команде Azure HDInsight.

Код ошибки: 2347

• Сообщение.Hive execution through ODBC failed with error message '%message;'.

• Причина. Служба передала сценарий Hive для выполнения в кластер HDI через подключение ODBC, и в сценарии возникла ошибка на HDI.

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

  1. Убедитесь, что вы правильно настроили подключение ODBC/JDBC.
     1. Если в JDBC вы используете ту же виртуальную сеть, это подключение можно получить из:
        Hive -> Summary -> HIVESERVER2 JDBC URL
     2. Чтобы убедиться, что вы правильно настроили JDBC, ознакомьтесь со статьей Отправка запросов в Apache Hive с помощью драйвера JDBC в HDInsight.
     3. Для открытия базы данных (ODB) см. в руководстве: Запрос Apache Hive с помощью ODBC и PowerShell, чтобы убедиться, что у вас правильная настройка.
  2. Убедитесь, что Hiveserver2, хранилище метаданных Hive и Hiveserver2 Interactive активны и работают.
  3. Проверьте пользовательский интерфейс Ambari:
     1. Убедитесь, что все службы по-прежнему работают.
     2. В пользовательском интерфейсе Ambari на панели мониторинга проверьте раздел оповещений.
        1. Дополнительные сведения об оповещениях и разрешениях для них см. на странице Мониторинг кластера и управление им.
  4. Если эти действия недостаточно для устранения проблемы, обратитесь к команде Azure HDInsight.

Код ошибки: 2348

• Сообщение.The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.

• Причина. Свойства связанной службы хранилища не заданы правильно.

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

Код ошибки: 2350

• Сообщение.Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'

• Причина: учетные данные, предоставленные для подключения к хранилищу, в котором должны находиться файлы, неверны или файлы не существуют.

• Рекомендация. Эта ошибка возникает, когда служба готовится к выполнению действий HDI и пытается перед отправкой задания в HDI скопировать файлы в основное хранилище. Убедитесь, что файлы существуют в указанном расположении и подключение к хранилищу настроено правильно. Поскольку действия HDI не поддерживают проверку подлинности MSI в учетных записях хранения, связанных с действиями HDI, убедитесь, что эти связанные службы имеют полные ключи или используют Azure Key Vault.

Код ошибки: 2351

• Сообщение.Could not open the file '%filePath;' in container/fileSystem '%container;'.

• Причина: файл не существует по указанному пути.

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

Код ошибки: 2352

• Сообщение.The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.

• Причина. Свойства связанной службы хранилища файлов не заданы правильно.

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

Код ошибки: 2353

• Сообщение.The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.

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

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

Код ошибки: 2354

• Сообщение.The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.

• Причина. Тип связанной службы хранилища не поддерживается действием.

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

  Дополнительные сведения см. в разделе Сравнение вариантов хранилищ для использования с кластерами Azure HDInsight

Код ошибки: 2355

• Сообщение.The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.

• Причина: указанное значение commandEnvironment неверно.

• Рекомендация. Убедитесь, что указанное значение аналогично следующему:

  \"variableName=variableValue\"
  ]
  

  Также убедитесь, что каждая переменная появляется в списке только один раз.

Код ошибки: 2356

• Сообщение.The commandEnvironment already contains a variable named '%variableName;'.

• Причина: указанное значение commandEnvironment неверно.

• Рекомендация. Убедитесь, что указанное значение аналогично следующему:

  \"variableName=variableValue\"
  ]
  

  Также убедитесь, что каждая переменная появляется в списке только один раз.

Код ошибки: 2357

• Сообщение.The certificate or password is wrong for ADLS Gen 1 storage.

• Причина: указанные учетные данные неверны.

• Рекомендация. Убедитесь, что сведения о подключении в ADLS 1-го поколения связаны со службой, и убедитесь, что тестовое подключение выполнено успешно.

Код ошибки: 2358

• Сообщение.The value '%value;' for the required property 'TimeToLive' in the on demand HDInsight linked service '%linkedServiceName;' has invalid format. It should be a timespan between '00:05:00' and '24:00:00'.

• Причина. Предоставленное значение для требуемого свойства TimeToLive имеет недопустимый формат.

• Рекомендация. Обновите значение до предлагаемого диапазона и повторите попытку.

Код ошибки: 2359

• Сообщение.The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.

• Причина. Предоставленное значение свойства roles недопустимо.

• Рекомендация: обновите значение, выбрав одно из предложений, и повторите попытку.

Код ошибки: 2360

• Сообщение.The строка подключения in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

• Причина: указанная строка подключения для HCatalogLinkedService недопустима.

• Рекомендация: обновите значение до правильной строки соединения с Azure SQL и повторите попытку.

Код ошибки: 2361

• Сообщение.Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.

• Причина. Произошел сбой при создании кластера, и служба не получила сообщение об ошибке от службы HDInsight.

• Recommendation: откройте портал Azure и попытайтесь найти ресурс HDI с указанным именем, а затем проверьте состояние подготовки. Обратитесь в службу поддержки HDInsight за дополнительной помощью.

Код ошибки: 2362

• Сообщение.Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.

• Cause: предоставленное дополнительное хранилище не было Azure Blob-хранилищем.

• Рекомендация: Укажите учетную запись хранения BLOB-объектов Azure в качестве дополнительного хранилища для связанной службы HDInsight по требованию.

Ошибка SSL при наличии связанной службы, использующей кластер HDInsight ESP

• Сообщение.Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'

• Причина. Вероятно, проблема связана с системным хранилищем доверия.

• Resolution: можно перейти к пути Microsoft Integration Runtime\4.0\Shared\ODBC Driver\Microsoft Hive ODBC Driver\lib и открыть DriverConfiguration64.exe, чтобы изменить параметр.

  

Действие HDI застряло при подготовке к кластеру

Если процесс HDI зависает при подготовке к работе с кластером, следуйте приведенным ниже рекомендациям:

1. Убедитесь, что время ожидания больше, чем описано ниже, и дождитесь либо завершения выполнения, либо истечения времени ожидания. После этого подождите время "Time To Live" (TTL), прежде чем отправлять новые задания.

   Максимальное время, необходимое для запуска кластера по умолчанию, составляет 2 часа, и если у вас есть скрипт инициализации, оно может добавиться еще на 2 часа.

2. Убедитесь, что хранилище и HDI выделены в одном регионе.

3. Убедитесь, что учетная запись службы, используемая для подключения к кластеру HDI, является действительной.

4. Если проблема сохраняется, используйте метод обхода: удалите связанную службу HDI и создайте ее заново с новым именем.

Веб-действие

Код ошибки: 2001

• Сообщение.The length of execution output is over limit (around 4MB currently).

• Причина: Размер выходных данных выполнения превышает 4 МБ, но максимальный поддерживаемый размер пакета ответа составляет 4 МБ.

• Рекомендация. Убедитесь, что размер выходных данных выполнения не превышает 4 МБ. Дополнительные сведения см. в разделе Как расширить объем данных, перемещаемых с помощью Фабрика данных Azure.

Код ошибки: 2002

• Сообщение.The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

• Причина: Нагрузка, которую вы пытаетесь отправить, слишком велика.

• Рекомендация: См. Полезная нагрузка слишком велика.

Код ошибки: 2003

• Сообщение.There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.

• Причина. Слишком много действий выполняются параллельно. Это может произойти, если одновременно запускается слишком много конвейеров.

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

Код ошибки: 2010

• Сообщение.The Self-hosted Integration Runtime ‘<SHIR name>’ is offline

• Причина: самостоятельно размещённая среда выполнения интеграции находится в автономном режиме или Azure среда выполнения интеграции истекла или не зарегистрирована.

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

Код ошибки: 2105

• Сообщение.The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'

• Причина. Данные, созданные в выражении динамического содержимого, не совпадают с ключом и приводят к сбою синтаксического анализа JSON.

• Рекомендация. Просмотрите поле ключа и исправьте определение динамического содержимого.

Код ошибки: 2108

• Сообщение.Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url: <URL>. Please verify Url or integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime'

• Причина. Не удается получить доступ к указанному URL-адресу. Это может произойти, так как возникла проблема с сетевым подключением, URL-адрес был неразрешимым или URL-адрес localhost использовался в среде выполнения интеграции Azure.

• Рекомендация. Убедитесь, что указанный URL-адрес доступен.

• Сообщение.Error calling the endpoint '%url;'. Response status code: '%code;'

• Причина: сбой запроса из-за базовой проблемы, такой как сетевое подключение, сбой DNS, проверка сертификата сервера или время ожидания.

• Рекомендация. Используйте Fiddler/Netmon/Wireshark для проверки запроса.

  Использование Fiddler

  Чтобы использовать Fiddler для создания HTTP-сеанса отслеживаемого веб-приложения, выполните приведенные ниже действия.

  1. Скачайте, установите и откройте Fiddler.

  2. Если ваше веб-приложение использует HTTPS, перейдите в Инструменты>Параметры Fiddler>HTTPS.

     1. На вкладке HTTPS выберите Capture HTTPS CONNECTs (Захват подключений HTTPS) и Decrypt HTTPS traffic (Расшифровка трафика HTTPS).

        

  3. Если в приложении используются TLS/SSL-сертификаты, добавьте сертификат Fiddler на устройство.

     Перейдите к: Сервис>Fiddler Options>HTTPS>Действия>Экспортировать корневой сертификат на рабочий стол.

  4. Отключите запись, выбрав Файл>Capture Traffic (Запись трафика). Или нажмите клавишу F12.

  5. Очистите кэш браузера, чтобы удалить все кэшированные элементы и скачать их снова.

  6. Создайте запрос:

  7. Выберите вкладку Композитор.

     1. Задайте метод HTTP и URL-адрес.

     2. При необходимости добавьте заголовки и текст запроса.

     3. Выберите Выполнить.

  8. Снова включите запись трафика и завершите проблемную транзакцию на странице.

  9. Перейдите в раздел: Файл>Сохранить>Все сессии.

  Для получения дополнительной информации см. Начало работы с Fiddler.

Код ошибки: 2113

• Сообщение.ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination

• Причина. Не удается создать сертификат из сочетания строки и пароля Base64.

• Рекомендация. Убедитесь, что сочетание сертификата PFX и пароля кодировке Base64 указано правильно.

Код ошибки: 2403

• Сообщение.Get access token from MSI failed for Datafactory <DF name>, region <region code>. Please verify resource url is valid and retry.

• Причина. Не удалось получить маркер доступа из предоставленного URL-адреса ресурса.

• Рекомендация: Убедитесь, что вы указали правильный URL-адрес ресурса для управляемой учетной записи.

Общие

Ошибка: маркер продолжения REST имеет значение NULL

Сообщение об ошибке: {"token":null,"range":{"min":..}

Причина: при запросе нескольких секций или страниц внутренняя служба возвращает маркер продолжения в формате JObject с 3 свойствами: маркер, минимальный и максимальный диапазон ключей, например {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}). В зависимости от исходных данных запрос может выводить значение 0, что означает отсутствие маркера, хотя доступно больше данных для выборки.

Рекомендации: если значение continuationToken отличается от null, как строка {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}, необходимо снова вызвать API queryActivityRuns с маркером продолжения из предыдущего ответа. Необходимо снова передать полную строку для API запроса. Действия будут возвращены на последующих страницах результата запроса. Пустой массив на этой странице следует игнорировать, если полное значение continuationToken != null, необходимо продолжить выполнение запросов. Дополнительные сведения см. в статье о REST API для запуска запроса конвейера.

Проблема с зависанием активности

Если вы заметили, что активность выполняется намного дольше, чем обычно, и едва ли заметен прогресс, возможно, произошло зависание процесса. Можно попробовать отменить действие и повторить попытку. Если это действие копирования, вы можете узнать о мониторинге производительности и порядке устранения неполадок в разделе Устранение неполадок с производительностью копирования. Если это поток данных, ознакомьтесь с разделом Производительность сопоставляемых потоков данных и руководством по их настройке.

Слишком большой объем данных

Сообщение об ошибке:The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

Причина. Полезные данные для каждого выполнения действия включают конфигурацию действия, конфигурации связанных наборов данных и связанных служб (при наличии), а также некоторые системные свойства, созданные для каждого типа действия. Ограничение такого размера полезных данных составляет 896 КБ, как указано в документации об ограничениях Azure Data Factory и Azure Synapse Analytics.

Рекомендация: Это может быть вызвано тем, что вы передаете одно или несколько больших значений параметров из выходных данных предшествующего или внешнего действия, особенно в случаях, когда передаются фактические данные между действиями в потоке управления. Проверьте, можно ли уменьшить значения больших параметров, или настройте логику конвейера, чтобы избежать передачи таких значений между действиями и обработки их внутри действия.

Неподдерживаемое сжатие приводит к повреждению файлов

Симптомы: вы пытаетесь распаковать файл, хранящийся в облачном контейнере. Одно действие копирования в конвейере имеет источник с типом сжатия deflate64 (или любым другим неподдерживаемым типом). Это действие выполняется успешно и создает текстовый файл в zip-архиве. Однако возникла проблема с текстом в файле, и этот файл, возможно, поврежден. Если распаковать файл локально, все будет нормально.

Cause: ZIP-файл сжимается алгоритмом "deflate64", а внутренняя zip-библиотека Фабрика данных Azure поддерживает только "deflate". Если ZIP-файл сжимается системой Windows, а общий размер файла превышает определенное число, Windows по умолчанию будет использовать "deflate64", который не поддерживается в Фабрика данных Azure. С другой стороны, если размер файла меньше или вы используете сторонние zip-инструменты, поддерживающие определение алгоритма сжатия, Windows будет использовать "deflate" по умолчанию.

Выполнение конвейера передает параметр массива в виде строки дочернему конвейеру

Сообщение об ошибке:Operation on target ForEach1 failed: The execution of template action 'MainForEach1' failed: the result of the evaluation of 'foreach' expression '@pipeline().parameters.<parameterName>' is of type 'String'. The result must be a valid array.

Причина. Даже если в конвейере выполнения вы создаете параметр массива типов, как показано на рисунке ниже, конвейер завершится ошибкой.

Это связано с тем, что полезные данные передаются из родительского конвейера дочернему объекту в виде строки. Мы можем увидеть это, когда проверяем входные данные, которые переданы дочернему конвейеру.

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

Затем наш конвейер будет успешным. И в поле ввода мы видим, что переданный параметр является массивом.

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

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

• Блог о Фабрике данных
• Запросы на добавление функции в Фабрику данных
• Форум Stack Overflow по Фабрике данных
• Сведения о Data Factory X
• Страница вопросов Microsoft Q&A