Solución de problemas de los flujos de datos de asignación en Azure Data Factory (ADF)

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 de flujos de datos de asignación en Azure Data Factory.

Guía de solución de problemas generales

  1. Compruebe el estado de las conexiones del conjunto de datos. En cada transformación de origen y de receptor, vaya al servicio vinculado para cada conjunto de datos que use y pruebe las conexiones.
  2. Compruebe el estado de las conexiones de archivos y tablas en el diseñador de flujo de datos. En el modo de depuración, seleccione Vista previa de datos en las transformaciones de origen para asegurarse de que puede tener acceso a los datos.
  3. Si todo parece correcto en la vista previa de los datos, vaya al diseñador de canalizaciones y coloque el flujo de datos en una actividad de canalización. Depure la canalización para realizar una prueba de un extremo a otro.

Errores internos del servidor

A continuación se muestran los escenarios específicos que pueden provocar errores internos del servidor.

Escenario 1: No elegir el tamaño o tipo de proceso adecuados y otros factores

La ejecución correcta de flujos de datos depende de muchos factores, como el tamaño y el tipo de proceso, el número de orígenes o receptores que se van a procesar, la especificación de la partición, las transformaciones implicadas, el tamaño de los conjuntos de datos, la asimetría de los datos, etc.

Para obtener más información, consulte Rendimiento de Integration Runtime.

Escenario 2: Uso de sesiones de depuración con actividades paralelas

Al desencadenar una ejecución mediante la sesión de depuración de flujo de datos con construcciones como ForEach en la canalización, pueden enviarse varias ejecuciones paralelas al mismo clúster. Esta situación puede provocar errores del clúster durante la ejecución, debido a problemas de recursos, como una memoria insuficiente.

Para enviar una ejecución con la configuración apropiada de IR definida en la actividad de la canalización tras publicar los cambios, seleccione Desencadenar ahora o Depurar>Usar tiempo de ejecución de actividad.

Escenario 3: Errores transitorios

Los problemas transitorios con microservicios implicados en la ejecución pueden provocar un error en la ejecución.

La configuración de reintentos en la actividad de canalización puede contribuir a resolver los problemas provocados por errores transitorios. Para obtener más información, consulte Directiva de actividades.

Mensajes y códigos de error comunes

En esta sección se enumeran los códigos de error comunes y los mensajes notificados por los flujos de datos de asignación de Azure Data Factory, junto con sus causas y recomendaciones asociadas.

Código de error: DF-AdobeIntegration-InvalidMapToFilter

  • Mensaje: El recurso personalizado solo puede tener un valor Key/Id asignado al filtro.
  • Causa: se proporcionaron configuraciones no válidas.
  • Recomendación: en la configuración de AdobeIntegration, asegúrese de que el recurso personalizado solo puede tener una clave o un identificador asignados para filtrar.

Código de error: DF-AdobeIntegration-InvalidPartitionConfiguration

  • Mensaje: Únicamente se admite una única partición. El esquema de partición puede ser RoundRobin o Hash.
  • Causa: se proporcionaron configuraciones de partición no válidas.
  • Recomendación: en la configuración de AdobeIntegration, confirme que solo se ha establecido la partición única y que los esquemas de partición pueden ser RoundRobin o Hash.

Código de error: DF-AdobeIntegration-InvalidPartitionType

  • Mensaje: El tipo de partición debe ser roundRobin.
  • Causa: se proporcionaron tipos de partición no válidos.
  • Recomendación: actualice la configuración de AdobeIntegration para que el tipo de partición sea RoundRobin.

Código de error: DF-AdobeIntegration-InvalidPrivacyRegulation

  • Mensaje: actualmente, el "RGPD" es la única norma de privacidad admitida.
  • Causa: se proporcionaron configuraciones de privacidad no válidas.
  • Recomendación: actualice la configuración de AdobeIntegration mientras solo se admite la privacidad "RGPD".

Código de error: DF-AdobeIntegration-KeyColumnMissed

  • Message: Debe especificarse la clave para las operaciones que no se pueden insertar.
  • Causa: faltan las columnas de clave.
  • Recomendación: actualice la configuración de AdobeIntegration para asegurarse de que las columnas de clave se especifican para las operaciones que no se pueden insertar.

Error code: DF-AzureDataExplorer-InvalidOperation

  • Mensaje: la operación de blob no se admite en cuentas de almacenamiento anteriores. La creación de una cuenta de almacenamiento puede corregir el problema.
  • Causa: la operación no es compatible.
  • Recomendación: cambie la configuración del método de actualización, ya que eliminar, actualizar y actualizar/insertar (upsert) no se admiten en Azure Data Explorer.

Error code: DF-AzureDataExplorer-ReadTimeout

  • Mensaje: tiempo de espera de la operación agotado durante la lectura de datos.
  • Causa: la operación agota el tiempo de espera durante la lectura de datos.
  • Recomendación: aumente el valor en la opción Tiempo de espera en la configuración de transformación del origen.

Error code: DF-AzureDataExplorer-WriteTimeout

  • Mensaje: tiempo de espera de la operación agotado durante la escritura de datos.
  • Causa: la operación agota el tiempo de espera durante la escritura de datos.
  • Recomendación: aumente el valor en la opción Tiempo de espera en la configuración de transformación del receptor.

Código de error: DF-Blob-FunctionNotSupport

  • Mensaje: este punto de conexión no admite BlobStorageEvents, SoftDelete o AutomaticSnapshot. Deshabilite estas características de cuenta si desea usar este punto de conexión.
  • Causa: no se admiten los eventos de Azure Blob Storage, la eliminación temporal o la instantánea automática en flujos de datos si el servicio vinculado de Azure Blob Storage se crea con autenticación de entidad de servicio o identidad administrada.
  • Recomendación: deshabilite los eventos de Azure Blob Storage, la eliminación temporal o la característica de instantánea automática en la cuenta de Azure Blob, o bien use la autenticación de clave para crear el servicio vinculado.

Código de error: DF-Blob-InvalidAccountConfiguration

  • Mensaje: se debe especificar la clave de cuenta o el token de SAS.
  • Causa: se proporcionó una credencial no válida en el servicio vinculado de ADLS Gen2.
  • Recomendación: use la clave de cuenta o el token de SAS para el servicio vinculado de Azure Blob.

Código de error: DF-BLOB-InvalidAuthConfiguration

  • Mensaje: Solo se puede especificar uno de los dos métodos de autenticación (Key, SAS).
  • Causa: se proporcionó un método de autenticación no válido en el servicio vinculado.
  • Recomendación: use la autenticación de clave o de SAS para el servicio vinculado de Azure Blob.

Código de error: DF-Blob-InvalidCloudType

  • Mensaje: El tipo de nube no es válido.
  • Causa: se proporcionó un tipo de nube no válido.
  • Recomendación: compruebe el tipo de nube en el servicio vinculado de Azure Blob relacionado.

Código de error: DF-Cosmos-DeleteDataFailed

  • Mensaje: no se pudieron eliminar los datos de Azure Cosmos DB después de 3 reintentos.
  • Causa: el rendimiento de la colección de Azure Cosmos DB es bajo y provoca que no haya datos de fila o limitación en Azure Cosmos DB.
  • Recomendación: para resolver este problema, tome las siguientes medidas:
    • Si el error es 404, asegúrese de que los datos de fila relacionados existan en la colección de Azure Cosmos DB.
    • Si el error está relacionado con la limitación, aumente el rendimiento de la colección de Azure Cosmos DB o establézcalo en la escala automática.
    • Si está relacionado con el tiempo de espera de la solicitud, establezca "Tamaño de lote" en el receptor de Azure Cosmos DB con un valor menor, por ejemplo, 1000.

Código de error: DF-Cosmos-FailToResetThroughput

  • Mensaje: la operación de escalado de rendimiento de Azure Cosmos DB no se puede realizar porque hay otra operación de escalado en curso. Vuelva a intentarlo más tarde.
  • Causa: La operación de escalado de rendimiento de Azure Cosmos DB no se puede realizar porque hay otra operación de escalado en curso.
  • Recomendación: inicie sesión en la cuenta de Azure Cosmos DB y cambie manualmente el rendimiento del contenedor para que sea escalado automático o agregue una actividad personalizada después de los flujos de datos de asignación para restablecer el rendimiento.

Código de error: DF-Cosmos-IdPropertyMissed

  • Mensaje: la propiedad "id" debe estar asignada para operaciones de eliminación y actualización.
  • Causa: falta la propiedad id para las operaciones de actualización y eliminación.
  • Recomendación: asegúrese de que los datos de entrada tienen una columna id en la configuración de transformación del receptor de Azure Cosmos DB. Si no es así, use una transformación de columna seleccionada o derivada para generar esta columna antes de la transformación del receptor.

Código de error: DF-Cosmos-InvalidAccountConfiguration

  • Mensaje: Se debe especificar AccountName o accountEndpoint.
  • Causa: se proporcionó información de cuenta no válida.
  • Recomendación: en el servicio vinculado de Azure Cosmos DB, especifique el nombre de cuenta o el punto de conexión de la cuenta.

Código de error: DF-Cosmos-InvalidAccountKey

  • Mensaje: El token de autorización de entrada no puede atender la solicitud. Compruebe que la carga esperada se compila según el protocolo y compruebe la clave que se está usando.
  • Causa: No hay permisos suficientes para leer o escribir datos de Azure Cosmos DB.
  • Recomendación: use la clave de lectura y escritura para acceder a Azure Cosmos DB.

Código de error: DF-Cosmos-InvalidConnectionMode

  • Mensaje: modo de conexión no válido.
  • Causa: se proporcionó un modo de conexión no válido.
  • Recomendación: confirme que el modo compatible es Gateway y DirectHttps en la configuración de Azure Cosmos DB.

Código de error: DF-Cosmos-InvalidPartitionKey

  • Mensaje: La ruta de acceso de la clave de partición no puede estar vacía para las operaciones de actualización y eliminación.
  • Mensaje: la ruta de acceso de la clave de partición está vacía para las operaciones de actualización y eliminación.
  • Recomendación: use la clave de partición que se proporciona en la configuración del receptor de Azure Cosmos DB.
  • Mensaje: la clave de partición no se ha asignado en el receptor para las operaciones de eliminación y actualización.
  • Causa: se proporcionó una clave de partición no válida.
  • Recomendación: en la configuración del receptor de Azure Cosmos DB, use la clave de partición que es la misma que la clave de partición del contenedor.

Código de error: DF-Cosmos-InvalidPartitionKeyContent

  • Mensaje: la clave de partición debe comenzar con /.
  • Causa: se proporcionó una clave de partición no válida.
  • Recomendación: asegúrese de que la clave de partición empiece por / en la configuración del receptor de Azure Cosmos DB, por ejemplo: /movieId.

Código de error: DF-Cosmos-PartitionKeyMissed

  • Mensaje: Se debe especificar la ruta de acceso de la clave de partición para las operaciones de actualización y eliminación.
  • Causa: falta la ruta de acceso de la clave de partición en el receptor de Azure Cosmos DB.
  • Recomendación: proporcione la clave de partición en la configuración del receptor de Azure Cosmos DB.

Error code: DF-Cosmos-ResourceNotFound

Código de error: DF-Cosmos-ShortTypeNotSupport

  • Mensaje: el tipo de datos short no se admite en Azure Cosmos DB.
  • Causa: el tipo de datos short no se admite en la instancia de Azure Cosmos DB.
  • Recomendación: agregue una columna de transformación derivada para convertir las columnas relacionadas de corto a entero antes de usarlas en la transformación del receptor de Cosmos DB.

Código de error: DF-CSVWriter-InvalidQuoteSetting

  • Mensaje: el trabajo produjo el error siguiente al escribir datos: El carácter de comillas y el de escape no pueden estar vacíos si el valor de columna contiene delimitador de columna.
  • Causa: los caracteres de comillas y de escape están vacíos cuando el valor de columna contiene delimitador de columna.
  • Recomendación: establezca el carácter de comillas o el de escape.

Código de error: DF-Delimited-ColumnDelimiterMissed

  • Mensaje: se requiere un delimitador de columna para el análisis.
  • Causa: falta el delimitador de columna.
  • Recomendación: en la configuración de CSV, confirme que tiene el delimitador de columna necesario para el análisis.

Código de error: DF-Delimited-InvalidConfiguration

  • Message: Se debe especificar una de las líneas vacías o el encabezado personalizado.
  • Causa: se proporcionó una configuración delimitada no válida.
  • Recomendación: actualice la configuración de CSV para especificar una de las líneas vacías o el encabezado personalizado.

Código de error: DF-DELTA-InvalidConfiguration

  • Mensaje: No se puede establecer la marca de tiempo y la versión al mismo tiempo.
  • Mensaje: no se puede establecer la marca de tiempo y la versión al mismo tiempo.
  • Recomendación: establezca la marca de tiempo o la versión en la configuración diferencial.

Código de error: DF-Delta-InvalidProtocolVersion

  • Mensaje: La versión del protocolo de tabla Delta no es compatible; consulte https://docs.delta.io/latest/versioning.html#-table-version para ver la información de control de versiones.
  • Causa: los flujos de datos no admiten esta versión del protocolo de tabla Delta.
  • Recomendación: use una versión inferior del protocolo de tabla Delta.

Código de error: DF-DELTA-InvalidTableOperationSettings

  • Mensaje: No se pueden especificar las opciones de volver a crear y truncar.
  • Causa: no se pueden especificar las opciones de volver a crear y truncar simultáneamente.
  • Recomendación: actualice la configuración diferencial para que incluya las operaciones de volver a crear o truncar.

Código de error: DF-DELTA-KeyColumnMissed

  • Mensaje: se deben especificar columnas de clave para las operaciones no insertables.
  • Causa: faltan las columnas de clave para las operaciones que no se pueden insertar.
  • Recomendación: para tener operaciones no insertables, especifique las columnas de clave en el receptor diferencial.

Código de error: DF-Dynamics-InvalidNullAlternateKeyColumn

  • Mensaje: Los valores de columna de clave alternativa no pueden ser NULL.
  • Causa: El valor de la columna de clave alternativa no puede ser NULL.
  • Recomendación: confirme que el valor de columna de la clave alternativa no es NULL.

Código de error: DF-Dynamics-TooMuchAlternateKey

  • Causa: no es válido un campo de búsqueda con más de una referencia de clave alternativa.
  • Recomendación: compruebe la asignación del esquema y confirme que cada campo de búsqueda tiene una sola clave alternativa.

Código de error: DF-Excel-DifferentSchemaNotSupport

  • Mensaje: En este momento no se admite la lectura de archivos de Excel con esquemas diferentes.
  • Causa: en este momento no se admite la lectura de archivos de Excel con esquemas diferentes.
  • Recomendación: aplique una de las siguientes opciones para solucionar este problema:
    • Use la actividad ForEach + flujo de datos para leer hojas de cálculo de Excel una por una.
    • Actualice cada esquema de hoja de cálculo para que tenga las mismas columnas manualmente antes de leer los datos.

Código de error: DF-Excel-InvalidDataType

  • Mensaje: Tipo de datos no admitido.
  • Causa: no se admite el tipo de datos.
  • Recomendación: cambie el tipo de datos a "string" para las columnas de datos de entrada relacionadas.

Código de error: DF-Excel-InvalidFile

  • Mensaje: Se proporcionó un archivo de Excel no válido mientras que solo se admiten .xlsx y .xls.
  • Causa: se proporcionaron archivos de Excel no válidos.
  • Recomendación: use el carácter comodín para filtrar y obtener archivos de Excel .xls y .xlsx antes de leer los datos.

Código de error: DF-Excel-InvalidRange

Código de error: DF-Excel-InvalidWorksheetConfiguration

  • Mensaje: Excel sheet name and index cannot exist at the same time (El nombre y el índice de la hoja de Excel no pueden existir al mismo tiempo).
  • Causa:el índice y el nombre de la hoja de Excel se proporcionan al mismo tiempo.
  • Recomendación: para leer los datos de Excel, compruebe el valor del parámetro y especifique el nombre de la hoja o el índice.

Código de error: DF-Excel-WorksheetConfigMissed

  • Mensaje: Excel sheet name or index is required (El nombre o el índice de la hoja de Excel es obligatorio).
  • Causa: se proporcionó una configuración de hoja de cálculo de Excel no válida.
  • Recomendación: para leer los datos de Excel, compruebe el valor del parámetro y especifique el nombre de la hoja o el índice.

Código de error: DF-Excel-WorksheetNotExist

  • Mensaje: Excel worksheet does not exist (La hoja de cálculo de Excel no existe).
  • Causa: se proporcionó un índice o un nombre de hoja de cálculo no válidos.
  • Recomendación: para leer los datos de Excel, compruebe el valor del parámetro y especifique un nombre de hoja o un índice válidos.

Código de error: DF-Executor-AcquireStorageMemoryFailed

  • Mensaje: error al transferir la memoria de inscripción a la memoria de almacenamiento. El clúster se quedó sin memoria durante la ejecución. Vuelva a intentar usar un entorno de ejecución de integración con más núcleos o un tipo de proceso optimizado para memoria.
  • Causa: el clúster no tiene memoria suficiente.
  • Recomendación: use un entorno de ejecución de integración con más núcleos o el tipo de proceso optimizado para memoria.

Código de error: DF-Executor-BlockCountExceedsLimitError

  • Mensaje: el recuento de bloques sin confirmar no puede superar el límite máximo de 100 000 bloques. Compruebe la configuración de blobs.
  • Causa: El número máximo de bloques sin confirmar en un blob es de 100 000.
  • Recomendación: Póngase en contacto con el equipo del producto de Microsoft para obtener más detalles sobre este problema.

Código de error: DF-Executor-BroadcastFailure

  • Mensaje: Error de ejecución del flujo de datos durante el intercambio de difusión. Entre las posibles causas pueden estar conexiones mal configuradas en los orígenes o un error de tiempo de espera para unirse a la difusión. Para garantizar que los orígenes estén configurados correctamente, pruebe la conexión o ejecute una vista previa de datos de origen en una sesión de depuración de flujo de datos. Con el fin de evitar que se agote el tiempo de espera para unirse a la difusión, puede elegir la opción de difusión "Desactivado" en las transformaciones join/exists/lookup. Si tiene previsto usar la opción de difusión para mejorar el rendimiento, asegúrese de que la secuencia de difusión pueda generar datos en un plazo de 60 segundos en ejecuciones de depuración y de 300 en ejecuciones de trabajos. Si el problema continúa, póngase en contacto con soporte al cliente.

  • Causa:

    1. El error de conexión o configuración de origen podría provocar un error de difusión en transformaciones join/exists/lookup.
    2. La difusión tiene un tiempo de espera predeterminado de 60 segundos en ejecuciones de depuración y de 300 en ejecuciones de trabajos. En la transformación join, la secuencia elegida para la difusión parece demasiado grande para generar datos dentro de este límite. Si no se usa una transformación join, la difusión predeterminada realizada por un flujo de entrada puede alcanzar el mismo límite.
  • Recomendación:

    • obtenga una vista previa de los datos en los orígenes para confirmar que están bien configurados.
    • Desactive la opción de difusión o evite difundir flujos de datos de gran tamaño que puedan tardar más de 60 segundos en procesarse. En su lugar, elija un flujo más pequeño para difundir.
    • Las tablas SQL o Data Warehouse y los archivos de código de fuente de gran tamaño suelen ser malos candidatos.
    • En ausencia de una combinación de difusión, use un clúster más grande si se presenta el error.
    • Si el problema continúa, póngase en contacto con el servicio de atención al cliente.

Código de error: DF-Executor-BroadcastTimeout

  • Mensaje: error de tiempo de espera de combinación de difusión. Asegúrese de que el flujo de difusión genera datos en un plazo de 60 segundos en ejecuciones de depuración y de 300 segundos en ejecuciones de trabajos.

  • Causa: La difusión tiene un tiempo de espera predeterminado de 60 segundos en ejecuciones de depuración y de 300 segundos en ejecuciones de trabajos. El flujo elegido para la difusión es demasiado grande para generar datos dentro de este límite.

  • Recomendación: Marque la pestaña Optimizar en las transformaciones de flujo de datos para combinación, existe y búsqueda. La opción predeterminada para la difusión es Auto. Si se establece en Auto o si configura manualmente el lado izquierdo o derecho para difundir en Fijo, puede establecer una configuración mayor de Azure Integration Runtime (IR) o desactivar la difusión. Para el mejor rendimiento en los flujos de datos, se recomienda permitir que Spark realice la difusión con Auto y use una instancia de Azure IR optimizada para memoria.

    Si ejecuta el flujo de datos en una ejecución de prueba de depuración desde una ejecución de canalización de depuración, puede ejecutar en esta condición con mayor frecuencia. La aparición más frecuente del error se debe a que Azure Data Factory limita el tiempo de espera de la difusión a 60 segundos para mantener una experiencia de depuración más rápida. Puede ampliar el tiempo de espera hasta el tiempo de espera de 300 segundos de una ejecución desencadenada. Para ello, puede usar la opción Depurar>Use Activity Runtime (Usar tiempo de ejecución de actividad) para usar la instancia de Azure IR definida en la actividad de ejecutar canalización de flujo de datos.

  • Mensaje: error de tiempo de espera de combinación de difusión. Puede elegir la opción de difusión "Desactivada" en la transformación join/exists/lookup para evitar este problema. Si tiene previsto difundir la opción de combinación para mejorar el rendimiento, asegúrese de que el flujo de difusión pueda generar datos en un plazo de 60 segundos en ejecuciones de depuración y de 300 segundos en ejecuciones de trabajos.

  • Causa: La difusión tiene un tiempo de espera predeterminado de 60 segundos en ejecuciones de depuración y de 300 segundos en ejecuciones de trabajos. En la combinación de difusión, el flujo elegido para la difusión es demasiado grande para generar datos dentro de este límite. Si no se usa una combinación de difusión, la difusión predeterminada realizada por el flujo de datos puede alcanzar el mismo límite.

  • Recomendación: Desactive la opción de difusión o evite la difusión de flujos de datos de gran tamaño para los que el procesamiento pueda tardar más de 60 segundos. Elija un flujo más pequeño para la difusión. Los archivos de código fuente y las tablas de Azure SQL Data Warehouse grandes no suelen ser opciones adecuadas. En ausencia de una combinación de difusión, use un clúster mayor si se produce el error.

Código de error: DF-Executor-ColumnNotFound

  • Mensaje: El nombre de columna usado en la expresión no está disponible o no es válido.
  • Causa: Se usa un nombre de columna no válido o no disponible en una expresión.
  • Recomendación: Compruebe los nombres de columna usados en las expresiones.

Código de error: DF-Executor-Conversion

  • Mensaje: Converting to a date or time failed due to an invalid character (Error al realizar la conversión a una fecha o hora porque un carácter no es válido).
  • Causa: Los datos no tienen el formato esperado.
  • Recomendación: Use el tipo de datos correcto.

Código de error: DF-Executor-DriverError

  • Mensaje: INT96 es un tipo de marca de tiempo heredado que no es compatible con el flujo de datos de ADF. Considere la posibilidad de actualizar el tipo de columna a los tipos más recientes.
  • Causa: Error del controlador.
  • Recomendación: INT96 es un tipo de marca de tiempo heredado que no es compatible con el flujo de datos de Azure Data Factory. Considere la posibilidad de actualizar el tipo de columna al tipo más reciente.

Código de error: DF-Executor-FieldNotExist

  • Mensaje: el campo de la estructura no existe.
  • Causa: se usan nombres de campo no válidos o no disponibles en las expresiones.
  • Recomendación: compruebe los nombres de campo usados en las expresiones.

Código de error: DF-Executor-illegalArgument

  • Mensaje: asegúrese de que la clave de acceso del servicio vinculado es correcta.
  • Causa: El nombre de cuenta o la clave de acceso son incorrectos.
  • Recomendación: asegúrese de que el nombre de cuenta o la clave de acceso especificados en el servicio vinculado son correctos.

Código de error: DF-Executor-IncorrectLinkedServiceConfiguration

  • Mensaje: Las causas posibles son:
    • El servicio vinculado está configurado incorrectamente como el tipo "Azure Blob Storage" en lugar de "Azure DataLake Storage Gen2" y tiene habilitada la opción "Espacio de nombres jerárquico". Cree un nuevo servicio vinculado de tipo "Azure DataLake Storage Gen2" para la cuenta de almacenamiento en cuestión.
    • Algunos escenarios con cualquier combinación de "Borrar la carpeta", la opción "Nombre de archivo" no predeterminada y creación de particiones "Clave" pueden producir un error con un servicio vinculado de blobs en una cuenta de almacenamiento habilitada para el "espacio de nombres jerárquico". Puede deshabilitar esta configuración de flujo de datos (si está habilitada) e intentarlo de nuevo en caso de que no desee crear un nuevo servicio vinculado de Gen2.
  • Causa: error en la operación de eliminación en la cuenta de Azure Data Lake Storage Gen2, ya que su servicio vinculado está configurado incorrectamente como Azure Blob Storage.
  • Recomendación: cree un nuevo servicio vinculado Azure Data Lake Storage Gen2 para la cuenta de almacenamiento. Si no es factible, algunos escenarios conocidos, como Borrar la carpeta, la opción de nombre de archivo no predeterminado, la creación de particiones de claves en cualquier combinación puede producir un error con un servicio vinculado de Azure Blob Storage en una cuenta de almacenamiento habilitada para el espacio de nombres jerárquico. Puede deshabilitar esta configuración de flujo de datos si las habilitó e intentarlo de nuevo.

Error code: DF-Executor-InternalServerError

  • Mensaje: no se pudo ejecutar el flujo de datos con un error interno del servidor, vuelva a intentarlo más adelante. Si el problema persiste, póngase en contacto con el equipo de soporte técnico de Microsoft para más ayuda.
  • Causa: se produce un error en la ejecución del flujo de datos debido al error del sistema.
  • Recomendación: para resolver este problema, consulte Errores internos del servidor.

Código de error: DF-Executor-InvalidColumn

  • Mensaje: Column name needs to be specified in the query, set an alias if using a SQL function.
  • Causa: No se ha especificado ningún nombre de columna.
  • Recomendación: Establezca un alias si usa una función SQL como min () o max().

Código de error: DF-Executor-InvalidInputColumns

  • Mensaje: la columna de la configuración de origen no se encuentra en el esquema de los datos de origen.
  • Causa: se proporcionaron columnas no válidas en el origen.
  • Recomendación: Compruebe las columnas de la configuración de origen y asegúrese de que es el subconjunto de los esquemas de los datos de origen.

Código de error: DF-Executor-InvalidOutputColumns

  • Mensaje: el resultado no tiene ninguna columna de salida. Asegúrese de que al menos una columna está asignada.
  • Causa: no se asignó ninguna columna.
  • Recomendación: compruebe el esquema del receptor para asegurarse de que se asigna al menos una columna.

Código de error: DF-Executor-InvalidPartitionFileNames

  • Mensaje: los nombres de archivo no pueden tener valores vacíos mientras la opción nombre de archivo está establecida según la partición.
  • Causa: se proporcionaron nombres de archivo de partición no válidos.
  • Recomendación: compruebe la configuración del receptor para que tenga el valor correcto de los nombres de archivo.

Código de error: DF-Executor-InvalidPath

  • Mensaje: la ruta de acceso no se resuelve en ningún archivo. Asegúrese de que el archivo o carpeta existe y no está oculto.
  • Causa: Se proporcionó una ruta de acceso de archivo o carpeta no válida que no se puede encontrar o a la que no se puede acceder.
  • Recomendación: compruebe la ruta de acceso de archivo o carpeta y asegúrese de que existe y que se puede acceder a ella en el almacenamiento.

Error code: DF-Executor-InvalidStageConfiguration

  • Mensaje: Storage with user assigned managed identity authentication in staging is not supported.
  • Causa: se produce una excepción debido a una configuración de almacenamiento provisional no válida.
  • Recomendación: la autenticación de identidad administrada asignada por el usuario no se admite en el almacenamiento provisional. Use una autenticación diferente para crear un servicio vinculado de Azure Data Lake Storage Gen2 o Azure Blob Storage y, a continuación, úselo como almacenamiento provisional en flujos de datos de asignación.

Código de error: DF-Executor-InvalidType

  • Mensaje: asegúrese de que el tipo de parámetro coincide con el tipo de valor pasado. Actualmente no se admite el paso de parámetros float desde canalizaciones.
  • Causa: los tipos de datos no son compatibles entre el tipo declarado y el valor del parámetro real.
  • Recomendación: Compruebe que los valores de parámetro pasados al flujo de datos coinciden con el tipo declarado.

Código de error: DF-Executor-OutOfDiskSpaceError

  • Mensaje: Error interno del servidor
  • Causa: El clúster se está quedando sin espacio en disco.
  • Recomendación: Vuelva a ejecutar la canalización. Si esto no resuelve el problema, póngase en contacto con el servicio de asistencia al cliente.

Código de error: DF-Executor-OutOfMemoryError

  • Mensaje: el clúster ha tenido un problema de memoria insuficiente durante la ejecución. Vuelva a intentar usar un entorno de ejecución de integración con un mayor recuento de núcleos o un tipo de proceso optimizado para memoria
  • Causa: El clúster se está quedando sin memoria.
  • Recomendación: Los clústeres de depuración están diseñados para el desarrollo. Use el muestreo de datos y un tipo y tamaño de proceso adecuados para ejecutar la carga. Para obtener sugerencias de rendimiento, vea Guía del rendimiento del flujo de datos de asignación.

Código de error: DF-Executor-OutOfMemorySparkBroadcastError

  • Mensaje: el conjunto de datos difundido explícitamente con la opción izquierda/derecha debe ser lo suficientemente pequeño como para ajustarse a la memoria del nodo. Puede elegir la opción de difusión "Desactivada" en la transformación join/exists/lookup para evitar este problema o usar un entorno de ejecución de integración con más memoria.
  • Causa: el tamaño de la tabla difundida supera con creces los límites de la memoria del nodo.
  • Recomendación: la opción izquierda/derecha de difusión solo debe usarse para tamaños de conjunto de datos más pequeños, que puedan ajustarse a la memoria del nodo. Asegúrese de configurar el tamaño del nodo correctamente o desactivar la opción de difusión.

Código de error: DF-Executor-OutOfMemorySparkError

  • Mensaje: Los datos podrían ser demasiado grandes para caber en la memoria.
  • Causa: el tamaño de los datos supera con creces los límites de la memoria del nodo.
  • Recomendación: aumente el número de núcleos y cambie al tipo de proceso optimizado para memoria.

Código de error: DF-Executor-ExpressionParseError

  • Mensaje: No puede analizarse la expresión.
  • Causa: Una expresión generó errores de análisis debido a un formato incorrecto.
  • Recomendación: Compruebe el formato de la expresión.

Código de error: DF-Executor-PartitionDirectoryError

  • Mensaje: la ruta de acceso de origen especificada tiene varios directorios con particiones (por ejemplo, <Ruta de acceso de origen>/<Directorio raíz de la partición 1>/a=10/b=20, <Ruta de acceso de origen>/<Directorio raíz de la partición 2>/c=10/d=30) o un directorio con particiones con otro archivo o directorio sin particiones (por ejemplo, <Ruta de acceso de origen>/<Directorio raíz de la partición 1>/a=10/b=20, <Ruta de acceso de origen>/Directorio 2/archivo1). Quite el directorio raíz con particiones de la ruta de origen y léalo a través de una transformación de origen independiente.
  • Causa: La ruta de origen tiene varios directorios con particiones o un directorio con particiones que tiene otro archivo o directorio sin particiones.
  • Recomendación: Quite el directorio raíz con particiones de la ruta de origen y léalo a través de una transformación de origen independiente.

Código de error: DF-Executor-RemoteRPCClientDisassociated

  • Mensaje: trabajo anulado debido a un error de fase. Cliente RPC remoto desasociado. Probablemente se deba a los contenedores que superan los umbrales o a problemas de red.
  • Causa: se ha producido un error en las ejecuciones de actividad de flujo de datos debido a un problema de red transitorio o porque un nodo del clúster de Spark se ha quedado sin memoria.
  • Recomendación: aplique una de las siguientes opciones para solucionar este problema:
    • Opción 1: Use un clúster potente (los nodos de unidad y ejecutor tienen suficiente memoria para controlar los macrodatos) para ejecutar canalizaciones de flujo de datos con la opción "Tipo de proceso" establecida en "Optimizado para memoria". La configuración se muestra en la siguiente imagen.

      Screenshot that shows the configuration of Compute type.

    • Opción 2: Use un tamaño de clúster mayor (por ejemplo, 48 núcleos) para ejecutar las canalizaciones de flujo de datos. Para obtener más información sobre el tamaño del clúster, consulte este documento.

    • Opción 3: Vuelva a particionar los datos de entrada. Para la tarea que se ejecuta en el clúster de Spark de flujo de datos, una partición es una tarea que se ejecuta en un solo nodo. Si los datos de una partición son demasiado grandes, la tarea relacionada que se ejecuta en el nodo debe consumir más memoria que el propio nodo, lo que provoca un error. Por lo tanto, puede usar la repartición para evitar una asimetría de datos y garantizar que el tamaño de los datos de cada partición sea el promedio y que el consumo de memoria no sea demasiado elevado.

      Screenshot that shows the configuration of partitions.

      Nota:

      Evalúe el tamaño de los datos o el número de datos de entrada de la partición y, a continuación, establezca un número de partición razonable en "Optimizar". Por ejemplo, el clúster que se usa en la ejecución de la canalización de flujo de datos tiene ocho núcleos, cada uno con 20 GB de memoria, pero los datos de entrada ocupan 1000 GB con diez particiones. Si ejecuta directamente el flujo de datos, se producirá el problema de memoria insuficiente porque 1000 GB/10 > 20 GB, por lo que es mejor establecer el número de nuevas particiones en 100 (1000 GB/100 < 20 GB).

    • Opción 4: Ajuste y optimice la configuración de origen, receptor o transformación. Por ejemplo, pruebe a copiar todos los archivos en un solo contenedor y no use el patrón de carácter comodín. Para obtener información más detallada, consulte Guía de optimización y rendimiento de flujos de datos de asignación.

Código de error: DF-Executor-SourceInvalidPayload

  • Mensaje: Data preview, debug, and pipeline data flow execution failed because container does not exist.
  • Causa: Un conjunto de datos contiene un contenedor que no existe en el almacenamiento.
  • Recomendación: Asegúrese de que el contenedor al que se hace referencia en el conjunto de datos exista o se pueda acceder.

Código de error: DF-Executor-StoreIsNotDefined

  • Mensaje: la configuración del almacén no está definida. Este error se puede deber a una asignación de parámetros no válida en la canalización.
  • Causa: se proporcionó una configuración de almacén no válida.
  • Recomendación: compruebe la asignación de valores de parámetro en la canalización. Una expresión de parámetro puede contener caracteres no válidos.

Código de error: DF-Executor-StringValueNotInQuotes

  • Mensaje: No se permiten operandos de columna en expresiones literales.
  • Causa: el valor de un parámetro de cadena o un valor de cadena esperado no está entre comillas simples.
  • Recomendación: cerca de los números de línea mencionados en el script de flujo de datos, asegúrese de que el valor de un parámetro de cadena o un valor de cadena esperado se incluya entre comillas simples.

Código de error: DF-Executor-SystemImplicitCartesian

  • Mensaje: no se admite el producto cartesiano implícito para la combinación interna. Use la combinación cruzada en su lugar. Columns used in join should create a unique key for rows. (No se admite el producto cartesiano implícito para la combinación interna; utilice la combinación cruzada en su lugar. Las columnas utilizadas en la combinación deben crear una clave única para las filas).
  • Causa: No se admiten los productos cartesianos implícitos para combinaciones internas entre planes lógicos. Si utiliza columnas en la combinación, cree una clave única.
  • Recomendación: En el caso de las combinaciones que se basan en la no igualdad, use la combinación cruzada.

Código de error: DF-Executor-SystemInvalidJson

  • Mensaje: JSON parsing error, unsupported encoding or multiline (Error de análisis de JSON, codificación no compatible o multilínea)
  • Causa: Posibles problemas con el archivo JSON, como codificación no admitida, bytes dañados o uso del origen JSON como un único documento en muchas líneas anidadas.
  • Recomendación: Verifique que se admite la codificación del archivo JSON. En la transformación de origen que usa un conjunto de datos JSON, expanda JSON Settings (Configuración de JSON) y active Documento único.

Código de error: DF-Executor-UnauthorizedStorageAccess

  • Causa: no se le permite acceder a la cuenta de almacenamiento debido a que faltan roles para la autenticación de identidad administrada o la entidad de servicio, o a la configuración del firewall de red.

  • Recomendación: al usar la autenticación de identidad administrada o entidad de servicio,

    1. Para el origen: en el Explorador de Storage, conceda a la identidad administrada o la entidad de servicio al menos permiso de ejecución para TODAS las carpetas de nivel superior y el sistema de archivos, junto con el permiso de lectura para los archivos que se van a copiar. Como alternativa, en el control de acceso (IAM), conceda a la identidad administrada o la entidad de servicio al menos el rol Lector de datos de Storage Blob.
    2. Para el receptor: en el Explorador de Storage, conceda a la identidad administrada o la entidad de servicio al menos permiso de ejecución para TODAS las carpetas de nivel superior y el sistema de archivos, junto con el permiso de escritura para la carpeta receptora. Como alternativa, en el control de acceso (IAM), conceda a la identidad administrada o la entidad de servicio al menos el rol Colaborador de datos de Storage Blob.

    Asegúrese también de que el firewall de red de la cuenta de almacenamiento está configurado correctamente, ya que al activar las reglas de firewall para la cuenta de almacenamiento se bloquean las solicitudes entrantes de datos de forma predeterminada, a menos que las solicitudes se originen en un servicio que funcione dentro de una red virtual de Azure o desde direcciones IP públicas permitidas.

Código de error: DF-Executor-UnreachableStorageAccount

  • Mensaje: el sistema no puede resolver la dirección IP del host. Compruebe que el nombre de host sea correcto o si el servidor DNS puede resolver el host en una dirección IP correctamente.
  • Causa: no se puede acceder a la cuenta de almacenamiento especificada.
  • Recomendación: compruebe el nombre de la cuenta de almacenamiento y asegúrese de que la cuenta de almacenamiento existe.

Código de error: DF-Executor-UserError

  • Mensaje: Error en el trabajo debido a la razón: GetjobStatus, Error en el trabajo: com.microsoft.dataflow.issues: DF-MICROSOFT365-CONSENTPENDING
  • Causa: se necesita la aprobación del acceso con privilegios para copiar datos. Se trata de un problema de configuración de usuario.
  • Recomendación: pida al administrador del inquilino que apruebe la solicitud de acceso a datos en Office365 en el módulo de administración de acceso con privilegios (PAM).

Código de error: DF-Executor-DSLParseError

  • Mensaje: No se puede analizar el script de flujo de datos.
  • Causa: el script de flujo de datos tiene errores de análisis.
  • Recomendación: compruebe si hay errores (ejemplo: símbolos que faltan, símbolos no deseados) cerca de los números de línea mencionados en el script de flujo de datos.

Código de error: DF-Executor-IncorrectQuery

  • Mensaje: Sintaxis incorrecta. El error detectado de SQL Server al leer de la tabla especificada o al ejecutar la consulta especificada.
  • Causa: la consulta enviada era sintácticamente incorrecta.
  • Recomendación: compruebe la corrección sintáctica de la consulta especificada. Asegúrese de tener una cadena de consulta sin comillas cuando se hace referencia a ella como parámetro de canalización.

Código de error: DF-Executor-ParameterParseError

  • Mensaje: el flujo de parámetros tiene errores de análisis. No respetar el tipo de datos de los parámetros podría ser una de las causas.
  • Causa: errores de análisis en parámetros especificados.
  • Recomendación: compruebe que los parámetros tienen errores, asegúrese de usar las funciones adecuadas y respete los tipos de datos especificados.

Error code: DF-File-InvalidSparkFolder

  • Mensaje: Failed to read footer for file.
  • Causa: el trabajo de flujo estructurado crea la carpeta _spark_metadata.
  • Recomendación: elimine la carpeta _spark_metadata si existe.

Código de error: DF-GEN2-InvalidAccountConfiguration

  • Message: se debe especificar la clave de cuenta o token de SAS, tenant/spnId/spnCredential/spnCredentialType, userAuth o miServiceUri/miServiceToken.
  • Causa: se proporcionó una credencial no válida en el servicio vinculado de Azure Data Lake Storage (ADLS) Gen2.
  • Recomendación: actualice el servicio vinculado de ADLS Gen2 para que tenga la configuración de credenciales correcta.

Código de error: DF-GEN2-InvalidAuthConfiguration

  • Mensaje: Solo se puede especificar uno de los tres métodos de autenticación (Key, ServicePrincipal y MI).
  • Causa: se proporcionó un método de autenticación no válido en el servicio vinculado de ADLS Gen2.
  • Recomendación: actualice el servicio vinculado de ADLS Gen2 para que tenga uno de los tres métodos de autenticación siguientes: Key, ServicePrincipal y MI.

Código de error: DF-GEN2-InvalidCloudType

  • Mensaje: El tipo de nube no es válido.
  • Causa: se proporcionó un tipo de nube no válido.
  • Recomendación: compruebe el tipo de nube en el servicio vinculado de ADLS Gen2 relacionado.

Código de error: DF-GEN2-InvalidServicePrincipalCredentialType

  • Mensaje: el tipo de credencial de entidad de servicio no es válido.
  • Causa: el tipo de credencial de entidad de servicio no es válido.
  • Recomendación: actualice el servicio vinculado de ADLS Gen2 para establecer el tipo de credencial de entidad de servicio correcto.

Error code: DF-GEN2-InvalidStorageAccountConfiguration

  • Mensaje: la operación de blob no se admite en cuentas de almacenamiento anteriores. La creación de una cuenta de almacenamiento puede corregir el problema.
  • Causa: la cuenta de almacenamiento es demasiado antigua.
  • Recomendación: cree una cuenta de almacenamiento nueva.

Código de error: DF-Github-WriteNotSupported

  • Mensaje: El almacén de GitHub no permite operaciones de escritura.
  • Causa: el almacén de GitHub es de solo lectura.
  • Recomendación: la definición de la entidad de almacén se encuentra en otro lugar.

Código de error: DF-Hive-InvalidBlobStagingConfiguration

  • Mensaje: Se deben especificar las propiedades de almacenamiento provisional de Blob Storage.
  • Causa: se proporcionó una configuración de almacenamiento provisional no válida en Hive.
  • Recomendación: compruebe si la clave de cuenta, el nombre de cuenta y el contenedor están configurados correctamente en el servicio vinculado de Blob relacionado que se usa como almacenamiento provisional.

Código de error: DF-Hive-InvalidDataType

  • Mensaje: columnas no admitidas.
  • Causa: se proporcionan columnas no admitidas.
  • Recomendación: actualice la columna de datos de entrada para que coincida con el tipo de datos admitido por Hive.

Código de error: DF-Hive-InvalidGen2StagingConfiguration

  • Mensaje: El almacenamiento provisional del almacenamiento de ADLS Gen2 solo admite la credenciales de clave de la entidad de servicio.

  • Causa: se proporcionó una configuración de almacenamiento provisional no válida en Hive.

  • Recomendación: actualice el servicio vinculado de ADLS Gen2 relacionado que se usa como almacenamiento provisional. Actualmente, solo se admiten las credenciales de clave de entidad de servicio.

  • Mensaje: Se deben especificar las propiedades de almacenamiento provisional de ADLS Gen2. Se requiere la clave o bien tenant/spnId/spn Credential/spnCredentialType o miServiceUri/miServiceToken.

  • Causa: se proporcionó una configuración de almacenamiento provisional no válida en Hive.

  • Recomendación: actualice el servicio vinculado de ADLS Gen2 con las credenciales adecuadas que se usan como almacenamiento provisional en Hive.

Código de error: DF-Hive-InvalidStorageType

  • Mensaje: El tipo de almacenamiento puede ser blob o gen2.
  • Causa: solo se admite el tipo de almacenamiento de Azure Blob o ADLS Gen2.
  • Recomendación: elija el tipo de almacenamiento correcto de Azure Blob o ADLS Gen2.

Error code: DF-JSON-WrongDocumentForm

  • Mensaje: los registros con formato incorrecto se detectan en la inferencia de esquema. Modo de análisis: FAILFAST. Podría deberse a una selección incorrecta en el formulario de documento para analizar los archivos JSON. Pruebe otro "formulario de documento" (documento único/documento por línea/matriz de documentos) en el origen json.
  • Causa: se ha seleccionado un formulario de documento incorrecto para analizar los archivos JSON.
  • Recomendación: pruebe otro formulario de documento (documento único/Document por línea/Matriz de documentos) en la configuración de JSON. La mayoría de los casos de errores de análisis se deben a una configuración incorrecta.

Código de error: DF-MICROSOFT365-CONSENTPENDING

  • Mensaje: el consentimiento del administrador está pendiente.
  • Causa: falta el consentimiento del administrador.
  • Recomendación: proporcione el consentimiento y vuelva a ejecutar la canalización. Para proporcionar consentimiento, consulte solicitudes de PAM.

Código de error: DF-MSSQL-ErrorRowsFound

  • Causa: se han encontrado filas de error o no válidas al escribir en el receptor de Azure SQL Database.
  • Recomendación: busque las filas de error en la ubicación de almacenamiento de datos rechazada si está configurada.

Código de error: DF-MSSQL-ExportErrorRowFailed

  • Mensaje: se ha producido una excepción al escribir filas de error en el almacenamiento.
  • Mensaje: Se ha producido una excepción al escribir filas de error en el almacenamiento.
  • Recomendación: compruebe la configuración del servicio vinculado de datos rechazados.

Código de error: DF-MSSQL-InvalidAuthConfiguration

  • Mensaje: solo se puede especificar uno de los tres métodos de autenticación (Key, ServicePrincipal y MI).
  • Causa: se proporcionó un método de autenticación no válido en el servicio vinculado de MSSQL.
  • Recomendación: solo puede especificar uno de los tres métodos de autenticación (Key, ServicePrincipal y MI) en el servicio vinculado de MSSQL relacionado.

Código de error: DF-MSSQL-InvalidCloudType

  • Mensaje: El tipo de nube no es válido.
  • Causa: se proporcionó un tipo de nube no válido.
  • Recomendación: Compruebe el tipo de nube en el servicio vinculado MSSQL relacionado.

Código de error: DF-MSSQL-InvalidCredential

  • Message: se debe especificar user/pwd o bien tenant/spnId/spnKey o miServiceUri/miServiceToken.
  • Causa: se proporcionó una credencial no válida en el servicio vinculado de ADLS Gen2.
  • Recomendación: actualice el servicio vinculado de MSSQL relacionado con las credenciales correctas y se debe especificar uno de los valores user/pwd o tenant/spnId/spnKey o miServiceUri/miServiceToken.

Código de error: DF-MSSQL-InvalidDataType

  • Mensaje: campos no admitidos.
  • Causa: se proporcionan campos no admitidos.
  • Recomendación: Modifique la columna de datos de entrada para que coincida con el tipo de datos admitido por MSSQL.

Código de error: DF-MSSQL-InvalidFirewallSetting

  • Mensaje: error al establecer la conexión de TCP/IP con el host. Asegúrese de que se esté ejecutando una instancia de SQL Server en el host y se acepten las conexiones TCP/IP en el puerto. Asegúrese de que un firewall no bloquee las conexiones TCP al puerto.
  • Causa: la configuración del firewall de la base de datos SQL bloquea el flujo de datos al que se accede.
  • Recomendación: compruebe la configuración del firewall de la base de datos SQL y permita que los servicios y recursos de Azure accedan a este servidor.

Código de error: DF-MSSQL-InvalidCertificate

  • Mensaje: Error de configuración de SQL Server. Instale un certificado de confianza en el servidor o cambie la configuración de la cadena de conexión "encrypt" a false y la de la cadena de conexión "trustServerCertificate" a true.
  • Causa: Error de configuración de SQL Server.
  • Recomendaciones: Instale un certificado de confianza en el servidor SQL Server o cambie la configuración de la cadena de conexión encrypt a false y la de la cadena de conexión trustServerCertificate a true.

Código de error: DF-PGSQL-InvalidCredential

  • Mensaje: Se debe especificar el usuario o la contraseña.
  • Causa: falta el usuario o la contraseña.
  • Recomendación: asegúrese de que tiene la configuración de credenciales correcta en el servicio vinculado de PostgreSQL relacionado.

Código de error: DF-SAPODATA-InvalidRunMode

  • Mensaje: no se pudo ejecutar el flujo de datos con el modo de ejecución no válido.
  • Causa: las causas posibles son:
    1. Solo se puede especificar el modo de lectura fullLoad cuando enableCdc es false.
    2. Solo se puede especificar el modo incrementalLoad o fullAndIncrementalLoad cuando enableCdc es true.
    3. Solo se puede especificar fullLoad, incrementalLoad o fullAndIncrementalLoad.
  • Recomendación: vuelva a configurar la actividad y ejecútela de nuevo. Si el problema persiste, póngase en contacto con el equipo de soporte técnico de Microsoft para más ayuda.

Código de error: DF-SAPODATA-StageLinkedServiceMissed

  • Mensaje: no se pudo ejecutar el flujo de datos, porque el servicio vinculado de almacenamiento provisional no existía en DSL. Vuelva a configurar la actividad y ejecútela de nuevo. Si el problema persiste, póngase en contacto con el Soporte técnico de Microsoft para obtener más ayuda.
  • Causa: el servicio vinculado de almacenamiento provisional no existe en DSL.
  • Recomendación: vuelva a configurar la actividad y ejecútela de nuevo. Si el problema persiste, póngase en contacto con el equipo de soporte técnico de Microsoft para más ayuda.

Código de error: DF-SAPOODATA-StageContainerMissed

  • Mensaje: Se requiere un contenedor o sistema de archivos para el almacenamiento provisional.
  • Causa: no se ha especificado el contenedor o el sistema de archivos para el almacenamiento provisional.
  • Recomendación: especifique el contenedor o el sistema de archivos para el almacenamiento provisional.

Código de error: DF-SAPODATA-StageFolderPathMissed

  • Mensaje: la ruta de acceso a la carpeta es necesaria para el almacenamiento provisional.
  • Causa: no se especifica ninguna ruta de acceso de carpeta para el almacenamiento provisional.
  • Recomendación: especifique la ruta de carpeta para el almacenamiento provisional.

Código de error: DF-SAPODATA-ODataServiceOrEntityMissed

  • Mensaje: Tanto servicePath de SAP como entityName son necesarios en la operación import-schema, preview-data y read data.
  • Causa: la ruta de acceso del servicio y el nombre de la entidad no pueden ser null al importar el esquema, obtener una vista previa de los datos o leer datos.
  • Recomendación: especifique la ruta de acceso del servicio y el nombre de la entidad al importar el esquema, obtener una vista previa de los datos o leer datos.

Código de error: DF-SAPODATA-TimeoutInvalid

  • Mensaje: el tiempo de espera no es válido, no debe ser superior a 7 días.
  • Causa: el tiempo de espera no puede superar los 7 días.
  • Recomendación: especifique el tiempo de espera válido.

Código de error: DF-SAPODATA-ODataServiceMissed

  • Mensaje: se requiere servicePath de SAP al examinar el nombre de la entidad.
  • Causa: la ruta de acceso del servicio no puede ser null al examinar el nombre de la entidad.
  • Recomendación: especifique la ruta de acceso del servicio.

Código de error: DF-SAPODATA-SystemError

  • Mensaje: Error del sistema: No se pudo obtener deltaToken de SAP. Póngase en contacto con el Soporte técnico de Microsoft para obtener más ayuda.
  • Causa: no se pudo obtener el token delta de SAP.
  • Recomendación: de lo contrario, comuníquese con el soporte técnico de Microsoft para obtener más ayuda.

Código de error: DF-SAPODATA-StageAuthInvalid

  • Mensaje: Se ha proporcionado un secreto de cliente no válido
  • Causa: la credencial de entidad de servicio del almacenamiento provisional no es correcta.
  • Recomendación: pruebe la conexión en el servicio vinculado de almacenamiento provisional y confirme que la configuración de autenticación del almacenamiento provisional es correcta.

Código de error: DF-SAPODATA-NotReached

  • Causas y recomendaciones: no se pudo crear la conexión de OData a la dirección URL de la solicitud. Diversas causas pueden provocar este problema. Consulte la lista siguiente para ver las posibles causas y recomendaciones relacionadas.

    Análisis de las causas Recomendación
    El servidor SAP se apaga. Compruebe si se ha iniciado el servidor SAP.
    Problema del proxy del entorno de ejecución de integración autohospedado. Compruebe el proxy del entorno de ejecución de integración autohospedado.
    Entrada de parámetros incorrectos (por ejemplo, nombre de servidor o contraseña de SAP incorrectos) Compruebe los parámetros de entrada: nombre del servidor y contraseña de SAP.

Código de error: DF-SAPODATA-NoneODPService

  • Mensaje: el servicio odata actual no admite la extracción de datos de ODP, habilite ODP para el servicio
  • Causa: el servicio OData actual no admite la extracción de datos de ODP.
  • Recomendación: habilite ODP para el servicio.

Código de error: DF-SAPODP-AuthInvalid

  • Mensaje: Nombre de SapOdp o Contraseña incorrecto
  • Causa: el nombre de entrada o la contraseña son incorrectos.
  • Recomendación: confirme que el nombre de entrada o la contraseña son correctos.

Código de error: DF-SAPODP-ContextMissed

  • Causa: El valor de contexto no existe en OPD de SAP.
  • Recomendación: compruebe el valor de contexto y asegúrese de que es válido.

Código de error: DF-SAPODP-ContextMissed

  • Mensaje: Se requiere un contexto

  • Causas y recomendaciones: diversas causas pueden provocar este error. Busque en la lista siguiente el análisis de las posibles causas y la recomendación relacionada.

    Análisis de las causas Recomendación
    El valor de contexto no puede estar vacío durante la lectura de datos. Especifique el contexto.
    El valor de contexto no puede estar vacío al examinar los nombres de objeto. Especifique el contexto.

Código de error: DF-SAPODP-DataflowSystemError

  • Recomendación: vuelva a configurar la actividad y ejecútela de nuevo. Si el problema persiste, póngase en contacto con el equipo de soporte técnico de Microsoft para más ayuda.

Código de error: DF-SAPODP-DataParsingFailed

  • Causa: principalmente, tiene la configuración de columna oculta en la tabla de SAP. Cuando se usa el flujo de datos de asignación de SAP para leer datos del servidor SAP, devuelve todo el esquema (columnas, incluidas las ocultas), pero los datos devueltos no contienen valores relacionados. Por lo tanto, se ha producido una desalineación de datos que causó un problema de valor de análisis o de datos incorrectos.
  • Recomendación: hay dos recomendaciones para este problema:
    1. Quite la configuración oculta de las columnas relacionadas a través de la interfaz de usuario SAP.
    2. Si desea mantener la configuración de SAP existente sin cambios, use la característica oculta (agregar manualmente la propiedad enableProjection:true de DSL en el script) en el flujo de datos de asignación de SAP para filtrar las columnas ocultas y continuar leyendo datos.

Código de error: DF-SAPODP-ObjectInvalid

  • Causa: el nombre del objeto no se encuentra o no se libera.
  • Recomendación: compruebe el nombre del objeto y asegúrese de que es válido y ya está liberado.

Código de error: DF-SAPODP-ObjectNameMissed

  • Mensaje: Se requiere 'objectName' (nombre de objeto de SAP)
  • Causa: los nombres de objeto deben definirse al leer datos ODP de SAP.
  • Recomendación: especifique el nombre del objeto ODP de SAP.

Código de error: DF-SAPODP-SAPSystemError

  • Causa: se trata de un error del sistema SAP: user id locked.
  • Recomendación: póngase en contacto con el administrador de SAP para obtener ayuda.

Código de error: DF-SAPODP-SessionTerminate

  • Mensaje: Sesión interna finalizada con un error en tiempo de ejecución RAISE_EXCEPTION (consulte ST22)
  • Causa: problemas transitorios de objetos SLT.
  • Recomendación: vuelva a ejecutar la actividad del flujo de datos.

Código de error: DF-SAPODP-SHIROFFLINE

  • Causa: el entorno de ejecución de integración autohospedado está sin conexión.
  • Recomendación: compruebe el estado del entorno de ejecución de integración autohospedado y confirme que está en línea.

Código de error: DF-SAPODP-SLT-LIMITATION

  • Mensaje: La versión preliminar no se admite en el sistema SLT
  • Causa: el contexto o el objeto está en el sistema SLT que no admite la versión preliminar. Se trata de una limitación del sistema SLT de ODP de SAP.
  • Recomendación: ejecute directamente la actividad del flujo de datos.

Código de error: DF-SAPODP-StageAuthInvalid

  • Mensaje: Se ha proporcionado un secreto de cliente no válido
  • Causa: la credencial del certificado de entidad de servicio del almacenamiento provisional no es correcta.
  • Recomendación: compruebe si la conexión de prueba es correcta en el servicio vinculado de almacenamiento provisional y confirme que la configuración de autenticación del almacenamiento provisional es correcta.
  • Mensaje: No se pudo autenticar la solicitud de almacenamiento
  • Causa: la clave del almacenamiento provisional no es correcta.
  • Recomendación: compruebe si la conexión de prueba es correcta en el servicio vinculado de almacenamiento provisional y confirme que la clave de Azure Blob Storage es correcta.

Código de error: DF-SAPODP-StageBlobPropertyInvalid

  • Mensaje: Error en la lectura del almacenamiento provisional: las propiedades de autenticación del almacenamiento provisional en blobs no son válidas.
  • Causa: las propiedades de almacenamiento provisional en blobs no son válidas.
  • Recomendación: compruebe la configuración de autenticación en el servicio vinculado de almacenamiento provisional.

Código de error: DF-SAPODP-StageContainerMissed

  • Mensaje: No se puede crear un contenedor de Azure Blob
  • Causa: el contenedor de entrada no existe en el almacenamiento provisional.
  • Recomendación: escriba un nombre de contenedor válido para el almacenamiento provisional. Vuelva a seleccionar otro nombre de contenedor existente o cree un contenedor manualmente con el nombre de entrada.

Código de error: DF-SAPODP-StageContainerMissed

  • Mensaje: Se requiere un contenedor o sistema de archivos para el almacenamiento provisional.
  • Causa: no se ha especificado el contenedor o el sistema de archivos para el almacenamiento provisional.
  • Recomendación: especifique el contenedor o el sistema de archivos para el almacenamiento provisional.

Código de error: DF-SAPODP-StageFolderPathMissed

  • Mensaje: La ruta de acceso a la carpeta es necesaria para el almacenamiento provisional
  • Causa: no se especifica la ruta de acceso de la carpeta de almacenamiento provisional.
  • Recomendación: especifique la carpeta de almacenamiento provisional.

Código de error: DF-SAPODP-StageGen2PropertyInvalid

  • Mensaje: Error en la lectura del almacenamiento provisional: las propiedades de autenticación del almacenamiento provisional en Gen2 no son válidas.
  • Causa: las propiedades de autenticación del Azure Data Lake Storage Gen2 de almacenamiento provisional no son válidas.
  • Recomendación: compruebe la configuración de autenticación en el servicio vinculado de almacenamiento provisional.

Código de error: DF-SAPODP-StageStorageServicePrincipalCertNotSupport

  • Mensaje: error en la lectura del almacenamiento provisional: la autenticación de almacenamiento provisional no admite el certificado de entidad de servicio.
  • Causa: la credencial del certificado de entidad de servicio no es compatible con el almacenamiento provisional.
  • Recomendación: cambie la autenticación para que no use la credencial de certificado de la entidad de servicio.

Código de error: DF-SAPODP-StageStorageTypeInvalid

  • Mensaje: El tipo de almacenamiento provisional de SapOdp no es válido
  • Causa: solo se admiten Azure Blob Storage y Azure Data Lake Storage Gen2 para el almacenamiento provisional de ODP de SAP.
  • Recomendación: seleccione Azure Blob Storage o Azure Data Lake Storage Gen2 como almacenamiento provisional.

Código de error: DF-SAPODP-SubscriberNameMissed

  • Mensaje: Se requiere "subscriberName" mientras está seleccionada la opción "habilitar la captura de datos modificados".
  • Causa: la propiedad subscriberName del servicio vinculado de SAP es necesaria mientras se selecciona la opción "habilitar la captura de datos modificados".
  • Recomendación: especifique subscriberName en el servicio vinculado de ODP de SAP.

Código de error: DF-SAPODP-SAPSystemError

  • Causa: este error es un error del sistema de flujo de datos o un error del sistema del servidor SAP.
  • Recomendación: compruebe los detalles del mensaje de error. Si contiene stacktrace de errores relacionados con el servidor de SAP, póngase en contacto con el administrador de SAP para obtener ayuda. De lo contrario, comuníquese con el soporte técnico de Microsoft para obtener más ayuda.

Código de error: DF-SAPODP-NotReached

  • Mensaje: No se ha alcanzado el asociado ".*"

  • Causas y recomendaciones: Se trata de un problema de conectividad. Diversas causas pueden provocar este problema. Busque en la lista siguiente el análisis de las posibles causas y la recomendación relacionada.

    Análisis de las causas Recomendación
    El servidor SAP se apaga. Compruebe que se ha iniciado el servidor SAP.
    La dirección IP o el puerto del entorno de ejecución de integración autohospedado no está en la regla de seguridad de red de SAP. Compruebe que la dirección IP o el puerto del entorno de ejecución de integración autohospedado se encuentra en la regla de seguridad de red de SAP.
    Problema del proxy del entorno de ejecución de integración autohospedado. Compruebe el proxy del entorno de ejecución de integración autohospedado.
    Entrada de parámetros incorrectos (por ejemplo, nombre de servidor o dirección IP de SAP incorrectos). Compruebe los parámetros de entrada: nombre del servidor, IP de SAP.

Código de error: DF-SAPODP-DependencyNotFound

  • Mensaje: No se pudo cargar el archivo o ensamblado "sapnco, Version=*
  • Causa: No descargue e instale el conector de .NET para SAP en la máquina del entorno de ejecución de integración autohospedado.
  • Recomendación: siga los pasos que se indican en Configuración de un entorno de ejecución de integración autohospedado para configurar el entorno de ejecución de integración autohospedado para el conector de captura de datos modificados (CDC) de SAP.

Código de error: DF-SAPODP-NoAuthForFunctionModule

  • Mensaje: No hay autorización REF para el módulo de función RODPS_REPL_CONTEXT_GET_LIST
  • Causa: Falta de autorización para ejecutar el módulo de función relacionado.
  • Recomendación: Siga los pasos que se indican en esta nota de SAP para agregar el perfil de autorización necesario a su cuenta de SAP.

Código de error: DF-SAPODP-OOM

  • Mensaje: No hay más memoria disponible para agregar filas a una tabla interna
  • Causa: El conector de tablas de SAP tiene su limitación para la extracción de tablas grandes. La tabla de SAP subyacente se basa en una RFC que leerá todos los datos de la tabla en la memoria del sistema SAP, por lo que se producirá un problema de memoria insuficiente (OOM) al extraer tablas grandes.
  • Recomendación: Use el conector CDC de SAP para realizar la carga completa directamente desde el sistema de origen y, luego, mueva el valor delta a SAP Landscape Transformation Replication Server (SLT) después de que se libere init sin un valor delta.

Código de error: DF-SAPODP-SourceNotSupportDelta

  • Mensaje: El origen .* no admite valores delta
  • Causa: el nombre o contexto de ODP especificado no admite valores delta.
  • Recomendación: Habilite el modo delta para el origen de SAP o seleccione Completo en cada ejecución como modo de ejecución en el flujo de datos. Para más información, consulte esta documentación.

Código de error: DF-SAPODP-SAPI-LIMITATION

  • Mensaje: Número de error 518, Origen .* no encontrado, no liberado o no autorizado
  • Causa: compruebe si el contexto es la API de servicio (SAPI) de SAP. Si lo es, en el contexto de SAPI, solo puede extraer los extractores pertinentes para las tablas de SAP.
  • Recomendaciones: Consulte este documento.

Código de error: DF-SAPODP-KeyColumnsNotSpecified

  • Mensaje: se deben especificar columnas de clave para las operaciones no insertables (actualizaciones o eliminaciones)
  • Causa: Este error se produce al omitir la selección de Columnas de clave en la tabla receptora.
  • Recomendaciones: Permitir las opciones de eliminación, upsert y actualización requiere que se especifique una columna de clave. Especifique una o varias columnas para la coincidencia de filas en el receptor.

Código de error: DF-SAPODP-InsufficientResource

  • Mensaje: Se ha producido un volcado corto en una operación de base de datos
  • Causa: El sistema SAP se quedó sin recursos, lo que dio lugar a un volcado corto en el servidor SAP.
  • Recomendaciones: Póngase en contacto con el administrador de SAP para solucionar el problema en la instancia de SAP y vuelva a intentarlo.

Código de error: DF-SAPODP-ExecuteFuncModuleWithPointerFailed

  • Mensaje: error al ejecutar el módulo de función .* con el puntero .*
  • Causa: Problema del sistema SAP.
  • Recomendaciones: Vaya a la instancia de SAP, compruebe ST22 (volcado corto, similar al volcado de ventanas) y revise el código donde se produjo el error. En la mayoría de los casos, SAP ofrece sugerencias sobre diversas posibilidades de solución de problemas adicional.

Error code: DF-Snowflake-IncompatibleDataType

  • Mensaje: el tipo de expresión no coincide con el tipo de datos de columna; se esperaba VARIANT pero se ha obtenido VARCHAR.
  • Causa: el tipo de datos de entrada de la columna que es una cadena es diferente del tipo de la columna relacionada en la transformación del receptor de Snowflake, que es VARIANT.
  • Recomendación: en el caso de VARIANT de Snowflake, solo puede aceptar el valor de flujo de datos de tipo estructura, asignación o matriz. Si el valor de las columnas de datos de entrada es JSON o XML u otra cadena, use una transformación de análisis antes de la transformación del receptor de Snowflake para cubrir el valor en tipo de estructura, asignación o matriz.

Código de error: DF-copo de nieve-InvalidDataType

  • Mensaje: El tipo de Spark no se admite en Snowflake.
  • Causa: se proporcionó un tipo de datos no válido en Snowflake.
  • Recomendación: use la transformación de derivación antes de aplicar el receptor de Snowflake para actualizar la columna relacionada de los datos de entrada en el tipo de cadena.

Código de error: DF-Snowflake-InvalidStageConfiguration

  • Mensaje: Solo se puede usar el tipo de almacenamiento de blobs como ubicación temporal en la operación de lectura y escritura de Snowflake.

  • Causa: se proporcionó una configuración de almacenamiento provisional no válida en Snowflake.

  • Recomendación: actualice la configuración de almacenamiento provisional de Snowflake para asegurarse de que solo se usa el servicio vinculado de Azure Blob.

  • Mensaje: Deben especificarse las propiedades del almacenamiento temporal de Snowflake con la autenticación de Azure Blob + SAS.

  • Causa: se proporcionó una configuración de almacenamiento provisional no válida en Snowflake.

  • Recomendación: asegúrese de que solo se especifique la autenticación de Azure Blob y de SAS en la configuración de almacenamiento provisional de Snowflake.

Código de error: DF-SQLDW-ErrorRowsFound

  • Causa: se han encontrado filas de error o no válidas al escribir en el receptor de Azure Synapse Analytics.
  • Recomendación: busque las filas de error en la ubicación de almacenamiento de datos rechazada si está configurada.

Código de error: DF-SQLDW-ExportErrorRowFailed

  • Mensaje: se ha producido una excepción al escribir filas de error en el almacenamiento.
  • Mensaje: Se ha producido una excepción al escribir filas de error en el almacenamiento.
  • Recomendación: compruebe la configuración del servicio vinculado de datos rechazados.

Código de error: DF-SQLDW-IncorrectLinkedServiceConfiguration

  • Mensaje: el servicio vinculado está configurado incorrectamente como el tipo "Azure Synapse Analytics" en lugar de "Azure SQL Database". Cree un nuevo servicio vinculado de tipo "Azure SQL Database"
    Nota: Compruebe que la base de datos especificada sea de tipo "Grupo de SQL dedicado (anteriormente SQL Data Warehouse)" para el tipo de servicio vinculado "Azure Synapse Analytics".
  • Causa: el servicio vinculado está configurado incorrectamente como el tipo Azure Synapse Analytics en lugar de Azure SQL Database
  • Recomendación: cree un nuevo servicio vinculado de tipo Azure SQL Database y compruebe que la base de datos especificada es del tipo Grupo de SQL dedicado (anteriormente SQL DW) para el tipo de servicio vinculado Azure Synapse Analytics.

Código de error: DF-SQLDW-InternalErrorUsingMSI

  • Mensaje: Se produjo un error interno al autenticarse en la identidad de servicio administrada en la instancia de Azure Synapse Analytics. Reinicie la instancia de Azure Synapse Analytics o póngase en contacto con el soporte técnico del grupo de SQL dedicado de Azure Synapse Analytics si este problema persiste.
  • Causa: se produjo un error interno en Azure Synapse Analytics.
  • Recomendación: reinicie la instancia de Azure Synapse Analytics o póngase en contacto con el soporte técnico del grupo de SQL dedicado de Azure Synapse Analytics si este problema persiste.

Código de error: DF-SQLDW-InvalidBlobStagingConfiguration

  • Mensaje: Se deben especificar las propiedades de almacenamiento provisional de Blob Storage.
  • Causa: se proporciona una configuración de almacenamiento provisional de Blob Storage no válida.
  • Recomendación: compruebe si el servicio vinculado de Blob usado para el almacenamiento provisional tiene las propiedades correctas.

Código de error: DF-SQLDW-InvalidConfiguration

  • Mensaje: Se deben especificar las propiedades de almacenamiento provisional de ADLS Gen2. Se requiere la clave o bien enant/spnId/spnCredential/spnCredentialType o miServiceUri/miServiceToken.
  • Causa: se proporcionan propiedades de almacenamiento provisional de ADLS Gen2 no válidas.
  • Recomendación: actualice la configuración de almacenamiento provisional de ADLS Gen2 para que tenga una de las opciones siguientes: key, tenant/spnId/spnCredential/spnCredentialType o miServiceUri/miServiceToken.

Código de error: DF-SQLDW-InvalidGen2StagingConfiguration

  • Mensaje: El almacenamiento provisional del almacenamiento de ADLS Gen2 solo admite la credenciales de clave de la entidad de servicio.
  • Causa: se proporcionó una credencial no válida para el almacenamiento provisional de ADLS Gen2.
  • Recomendación: use las credenciales de clave de entidad de servicio del servicio vinculado de Gen2 que se usa para el almacenamiento provisional.

Código de error: DF-SQLDW-InvalidStorageType

  • Mensaje: El tipo de almacenamiento puede ser blob o gen2.
  • Causa: se proporcionó un tipo de almacenamiento no válido para el almacenamiento provisional.
  • Recomendación: Compruebe el tipo de almacenamiento del servicio vinculado que se usa para el almacenamiento provisional y asegúrese de que es Blob o Gen2.

Código de error: DF-SQLDW-StagingStorageNotSupport

  • Mensaje: El almacenamiento provisional con DNS de partición habilitado no se admite si se habilita el almacenamiento provisional. Desactive la habilitación del almacenamiento provisional en el receptor mediante Synapse Analytics.
  • Causa: el almacenamiento provisional con DNS de partición habilitado no se admite si habilita el almacenamiento provisional.
  • Recomendaciones: Desactive Habilitar almacenamiento provisional en el receptor al usar Azure Synapse Analytics.

Código de error: DF-SQLDW-DataTruncation

  • Mensaje: La tabla de destino tiene una columna con un tipo (n)varchar o (n)varbinary que tiene una limitación de longitud de columna menor que los datos reales. Ajuste la definición de columna en la tabla de destino o cambie los datos de origen.
  • Causa: La tabla de destino tiene una columna con un tipo varchar o varbinary que tiene una limitación de longitud de columna menor que los datos reales.
  • Recomendaciones: Ajuste la definición de columna en la tabla de destino o cambie los datos de origen.

Código de error: DF-Synapse-DBNotExist

  • Causa: la base de datos no existe.
  • Recomendación: compruebe si la base de datos existe.

Código de error: DF-Synapse-InvalidDatabaseType

  • Mensaje: No se admite este tipo de base de datos.
  • Causa: no se admite el tipo de base de datos.
  • Recomendación: compruebe el tipo de base de datos y cámbielo por el correcto.

Código de error: DF-Synapse-InvalidFormat

  • Mensaje_ No se admite el formato.
  • Causa: no se admite el formato.
  • Recomendación: compruebe el formato y cámbielo por el correcto.

Código de error: DF-Synapse-InvalidOperation

  • Causa: la operación no es compatible.
  • Recomendación: no se admite la configuración del método de actualización como eliminar, actualizar y actualizar/insertar (upsert) en la base de datos del área de trabajo.

Código de error: DF-Synapse-InvalidTableDBName

  • Mensaje: el nombre de la tabla o base de datos no es un nombre válido para tablas o bases de datos. Solo se admiten nombres con caracteres alfabéticos, números y _.
  • Causa: el nombre de la base de datos o tabla no es válido.
  • Recomendación: especifique un nombre válido para la tabla o base de datos. Solo se admiten nombres con caracteres alfabéticos, números y _.

Código de error: DF-Synapse-StoredProcedureNotSupported

  • Mensaje: Use "Procedimiento almacenado", ya que el origen no es compatible con un grupo sin servidor (a petición).
  • Causa: el grupo sin servidor tiene limitaciones.
  • Recomendación: vuelva a intentar usar "query" como origen o guardar el procedimiento almacenado como una vista y, a continuación, use "table" como origen para leer directamente desde la vista.

Código de error: DF-Xml-InvalidDataField

  • Mensaje: El campo de los registros dañados debe ser de tipo cadena y admitir valores NULL.
  • Causa: se proporcionó un tipo de datos no válido de la columna \"_corrupt_record\" en el origen XML.
  • Recomendación: asegúrese de que la columna \"_corrupt_record\" del origen XML tiene un tipo de datos de cadena y que admite valores NULL.

Código de error: DF-Xml-InvalidElement

  • Mensaje: el elemento XML tiene elementos secundarios o atributos que no se puede convertir.
  • Causa: el elemento XML tiene elementos secundarios o atributos que no se puede convertir.
  • Recomendación: actualice el archivo XML para que el elemento XML tenga los elementos secundarios o atributos correctos.

Código de error: DF-XML-InvalidReferenceResource

  • Mensaje: no se puede resolver el recurso de referencia en el archivo de datos XML.
  • Causa: No se puede resolver el recurso de referencia en el archivo de datos XML.
  • Recomendación: Compruebe el recurso de referencia en el archivo de datos XML.

Código de error: DF-Xml-InvalidSchema

  • Mensaje: Error en la validación del esquema.
  • Causa: se proporcionó un esquema no válido en el origen XML.
  • Recomendación: Compruebe la configuración del esquema en el origen XML para asegurarse de que es el esquema de subconjunto de los datos de origen.

Código de error: DF-Xml-InvalidValidationMode

  • Mensaje: Se proporciona un modo de validación XML no válido.
  • Causa: se proporcionó un modo de validación XML no válido.
  • Recomendación: Compruebe el valor del parámetro y especifique el modo de validación adecuado.

Código de error: DF-Xml-MalformedFile

  • Mensaje: XML con formato incorrecto con ruta de acceso en modo FAILFAST.
  • Causa: XML con formato incorrecto con ruta de acceso existe en el modo FAILFAST.
  • Recomendación: Actualice el contenido del archivo XML con el formato correcto.

Código de error: DF-XML-UnsupportedExternalReferenceResource

  • Mensaje: No se admite el recurso de referencia externa en el archivo de datos XML.
  • Causa: no se admite el recurso de referencia externa en el archivo de datos XML.
  • Recomendación: actualice el contenido del archivo XML cuando el recurso de referencia externa no se admita ahora.

Código de error: Error de GetCommand OutputAsync

  • Mensaje: Durante la depuración de Data Flow y la vista previa de datos: Error de GetCommand OutputAsync con...
  • Causa: Se trata de un error del servicio de back-end.
  • Recomendación: Vuelva a intentar la operación y reinicie la sesión de depuración. Si con ello no se resuelve el problema, póngase en contacto con el servicio de soporte al cliente.

Código de error: InvalidTemplate

  • Mensaje: no se puede evaluar la expresión de canalización.
  • Causa: La expresión de canalización pasada en la actividad de flujo de datos no se está procesando correctamente debido a un error de sintaxis.
  • Recomendación: Compruebe el nombre de la actividad de flujo de datos. Compruebe las expresiones de la supervisión de la actividad para verificarlas. Por ejemplo, el nombre de la actividad de flujo de datos no puede tener un espacio ni un guion.

Código de error: 127

  • Mensaje: el trabajo de Spark del flujo de datos se ha completado, pero el estado en tiempo de ejecución es nulo o sigue siendo InProgress.
  • Causa: los problemas transitorios con microservicios implicados en la ejecución pueden provocar un error en la ejecución.
  • Recomendación: consulte el escenario 3 problemas transitorios.

Código de error: 2011

  • Mensaje: la actividad se estaba ejecutando en Azure Integration Runtime y no pudo descifrar la credencial del almacén de datos o el proceso conectado a través de un entorno de ejecución de integración autohospedado. Compruebe la configuración de los servicios vinculados asociados con esta actividad y asegúrese de usar el tipo de entorno de ejecución de integración adecuado.
  • Causa: El flujo de datos no es compatible con los servicios vinculados en los entornos de ejecución de integración autohospedados.
  • Recomendación: Configure el flujo de datos para que se ejecute en el entorno de ejecución de integración de red virtual administrada.

Código de error: 4502

  • Mensaje: Hay importantes ejecuciones de MappingDataflow simultáneas que están causando errores debido a la limitación en el entorno de ejecución de integración.
  • Causa: Un gran número de ejecuciones de actividad de flujo de datos se producen simultáneamente en el entorno de ejecución de integración. Para más información, consulte Límites de Data Factory.
  • Recomendación: Si desea ejecutar más actividades de flujo de datos en paralelo, distribúyalas en varios entornos de ejecución de integración.

Código de error: 4503

  • Mensaje: Hay considerables ejecuciones simultáneas de MappingDataflow que están causando errores debido a la limitación en la suscripción "%subscriptionId;", 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: 4506

  • Mensaje: No se pudo aprovisionar el clúster para "%activityId;" porque el equipo de solicitud supera el recuento simultáneo máximo de 200. Entorno de ejecución de integración "%IRName;"
  • Causa: Error transitorio.
  • Recomendación: Vuelva a intentar la solicitud después de un período de espera.

Código de error: 4507

  • Mensaje: Valor de recuento de núcleos o tipo de proceso no admitido.
  • Causa: Se ha proporcionado un valor de recuento de núcleos o tipo de proceso no admitido.
  • Recomendación: Use uno de los valores de recuento de núcleos o tipo de proceso admitidos en este documento.

Código de error: 4508

  • Mensaje: No se encontró el clúster de Spark.
  • Recomendación: Reinicie la sesión de depuración.

Código de error: 4509

  • Mensaje: Se obtuvo un error inesperado al asignar recursos de proceso, vuelva a intentarlo. Si el problema persiste, póngase en contacto con el Soporte técnico de Azure.
  • Causa: Error transitorio.
  • Recomendación: Vuelva a intentar la solicitud después de un período de espera.

Código de error: 4510

  • Mensaje: Error inesperado durante la ejecución.
  • Causa: dado que los clústeres de depuración funcionan de forma diferente a los de trabajo, un número excesivo de ejecuciones de depuración podría desgastar el clúster con el tiempo, lo que a su vez podría provocar problemas de memoria y reinicios bruscos.
  • Recomendación: reinicie el clúster de depuración. Si va a ejecutar varios flujos de datos durante la sesión de depuración, use ejecuciones de actividad en su lugar, ya que la ejecución de nivel de actividad crea una sesión independiente sin comprometer al clúster de depuración principal.

Código de error: 4511

  • Mensaje: java.sql.SQLTransactionRollbackException. Se ha encontrado un interbloqueo al intentar obtener un bloqueo; pruebe a reiniciar la transacción. Si el problema persiste, póngase en contacto con el Soporte técnico de Azure.
  • Causa: Error transitorio.
  • Recomendación: Vuelva a intentar la solicitud después de un período de espera.

Consejos de solución de problemas varios

  • Problema: Se produjo una excepción inesperada y un error en la ejecución.

    • Mensaje: Durante la ejecución de una actividad de Data Flow: Se obtuvo una excepción inesperada y se produjo un error de ejecución.
    • Causa: Se trata de un error del servicio de back-end. Vuelva a intentar la operación y reinicie la sesión de depuración.
    • Recomendación: Si reintenta y reinicia y no se resuelve el problema, póngase en contacto con el servicio de soporte al cliente.
  • Problema: No hay datos de salida en la combinación durante la vista previa de los datos de depuración.

    • Mensaje: hay un gran número de valores NULL o valores que faltan, lo que puede deberse a que no se han muestreado suficientes filas. Pruebe a actualizar el límite de filas de depuración y los datos.
    • Causa: La condición de combinación no ha coincidido con ninguna fila o dio como resultado un gran número de valores NULL durante la vista previa de los datos.
    • Recomendación: En Configuración de depuración, aumente el número de filas del límite de filas de origen. Asegúrese de seleccionar una instancia de Azure IR que tenga un clúster de flujo de datos lo suficientemente grande como para controlar más datos.
  • Problema: Error de validación en el origen con archivos CSV de varias líneas.

    • Mensaje: Puede ver uno de estos mensajes de error:
      • Falta la última columna o es NULL.
      • Error en la validación del esquema en el origen.
      • La importación de esquema no se muestra correctamente en la experiencia de usuario y la última columna tiene un carácter de nueva línea en el nombre.
    • Causa: En el flujo de datos de asignación, los archivos de origen CSV de varias líneas no funcionan actualmente cuando se usa \r\n como delimitador de filas. A veces, las líneas adicionales de los retornos de carro pueden producir errores.
    • Recomendación Genere el archivo en el origen usando el carácter \n como delimitador de filas, en lugar de \r\n. O bien, use la actividad de copia para convertir el archivo CSV para que use \n como delimitador de filas.

Mejora en el formato CSV/CDM en Data Flow

Si usa el formato de texto delimitado o CDM para asignar el flujo de datos en Azure Data Factory V2, puede que se enfrente a cambios de comportamiento en las canalizaciones existentes debido a la mejora del texto delimitado o CDM en el flujo de datos a partir del 1 de mayo de 2021.

Es posible que encuentre los siguientes problemas antes de realizar la mejora, pero después de este proceso se solucionarán los problemas. Lea el siguiente contenido para determinar si esta mejora le afecta.

Escenario 1: encontrar el problema de delimitador de filas inesperado.

Se verá afectado si se encuentra en las siguientes condiciones:

  • Uso del texto delimitado con la configuración de varias líneas establecida en "true" o CDM como origen.
  • La primera fila tiene más de 128 caracteres.
  • El delimitador de fila de los archivos de datos no es \n.

Antes de realizar la mejora, el delimitador de filas predeterminado \n se puede usar inesperadamente para analizar archivos de texto delimitados, ya que cuando la configuración de varias líneas está establecida en "true", se invalida la configuración del delimitador de filas y este se detecta automáticamente en función de los primeros 128 caracteres. Si no detecta el delimitador de filas real, se revertiría a \n.

Después de realizar la mejora, debería funcionar cualquiera de los tres delimitadores de fila: \r, \n o \r\n.

En el ejemplo siguiente se muestra un cambio de comportamiento en la canalización después de realizar la mejora:

Ejemplo:
En la siguiente columna:
C1, C2, {long first row}, C128\r\n
V1, V2, {values………………….}, V128\r\n 

Antes de realizar la mejora, \r se mantiene en el valor de la columna. El resultado de la columna analizada es:
C1 C2 {long first row} C128\r
V1 V2 {values………………….} V128\r

Después de realizar la mejora, el resultado de la columna analizada debe ser:
C1 C2 {long first row} C128
V1 V2 {values………………….} V128

Escenario 2: detecte un problema de lectura incorrecta de valores de columna que contengan "\r\n".

Se verá afectado si se encuentra en las siguientes condiciones:

  • Uso del texto delimitado con la configuración de varias líneas establecida en "true" o CDM como origen.
  • El delimitador de filas es \r\n.

Antes de la mejora, al leer el valor de la columna, puede que se reemplace \r\n incorrectamente por \n.

Después de realizar la mejora, \r\n en el valor de la columna no se reemplazará por \n.

En el ejemplo siguiente se muestra un cambio de comportamiento en la canalización después de realizar la mejora:

Ejemplo:

En la siguiente columna:
"A\r\n", B, C\r\n

Antes de realizar la mejora, el resultado de la columna analizada es:
A\n B C

Después de realizar la mejora, el resultado de la columna analizada debe ser:
A\r\n B C

Escenario 3: detecte un problema de escritura incorrecta de valores de columna que contengan "\n".

Se verá afectado si se encuentra en las siguientes condiciones:

  • Uso del texto delimitado como receptor.
  • El valor de la columna contiene \n.
  • El delimitador de filas está establecido en \r\n.

Antes de realizar la mejora, al escribir el valor de la columna, puede que se reemplace \n incorrectamente por \r\n.

Después de realizar la mejora, \n en el valor de la columna no se reemplazará por \r\n.

En el ejemplo siguiente se muestra un cambio de comportamiento en la canalización después de realizar la mejora:

Ejemplo:

En la siguiente columna:
A\n B C

Antes de realizar la mejora, el receptor de CSV es:
"A\r\n", B, C\r\n

Después de realizar la mejora, el receptor de CSV debe ser:
"A\n", B, C\r\n

Escenario 4: se detectó un problema al leer incorrectamente una cadena vacía como NULL.

Se verá afectado si se encuentra en las siguientes condiciones:

  • Uso del texto delimitado como origen.
  • El valor NULL se establece en un valor que no está vacío.
  • El valor de la columna es una cadena vacía y no tiene comillas.

Antes de realizar la mejora, el valor de columna de cadena vacía sin comillas se lee como NULL.

Después de realizar la mejora, la cadena vacía no se analizará como un valor NULL.

En el ejemplo siguiente se muestra un cambio de comportamiento en la canalización después de realizar la mejora:

Ejemplo:

En la siguiente columna:
A, ,B,

Antes de realizar la mejora, el resultado de la columna analizada es:
A null B null

Después de realizar la mejora, el resultado de la columna analizada debe ser:
A "" (empty string) B "" (empty string)

Para obtener más ayuda para solucionar problemas, consulte estos recursos: