Compartir vía


Ejecución de un paquete de SSIS mediante la actividad Ejecutar paquete SSIS de Azure Portal

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 describe cómo ejecutar un paquete de SQL Server Integration Services (SSIS) en una canalización de Azure Data Factory mediante la actividad Ejecutar paquetes SSIS y en el portal de canalizaciones de Azure Data Factory y Synapse.

Requisitos previos

Cree una instancia de Azure-SSIS Integration Runtime (IR) si no tiene ya una. Para ello, siga las instrucciones paso a paso del Tutorial: Aprovisionamiento de Azure-SSIS IR.

Creación de una canalización con una actividad Ejecutar paquete de SSIS

En este paso, usa la interfaz de usuario de Data Factory o aplicación para crear una canalización. Agregará una actividad Ejecutar paquete de SSIS a la canalización y la configurará para ejecutar el paquete de SSIS.

  1. En la información general de Data Factory o en la página principal de Azure Portal, seleccione el icono Abrir Azure Data Factory Studio para iniciar la interfaz de usuario o la aplicación en una pestaña independiente.

    Captura de pantalla que muestra la página principal de Azure Data Factory.

    En la página principal, seleccione Orchestrate (Organizar).

    Captura de pantalla que muestra el botón Orquestar en la página principal de Azure Data Factory.

  1. En el cuadro de herramientas Actividades, busque SSIS. Después, arrastre la actividad Ejecutar paquete SSIS a la superficie del diseñador

    Arrastrar la actividad Execute SSIS Package (Ejecutar paquete de SSIS) a la superficie del diseñador

    Seleccione el objeto Execute SSIS Package activity (Ejecutar una actividad de paquete SSISS) para configurar sus pestañas General, Settings (Configuración), SSIS Parameters (Parámetros de SSIS), Connection Managers (Administradores de conexiones) y Property Overrides (Invalidaciones de propiedad).

Pestaña General

En la pestaña General de la actividad Execute SSIS Package (Ejecutar paquete SSIS), realice los pasos siguientes.

Establecimiento de propiedades en la pestaña General

  1. En Name (Nombre), escriba el nombre de la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

  2. En Description (Descripción), escriba la descripción de la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

  3. En Timeout (Tiempo de espera), escriba la cantidad máxima de tiempo que se puede ejecutar la actividad Execute SSIS Package (Ejecutar paquete de SSIS). El valor predeterminado es 7 días y el formato es D.HH:MM:SS.

  4. En Retry (Reintentar), escriba el número máximo de reintentos para la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

  5. En Retry interval (Intervalo de reintento), escriba el número de segundos entre cada reintento de la actividad Execute SSIS Package (Ejecutar paquete de SSIS). El valor predeterminado es 30 segundos.

  6. Active la casilla Secure output (Salida segura) para elegir si quiere excluir del registro la salida de la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

  7. Active la casilla Secure input (Entrada segura) para elegir si quiere excluir del registro la entrada de la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

Pestaña Settings

En la pestaña Settings (Configuración) de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), haga lo siguiente.

Establecer propiedades de la pestaña Settings (Configuración): Automatic (Automática)

  1. En Azure-SSIS IR, seleccione la instancia de Azure-SSIS IR designada para ejecutar la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

  2. En Description (Descripción), escriba la descripción de la actividad Execute SSIS Package (Ejecutar paquete de SSIS).

  3. Active la casilla Windows authentication (Autenticación de Windows) para elegir si quiere usar la autenticación de Windows para acceder a los almacenes de datos, por ejemplo, a los servidores o a los recursos compartidos de archivos locales de SQL o a Azure Files.

    Si activa esta casilla, escriba los valores de las credenciales de ejecución del paquete en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, para acceder a Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>.

    También puede usar como valores los secretos almacenados en la instancia de Azure Key Vault. Para hacerlo, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

  4. Si el paquete necesita el entorno de ejecución de 32 bits para funcionar, active la casilla 32-Bit runtime (Entorno de ejecución de 32 bits).

  5. En Package location (Ubicación del paquete), seleccione SSISDB, File System (Package) (Sistema de archivos [paquete]), File System (Project) (Sistema de archivos [proyecto]), Embedded package (Paquete insertado) o Package store (Almacén de paquetes).

Ubicación del paquete: SSISDB

La ubicación del paquete SSISDB se selecciona automáticamente si Azure-SSIS IR se aprovisionó con un catálogo de SSIS (SSISDB) hospedado en el servidor de base de datos o la instancia administrada de Azure SQL; también la puede seleccionar el usuario. Si está seleccionada, siga estos pasos.

  1. Si la instancia de Azure-SSIS IR está en ejecución y la casilla Manual entries (Entradas manuales) está desactivada, puede examinar y seleccionar sus carpetas, proyectos, paquetes y entornos existentes de SSISDB. Seleccione Refresh (Actualizar) para capturar las carpetas, proyectos, paquetes y entornos recién agregados de SSISDB, de forma que estén disponibles para su examen y selección. Para examinar y seleccionar los entornos para la ejecución de paquetes, debe configurar los proyectos antes de agregar esos entornos como referencias desde las mismas carpetas en SSISDB. Para más información, consulte Creación y asignación de entornos SSIS.

  2. En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.

  3. Si la instancia de Azure-SSIS IR no se está ejecutando o la casilla Manual entries (Entradas manuales) está activada, escriba las rutas de acceso del paquete y el entorno de SSISDB directamente en los siguientes formatos: <folder name>/<project name>/<package name>.dtsx y <folder name>/<environment name>.

    Establecer las propiedades en la pestaña Settings (Configuración): manual

Ubicación del paquete: File System (Package) (Sistema de archivos [paquete])

La ubicación del paquete File System (Package) (Sistema de archivos [paquete]) se selecciona automáticamente si Azure-SSIS IR se aprovisionó sin SSISDB; también la puede seleccionar el usuario. Si está seleccionada, siga estos pasos.

Establecimiento de las propiedades en la pestaña Properties (Propiedades): File System (Package) (Sistema de archivos [paquete])

  1. Especifique el paquete que se va a ejecutar, para lo que debe proporcionar una ruta de acceso UNC (Convención de nomenclatura universal) al archivo de paquete (con .dtsx) en el cuadro Package path (Ruta de acceso del paquete). Para examinar y seleccionar el paquete, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena el paquete en Azure Files, su ruta de acceso es \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

  2. Si configura el paquete en un archivo independiente, también deberá proporcionar una ruta de acceso UNC para el archivo de configuración (.dtsConfig) en el cuadro Configuration path (Ruta de configuración). Para examinar y seleccionar la configuración, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena la configuración en Azure Files, su ruta de acceso es \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

  3. Especifique las credenciales de acceso al paquete y a los archivos de configuración. Si anteriormente ha escrito los valores de las credenciales de ejecución del paquete (para la autenticación de Windows), puede volver a usarlas si selecciona la casilla Same as package execution credentials (Igual que las credenciales de ejecución del paquete). En caso contrario, escriba los valores de las credenciales de acceso del paquete en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena el paquete y la configuración en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>.

    También puede usar como valores los secretos almacenados en la instancia de Azure Key Vault. Para hacerlo, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

    Estas credenciales también se usan para acceder a los paquetes secundarios de la tarea de ejecución del paquete a la que se hace referencia mediante su propia ruta de acceso y otras configuraciones especificadas en los paquetes.

  4. Si ha usado el nivel de protección EncryptAllWithPassword o EncryptSensitiveWithPassword al crear el paquete mediante SQL Server Data Tools (SSDT), escriba el valor de la contraseña en el cuadro Encryption password (Contraseña de cifrado). También puede usar como valor un secreto almacenado en su instancia de Azure Key Vault (consulte anteriormente).

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey, vuelva a escribir los valores confidenciales en los archivos de configuración en las pestañas SSIS Parameters (Parámetros SSIS), Connection Managers (Administradores de conexiones) o Property Overrides (Invalidaciones de propiedad) (consulte a continuación).

    Si ha usado el nivel de protección EncryptAllWithUserKey , no se admite. Debe volver a configurar el paquete para usar otro nivel de protección mediante SSDT o la utilidad de línea de comandos dtutil.

  5. En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.

  6. Si quiere registrar las ejecuciones del paquete mediante el uso de los proveedores de registro estándar que se pueden especificar en el paquete, especifique la carpeta de registro mediante el suministro de su ruta de acceso UNC en el cuadro Logging path (Ruta de acceso a registros). Para examinar y seleccionar la carpeta de registro, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena los registros en Azure Files, su ruta de acceso al registro es \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. En esta ruta de acceso se crea una subcarpeta para cada ejecución de paquete, designada tras un identificador de ejecución de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), y en la que se generan archivos de registro cada cinco minutos.

  7. Especifique las credenciales para acceder a la carpeta de registro. Si previamente ha escrito los valores de las credenciales de acceso del paquete (consulte más arriba), puede volver a usarlas mediante la activación de la casilla Same as package access credentials (Igual que las credenciales de acceso al paquete). En caso contrario, escriba los valores de las credenciales de acceso del registro en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena los registros en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>. También puede usar como valores los secretos almacenados en Azure Key Vault.

Para todas las rutas de acceso UNC mencionadas anteriormente, el nombre de archivo completo debe tener menos de 260 caracteres. El nombre del directorio debe tener menos de 248 caracteres.

Ubicación del paquete: File System (Project) (Sistema de archivos [proyecto])

Si selecciona File System (Project) (Sistema de archivos [proyecto]) como ubicación del paquete, realice los pasos siguientes.

Establecimiento de las propiedades en la pestaña Settings (Configuración): File System (Project) (Sistema de archivos [proyecto])

  1. Especifique el paquete que quiere ejecutar; para ello, proporcione una ruta de acceso UNC al archivo de proyecto (con .ispac) en el cuadro Project path (Ruta de acceso del proyecto) y un archivo de paquete (con .dtsx) del proyecto en el cuadro Package name (Nombre del paquete). Para examinar y seleccionar el proyecto, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena el proyecto en Azure Files, su ruta de acceso será \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

  2. Especifique las credenciales para acceder a los archivos del proyecto y del paquete. Si anteriormente ha escrito los valores de las credenciales de ejecución del paquete (para la autenticación de Windows), puede volver a usarlas si selecciona la casilla Same as package execution credentials (Igual que las credenciales de ejecución del paquete). En caso contrario, escriba los valores de las credenciales de acceso del paquete en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena su proyecto y paquete en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>.

    También puede usar como valores los secretos almacenados en la instancia de Azure Key Vault. Para hacerlo, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

    Estas credenciales también se usan acceder a los paquetes secundarios de la tarea de ejecución de paquetes a la que se hace referencia desde el mismo proyecto.

  3. Si ha usado el nivel de protección EncryptAllWithPassword o EncryptSensitiveWithPassword al crear el paquete a través de SSDT, escriba el valor de la contraseña en el cuadro Encryption password (Contraseña de cifrado). También puede usar como valor un secreto almacenado en su instancia de Azure Key Vault (consulte anteriormente).

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey, vuelva a escribir los valores confidenciales en las pestañas SSIS Parameters (Parámetros SSIS), Connection Managers (Administradores de conexiones) o Property Overrides (Invalidaciones de propiedad).

    Si ha usado el nivel de protección EncryptAllWithUserKey , no se admite. Debe volver a configurar el paquete para usar otro nivel de protección mediante SSDT o la utilidad de línea de comandos dtutil.

  4. En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.

  5. Si quiere registrar las ejecuciones del paquete mediante el uso de los proveedores de registro estándar que se pueden especificar en el paquete, especifique la carpeta de registro mediante el suministro de su ruta de acceso UNC en el cuadro Logging path (Ruta de acceso a registros). Para examinar y seleccionar la carpeta de registro, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena los registros en Azure Files, su ruta de acceso al registro es \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. En esta ruta de acceso se crea una subcarpeta para cada ejecución de paquete, designada tras un identificador de ejecución de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), y en la que se generan archivos de registro cada cinco minutos.

  6. Especifique las credenciales para acceder a la carpeta de registro. Si previamente ha escrito los valores de las credenciales de acceso del paquete (consulte más arriba), puede volver a usarlas mediante la activación de la casilla Same as package access credentials (Igual que las credenciales de acceso al paquete). En caso contrario, escriba los valores de las credenciales de acceso del registro en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena los registros en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>. También puede usar como valores los secretos almacenados en Azure Key Vault.

Para todas las rutas de acceso UNC mencionadas anteriormente, el nombre de archivo completo debe tener menos de 260 caracteres. El nombre del directorio debe tener menos de 248 caracteres.

Ubicación del paquete: Embedded package (Paquete insertado)

Si selecciona Embedded package (Paquete insertado) como ubicación del paquete, realice los pasos siguientes.

Establecimiento de propiedades en la pestaña Configuración: Embedded package (Paquete insertado)

  1. Arrastre y coloque el archivo de paquete (con .dtsx) o cárguelo desde una carpeta de archivos en el cuadro proporcionado. El paquete se comprimirá e insertará automáticamente en la carga de la actividad. Una vez insertado, puede descargar el paquete más adelante para su edición. También puede parametrizar el paquete insertado si lo asigna a un parámetro de canalización que se puede usar en varias actividades, por lo que se optimiza el tamaño de la carga de la canalización. Actualmente no se admite la inserción de archivos de proyecto (con .ispac), por lo que no se pueden usar parámetros de SSIS ni administradores de conexión con el ámbito de nivel de proyecto en los paquetes insertados.

  2. Si el paquete insertado no está cifrado por completo y se detecta el uso de la tarea Ejecutar paquete (EPT) en su interior, la casilla Tarea Ejecutar paquete se seleccionará automáticamente y se agregarán automáticamente los paquetes secundarios a los que hace referencia la ruta de acceso del sistema de archivos, así que también puede insertarlos.

    Si no se puede detectar el uso de EPT, tendrá que seleccionar la casilla Tarea Ejecutar paquete de forma manual y agregar los paquetes secundarios a los que hacer referencia la ruta de acceso del sistema de archivos de uno en uno, para poder insertarlos también. Si los paquetes secundarios se almacenan en una base de datos de SQL Server (MSDB), no puede insertarlos, por lo que debe asegurarse de que Azure-SSIS IR pueda tener acceso a MSDB para capturarlos con sus referencias de SQL Server. Actualmente no se admite la inserción de archivos de proyecto (con .ispac), por lo que no se pueden usar referencias basadas en proyectos para los paquetes secundarios.

  3. Si ha usado el nivel de protección EncryptAllWithPassword o EncryptSensitiveWithPassword al crear el paquete a través de SSDT, escriba el valor de la contraseña en el cuadro Encryption password (Contraseña de cifrado).

    También puede usar como valor un secreto almacenado en Azure Key Vault. Para ello, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey, vuelva a escribir los valores confidenciales en los archivos de configuración en las pestañas SSIS Parameters (Parámetros SSIS), Connection Managers (Administradores de conexiones) o Property Overrides (Invalidaciones de propiedad) (consulte a continuación).

    Si ha usado el nivel de protección EncryptAllWithUserKey , no se admite. Debe volver a configurar el paquete para usar otro nivel de protección mediante SSDT o la utilidad de línea de comandos dtutil.

  4. En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.

  5. Si quiere registrar las ejecuciones del paquete mediante el uso de los proveedores de registro estándar que se pueden especificar en el paquete, especifique la carpeta de registro mediante el suministro de su ruta de acceso UNC en el cuadro Logging path (Ruta de acceso a registros). Para examinar y seleccionar la carpeta de registro, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena los registros en Azure Files, su ruta de acceso al registro es \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. En esta ruta de acceso se crea una subcarpeta para cada ejecución de paquete, designada tras un identificador de ejecución de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), y en la que se generan archivos de registro cada cinco minutos.

  6. Especifique las credenciales de acceso a la carpeta de registro. para ello, escriba sus valores en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena los registros en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>. También puede usar como valores los secretos almacenados en Azure Key Vault.

Para todas las rutas de acceso UNC mencionadas anteriormente, el nombre de archivo completo debe tener menos de 260 caracteres. El nombre del directorio debe tener menos de 248 caracteres.

Ubicación del paquete: Package store (Almacén de paquetes)

Si selecciona Package store (Almacén de paquetes) como ubicación del paquete, realice los pasos siguientes.

Establecimiento de las propiedades de la pestaña Settings (Configuración): Package store (Almacén de paquetes)

  1. En Package store name (Nombre del almacén de paquetes), seleccione un almacén de paquetes existente que esté asociado a su instancia de Azure-SSIS IR.

  2. Especifique el paquete que se va a ejecutar; para ello, proporcione la ruta de acceso (sin .dtsx) del almacén de paquetes seleccionado en el cuadro Package path (Ruta de acceso del paquete). Si el almacén de paquetes seleccionado está encima del sistema de archivos o de Azure Files, puede examinar y seleccionar el paquete con Browse file storage (Examinar almacenamiento de archivos); en caso contrario, puede escribir su ruta de acceso en el formato <folder name>\<package name>. También puede importar paquetes nuevos en el almacén de paquetes seleccionado a través de SQL Server Management Studio (SSMS) de forma similar al almacén de paquetes SSIS heredado. Para más información, consulte el artículo Administración de paquetes SSIS con almacenes de paquetes de Azure-SSIS IR.

  3. Si configura el paquete en un archivo aparte, también deberá proporcionar una ruta de acceso UNC al archivo de configuración (.dtsConfig) en el cuadro Configuration path (Ruta de configuración). Para examinar y seleccionar la configuración, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena la configuración en Azure Files, su ruta de acceso es \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

  4. Active la casilla Configuration access credentials (Credenciales de acceso de configuración) para elegir si quiere especificar las credenciales de acceso al archivo de configuración por separado. Esto es necesario cuando el almacén de paquetes seleccionado se encuentra encima de la base de datos de SQL Server (MSDB) hospedada en Instancia administrada de Azure SQL o no almacena tampoco el archivo de configuración.

    Si anteriormente ha escrito los valores de las credenciales de ejecución del paquete (para la autenticación de Windows), puede volver a usarlas si selecciona la casilla Same as package execution credentials (Igual que las credenciales de ejecución del paquete). En caso contrario, escriba los valores de las credenciales de acceso de configuración en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena su configuración en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>.

    También puede usar como valores los secretos almacenados en la instancia de Azure Key Vault. Para hacerlo, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

  5. Si ha usado el nivel de protección EncryptAllWithPassword o EncryptSensitiveWithPassword al crear el paquete a través de SSDT, escriba el valor de la contraseña en el cuadro Encryption password (Contraseña de cifrado). También puede usar como valor un secreto almacenado en su instancia de Azure Key Vault (consulte anteriormente).

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey, vuelva a escribir los valores confidenciales en los archivos de configuración en las pestañas SSIS Parameters (Parámetros SSIS), Connection Managers (Administradores de conexiones) o Property Overrides (Invalidaciones de propiedad) (consulte a continuación).

    Si ha usado el nivel de protección EncryptAllWithUserKey , no se admite. Debe volver a configurar el paquete para usar otro nivel de protección mediante SSDT o la utilidad de línea de comandos dtutil.

  6. En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.

  7. Si quiere registrar las ejecuciones del paquete mediante el uso de los proveedores de registro estándar que se pueden especificar en el paquete, especifique la carpeta de registro mediante el suministro de su ruta de acceso UNC en el cuadro Logging path (Ruta de acceso a registros). Para examinar y seleccionar la carpeta de registro, elija Browse file storage (Examinar almacenamiento de archivos) o escriba su ruta de acceso manualmente. Por ejemplo, si almacena los registros en Azure Files, su ruta de acceso al registro es \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. En esta ruta de acceso se crea una subcarpeta para cada ejecución de paquete, designada tras un identificador de ejecución de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), y en la que se generan archivos de registro cada cinco minutos.

  8. Especifique las credenciales de acceso a la carpeta de registro. para ello, escriba sus valores en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña). Por ejemplo, si almacena los registros en Azure Files, el dominio es Azure, el nombre de usuario es <storage account name> y la contraseña es <storage account key>. También puede usar como valores los secretos almacenados en Azure Key Vault.

Para todas las rutas de acceso UNC mencionadas anteriormente, el nombre de archivo completo debe tener menos de 260 caracteres. El nombre del directorio debe tener menos de 248 caracteres.

Pestaña SSIS Parameters (Parámetros de SSIS)

En la pestaña SSIS Parameters (Parámetros de SSIS) de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), haga lo siguiente.

Establecer propiedades en la pestaña SSIS Parameters (Parámetros de SSIS)

  1. Si la instancia de Azure-SSIS IR está en ejecución, se selecciona SSISDB como la ubicación del paquete y la casilla Manual entries (Entradas manuales) de la pestaña Settings (Configuración) está desactivada, se muestran los parámetros de SSIS existentes en el proyecto o paquete seleccionados de SSISDB para que les asigne valores. De lo contrario, puede escribirlos uno por uno para asignarles valores manualmente. Asegúrese de que existen y que se han escrito correctamente para que la ejecución del paquete se realice satisfactoriamente.

  2. Si ha usado el nivel de protección EncryptSensitiveWithUserKey al crear el paquete mediante SSDT y se ha seleccionado File System (Package) (Sistema de archivos [paquete]), File System (Project) (Sistema de archivos [proyecto]), Embedded package (Paquete insertado) o Package store (Almacén de paquetes) como ubicación del paquete, también debe volver a escribir las propiedades confidenciales del paquete para asignarles valores en esta pestaña.

Al asignar valores a los parámetros, puede agregar contenido dinámico mediante expresiones, funciones, variables del sistema de Data Factory y parámetros o variables de canalización de Data Factory.

También puede usar como valores los secretos almacenados en la instancia de Azure Key Vault. Para hacerlo, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

Pestaña Administradores de conexiones

En la pestaña Connection Managers (Administradores de conexones) de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), haga lo siguiente.

Establecer propiedades en la pestaña Connection Managers (Administradores de conexiones)

  1. Si la instancia de Azure-SSIS IR está en ejecución, se selecciona SSISDB como ubicación del paquete y la casilla Manual entries (Entradas manuales) de la pestaña Settings (Configuración) está desactivada, se muestran los administradores de conexiones existentes del proyecto y del paquete seleccionados en SSISDB para que se asignen valores a sus propiedades. De lo contrario, puede escribirlos uno por uno para asignar valores a sus propiedades manualmente. Asegúrese de que existen y que se han escrito correctamente para que la ejecución del paquete se realice satisfactoriamente.

    Puede obtener los nombres correctos deSCOPE, NAME y PROPERTY de cualquier administrador de conexiones; para ello, abra el paquete que lo contiene en SSDT. Una vez abierto el paquete, seleccione el administrador de conexiones correspondiente para mostrar los nombres y valores de todas sus propiedades en la ventana Propiedades de SSDT. Con esta información, puede invalidar los valores de las propiedades del administrador de conexiones en tiempo de ejecución.

    Obtención de las propiedades del administrador de conexiones de SSDT

    Por ejemplo, sin modificar el paquete original en SSDT, puede convertir sus flujos de datos del entorno local al entorno local que se ejecutan en SQL Server en flujos de datos del entorno local a la nube que se ejecutan en SSIS IR en ADF mediante la invalidación de los valores de las propiedades ConnectByProxy, ConnectionString y ConnectUsingManagedIdentity en los administradores de conexiones existentes en tiempo de ejecución.

    Estas invalidaciones en tiempo de ejecución pueden habilitar IR autohospedado (SHIR) como proxy para SSIS IR al acceder a los datos locales, consulte Configuración de IR autohospedado como proxy para Azure-SSIS IR, y las conexiones de Instancia administrada/Azure SQL Database con el controlador MSOLEDBSQL más reciente que, a su vez, habilita la autenticación de Microsoft Entra con la identidad administrada de ADF, consulte Configuración de la autenticación de Microsoft Entra con la identidad administrada de ADF para conexiones OLEDB.

    Definición de propiedades desde SSDT en la pestaña Administradores de conexiones

  2. Si ha usado el nivel de protección EncryptSensitiveWithUserKey al crear el paquete mediante SSDT y se ha seleccionado File System (Package) (Sistema de archivos [paquete]), File System (Project) (Sistema de archivos [proyecto]), Embedded package (Paquete insertado) o Package store (Almacén de paquetes) como ubicación del paquete, también debe volver a escribir las propiedades confidenciales del administrador de conexiones para asignarles valores en esta pestaña.

Al asignar valores a las propiedades del administrador de conexiones, puede agregar contenido dinámico mediante expresiones, funciones, variables del sistema de Data Factory y parámetros o variables de canalización de Data Factory.

También puede usar como valores los secretos almacenados en la instancia de Azure Key Vault. Para hacerlo, active la casilla AZURE KEY VAULT que aparece al lado. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo. Luego, seleccione el nombre del secreto y la versión del valor. Al crear o editar el servicio vinculado del almacén de claves, puede seleccionar o editar el almacén de claves existente o crear uno nuevo. Asegúrese de conceder a Data Factory el acceso de la identidad administrada a su almacén de claves si aún no lo ha hecho. Los secretos también se pueden escribir directamente en el siguiente formato: <key vault linked service name>/<secret name>/<secret version>.

Pestaña Property Overrides (Invalidaciones de propiedad)

En la pestaña Property Overrides (Invalidaciones de propiedad) de la actividad Execute SSIS Package (Ejecutar paquete de SSIS), siga estos pasos.

Establecer propiedades en la pestaña Property Overrides (Reemplazos de propiedad)

  1. Escriba las rutas de acceso de las propiedades existentes en el paquete seleccionado una por una para asignarles valores manualmente. Asegúrese de que existen y que se han escrito correctamente para que la ejecución del paquete se realice satisfactoriamente. Por ejemplo, para invalidar el valor de la variable de usuario, escriba su ruta de acceso en el formato \Package.Variables[User::<variable name>].Value.

    Para obtener la RUTA DE ACCESO DE LA PROPIEDAD correcta para cualquier propiedad del paquete, puede abrir el paquete que la contiene en SSDT. Una vez abierto el paquete, seleccione su flujo de control y la propiedad Configurations en la ventana Propiedades de SSDT. Después, seleccione el botón de puntos suspensivos ( ) situado junto a su propiedad Configurations para abrir el Organizador de configuraciones de paquetes que se usa normalmente para crear configuraciones de paquetes en el modelo de implementación de paquetes.

    Obtención de las propiedades de paquete desde la propiedad Configurations de SSDT

    En el Organizador de configuraciones de paquetes, active la casilla Habilitar configuraciones de paquetes y el botón Agregar… para abrir el Asistente para la configuración de paquetes.

    En el Asistente para la configuración de paquetes, seleccione el elemento Archivo de configuración XML en el menú desplegable Tipo de configuración y el botón Especificar valores de configuración directamente, escriba el nombre del archivo de configuración y seleccione el botón Siguiente >.

    Obtención de las propiedades de paquete desde el Organizador de configuraciones de SSDT

    Por último, seleccione las propiedades del paquete que está en la ruta de acceso que desea y el botón Siguiente >. Ahora puede ver, copiar & pegar las rutas de acceso de las propiedades del paquete que desee y guardarlas en el archivo de configuración. Con esta información, puede invalidar los valores de las propiedades del paquete en tiempo de ejecución.

    Obtención de las propiedades de paquete desde el Asistente para la configuración de SSDT

  2. Si ha usado el nivel de protección EncryptSensitiveWithUserKey al crear el paquete mediante SSDT y se ha seleccionado File System (Package) (Sistema de archivos [paquete]), File System (Project) (Sistema de archivos [proyecto]), Embedded package (Paquete insertado) o Package store (Almacén de paquetes) como ubicación del paquete, también debe volver a escribir las propiedades confidenciales del paquete para asignarles valores en esta pestaña.

Al asignar valores a las propiedades del paquete, puede agregar contenido dinámico mediante expresiones, funciones, variables del sistema de Data Factory y parámetros o variables de canalización de Data Factory.

Los valores asignados en los archivos de configuración y en la pestaña SSIS Parameters (Parámetros de SSIS) se pueden invalidar mediante las pestañas Connection Managers (Administradores de conexiones) o Property Overrides (Reemplazos de propiedad). Los valores asignados en la pestaña Connection Managers (Administradores de conexiones) también se pueden usar con la pestaña Property Overrides (Reemplazos de propiedad).

Para validar la configuración de la canalización, seleccione Validate (Validar) en la barra de herramientas. Para cerrar Pipeline Validation Report (Informe de validación de la canalización), seleccione >>.

Para publicar la canalización en Data Factory, seleccione Publish All (Publicar todo).

Ejecución de la canalización

En este paso, desencadenará una ejecución de canalización.

  1. Para desencadenar una ejecución de canalización, seleccione Trigger (Desencadenar) en la barra de herramientas y en Trigger now (Desencadenar ahora).

    Trigger now (Desencadenar ahora)

  2. En la ventana Pipeline Run (Ejecución de canalización), seleccione Finish (Finalizar).

Supervisar la canalización

  1. Cambie a la pestaña Monitor (Supervisar) de la izquierda. Verá la ejecución de canalización y su estado junto con otro tipo de información, como la hora de inicio de la ejecución. Para actualizar la vista, seleccione Refresh (Actualizar).

    Ejecuciones de la canalización

  2. Seleccione el vínculo View Activity Runs (Ver ejecuciones de actividad) en la columna Actions (Acciones). Solo verá una ejecución de actividad porque la canalización solo tiene una actividad. Es la actividad de ejecución de paquetes de SSIS.

    Ejecuciones de actividad

  3. Ejecute la consulta siguiente en la base de datos SSISDB en el servidor de SQL para comprobar la ejecución del paquete.

    select * from catalog.executions
    

    Comprobación de las ejecuciones del paquete

  4. También puede obtener el identificador de ejecución de SSISDB desde la salida de la ejecución de la actividad de canalización, y usar el identificador para comprobar registros de ejecución y mensajes de error más completos en SQL Server Management Studio.

    Obtenga el identificador de ejecución.

Programación de la canalización con un desencadenador

También puede crear un desencadenador programado para la canalización de manera que esta se ejecute según una programación, como por hora o cada día. Para ver un ejemplo, consulte Create a data factory - Data Factory UI (Creación de una factoría de datos: interfaz de usuario de Data Factory).