Solución de problemas de canalizaciones de Azure Data Factory y Synapse

Artículo
08/10/2023

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. ¡Obtenga más información sobre cómo iniciar una nueva evaluación gratuita!

En este artículo se exploran métodos comunes de solución de problemas relativos a actividades de control externo en canalizaciones de Azure Data Factory y Synapse.

Conector y actividad de copia

Para obtener más información sobre problemas de conector como, por ejemplo, errores relacionados con la actividad de copia, consulte el artículo Solución de problemas relacionados con conectores.

Azure Databricks

Código de error: 3200

Mensaje: Error 403.
Causa: The Databricks access token has expired.
Recomendación: De forma predeterminada, el token de acceso de Azure Databricks es válido durante noventa días. Cree un nuevo token y actualice el servicio vinculado.

Código de error: 3201

Mensaje: Missing required field: settings.task.notebook_task.notebook_path.
Causa: Bad authoring: Notebook path not specified correctly.
Recomendación: Especifique la ruta de acceso de Notebook en la actividad de Databricks.

Mensaje: Cluster... does not exist.
Causa: Authoring error: Databricks cluster does not exist or has been deleted.
Recomendación: Compruebe que existe el clúster de Databricks.

Mensaje: Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.
Causa: Bad authoring.
Recomendación: Especifique las rutas de acceso absolutas para los esquemas de direccionamiento del área de trabajo, o bien dbfs:/folder/subfolder/foo.py para los archivos almacenados en el sistema de archivos de Databricks (DFS).

Mensaje: {0} LinkedService should have domain and accessToken as required properties.
Causa: Bad authoring.
Recomendación: Compruebe la definición del servicio vinculado.

Mensaje: {0} LinkedService should specify either existing cluster ID or new cluster information for creation.
Causa: Bad authoring.
Recomendación: Compruebe la definición del servicio vinculado.

Mensaje: 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.
Causa: Bad authoring.
Recomendación: Consulte el mensaje de error.

Código de error: 3202

Mensaje: There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.
Causa: Too many Databricks runs in an hour.
Recomendación: Compruebe todas las canalizaciones que usen esta área de trabajo de Databricks para la velocidad de creación de trabajos. Si las canalizaciones inician demasiadas ejecuciones de Databricks en agregado, migre algunas canalizaciones a un área de trabajo nueva.

Mensaje: Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.
Causa: Authoring error: No value provided for the parameter.
Recomendación: Inspeccione el json de canalización y asegúrese de que todos los parámetros del cuaderno baseParameters tienen especificado un valor no vacío.

Mensaje: User: SimpleUserContext{userId=..., name=user@company.com, orgId=...} is not authorized to access cluster.
Causa: El usuario que ha generado el token de acceso no tiene permiso para obtener acceso al clúster de Databricks especificado en el servicio vinculado.
Recomendación: Asegúrese de que el usuario tiene los permisos necesarios en el área de trabajo.

Mensaje: Job is not fully initialized yet. Please retry later.
Causa: el trabajo no se ha inicializado.
Recomendación: espere y vuelva a intentarlo más adelante.

Código de error: 3203

Mensaje: The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.
Causa: El clúster se ha finalizado. Para un clúster interactivo, este problema podría ser una condición de carrera.
Recomendación: Para evitar este error, use clústeres de trabajo.

Código de error: 3204

Mensaje: Job execution failed.
Causa: Los mensajes de error indican varias incidencias, como un estado de clúster inesperado o una actividad específica. Con frecuencia, no aparece ningún mensaje de error.
Recomendación: N/D

Código de error: 3208

Mensaje: An error occurred while sending the request.
Causa: Se interrumpió la conexión de red con el servicio de Databricks.
Recomendación: Si usa un entorno de ejecución de integración autohospedado, asegúrese de que la conexión de red sea estable desde los nodos del entorno de ejecución de integración. Si usa Azure Integration Runtime, el reintento suele funcionar.

La ejecución booleana se genera como una cadena y no como el valor entero que se esperaba

Síntomas: La ejecución booleana se genera como una cadena (por ejemplo, "0" o "1") en lugar del valor entero esperado (por ejemplo, 0 o 1).

Observó este cambio el 28 de septiembre de 2021 alrededor de las 9:00 a. m. IST, cuando la canalización que se basa en esta salida empezó a generar errores. No se hizo ningún cambio en la canalización y los datos de la salida booleana han llegado como se esperaba antes de que se produjera el error.
Causa: Este problema se debe a un cambio intencional reciente. Después del cambio, si el resultado es un número que comienza con cero, Azure Data Factory convertirá el número en el valor octal, lo que es un error. Este número siempre es 0 o 1, lo que nunca generó ningún error antes del cambio. Por lo tanto, y para corregir la conversión octal, la salida de cadena de la ejecución de Notebook se pasa sin ningún cambio.
Recomendación: Cambie la condición if a algo similar a esto if(value=="0").

Análisis con Azure Data Lake

La tabla siguiente se aplica a U-SQL.

Código de error: 2709

Mensaje: The access token is from the wrong tenant.
Causa: El inquilino de Microsoft Entra es incorrecto.
Recomendación: El inquilino de Microsoft Entra es incorrecto.

Mensaje: We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.
Causa: Este error se debe a una limitación en Data Lake Analytics.
Recomendación: Reduzca el número de trabajos enviados a Data Lake Analytics. Cambie la configuración de simultaneidad y de los desencadenadores en las actividades, o bien aumente los límites en Data Lake Analytics.

Mensaje: This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.
Causa: Este error se debe a una limitación en Data Lake Analytics.
Recomendación: Reduzca el número de trabajos enviados a Data Lake Analytics. Cambie la configuración de simultaneidad y de los desencadenadores en las actividades, o bien aumente los límites en Data Lake Analytics.

Código de error: 2705

Mensaje: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation. User is not able to access Data Lake Store. User is not authorized to use Data Lake Analytics.
Causa: La entidad de servicio o el certificado no tiene acceso al archivo en el almacenamiento.
Recomendación: Compruebe que la entidad de servicio o el certificado que el usuario proporciona para los trabajos de Data Lake Analytics tiene acceso a la cuenta de Data Lake Analytics y a la instancia de Data Lake Storage predeterminada de la carpeta raíz.

Código de error: 2711

Mensaje: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation. User is not able to access Data Lake Store. User is not authorized to use Data Lake Analytics.
Causa: La entidad de servicio o el certificado no tiene acceso al archivo en el almacenamiento.
Recomendación: Compruebe que la entidad de servicio o el certificado que el usuario proporciona para los trabajos de Data Lake Analytics tiene acceso a la cuenta de Data Lake Analytics y a la instancia de Data Lake Storage predeterminada de la carpeta raíz.

Mensaje: Cannot find the 'Azure Data Lake Store' file or folder.
Causa: La ruta de acceso al archivo U-SQL es incorrecta o las credenciales del servicio vinculado no tienen acceso.
Recomendación: Compruebe la ruta de acceso y las credenciales proporcionadas en el servicio vinculado.

Código de error: 2704

Mensaje: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation. User is not able to access Data Lake Store. User is not authorized to use Data Lake Analytics.
Causa: La entidad de servicio o el certificado no tiene acceso al archivo en el almacenamiento.
Recomendación: Compruebe que la entidad de servicio o el certificado que el usuario proporciona para los trabajos de Data Lake Analytics tiene acceso a la cuenta de Data Lake Analytics y a la instancia de Data Lake Storage predeterminada de la carpeta raíz.

Código de error: 2707

Mensaje: Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.
Causa: La cuenta de Data Lake Analytics en el servicio vinculado es incorrecta.
Recomendación: Compruebe que se proporciona la cuenta adecuada.

Código de error: 2703

Mensaje: Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").
Causa: El error es de Data Lake Analytics.
Recomendación: El trabajo se envió a Data Lake Analytics y, junto con el script, produjeron un error. Investigue el error en Data Lake Analytics. En el portal, vaya a la cuenta de Data Lake Analytics y busque el trabajo mediante el identificador de ejecución de actividad de Data Factory (no use el identificador de ejecución de canalización). El trabajo proporcionará más información sobre el error y le ayudará a solucionar el problema.

Si la resolución no está clara, póngase en contacto con el equipo de soporte técnico de Data Lake Analytics y proporcióneles el localizador de recursos universal (URL) del trabajo, que incluye el nombre de cuenta y el identificador del trabajo.

Azure Functions

Código de error: 3602

Mensaje: Invalid HttpMethod: '%method;'.
Causa: La actividad de las funciones de Azure no admite el método HTTP especificado en la carga de la actividad.
Recomendación: Los métodos HTTP admitidos son: PUT, POST, GET, DELETE, OPTIONS, HEAD y TRACE.

Código de error: 3603

Mensaje: Response Content is not a valid JObject.
Causa: La función de Azure a la que se llamó no devolvió una carga JSON en la respuesta. La actividad de la función de Azure de la canalización de Azure Data Factory y Synapse admite únicamente contenido de respuesta JSON.
Recomendación: Actualice la función de Azure para que devuelva una carga JSON válida, tal como una función C# puede devolver (ActionResult)new OkObjectResult("{\"Id\":\"123\"}");.

Código de error: 3606

Mensaje: falta la clave de función de la actividad de Azure Function.
Causa: La definición de actividad de funciones de Azure no está completa.
Recomendación: Compruebe que la definición JSON de la actividad de función de Azure de entrada tiene una propiedad denominada functionKey.

Código de error: 3607

Mensaje: Azure function activity missing function name.
Causa: La definición de actividad de funciones de Azure no está completa.
Recomendación: Compruebe que la definición JSON de la actividad de función de Azure de entrada tiene una propiedad denominada functionName.

Código de error: 3608

Mensaje: Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.
Causa: Los detalles de las funciones de Azure en la definición de la actividad pueden ser incorrectos.
Recomendación: Corrija los detalles de las funciones de Azure y vuelva a intentarlo.

Código de error: 3609

Mensaje: Azure function activity missing functionAppUrl.
Causa: La definición de actividad de funciones de Azure no está completa.
Recomendación: Compruebe que la definición JSON de la actividad de función de Azure de entrada tiene una propiedad denominada functionAppUrl.

Código de error: 3610

Mensaje: There was an error while calling endpoint.
Causa: La dirección URL de la función puede ser incorrecta.
Recomendación: Asegúrese de que el valor de functionAppUrl en el JSON de actividad es correcto e inténtelo de nuevo.

Código de error: 3611

Mensaje: Azure function activity missing Method in JSON.
Causa: La definición de actividad de funciones de Azure no está completa.
Recomendación: Compruebe que la definición JSON de la actividad de función de Azure de entrada tiene una propiedad denominada method.

Código de error: 3612

Mensaje: Azure function activity missing LinkedService definition in JSON.
Causa: La definición de actividad de funciones de Azure no está completa.
Recomendación: Compruebe que la definición JSON de la actividad de función de Azure de entrada tiene detalles del servicio vinculado.

Azure Machine Learning

Código de error: 4101

Mensaje: AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.
Causa: Formato incorrecto o falta la definición de la propiedad %propertyName;.
Recomendación: Compruebe si la actividad %activityName; tiene la propiedad %propertyName; definida con los datos correctos.

Código de error: 4110

Mensaje: AzureMLExecutePipeline activity missing LinkedService definition in JSON.
Causa: La definición de la actividad AzureMLExecutePipeline no está completa.
Recomendación: Compruebe que la definición JSON de la actividad AzureMLExecutePipeline de entrada tiene detalles del servicio vinculado correctos.

Código de error: 4111

Mensaje: AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.
Causa: Definición de actividad incorrecta.
Recomendación: Compruebe que la definición JSON de la actividad AzureMLExecutePipeline de entrada tiene detalles del servicio vinculado correctos.

Código de error: 4112

Mensaje: AzureMLService linked service has invalid value for property '%propertyName;'.
Causa: formato incorrecto o falta la definición de la propiedad "%propertyName;".
Recomendación: Compruebe si el servicio vinculado tiene la propiedad %propertyName; definida con los datos correctos.

Código de error: 4121

Mensaje: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.
Causa: La credencial usada para acceder a Azure Machine Learning ha expirado.
Recomendación: Compruebe que la credencial es válida y vuelva a intentarlo.

Código de error: 4122

Mensaje: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.
Causa: La credencial proporcionada en el servicio vinculado de Azure Machine Learning no es válida o no tiene permiso para la operación.
Recomendación: Compruebe que la credencial del servicio vinculado es válida y tiene permiso para acceder a Azure Machine Learning.

Código de error: 4123

Mensaje: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.
Causa: Las propiedades de la actividad, como pipelineParameters, no son válidas para la canalización de Azure Machine Learning (ML).
Recomendación: Compruebe el valor de las propiedades de la actividad para que coincida con la carga esperada de la canalización de Azure Machine Learning publicada especificada en el servicio vinculado.

Código de error: 4124

Mensaje: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.
Causa: el punto de conexión de canalización de Azure Machine Learning publicado no existe.
Recomendación: Compruebe que el punto de conexión de la canalización de Azure Machine Learning publicado que se especifica en el servicio vinculado existe en Azure Machine Learning.

Código de error: 4125

Mensaje: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.
Causa: Hay un error de servidor en Azure Machine Learning.
Recomendación: Vuelva a intentarlo más tarde. Póngase en contacto con el equipo de Azure Machine Learning para obtener ayuda si el problema continúa.

Código de error: 4126

Mensaje: Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Azure Machine Learning for more error logs.
Causa: se produjo un error con la ejecución de la canalización de Azure Machine Learning.
Recomendación: Compruebe si en Azure Machine Learning hay más registros de errores y después corrija la canalización de ML.

Azure Synapse Analytics

Código de error: 3250

Mensaje: There are not enough resources available in the workspace, details: '%errorMessage;'
Causa: recursos insuficientes.
Recomendación: intente finalizar los trabajos en ejecución en el área de trabajo, reducir el número de núcleos virtuales solicitados, aumentar la cuota del área de trabajo o usar otra área de trabajo.

Código de error: 3251

Mensaje: There are not enough resources available in the pool, details: '%errorMessage;'
Causa: recursos insuficientes.
Recomendación: intente finalizar los trabajos en ejecución en el grupo, reducir el número de núcleos virtuales solicitados, aumentar el tamaño máximo del grupo o usar otro grupo.

Código de error: 3252

Mensaje: There are not enough vcores available for your spark job, details: '%errorMessage;'
Causa: núcleos virtuales insuficientes
Recomendación: intente reducir el número de núcleos virtuales solicitados o aumentar la cuota de núcleos virtuales. Para más información, consulte Conceptos básicos sobre Apache Spark.

Código de error: 3253

Mensaje: There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.
Causa: se alcanzó el umbral de limitación.
Recomendación: vuelva a intentar la solicitud después de un período de espera.

Código de error: 3254

Mensaje: AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.
Causa: formato incorrecto o falta la definición de la propiedad "%propertyName;".
Recomendación: compruebe si el servicio vinculado tiene la propiedad "%propertyName;" definida con los datos correctos.

Comunes

Código de error: 2103

Mensaje: Please provide value for the required property '%propertyName;'.
Causa: El valor necesario para la propiedad no se ha proporcionado.
Recomendación: proporcione el valor del mensaje e inténtelo de nuevo.

Código de error: 2104

Mensaje: The type of the property '%propertyName;' is incorrect.
Causa: El tipo de propiedad proporcionado no es correcto.
Recomendación: Corrija el tipo de la propiedad e inténtelo de nuevo.

Código de error: 2105

Mensaje: An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.
Causa: El valor de la propiedad no es válido o no tiene el formato esperado.
Recomendación: Consulte la documentación de la propiedad y compruebe que el valor proporcionado incluye el tipo y el formato correctos.

Código de error: 2106

Mensaje: The storage connection string is invalid. %errorMessage;
Causa: la cadena de conexión del almacenamiento no es válida o tiene un formato incorrecto.
Recomendación: Vaya a Azure Portal y busque el almacenamiento, después copie y pegue la cadena de conexión en el servicio vinculado y e inténtelo de nuevo.

Código de error: 2110

Mensaje: The linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.
Causa: El servicio vinculado especificado en la actividad es incorrecto.
Recomendación: Compruebe que el tipo de servicio vinculado sea uno de los tipos admitidos para la actividad. Por ejemplo, el tipo de servicio vinculado para las actividades de HDI puede ser HDInsight o HDInsightOnDemand.

Código de error: 2111

Mensaje: The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.
Causa: El tipo de la propiedad proporcionada no es correcto.
Recomendación: Corrija el tipo de propiedad e inténtelo de nuevo.

Código de error: 2112

Mensaje: The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.
Causa: El tipo de nube no es compatible o no se pudo determinar para el almacenamiento desde EndpointSuffix.
Recomendación: Use el almacenamiento en otra nube e inténtelo de nuevo.

Personalizado

La tabla siguiente se aplica a Azure Batch.

Código de error: 2.500

Mensaje: Hit unexpected exception and execution failed.
Causa: Can't launch command, or the program returned an error code.
Recomendación: Compruebe que existe el archivo ejecutable. Si se inicia el programa, compruebe si los archivos stdout.txt y stderr.txt se cargaron en la cuenta de almacenamiento. Es un procedimiento recomendado incluir registros en el código para la depuración.

Código de error: 2501

Mensaje: Cannot access user batch account; please check batch account settings.
Causa: Clave de acceso o nombre de grupo de Batch incorrectos.
Recomendación: Compruebe el nombre del grupo y la clave de acceso de Batch en el servicio vinculado.

Código de error: 2502

Mensaje: Cannot access user storage account; please check storage account settings.
Causa: Nombre de cuenta de almacenamiento o clave de acceso incorrectos.
Recomendación: Compruebe la clave de acceso y el nombre de cuenta de almacenamiento en el servicio vinculado.

Código de error: 2504

Mensaje: Operation returned an invalid status code 'BadRequest'.
Causa: Hay demasiados archivos en folderPath de la actividad personalizada. El tamaño total de resourceFiles no puede superar los 32 768 caracteres.
Recomendación: Elimine los archivos innecesarios o comprímalos y agregue un comando de descompresión para extraerlos.

Por ejemplo, use powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe.

Código de error: 2505

Mensaje: Cannot create Shared Access Signature unless Account Key credentials are used.
Causa: Las actividades personalizadas solo admiten cuentas de almacenamiento que usen una clave de acceso.
Recomendación: Consulte la descripción del error.

Código de error: 2507

Mensaje: The folder path does not exist or is empty: ...
Causa: No hay archivos en la cuenta de almacenamiento en la ruta de acceso especificada.
Recomendación: La ruta de acceso a la carpeta debe contener los archivos ejecutables que desea ejecutar.

Código de error: 2508

Mensaje: There are duplicate files in the resource folder.
Causa: Hay varios archivos con el mismo nombre en subcarpetas diferentes de folderPath.
Recomendación: Estructura de carpetas de actividades personalizadas aplanada en folderPath. Si necesita conservar la estructura de carpetas, comprima los archivos y extráigalos en Azure Batch mediante un comando unzip.

Por ejemplo, use powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe.

Código de error: 2509

Mensaje: Batch url ... is invalid; it must be in Uri format.
Causa: Las direcciones URL del lote tienen que ser similares a https://mybatchaccount.eastus.batch.azure.com
Recomendación: Consulte la descripción del error.

Código de error: 2510

Mensaje: An error occurred while sending the request.
Causa: La dirección URL del lote no es válida.
Recomendación: Compruebe la dirección URL del lote.

HDInsight

Código de error: 206

Mensaje: The batch ID for Spark job is invalid. Please retry your job.
Causa: Hubo un problema interno con el servicio que causó este error.
Recomendación: Este problema puede ser transitorio. Vuelva a intentar el trabajo más tarde.

Código de error: 207

Mensaje: Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.
Causa: se produjo un error interno al intentar determinar la región desde la cuenta de almacenamiento principal.
Recomendación: pruebe con otro almacenamiento.

Código de error: 208

Mensaje: 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.
Causa: se produjo un error interno al intentar leer la entidad de servicio o crear una instancia de la autenticación de MSI.
Recomendación: Considere la posibilidad de proporcionar una entidad de servicio que tenga permisos para crear un clúster de HDInsight en la suscripción proporcionada e inténtelo de nuevo. Compruebe que las identidades administradas están configuradas correctamente.

Código de error: 2300

Mensaje: Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.
Causa: El mensaje de error contiene un mensaje similar a The remote name could not be resolved.. Es posible que el URI del clúster proporcionado no sea válido.
Recomendación: Compruebe que el clúster no se ha eliminado y que el URI proporcionado es correcto. Al abrir el identificador URI en cualquier explorador, debe ver la interfaz de usuario de Ambari. Si el clúster está en una red virtual, el URI debe ser el URI privado. Para abrirlo, use una máquina virtual (VM) que forme parte de la misma red virtual.

Para más información, consulte Conexión directa a los servicios de Apache Hadoop.

Causa: Si el mensaje de error contiene un mensaje similar a A task was canceled., quiere decir que el envío del trabajo agotó el tiempo de espera.
Recomendación: podría tratarse de un problema de conectividad general de HDInsight o de un problema de conectividad de red. En primer lugar, confirme que la interfaz de usuario de HDInsight Ambari está disponible desde cualquier explorador. A continuación, compruebe que las credenciales siguen siendo válidas.

Si usa Integrated Runtime (IR) autohospedado, realice este paso desde la VM o la máquina donde está instalada la instancia de IR autohospedado. Luego, intente volver a enviar el trabajo.

Para más información, lea Interfaz de usuario web de Ambari.

Causa: Cuando el mensaje de error contiene un mensaje similar a User admin is locked out in Ambari o Unauthorized: Ambari user name or password is incorrect, quiere decir que las credenciales de HDInsight son incorrectas o han expirado.
Recomendación: Corrija las credenciales y vuelva a implementar el servicio vinculado. En primer lugar, compruebe que las credenciales funcionan en HDInsight; para ello, abra el URI del clúster en cualquier explorador e intente iniciar sesión. Si las credenciales no funcionan, puede restablecerlas desde Azure Portal.

En el caso del clúster de ESP, restablezca la contraseña mediante el autoservicio de restablecimiento de contraseña.

Causa: Cuando el mensaje de error contiene un mensaje similar a 502 - Web server received an invalid response while acting as a gateway or proxy server, el servicio HDInsight devuelve este error.
Recomendación: A menudo se produce un error 502 cuando el proceso del servidor de Ambari se apaga. Para reiniciar los servicios de Ambari puede reiniciar el nodo principal.
1. Conéctese a uno de los nodos de HDInsight con SSH.
2. Identifique el host del nodo principal activo mediante la ejecución de ping headnodehost.
3. Conéctese al nodo principal activo, ya que el servidor de Ambari se coloca en el nodo principal activo mediante SSH.
4. Reinicie el nodo principal activo.
  
  Para obtener más información, consulte la documentación de solución de problemas de Azure HDInsight. Por ejemplo:

Causa: Cuando el mensaje de error contiene un mensaje similar a Unable to service the submit job request as templeton service is busy with too many submit job requests o Queue root.joblauncher already has 500 applications, cannot accept submission of application, quiere decir que se están enviando demasiados trabajos a HDInsight al mismo tiempo.
Recomendación: Limite el número de trabajos simultáneos que se envían a HDInsight. Consulte la simultaneidad de actividad si los trabajos los envía la misma actividad. Cambie los desencadenadores para que las ejecuciones de canalización simultánea se repartan en el tiempo.

Consulte la documentación de HDInsight para ajustar templeton.parallellism.job.submit tal y como sugiere el error.

Código de error: 2301

Mensaje: 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.
Causa: el servicio o el clúster de HDInsight tiene problemas.
Recomendación: este error se produce cuando el servicio no recibe respuesta del clúster de HDInsight al intentar solicitar el estado del trabajo en ejecución. Este problema podría deberse al propio clúster o a que el servicio HDInsight haya sufrido una interrupción.

Consulte la documentación de solución de problemas de HDInsight o póngase en contacto con el soporte técnico de Microsoft para obtener más ayuda.

Código de error: 2302

Mensaje: 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.
Causa: El trabajo se envió al clúster de HDI y generó un error.
Recomendación:

Compruebe la interfaz de usuario de Ambari:
1. Asegúrese de que aún se están ejecutando todos los servicios.
2. En la interfaz de usuario de Ambari, compruebe la sección de alerta en el panel.
  1. Para obtener más información sobre las alertas y las resoluciones para las alertas, consulte Administración y supervisión de un clúster.
3. Revise la memoria de YARN. Si la memoria de YARN es alta, el procesamiento de los trabajos se puede retrasar. Si no tiene recursos suficientes para acomodar la aplicación o el trabajo de Spark, escale verticalmente el clúster para asegurarse de que el clúster tiene suficiente memoria y núcleos.
Ejecute un trabajo de prueba de ejemplo.
1. Si ejecuta el mismo trabajo en el back-end de HDInsight, compruebe que se ha realizado correctamente. Para ver ejemplos de ejecuciones de ejemplo, consulte Ejecución de los ejemplos de MapReduce incluidos en HDInsight.
Si el trabajo todavía no se ha realizado correctamente en HDInsight, compruebe los registros de la aplicación y la información que debe proporcionar para el soporte técnico:
1. Compruebe si el trabajo se envió a YARN. Si el trabajo no se ha enviado a YARN, use --master yarn.
2. Si la aplicación ha finalizado la ejecución, recopile la hora de inicio y la hora de finalización de la aplicación YARN. Si la aplicación no completó la ejecución, recopile la hora de inicio.
3. Compruebe y recopile el registro de aplicaciones con yarn logs -applicationId <Insert_Your_Application_ID>.
4. Compruebe y recopile los registros de Resource Manager en el directorio /var/log/hadoop-yarn/yarn.
5. Si estos pasos no son suficientes para resolver el problema, póngase en contacto con el equipo de Azure HDInsight para obtener soporte técnico y proporcione los registros y las marcas de tiempo anteriores.

Código de error: 2303

Mensaje: 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.
Causa: El trabajo se envió al clúster de HDI y generó un error.
Recomendación:

Compruebe la interfaz de usuario de Ambari:
1. Asegúrese de que aún se están ejecutando todos los servicios.
2. En la interfaz de usuario de Ambari, compruebe la sección de alerta en el panel.
  1. Para obtener más información sobre las alertas y las resoluciones para las alertas, consulte Administración y supervisión de un clúster.
3. Revise la memoria de YARN. Si la memoria de YARN es alta, el procesamiento de los trabajos se puede retrasar. Si no tiene recursos suficientes para acomodar la aplicación o el trabajo de Spark, escale verticalmente el clúster para asegurarse de que el clúster tiene suficiente memoria y núcleos.
Ejecute un trabajo de prueba de ejemplo.
1. Si ejecuta el mismo trabajo en el back-end de HDInsight, compruebe que se ha realizado correctamente. Para ver ejemplos de ejecuciones de ejemplo, consulte Ejecución de los ejemplos de MapReduce incluidos en HDInsight.
Si el trabajo todavía no se ha realizado correctamente en HDInsight, compruebe los registros de la aplicación y la información que debe proporcionar para el soporte técnico:
1. Compruebe si el trabajo se envió a YARN. Si el trabajo no se ha enviado a YARN, use --master yarn.
2. Si la aplicación ha finalizado la ejecución, recopile la hora de inicio y la hora de finalización de la aplicación YARN. Si la aplicación no completó la ejecución, recopile la hora de inicio.
3. Compruebe y recopile el registro de aplicaciones con yarn logs -applicationId <Insert_Your_Application_ID>.
4. Compruebe y recopile los registros de Resource Manager en el directorio /var/log/hadoop-yarn/yarn.
5. Si estos pasos no son suficientes para resolver el problema, póngase en contacto con el equipo de Azure HDInsight para obtener soporte técnico y proporcione los registros y las marcas de tiempo anteriores.

Código de error: 2304

Mensaje: MSI authentication is not supported on storages for HDI activities.
Causa: Los servicios vinculados de almacenamiento usados en el servicio vinculado de HDInsight (HDI) o la actividad de HDI están configurados con la autenticación MSI, la cual no se admite.
Recomendación: Proporcione cadenas de conexión completas para las cuentas de almacenamiento usadas en el servicio vinculado o la actividad de HDI.

Código de error: 2305

Mensaje: Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'
Causa: la información de conexión del clúster de HDI es incorrecta, el usuario proporcionado no tiene los permisos para realizar la acción necesaria o el servicio HDInsight tiene problemas para responder a las solicitudes del servicio.
Recomendación: Compruebe que la información del usuario sea correcta y que la interfaz de usuario de Ambari del clúster de HDI se pueda abrir en un explorador desde la VM en la que está instalado IR (en el caso de IR autohospedado) o desde cualquier máquina (en el caso de Azure IR).

Código de error: 2306

Mensaje: An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'
Causa: El código JSON proporcionado para la acción de script no es válido.
Recomendación: el mensaje de error debe ayudar a identificar el problema. Corrija la configuración de JSON e inténtelo de nuevo.

Consulte Servicio vinculado a petición de Azure HDInsight para obtener más información.

Código de error: 2310

Mensaje: Failed to submit Spark job. Error: '%message;'
Causa: el servicio intentó crear un lote en un clúster de Spark mediante Livy API (Livy/batch), pero recibió un error.
Recomendación: Siga el mensaje de error para solucionar el problema. Si no hay suficiente información para resolver este problema, comuníquese con el equipo de HDI y proporcione los id. de trabajo y lote, que encontrará en la salida de ejecución de actividad de la página de supervisión del servicio. Para seguir solucionando el problema, recopile el registro completo del trabajo por lotes.

Para obtener más información sobre cómo recopilar el registro completo, consulte Obtener el registro completo de un trabajo por lotes.

Código de error: 2312

Mensaje: 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.
Causa: Error en el trabajo en el clúster de HDInsight Spark.
Recomendación: siga los vínculos de la salida de ejecución de actividad de la página de supervisión del servicio para solucionar los problemas de ejecución en el clúster de HDInsight Spark. Póngase en contacto con el equipo de soporte técnico de HDInsight para obtener más ayuda.

Para obtener más información sobre cómo recopilar el registro completo, consulte Obtener el registro completo de un trabajo por lotes.

Código de error: 2313

Mensaje: 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.
Causa: el lote se eliminó en el clúster de HDInsight Spark.
Recomendación: solucione los problemas de lotes en el clúster de HDInsight Spark. Póngase en contacto con el soporte técnico de HDInsight para obtener más ayuda.

Para obtener más información sobre cómo recopilar el registro completo, consulte Obtener el registro completo de un trabajo por lotes y comparta el registro completo con el soporte técnico de HDInsight para obtener más ayuda.

Código de error: 2328

Mensaje: Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'
Causa: el mensaje de error debe mostrar los detalles de lo que ha ido mal.
Recomendación: el mensaje de error debe ayudarle a solucionar el problema.

Código de error: 2329

Mensaje: Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'
Causa: el mensaje de error debe mostrar los detalles de lo que ha ido mal.
Recomendación: el mensaje de error debe ayudarle a solucionar el problema.

Código de error: 2331

Mensaje: The file path should not be null or empty.
Causa: la ruta de acceso del archivo proporcionada está vacía.
Recomendación: Proporcione una ruta de acceso para un archivo que exista.

Código de error: 2340

Mensaje: HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.
Causa: El servicio vinculado HDInsightOnDemand no admite la ejecución a través de IR autohospedado.
Recomendación: Seleccione una instancia de Azure IR e inténtelo de nuevo.

Código de error: 2341

Mensaje: HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.
Causa: La dirección URL proporcionada no tiene el formato correcto.
Recomendación: Corrija la dirección URL del clúster e inténtelo de nuevo.

Código de error: 2342

Mensaje: Failed to connect to HDInsight cluster: '%errorMessage;'.
Causa: Las credenciales proporcionadas para el clúster son incorrectas o se produjo un problema de conexión o configuración de la red; también, puede que IR esté teniendo problemas para conectarse al clúster.
Recomendación:
1. compruebe que las credenciales sean correctas; para ello, abra la interfaz de usuario de Ambari del clúster de HDInsight en un explorador.
2. Si el clúster se encuentra en Virtual Network (VNet) y se está usando un IR autohospedado, la dirección URL de HDI debe ser la dirección URL privada de las redes virtuales y debe tener -int después del nombre del clúster.
  
  Por ejemplo, cambie https://mycluster.azurehdinsight.net/ a https://mycluster-int.azurehdinsight.net/. Tenga en cuenta que -int debe ir después de mycluster, pero antes de .azurehdinsight.net.
3. Si el clúster está en la red virtual, se usa IR autohospedado, se ha utilizado la dirección URL privada y se sigue produciendo un error en la conexión, la VM en la que se instaló IR tenía problemas para conectarse a HDI.
  
  Conéctese a la VM en la que está instalado IR y abra la interfaz de usuario de Ambari en un explorador. Use la dirección URL privada del clúster. Esta conexión debería funcionar desde el explorador. Si no es así, póngase en contacto con el equipo de soporte técnico de HDInsight para obtener más ayuda.
4. Si no se usa IR autohospedado, el clúster de HDI debe ser accesible públicamente. Abra la interfaz de usuario de Ambari en un explorador y compruebe que se abre. Si hay algún problema con el clúster o con los servicios que contiene, póngase en contacto con el equipo de soporte técnico de HDInsight para obtener ayuda.
  
  La dirección URL del clúster de HDI usada en el servicio vinculado debe ser accesible para IR (autohospedado o Azure) para que la conexión de prueba se supere y para que las ejecuciones funcionen. Una manera fácil de comprobar este estado es abrir esa dirección URL en un explorador desde una VM o desde cualquier máquina pública.

Código de error: 2343

Mensaje: User name and password cannot be null or empty to connect to the HDInsight cluster.
Causa: El nombre de usuario o la contraseña están vacíos.
Recomendación: Proporcione las credenciales correctas para conectarse a HDI e inténtelo de nuevo.

Código de error: 2345

Mensaje: Failed to read the content of the hive script. Error: '%message;'
Causa: el archivo de script no existe o el servicio no se pudo conectar a la ubicación del script.
Recomendación: Compruebe que el script existe y que el servicio vinculado asociado tenga las credenciales adecuadas para una conexión.

Código de error: 2346

Mensaje: Failed to create ODBC connection to the HDI cluster with error message '%message;'.
Causa: el servicio intentó establecer una conexión de conectividad abierta de bases de datos (ODBC) con el clúster de HDI y se produjo un error.
Recomendación:
1. Confirme que ha configurado correctamente la conexión de ODBC o Java Database Connectivity (JDBC).
  1. En el caso de JDBC, si está usando la misma red virtual, puede obtener esta conexión desde:
    Hive -> Summary -> HIVESERVER2 JDBC URL
  2. Para asegurarse de que tiene la configuración de JDBC correcta, consulte Consulta de Apache Hive mediante el controlador JDBC en HDInsight.
  3. En el caso de la conectividad abierta de bases de datos (ODB), consulte Tutorial: Consulta de Apache Hive con ODBC y PowerShell para asegurarse de que tiene la configuración correcta.
2. Compruebe que Hiveserver2, Hive MetaStore e Hiveserver2 Interactive están activos y en funcionamiento.
3. Compruebe la interfaz de usuario de Ambari (UI):
  1. Asegúrese de que aún se están ejecutando todos los servicios.
  2. En la interfaz de usuario de Ambari, compruebe la sección de alerta en el panel.
    1. Para obtener más información sobre las alertas y las resoluciones para las alertas, consulte Administración y supervisión de un clúster.
4. Si estos pasos no son suficientes para resolver el problema, póngase en contacto con el equipo de Azure HDInsight.

Código de error: 2347

Mensaje: Hive execution through ODBC failed with error message '%message;'.
Causa: el servicio envió el script de Hive para ejecutar al clúster de HDI a través de la conexión ODBC y el script ha generado un error en HDI.
Recomendación:
1. Confirme que ha configurado correctamente la conexión de ODBC o Java Database Connectivity (JDBC).
  1. En el caso de JDBC, si está usando la misma red virtual, puede obtener esta conexión desde:
    Hive -> Summary -> HIVESERVER2 JDBC URL
  2. Para asegurarse de que tiene la configuración de JDBC correcta, consulte Consulta de Apache Hive mediante el controlador JDBC en HDInsight.
  3. En el caso de la conectividad abierta de bases de datos (ODB), consulte Tutorial: Consulta de Apache Hive con ODBC y PowerShell para asegurarse de que tiene la configuración correcta.
2. Compruebe que Hiveserver2, Hive MetaStore e Hiveserver2 Interactive están activos y en funcionamiento.
3. Compruebe la interfaz de usuario de Ambari (UI):
  1. Asegúrese de que aún se están ejecutando todos los servicios.
  2. En la interfaz de usuario de Ambari, compruebe la sección de alerta en el panel.
    1. Para obtener más información sobre las alertas y las resoluciones para las alertas, consulte Administración y supervisión de un clúster.
4. Si estos pasos no son suficientes para resolver el problema, póngase en contacto con el equipo de Azure HDInsight.

Código de error: 2348

Mensaje: The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.
Causa: las propiedades del servicio vinculado de almacenamiento no se han establecido correctamente.
Recomendación: solo se admiten cadenas de conexión completas en el servicio vinculado de almacenamiento principal para las actividades de HDI. Compruebe que no está utilizando aplicaciones o autorizaciones de MSI.

Código de error: 2350

Mensaje: Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'
Causa: las credenciales proporcionadas para conectarse al almacenamiento donde se deben ubicar los archivos son incorrectas o los archivos no existen ahí.
Recomendación: este error se produce cuando el servicio se prepara para actividades de HDI e intenta copiar archivos en el almacenamiento principal antes de enviar el trabajo a HDI. Compruebe que los archivos se encuentren en la ubicación proporcionada y que la conexión de almacenamiento sea correcta. Las actividades de HDI no admiten la autenticación de MSI en cuentas de almacenamiento relativas a actividades de HDI, por lo que debe comprobar que esos servicios vinculados tengan claves completas o usen Azure Key Vault.

Código de error: 2351

Mensaje: Could not open the file '%filePath;' in container/fileSystem '%container;'.
Causa: El archivo no existe en la ruta de acceso especificada.
Recomendación: Compruebe si el archivo existe realmente y si el servicio vinculado con información de conexión que apunta a este archivo tiene las credenciales correctas.

Código de error: 2352

Mensaje: The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.
Causa: las propiedades del servicio vinculado de almacenamiento de archivos no se han establecido correctamente.
Recomendación: Compruebe que las propiedades del servicio vinculado de almacenamiento de archivos estén configuradas correctamente.

Código de error: 2353

Mensaje: The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.
Causa: las propiedades del servicio vinculado de almacenamiento de scripts no se han establecido correctamente.
Recomendación: Compruebe que las propiedades del servicio vinculado de almacenamiento de scripts estén configuradas correctamente.

Código de error: 2354

Mensaje: The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.
Causa: El tipo de servicio vinculado de almacenamiento no es compatible con la actividad.
Recomendación: Compruebe que el servicio vinculado seleccionado tenga uno de los tipos admitidos de la actividad. Las actividades de HDI admiten los servicios vinculados AzureBlobStorage y AzureBlobFSStorage.

Para más información, consulte Comparación de opciones de almacenamiento para los clústeres de Azure HDInsight.

Código de error: 2355

Mensaje: The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.
Causa: El valor proporcionado para commandEnvironment es incorrecto.
Recomendación: Compruebe que el valor proporcionado sea similar al siguiente:
```
\"variableName=variableValue\"
]
```
Compruebe también que cada variable aparece en la lista solo una vez.

Código de error: 2356

Mensaje: The commandEnvironment already contains a variable named '%variableName;'.
Causa: El valor proporcionado para commandEnvironment es incorrecto.
Recomendación: Compruebe que el valor proporcionado sea similar al siguiente:
```
\"variableName=variableValue\"
]
```
Compruebe también que cada variable aparece en la lista solo una vez.

Código de error: 2357

Mensaje: The certificate or password is wrong for ADLS Gen 1 storage.
Causa: las credenciales proporcionadas son incorrectas.
Recomendación: Compruebe la información de conexión en el servicio vinculado ADLS Gen 1 y compruebe que la conexión de prueba se realiza correctamente.

Código de error: 2358

Mensaje: 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'.
Causa: El valor proporcionado para la propiedad necesaria TimeToLive tiene un formato no válido.
Recomendación: Actualice el valor para que esté en el intervalo sugerido e inténtelo de nuevo.

Código de error: 2359

Mensaje: The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.
Causa: El valor proporcionado para la propiedad roles no es válido.
Recomendación: Actualice el valor para que sea una de las sugerencias e inténtelo de nuevo.

Código de error: 2360

Mensaje: The connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.
Causa: La cadena de conexión proporcionada para HCatalogLinkedService no es válida.
Recomendación: Actualice el valor a una cadena de conexión de Azure SQL correcta e inténtelo de nuevo.

Código de error: 2361

Mensaje: Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.
Causa: no se pudo crear el clúster y el servicio no ha recibido un error del servicio HDInsight.
Recomendación: Abra Azure Portal, intente encontrar el recurso de HDI con el nombre proporcionado y compruebe el estado de aprovisionamiento. Póngase en contacto con el equipo de soporte técnico de HDInsight para obtener más ayuda.

Código de error: 2362

Mensaje: Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.
Causa: el almacenamiento adicional proporcionado no era almacenamiento de blobs de Azure.
Recomendación: Proporcione una cuenta de Azure Blob Storage como almacenamiento adicional para el servicio vinculado de HDInsight a petición.

Error de SSL cuando el servicio vinculado usa un clúster de ESP de HDInsight

Mensaje: Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'
Causa: lo más probable es que el problema esté relacionado con el almacén de confianza del sistema.
Solución: puede ir a la ruta de acceso Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib y abrir DriverConfiguration64.exe para cambiar la configuración.

Actividad de HDI bloqueada en la preparación del clúster

Si la actividad de HDI está bloqueada en la preparación del clúster, siga las instrucciones siguientes:

Asegúrese de que el tiempo de espera es mayor que el que se describe a continuación y espere a que se complete la ejecución o hasta que se agote el tiempo de espera, y espere a que se agote el período de vida (TTL) antes de enviar nuevos trabajos.

El tiempo máximo predeterminado que se tarda en crear un clúster es de 2 horas y, si tiene algún script de init, se sumará hasta otras 2 horas.
Asegúrese de que el almacenamiento y el HDI se han aprovisionado para la misma región.
Asegúrese de que la entidad de servicio usada para acceder al clúster de HDI es válida.
Si el problema persiste, como solución alternativa, elimine el servicio vinculado de HDI y vuelva a crearlo con un nuevo nombre.

Actividad web

Código de error: 2001

Mensaje: The length of execution output is over limit (around 4MB currently).
Causa: la salida de ejecución es superior a 4 MB, pero el tamaño máximo admitido de la carga de respuesta de salida es de 4 MB.
Recomendación: asegúrese de que el tamaño de salida de ejecución no supere los 4 MB. Para obtener más información, consulte Cómo escalar el tamaño de los datos que se mueven mediante Azure Data Factory.

Código de error: 2002

Mensaje: 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.
Causa: la carga que intenta enviar es demasiado grande.
Recomendación: consulte Carga útil es demasiado grande.

Código de error: 2003

Mensaje: 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.
Causa: hay demasiadas actividades que se ejecutan simultáneamente. Esto puede ocurrir cuando se desencadenan demasiadas canalizaciones a la vez.
Recomendación: reduzca la simultaneidad de canalización. Es posible que tenga que distribuir la hora del desencadenador de las canalizaciones.

Código de error: 2010

Mensaje: The Self-hosted Integration Runtime ‘<SHIR name>’ is offline
Causa: el entorno de ejecución de integración autohospedado está sin conexión o el entorno de ejecución de integración de Azure ha expirado o no está registrado.
Recomendación: asegúrese de que el entorno de ejecución de integración autohospedado esté en funcionamiento. Consulte Solución de problemas del entorno de ejecución de integración autohospedado.

Código de error: 2105

Mensaje: The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'
Causa: los datos generados en la expresión de contenido dinámico no coinciden con la clave y provocan un error de análisis de JSON.
Recomendación: examine el campo clave y corrija la definición de contenido dinámico.

Código de error: 2108

Mensaje: 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'
Causa: no se puede acceder a la dirección URL proporcionada. Esto puede ocurrir porque se produjo un problema de conexión de red, la dirección URL no se pudo resolver o se usaba una dirección URL de localhost en un entorno de ejecución de integración de Azure.
Recomendación: compruebe que se puede acceder a la dirección URL proporcionada.

Mensaje: Error calling the endpoint '%url;'. Response status code: '%code;'
Causa: No se pudo realizar la solicitud debido a un problema subyacente (conectividad de red, error de DNS, validación del certificado de servidor o tiempo de espera).
Recomendación: use Fiddler/Postman/Netmon/Wireshark para validar la solicitud.

Uso de Fiddler

Para usar Fiddler para crear una sesión HTTP de la aplicación web supervisada:
1. Descargue, instale y abra Fiddler.
2. Si su aplicación web usa HTTPS, vaya a Tools>Fiddler Options>HTTPS (Herramientas>Opciones de Fiddler>HTTPS).
  1. Seleccione Capturar CONEXIONES HTTPS y Descifrar tráfico HTTPS.
3. Si la aplicación usa certificados TLS/SSL, agregue el certificado de Fiddler al dispositivo.
  
  Vaya a: Herramientas>Opciones de Fiddler>HTTPS>Acciones>Exportar el certificado raíz al escritorio.
4. Desactive la captura en File>Capture Traffic (Archivo > Capturar tráfico). O bien, presione F12.
5. Borre la caché del explorador para quitar todos los elementos almacenados en caché, que tendrá que volver a descargar.
6. Creación de una solicitud:
7. Seleccione la pestaña Composer (Compositor).
  1. Establezca el método HTTP y la dirección URL.
  2. Si es necesario, agregue encabezados y un cuerpo de la solicitud.
  3. Seleccione Execute(Ejecutar).
8. Active la captura de tráfico de nuevo y complete la transacción problemática en su página.
9. Vaya a: Archivo>Guardar>Todas las sesiones.
Para más información, consulte Introducción a Fiddler

Código de error: 2113

Mensaje: ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination
Causa: no se puede generar el certificado a partir de la combinación de cadena o contraseña de Base64.
Recomendación: compruebe que el certificado PFX codificado en Base64 y la combinación de contraseñas que está usando se escriben correctamente.

Código de error: 2403

Mensaje: Get access token from MSI failed for Datafactory <DF mname>, region <region code>. Please verify resource url is valid and retry.
Causa: no se puede adquirir un token de acceso de la dirección URL del recurso proporcionada.
Recomendación: compruebe que ha proporcionado la dirección URL de recurso correcta para la identidad administrada.

General

Error NULL del token de continuación REST

Mensaje de error: {"token":null,"range":{"min":..}

Causa: Al realizar consultas en varias particiones o páginas, el servicio back-end devuelve el token de continuación en formato JObject con 3 propiedades: token, intervalos de clave mínimos y máximos; por ejemplo, {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}). En función de los datos de origen, la consulta puede dar como resultado 0, lo que indica que falta el token, aunque haya más datos que recuperar.

Recomendación: Cuando continuationToken es distinto de NULL, como la cadena {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}, es necesario llamar de nuevo a la API queryActivityRuns con el token de continuación de la respuesta anterior. Debe volver a pasar la cadena completa para la API de consulta. Las actividades serán devueltas en las páginas siguientes para el resultado de la consulta. Debe ignorar que hay una matriz vacía en esta página; mientras el valor completo de continuationToken sea != null, debe continuar con las consultas. Para más información, consulte la API de REST para la consulta de ejecución de canalización.

Problema de bloqueo de actividad

Si observa que la actividad tarda mucho más tiempo en ejecutarse que sus ejecuciones normales sin apenas progreso, es posible que se haya bloqueado. Puede intentar cancelarla y volver a intentarlo para ver si sirve. Si se trata de una actividad de copia, puede encontrar información sobre la solución de problemas y la supervisión de rendimiento en Solución de problemas de rendimiento de la actividad de copia; si se trata de un flujo de datos, puede encontrar información en Rendimiento de los flujos de datos de asignación y la guía de ajuste.

La carga es demasiado grande

Mensaje de error: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.

Causa: La carga de cada ejecución de actividad incluye la configuración de la actividad, las configuraciones de los conjuntos de datos asociados y los servicios vinculados (si los hay), y una pequeña parte de las propiedades del sistema que se generan por tipo de actividad. El límite de este tamaño de carga es 896 KB, tal y como se menciona en la documentación sobre los límites de Azure para Data Factory y Azure Synapse Analytics.

Recomendación: Probablemente se alcanza este límite porque se pasan uno o más valores grandes de parámetro desde una salida de actividad ascendente o de forma externa, especialmente si se pasan datos reales entre actividades en el flujo de control. Compruebe si puede reducir el tamaño de los valores de parámetros grandes, o bien ajuste la lógica de canalización para evitar pasar estos valores entre las actividades y administrarlos dentro de la actividad en su lugar.

La compresión no compatible daña los archivos

Síntomas: Intenta descomprimir un archivo que está almacenado en un contenedor de blobs. El origen de una actividad de copia en una canalización tiene el tipo de compresión establecido en "deflate64" (o cualquier tipo no compatible). Esta actividad se ejecuta correctamente y genera el archivo de texto contenido en el archivo ZIP; pero hay un problema con el texto del archivo y este archivo parece estar dañado. Cuando este archivo se descomprime de manera local, no tiene problemas.

Causa: El archivo ZIP se comprime con el algoritmo de "deflate64", mientras que la biblioteca interna de archivos ZIP de Azure Data Factory solo admite "deflate". Si el sistema Windows comprime el archivo ZIP y el tamaño total del archivo supera un número determinado, Windows usará "deflate64" de manera predeterminada, algo que no es compatible con Azure Data Factory. Por otro lado, si el tamaño del archivo es menor o usa algunas herramientas de compresión de terceros que sí admiten la especificación del algoritmo de compresión, Windows usará "deflate" de manera predeterminada.

Sugerencia

De hecho, en los artículos Formato binario en Azure Data Factory y Synapse Analytics y Formato de texto delimitado en Azure Data Factory y Azure Synapse Analytics establecen claramente que el formato "deflate64" no es compatible con Azure Data Factory.

La ejecución de canalización pasa el parámetro de matriz como cadena a la canalización secundaria

Mensaje de error: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.

Causa: incluso si en la ejecución de canalización crea el parámetro de tipo matriz, tal como se muestra en la imagen siguiente, se producirá un error en la canalización.

Screenshot showing the parameters of the Execute Pipeline activity.

Esto se debe al hecho de que la carga útil se pasa de la canalización primaria al elemento secundario como cadena. Esto se puede ver cuando se comprueba la entrada que se pasa a la canalización secundaria.

Screenshot showing the input type string.

Recomendación: para resolver el problema, se puede aprovechar la función create array, tal como se muestra en la imagen siguiente.

Screenshot showing how to use the create array function.

La canalización se llevará a cabo correctamente. Y en el cuadro de entrada se puede ver que el parámetro pasado es una matriz.

Screenshot showing input type array.

Para obtener ayuda para solucionar problemas, pruebe estos recursos: