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

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

Совет

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

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

Соединитель и действие копирования

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

Azure Databricks

Код ошибки: 3200

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

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

• Рекомендация. По умолчанию маркер доступа 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 указывают значение nonempty.

• Сообщение: 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 часов по IST, когда конвейер, использующий эти данные, начал выдавать ошибки. Изменения не были сделаны в конвейере, и логические выходные данные прибыли, как ожидалось до сбоя.

  

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

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

Аналитика озера данных Azure

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

Код ошибки: 2709

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

• Причина: неверный клиент Microsoft Entra.

• Рекомендация. Неправильный клиент Microsoft Entra.

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

• Причина. Эта ошибка вызвана регулированием в Data Lake Analytics.

• Рекомендация. Уменьшите количество отправленных заданий в 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.

• Причина. Эта ошибка вызвана регулированием в Data Lake Analytics.

• Рекомендация. Уменьшите количество отправленных заданий в 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 Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

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

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

Код ошибки: 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 Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

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

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

• Сообщение.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 Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

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

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

Код ошибки: 2707

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

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

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

Код ошибки: 2703

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

• Причина: ошибка из Data Lake Analytics.

• Рекомендация. Задание было отправлено в Data Lake Analytics, и сценарий там завершился ошибкой. Выполните исследование в Data Lake Analytics. На портале перейдите к учетной записи Data Lake Analytics и найдите задание, используя идентификатор выполнения действия Фабрики данных (не используйте идентификатор запуска конвейера). Задание там содержит больше сведений об ошибке и поможет устранить неполадки.

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

Функции Azure

Код ошибки: 3602

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

• Причина. Httpmethod, указанный в полезных данных действия, не поддерживается действием функции Azure.

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

Код ошибки: 3603

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

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

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

Код ошибки: 3606

• Сообщение: отсутствующий ключ функции в действии функции Azure.

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

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

Код ошибки: 3607

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

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

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

Код ошибки: 3608

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

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

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

Код ошибки: 3609

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

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

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

Код ошибки: 3610

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

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

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

Код ошибки: 3611

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

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

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

Код ошибки: 3612

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

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

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

Машинное обучение 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 Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

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

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

Код ошибки: 4122

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

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

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

Код ошибки: 4123

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

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

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

Код ошибки: 4124

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

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

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

Код ошибки: 4125

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

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

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

Код ошибки: 4126

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

• Причина: сбой запуска конвейера Машинное обучение Azure.

• Рекомендация. Проверьте Машинное обучение 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 connection string is invalid. %errorMessage;

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

• Рекомендация. Перейдите к портал 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 с помощью команды unzip.

  Например, используйте 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 в Azure HDInsight
     • Устранение ошибок "Недопустимый шлюз" в шлюзе приложений

• Причина. Если сообщение об ошибке содержит сообщение, аналогичное 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. Ознакомьтесь со сведениями о параллелизме действий, если задания отправляются при выполнении одного и того же действия. Измените триггеры так, чтобы параллельные запуски конвейера распределялись по времени.

  Ознакомьтесь со статьей Понимание и устранение ошибок, полученных из WebHCat в 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 или обратитесь в службу поддержки Майкрософт за дополнительной помощью.

Код ошибки: 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 есть проблемы с ответами на запросы от службы.

• Рекомендация. Убедитесь, что сведения о пользователе правильно и что пользовательский интерфейс 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.

• Рекомендация. Выберите 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;'.

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

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

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

  2. Если кластер находится в виртуальной сети (VNet) и используется локальная среда выполнения интеграции, 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, используемый в связанной службе, должен быть доступен для среды выполнения интеграции службы (локально размещенного или 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 или Java Database Connectivity (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 или Java Database Connectivity (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 connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

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

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

Код ошибки: 2361

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

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

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

Код ошибки: 2362

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

• Причина. Предоставленное дополнительное хранилище не было хранилищем BLOB-объектов Azure.

• Рекомендация. Укажите учетную запись хранения 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.'

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

• Решение. Можно перейти по пути Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib и открыть файл DriverConfiguration64.exe, чтобы изменить этот параметр.

  

Действие HDI зависает в процессе подготовки к работе с кластером

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

1. Убедитесь, что время ожидания больше, чем описано ниже, и дождитесь завершения выполнения или истечения времени ожидания, а затем дождитесь истечения срока жизни (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/Postman/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>Actions>экспорт корневого сертификата на рабочий стол.

  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 mname>, region <region code>. Please verify resource url is valid and retry.

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

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

Общие

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

Сообщение об ошибке: {"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, необходимо продолжить выполнение запросов. Дополнительные сведения см. в статье об интерфейсе 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 для Фабрики данных Azure и Azure Synapse Analytics.

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

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

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

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

Совет

Фактически, двоичный формат в Фабрике данных Azure и Synapse Analytics и текстовый формат с разделителями в Фабрике данных Azure и Azure Synapse Analytics однозначно указывают на то, что формат deflate64 не поддерживается в Фабрике данных Azure.

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

Сообщение об ошибке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 по Фабрике данных
• Сведения о Фабрике данных в Twitter
• Видео по Azure
• Страница вопросов (раздел вопросов и ответов на сайте Майкрософт)