Solución de problemas de administración de SSIS Integration Runtime

  • Artículo

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 movimientos de datos hasta ciencia de datos, análisis en tiempo real, inteligencia empresarial e informes. ¡Obtenga más información sobre cómo iniciar una nueva evaluación gratuita!

En este artículo se proporcionan instrucciones para la solución de problemas de administración de Integration Runtime (IR) de Azure SQL Server Integration Services, también conocido como SSIS IR.

Información general

Si tiene algún problema durante el aprovisionamiento o el desaprovisionamiento de SSIS IR, verá un mensaje de error en el portal de Microsoft Azure Data Factory o un error devuelto por un cmdlet de PowerShell. El error siempre está en formato de código de error con un mensaje detallado.

Si el código de error es InternalServerError, el servicio tiene problemas transitorios y debe reintentar la operación más tarde. Si el reintento no sirve, póngase en contacto con el equipo de soporte técnico de Azure Data Factory.

De lo contrario, tres dependencias externas principales pueden causar errores: Azure SQL Database o Instancia administrada de Azure SQL, un script de instalación personalizada y una configuración de red virtual.

Problemas de SQL Database o Instancia administrada de SQL

SQL Database o Instancia administrada de SQL son necesarios si SSIS IR se aprovisiona con una base de datos de catálogo de SSIS. El SSIS IR debe poder acceder a SQL Database o a Instancia administrada de SQL. Además, la cuenta de inicio de sesión de SQL Database o de Instancia administrada de SQL debe tener permiso para crear una base de datos de catálogo de SSIS (SSISDB). Si se produce un error, se mostrará un código de error con un mensaje de excepción detallado de SQL en el portal de Data Factory. Use la información de la lista siguiente para solucionar los problemas de los códigos de error.

AzureSqlConnectionFailure

Puede que observe este problema cuando vaya a aprovisionar un nuevo SSIS IR o mientras se ejecuta IR. Si experimenta este error durante el aprovisionamiento de IR, puede que reciba un mensaje detallado SqlException en el mensaje de error que indica uno de los siguientes problemas:

  • Problema de conexión de red. Compruebe si el nombre de host de SQL Database o de SQL Managed Instance está accesible. Compruebe también que ningún firewall o grupo de seguridad de red (NSG) estén bloqueando el acceso de SSIS IR al servidor.
  • Error de inicio de sesión durante la autenticación de SQL. La cuenta proporcionada no puede iniciar sesión en la base de datos de SQL Server. Asegúrese de que se ha proporcionado la cuenta de usuario correcta.
  • Error de inicio de sesión durante la autenticación de Microsoft Azure Active Directory (Azure AD) (identidad administrada). Agregue la identidad administrada de su fábrica a un grupo de AAD y asegúrese de que tenga permisos de acceso al servidor de la base de datos de catálogo.
  • Tiempo de espera de conexión agotado. Este error siempre se debe a una configuración relacionada con la seguridad. Se recomienda que:
    1. Cree una máquina virtual.
    2. Una la máquina virtual a la misma instancia de IR de Microsoft Azure Virtual Network si IR está en una red virtual.
    3. Instale SSMS y compruebe el estado de SQL Database o de Instancia administrada de SQL.

Para otros problemas, solucione la incidencia mostrada en el mensaje de error detallado de la excepción de SQL. Si sigue teniendo problemas, póngase en contacto con el equipo de soporte técnico de SQL Database o de Instancia administrada de SQL.

Si observa el error mientras IR se ejecuta, es probable que los cambios en el firewall o en el grupo de seguridad de red impidan que el nodo de trabajo de SSIS IR tenga acceso a SQL Database o a Instancia administrada de SQL. Desbloquee el nodo de trabajo de SSIS IR para que pueda acceder a SQL Database o a Instancia administrada de SQL.

CatalogCapacityLimitError

Este es el tipo de mensaje de error que podría aparecer: "La base de datos "SSISDB" ha alcanzado su cuota de tamaño". Cree particiones o elimine datos, quite índices o consulte la documentación para obtener soluciones posibles".

Las posibles soluciones son:

  • Aumente el tamaño de la cuota de la SSISDB.
  • Cambie la configuración de SSISDB para reducir el tamaño de las maneras siguientes:
    • Al reducir el período de retención y el número de versiones del proyecto.
    • Reduzca el período de retención del registro.
    • Cambie el nivel predeterminado del registro.

CatalogDbBelongsToAnotherIR

Este error significa que SQL Database o Instancia administrada de SQL ya tienen una SSISDB y se usa en otra instancia de IR. Deberá proporcionar otra instancia de SQL Database o de Instancia administrada de SQL, o bien eliminar la SSISDB existente y reiniciar la nueva instancia de IR.

CatalogDbCreationFailure

Este problema puede ocurrir debido a uno de los siguientes motivos:

  • La cuenta de usuario que está configurada para la instancia de SSIS IR no tiene permiso para crear la base de datos. Puede conceder al usuario permiso para crear la base de datos.
  • Se agota el tiempo de espera, por ejemplo, tiempo de espera de ejecución o de operación de base de datos, durante la creación de la base de datos. Debe intentar la operación más tarde. Si el reintento no funciona, póngase en contacto con el equipo de soporte técnico de SQL Database o de Instancia administrada de SQL.

Para otras incidencias, compruebe el mensaje de error de excepción de SQL y corrija la incidencia mencionada en los detalles del error. Si sigue teniendo problemas, póngase en contacto con el equipo de soporte técnico de SQL Database o de Instancia administrada de SQL.

InvalidCatalogDb

Este tipo de mensaje de error se parece a este: "Nombre de objeto no válido 'catalog.catalog_properties'”. En esta situación, ya tiene una base de datos denominada SSISDB pero no se creó con SSIS IR; o bien, la base de datos se encuentra en un estado no válido debido a errores en el último aprovisionamiento de SSIS IR. Puede quitar la base de datos existente con el nombre SSISDB o configurar una nueva instancia de SQL Database o de Instancia administrada de SQL para IR.

Incidencias de instalación personalizada

La instalación personalizada proporciona una interfaz para agregar sus propios pasos de instalación durante el aprovisionamiento o la reconfiguración de SSIS IR. Para más información, consulte Instalación personalizada de Azure-SSIS Integration Runtime.

Asegúrese de que el contenedor incluya solo los archivos de instalación personalizada necesarios; todos los archivos del contenedor se descargarán en el nodo de trabajo de SSIS IR. Se recomienda probar el script de instalación personalizada en una máquina local para corregir cualquier problema de ejecución antes de ejecutarlo en SSIS IR.

Mientras se ejecuta IR, se comprobará el contenedor de scripts de instalación personalizada, dado que SSIS IR se actualiza periódicamente. Esta actualización requiere acceso al contenedor para descargar el script de instalación personalizada e instalarlo de nuevo. El proceso también comprueba si el contenedor es accesible y si existe el archivo main.cmd.

Para cualquier error relacionado con la instalación personalizada, verá un código de error CustomSetupScriptFailure con subcódigo como CustomSetupScriptBlobContainerInaccessible o CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Este error significa que SSIS IR no puede acceder al contenedor de blobs de Azure para la instalación personalizada. Compruebe que el URI de SAS del contenedor sea accesible y que no haya expirado.

Detenga el IR si está en ejecución, vuelva a configurarlo con el nuevo URI de SAS del contenedor de instalación personalizada y, luego, reinícielo.

CustomSetupScriptNotFound

Este error significa que SSIS IR no puede encontrar un script de instalación personalizada (main.cmd) en el contenedor de blobs. Asegúrese de que main.cmd exista en el contenedor, que es el punto de entrada para la instalación personalizada.

CustomSetupScriptExecutionFailure

Este error significa que se produjo un error en la ejecución del script de instalación personalizada (main.cmd). Pruebe primero el script en la máquina local, o compruebe los registros de ejecución de la instalación personalizada en el contenedor de blobs.

CustomSetupScriptTimeout

Este error indica un tiempo de espera en la ejecución del script de instalación personalizada. Asegúrese de que el script se puede ejecutar en modo silencioso y no se necesita ninguna entrada interactiva, además de que el contenedor de blobs contenga solo los archivos de instalación personalizados necesarios. Se recomienda probar primero el script en la máquina local. También debe comprobar los registros de ejecución de la instalación personalizada en el contenedor de blobs. El período máximo para la instalación personalizada e de 45 minutos antes de que se agote el tiempo de espera, y el período máximo incluye el tiempo necesario para descargar todos los archivos del contenedor e instalarlos en SSIS IR. Si es necesario un período más largo, genere una incidencia de soporte técnico.

CustomSetupScriptLogUploadFailure

Este error significa que se ha producido un error al intentar cargar los registros de ejecución de la instalación personalizada en el contenedor de blobs. Este problema se produce porque SSIS IR no tiene permisos de escritura en el contenedor de blobs o debido a problemas de almacenamiento o red. Si la instalación personalizada se realiza correctamente, este error no afectará a ninguna función de SSIS, pero se perderán los registros. Si se produce un error en la instalación personalizada y el registro no se carga, se notificará este error primero para que el registro pueda cargarse y analizarse. Además, después de resolver esta incidencia, notificaremos otras más específicas. Si la incidencia no se resuelve tras un reintento, póngase en contacto con el equipo de soporte técnico de Azure Data Factory.

Configuración de redes virtuales

Al unir SSIS IR a Azure Virtual Network, SSIS IR usa la red virtual que se encuentra en la suscripción del usuario. Para más información, consulte Unión de Azure-SSIS Integration Runtime a una red virtual. Después de que SSIS IR se inicie correctamente, si detecta problemas de conexión de red, puede intentar usar la herramienta de diagnóstico de conectividad para diagnosticar el problema. Cuando haya una incidencia relacionada con Virtual Network, verá uno de los siguientes errores.

InvalidVnetConfiguration

Este error puede producirse por diversos motivos. Para solucionarlo, consulte las secciones Prohibido, InvalidPropertyValue y MisconfiguredDnsServerOrNsgSettings.

Prohibido

Este tipo de error puede parecerse a este: "Subnetid no está habilitado para la cuenta actual. El proveedor de recursos Microsoft.Batch no está registrado en la misma suscripción que la red virtual".

Estos detalles significan que Azure Batch no puede tener acceso a la red virtual. Registre el proveedor de recursos Microsoft.Batch en la misma suscripción que Virtual Network.

InvalidPropertyValue

Este tipo de error puede parecerse a uno de los siguientes:

  • "La red virtual especificada no existe o el servicio Batch no tiene acceso a ella".
  • "La subred especificada XXX no existe".

Estos errores significan que la red virtual no existe, que el servicio Azure Batch no puede acceder a ella o que la subred proporcionada no existe. Asegúrese de que la red virtual y la subred existen y que Azure Batch puede acceder a ellas.

MisconfiguredDnsServerOrNsgSettings

Este tipo de mensaje de error puede parecerse a este: "No se pudo aprovisionar Integration Runtime en la red virtual. Si están configurados el servidor DNS o el grupo de seguridad de red, asegúrese de que el primero sea accesible y de que el segundo esté configurado correctamente".

En esta situación, es probable que tenga una configuración personalizada del servidor DNS o de NSG, lo que impide que el nombre del servidor de Azure que se requiere en SSIS IR se resuelva o se tenga acceso a él. Para más información, consulte Configuración de Virtual Network para SSIS IR. Si el problema persiste, póngase en contacto con el equipo de soporte técnico de Azure Data Factory.

VNetResourceGroupLockedDuringUpgrade

SSIS IR se actualizará automáticamente de forma periódica. Durante la actualización se crea un nuevo grupo de Azure Batch y se elimina el grupo de Azure Batch anterior. Además, se eliminan los recursos relacionados con Virtual Network del grupo anterior y se crean los recursos relacionados con Virtual Network en su suscripción. Este error significa que no se pudieron eliminar los recursos relacionados con Virtual Network del grupo anterior debido a un bloqueo de eliminación en el nivel de suscripción o grupo de recursos. Dado que el cliente controla y establece el bloqueo de eliminación, debe quitarlo en esta situación.

VNetResourceGroupLockedDuringStart

Si se produce un error en el aprovisionamiento de SSIS IR, se eliminan todos los recursos que se crearon. Sin embargo, si hay un bloqueo de eliminación de recursos en el nivel de suscripción o grupo de recursos, los recursos de Virtual Network no se eliminan como estaba previsto. Para corregir este error, quite el bloqueo de eliminación y reinicie el IR.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Cuando detenga SSIS IR, se eliminarán todos los recursos relacionados con Virtual Network. Sin embargo, se puede producir un error en la eliminación si hay un bloqueo de eliminación de recursos en el nivel de suscripción o grupo de recursos. Aquí, también, el cliente controla y establece el bloqueo de eliminación. Por lo tanto, debe quitar el bloqueo de eliminación y, luego, detener de nuevo el SSIS IR.

NodeUnavailable

Este error se produce cuando se ejecuta IR y significa que su estado ya no es correcto. Este error siempre se debe a un cambio en la configuración del servidor DNS o de NSG que impide que SSIS IR se conecte a un servicio necesario. Dado que es el cliente quien controla la configuración del servidor DNS y de NSG, debe corregir los problemas de bloqueo en su lado. Para más información, consulte Configuración de Virtual Network para SSIS IR. Si el problema persiste, póngase en contacto con el equipo de soporte técnico de Azure Data Factory.

Configuración de direcciones IP públicas estáticas

Al unir Azure-SSIS IR a Azure Virtual Network, también puede traer sus propias direcciones IP públicas estáticas a IR para que este pueda acceder a los orígenes de datos que limitan el acceso a direcciones IP específicas. Para más información, consulte Unión de Azure-SSIS Integration Runtime a una red virtual.

Además de los problemas de red virtual anteriores, puede encontrarse también con problemas relacionados con las direcciones IP públicas estáticas. Compruebe los siguientes errores para obtener ayuda.

InvalidPublicIPSpecified

Este error puede producirse por diversos motivos al iniciar Azure-SSIS IR:

Mensaje de error Solución
La dirección IP pública estática proporcionada ya está en uso. Proporcione dos sin usar para la instancia de Azure-SSIS Integration Runtime. Debe seleccionar dos direcciones IP públicas estáticas sin usar o quitar las referencias actuales a la dirección IP pública especificada y, luego, reiniciar Azure-SSIS IR.
La dirección IP pública estática proporcionada no tiene un nombre DNS. Proporcione dos de ellas con el nombre DNS para la instancia de Azure-SSIS Integration Runtime. Puede configurar el nombre DNS de la dirección IP pública en Azure Portal, como se muestra en la imagen siguiente. Los pasos básicos son los siguientes: (1) Abra Azure Portal y vaya a la página de recursos de esta dirección IP pública. (2) Seleccione la sección Configuración y configure el nombre DNS; a continuación, haga clic en el botón Guardar. (3) Reinicie Azure-SSIS IR.
La red virtual y las direcciones IP públicas estáticas proporcionadas para Azure-SSIS Integration Runtime deben estar en la misma ubicación. De acuerdo con los requisitos de la red de Azure, la dirección IP pública estática y la red virtual deben estar en la misma ubicación y suscripción. Proporcione dos direcciones IP públicas estáticas válidas y reinicie Azure-SSIS IR.
La dirección IP pública estática proporcionada es una básica; proporcione dos estándar para Azure-SSIS Integration Runtime. Consulte las SKU de dirección IP pública para obtener ayuda.

Integration Runtime de SSIS de Azure

PublicIPResourceGroupLockedDuringStart

Si se produce un error en el aprovisionamiento de Azure SSIS IR, se eliminan todos los recursos que se crearon. Sin embargo, si hay un bloqueo de eliminación de recursos en el nivel de suscripción o grupo de recursos (que contiene la dirección IP pública estática), los recursos de red no se eliminan según lo esperado. Para corregir este error, quite el bloqueo de eliminación y reinicie la instancia de IR.

PublicIPResourceGroupLockedDuringStop

Al detener Azure-SSIS IR, se eliminarán todos los recursos de red creados en el grupo de recursos que contiene la dirección IP pública. Sin embargo, se puede producir un error en la eliminación si hay un bloqueo de eliminación de recursos en el nivel de suscripción o grupo de recursos (que contiene la dirección IP pública estática). Quite el bloqueo de eliminación y reinicie la instancia de IR.

PublicIPResourceGroupLockedDuringUpgrade

Azure SSIS IR se actualizará automáticamente de forma periódica. Los nuevos nodos de IR se crean durante la actualización y los nodos antiguos se eliminan. Además, los recursos de red creados (por ejemplo, el equilibrador de carga y el grupo de seguridad de red) para los nodos antiguos se eliminan y los nuevos recursos de red se crean en la suscripción. Este error significa que no se pudieron eliminar los recursos de red de los nodos antiguos debido a un bloqueo de eliminación en el nivel de suscripción o grupo de recursos (que contiene la dirección IP pública estática). Quite el bloqueo de eliminación para poder limpiar los nodos antiguos y liberar la dirección IP pública estática para los nodos antiguos. En caso contrario, no se podrá liberar la dirección IP pública estática y no podremos seguir actualizando la instancia de IR.

PublicIPNotUsableDuringUpgrade

Si quiere traer sus propias direcciones IP públicas estáticas, deben proporcionarse dos direcciones IP públicas. Una de ellas se usará para crear los nodos de IR inmediatamente y la otra se usará durante la actualización de la instancia de IR. Este error puede producirse cuando la otra dirección IP pública no se puede usar durante la actualización. Consulte InvalidPublicIPSpecified para ver las posibles causas.

Administración de recursos

Etiqueta de recurso no actualizada

Puede aplicar etiquetas a los recursos de Azure para organizarlos de forma lógica en una taxonomía. Mientras se ejecuta SSIS IR, los cambios en las etiquetas de la factoría de datos primaria de SSIS IR no se harán efectivos hasta que se reinicie SSIS IR.