Ejecución de un paquete de SSIS mediante la actividad Ejecutar paquete SSIS de Azure Data FactoryRun an SSIS package with the Execute SSIS Package activity in Azure Data Factory

En este artículo se describe cómo ejecutar un paquete de SQL Server Integration Services (SSIS) desde una canalización de Azure Data Factory mediante la actividad de ejecución de paquetes SSIS.This article describes how to run a SQL Server Integration Services (SSIS) package in an Azure Data Factory pipeline by using the Execute SSIS Package activity.

Requisitos previosPrerequisites

Nota

Este artículo se ha actualizado para usar el nuevo módulo Az de Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Aún puede usar el módulo de AzureRM que continuará recibiendo correcciones de errores hasta diciembre de 2020 como mínimo.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para más información acerca del nuevo módulo Az y la compatibilidad con AzureRM, consulte Introducing the new Azure PowerShell Az module (Presentación del nuevo módulo Az de Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obtener instrucciones sobre la instalación del módulo Az, consulte Instalación de Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

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.Create an Azure-SSIS integration runtime (IR) if you don't have one already by following the step-by-step instructions in the Tutorial: Provisioning Azure-SSIS IR.

Ejecución de un paquete en Azure PortalRun a package in the Azure portal

En esta sección, usará la interfaz de usuario de Data Factory o la aplicación para crear una canalización de Data Factory con una actividad de ejecución de paquetes SSIS que ejecuta un paquete SSIS.In this section, you use the Data Factory user interface (UI) or app to create a Data Factory pipeline with an Execute SSIS Package activity that runs your SSIS package.

Creación de una canalización con una actividad Ejecutar paquete de SSISCreate a pipeline with an Execute SSIS Package activity

En este paso, usa la interfaz de usuario de Data Factory o aplicación para crear una canalización.In this step, you use the Data Factory UI or app to create a pipeline. Agregará una actividad Ejecutar paquete de SSIS a la canalización y la configurará para ejecutar el paquete de SSIS.You add an Execute SSIS Package activity to the pipeline and configure it to run your SSIS package.

  1. En la información general de Data Factory o en la página principal de Azure Portal, seleccione el icono Crear y supervisar para iniciar la interfaz de usuario de Data Factory o la aplicación en una pestaña independiente.On your Data Factory overview or home page in the Azure portal, select the Author & Monitor tile to start the Data Factory UI or app in a separate tab.

    Página principal de Data Factory

    En la página Let's get started (Introducción) seleccione Create pipeline (Crear canalización).On the Let's get started page, select Create pipeline.

    Página de introducción

  2. En el cuadro de herramientas Activities (Actividades), expanda General.In the Activities toolbox, expand General. Después, arrastre la actividad Ejecutar paquete SSIS a la superficie del diseñadorThen drag an Execute SSIS Package activity to the pipeline designer surface.

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

  3. En la pestaña General de la actividad Ejecutar paquete SSIS, proporcione un nombre y una descripción para la actividad.On the General tab for the Execute SSIS Package activity, provide a name and description for the activity. Establezca el tiempo de expiraciónopcional y los valores de reintento.Set optional Timeout and Retry values.

    Establecimiento de propiedades en la pestaña General

  4. En la pestaña Settings (Configuración) de la actividad de ejecución de paquetes SSIS, seleccione la instancia de Azure-SSIS IR donde quiere ejecutar el paquete.On the Settings tab for the Execute SSIS Package activity, select an Azure-SSIS IR where you want to run your package. Si el paquete usa la autenticación de Windows para tener acceso a los almacenes de datos (por ejemplo, servidores SQL Server o recursos compartidos de archivos locales o Azure Files), active la casilla de autenticación de Windows.If your package uses Windows authentication to access data stores (for example, SQL servers or file shares on-premises or Azure Files), select the Windows authentication check box. Escriba los valores de las credenciales de ejecución del paquete en los cuadros Domain (Dominio), Username (Nombre de usuario) y Password (Contraseña).Enter the values for your package execution credentials in the Domain, Username, and Password boxes.

    También puede usar los secretos almacenados en el almacén de claves de Azure como sus valores.Alternatively, you can use secrets stored in your Azure key vault as their values. Para ello, active la casilla AZURE KEY VAULT junto a la credencial correspondiente.To do so, select the AZURE KEY VAULT check box next to the relevant credential. Seleccione o edite el servicio vinculado del almacén de claves existente o cree uno nuevo.Select or edit your existing key vault linked service or create a new one. A continuación, seleccione el nombre o la versión del secreto para el valor de la credencial.Then select the secret name or version for your credential value.

    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.When you create or edit your key vault linked service, you can select or edit your existing key vault or create a new one. 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.Make sure to grant Data Factory managed identity access to your key vault if you haven't done so already. Los secretos también se pueden escribir directamente en el siguiente formato: <Key vault linked service name>/<secret name>/<secret version>.You can also enter your secrets directly in the following format: <Key vault linked service name>/<secret name>/<secret version>. 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).If your package needs 32-bit runtime to run, select the 32-Bit runtime check box.

    Para Ubicación del paquete, seleccione SSISDB, Sistema de archivos (paquete) , Sistema de archivos (proyecto) o Embedded package (Paquete insertado).For Package location, select SSISDB, File System (Package), File System (Project), or Embedded package. Si selecciona SSISDB como la ubicación del paquete, opción que se selecciona automáticamente si se ha aprovisionado la instancia de Azure-SSIS IR con el catálogo de SSIS (SSISDB) hospedada por el servidor de Azure SQL Database o Instancia administrada, especifique que el paquete que se va a ejecutar se ha implementado en SSISDB.If you select SSISDB as your package location, which is automatically selected if your Azure-SSIS IR was provisioned with the SSIS catalog (SSISDB) hosted by an Azure SQL Database server or managed instance, specify your package to run that was deployed into SSISDB.

    Si se ejecuta la instancia de Azure-SSIS IR y la casilla Manual entries (Entradas manuales) está desactivada, puede examinar y seleccionar sus carpetas, proyectos, paquetes y entornos existentes de SSISDB.If your Azure-SSIS IR is running and the Manual entries check box is cleared, browse and select your existing folders, projects, packages, or environments from 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.Select Refresh to fetch your newly added folders, projects, packages, or environments from SSISDB so that they're available for browsing and selection. Para examinar o seleccionar los entornos para la ejecución de paquetes, debe configurar los proyectos antes de agregar esos entornos como referencias a partir de las mismas carpetas de SSISDB.To browse or select the environments for your package executions, you must configure your projects beforehand to add those environments as references from the same folders under SSISDB. Para más información, consulte Creación y asignación de entornos SSIS.For more information, see Create and map SSIS environments.

    En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete.For Logging level, select a predefined scope of logging for your package execution. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.Select the Customized check box if you want to enter your customized logging name instead.

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

    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>.If your Azure-SSIS IR isn't running or the Manual entries check box is selected, enter your package and environment paths from SSISDB directly in the following formats: <folder name>/<project name>/<package name>.dtsx and <folder name>/<environment name>.

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

    Si selecciona File System (Package) (Sistema de archivos [paquete]) como la ubicación del paquete, opción que se selecciona automáticamente si se ha aprovisionado la instancia de Azure-SSIS IR sin SSISDB, especifique que el paquete se ejecute mediante el suministro de una ruta de acceso de convención de nomenclatura universal (UNC) para el archivo del paquete (.dtsx) en la ruta de acceso al paquete.If you select File System (Package) as your package location, which is automatically selected if your Azure-SSIS IR was provisioned without SSISDB, specify your package to run by providing a Universal Naming Convention (UNC) path to your package file (.dtsx) in the Package path box. Por ejemplo, si almacena el paquete en Azure Files, su ruta de acceso al paquete es \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.For example, if you store your package in Azure Files, its package path is \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

    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).If you configure your package in a separate file, you also need to provide a UNC path to your configuration file (.dtsConfig) in the Configuration path box. Por ejemplo, si almacena la configuración de Azure Files, su ruta de acceso de configuración es \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.For example, if you store your configuration in Azure Files, its configuration path is \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

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

    Si selecciona File System (Project) (Sistema de archivos [proyecto]) como la ubicación del paquete, deberá especificar que el paquete se ejecute mediante el suministro de una ruta de acceso UNC para el archivo del proyecto (.ispac) en cuadro Project path (Ruta de acceso del proyecto) y un archivo de paquete (.dtsx) del proyecto en el cuadro Package name (Nombre del paquete).If you select File System (Project) as your package location, specify your package to run by providing a UNC path to your project file (.ispac) in the Project path box and a package file (.dtsx) from your project in the Package name box. 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.For example, if you store your project in Azure Files, its project path is \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

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

    A continuación, especifique las credenciales para tener acceso a los archivos de configuración, del proyecto o del paquete.Next, specify the credentials to access your project, package, or configuration files. Si previamente ha escrito los valores para las credenciales de ejecución del paquete (véase más arriba), puede volver a usarlas mediante la selección de la casilla Same as package execution credentials (Igual que las credenciales de ejecución del paquete).If you previously entered the values for your package execution credentials (see previous), you can reuse them by selecting the Same as package execution credentials check box. 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).Otherwise, enter the values for your package access credentials in the Domain, Username, and Password boxes. Por ejemplo, si almacena su proyecto, paquete o 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>.For example, if you store your project, package, or configuration in Azure Files, the domain is Azure, the username is <storage account name>, and the password is <storage account key>.

    También puede usar secretos almacenados en el almacén de claves como sus valores (ver antes).Alternatively, you can use secrets stored in your key vault as their values (see previous). Estas credenciales se usan para tener acceso al paquete y a los paquetes secundarios en la tarea Ejecutar paquete, todo ello desde su propia ruta de acceso o desde el mismo proyecto, así como a las configuraciones, incluidas las que se especifiquen en los paquetes.These credentials are used to access your package and child packages in Execute Package Task, all from their own path or the same project, as well as configurations, which include those specified in your packages.

    Si selecciona Embedded package (Paquete insertado) como ubicación del paquete, arrastre y coloque el paquete para ejecutar o cárguelo desde una carpeta de archivos en el cuadro proporcionado.If you select Embedded package as your package location, drag and drop your package to run or Upload it from a file folder into the box provided. El paquete se comprimirá e insertará automáticamente en la carga de la actividad.Your package will be automatically compressed and embedded in the activity payload. Una vez insertado, puede descargar el paquete más adelante para su edición.Once embedded, you can Download your package later for editing. 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.You can also Parameterize your embedded package by assigning it to a pipeline parameter that can be used in multiple activities, hence optimizing the size of your pipeline payload. Si el paquete insertado no está cifrado por completo y se detecta el uso de la tarea Ejecutar paquete en su interior, la casilla Tarea Ejecutar paquete se activará automáticamente y se agregarán automáticamente los paquetes secundarios correspondientes con las referencias del sistema de archivos para que también los inserte.If your embedded package is not all encrypted and we detect the use of Execute Package Task in it, the Execute Package Task check box will be automatically selected and the relevant child packages with their file system references will be automatically added for you to also embed them. Si no se puede detectar el uso de la tarea Ejecutar paquete, tendrá que activar la casilla Tarea Ejecutar paquete de forma manual y agregar los paquetes secundarios correspondientes con sus referencias del sistema de archivos de uno en uno para insertarlos también.If we can't detect the use of Execute Package Task, you'll have to manually select the Execute Package Task check box and add the relevant child packages with their file system references one by one for you to also embed them. Si los paquetes secundarios usan referencias de SQL Server, asegúrese de que Azure-SSIS IR pueda acceder a SQL Server.If the child packages use SQL Server references, please ensure that the SQL Server is accessible by your Azure-SSIS IR. Actualmente no se admite el uso de referencias de proyecto para paquetes secundarios.The use of project references for child packages is currently unsupported.

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

    Si ha usado el nivel de protección EncryptAllWithPassword o EncryptSensitiveWithPassword al crear el paquete a través de SQL Server Data Tools (SSDT), deberá escribir el valor de la contraseña en el cuadro Encryption password (Contraseña de cifrado).If you used the EncryptAllWithPassword or EncryptSensitiveWithPassword protection level when you created your package via SQL Server Data Tools, enter the value for your password in the Encryption password box. También puede usar un secreto almacenado en el almacén de claves como su valor (véase antes).Alternatively, you can use a secret stored in your key vault as its value (see previous). Si ha usado el nivel de protección EncryptSensitiveWithUserKey, deberá volver 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 (Reemplazos de propiedad).If you used the EncryptSensitiveWithUserKey protection level, reenter your sensitive values in configuration files or on the SSIS Parameters, Connection Managers, or Property Overrides tabs (see later).

    Si ha usado el nivel de protección EncryptAllWithUserKey , no se admite.If you used the EncryptAllWithUserKey protection level, it's unsupported. Debe volver a configurar el paquete para usar otro nivel de protección a través de SQL Server Data Tools o la utilidad de línea de comandos dtutil.You need to reconfigure your package to use another protection level via SQL Server Data Tools or the dtutil command-line utility.

    En Logging level (Nivel de registro), seleccione un ámbito predefinido de registro para la ejecución de su paquete.For Logging level, select a predefined scope of logging for your package execution. Active la casilla Customized (Personalizado), si quiere escribir en su lugar un nombre de registro personalizado.Select the Customized check box if you want to enter your customized logging name instead. 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).If you want to log your package executions beyond using the standard log providers that can be specified in your package, specify your log folder by providing its UNC path in the Logging path box. 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>.For example, if you store your logs in Azure Files, your logging path is \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. Se crea una subcarpeta en esta ruta de acceso para cada ejecución de paquete individual y se le asignará un nombre tras el id. de ejecución de actividad Ejecutar paquete SSIS, en el que se generan archivos de registro cada cinco minutos.A subfolder is created in this path for each individual package run and named after the Execute SSIS Package activity run ID, in which log files are generated every five minutes.

    Por último, especifique las credenciales para tener acceso a la carpeta de registro.Finally, specify the credentials to access your log folder. Si previamente ha escrito los valores para las credenciales de acceso al paquete (véase 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).If you previously entered the values for your package access credentials (see previous), you can reuse them by selecting the Same as package access credentials check box. 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).Otherwise, enter the values for your logging access credentials in the Domain, Username, and Password boxes. 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>.For example, if you store your logs in Azure Files, the domain is Azure, the username is <storage account name>, and the password is <storage account key>.

    También puede usar secretos almacenados en el almacén de claves como sus valores (ver antes).Alternatively, you can use secrets stored in your key vault as their values (see previous). Estas credenciales se usarán para almacenar los registros.These credentials are used to store your logs.

    Para todas las rutas de acceso UNC mencionadas anteriormente, el nombre de archivo completo debe tener menos de 260 caracteres.For all UNC paths previously mentioned, the fully qualified file name must be fewer than 260 characters. El nombre del directorio debe tener menos de 248 caracteres.The directory name must be fewer than 248 characters.

  5. En la pestaña Parameters SSIS (Parámetros de SSIS ) de la actividad de ejecución de paquetes de SSIS, si la instancia de Azure-SSIS IR está en ejecución, se ha seleccionado 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.On the SSIS Parameters tab for the Execute SSIS Package activity, if your Azure-SSIS IR is running, SSISDB is selected as your package location, and the Manual entries check box on the Settings tab is cleared, the existing SSIS parameters in your selected project or package from SSISDB are displayed for you to assign values to them. De lo contrario, puede escribirlos uno por uno para asignarles valores manualmente.Otherwise, you can enter them one by one to assign values to them manually. Asegúrese de que existen y que se han escrito correctamente para que la ejecución del paquete se realice satisfactoriamente.Make sure that they exist and are correctly entered for your package execution to succeed.

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey al crear el paquete a través de SQL Server Data Tools y se ha seleccionado File System (Package) (Sistema de archivos [paquete]) o File System (Project) (Sistema de archivos [proyecto]) como la ubicación del paquete, también deberá volver a introducir los parámetros confidenciales para asignarles valores en los archivos de configuración o en esta pestaña.If you used the EncryptSensitiveWithUserKey protection level when you created your package via SQL Server Data Tools and File System (Package) or File System (Project) is selected as your package location, you also need to reenter your sensitive parameters to assign values to them in configuration files or on this tab.

    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.When you assign values to your parameters, you can add dynamic content by using expressions, functions, Data Factory system variables, and Data Factory pipeline parameters or variables. También puede usar secretos almacenados en el almacén de claves como sus valores (ver antes).Alternatively, you can use secrets stored in your key vault as their values (see previous).

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

  6. En la pestaña Connection Managers (Administradores de conexión) de la actividad de ejecución de paquetes de SSIS, si la instancia de Azure-SSIS IR está en ejecución, se ha seleccionado 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 administradores de conexión existentes en el proyecto o paquete seleccionado de SSISDB para que se asignen valores a sus propiedades.On the Connection Managers tab for the Execute SSIS Package activity, if your Azure-SSIS IR is running, SSISDB is selected as your package location, and the Manual entries check box on the Settings tab is cleared, the existing connection managers in your selected project or package from SSISDB are displayed for you to assign values to their properties. De lo contrario, puede escribirlos uno por uno para asignar valores a sus propiedades manualmente.Otherwise, you can enter them one by one to assign values to their properties manually. Asegúrese de que existen y que se han escrito correctamente para que la ejecución del paquete se realice satisfactoriamente.Make sure that they exist and are correctly entered for your package execution to succeed.

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey al crear el paquete a través de SQL Server Data Tools y se ha seleccionado File System (Package) (Sistema de archivos [paquete]) o File System (Project) (Sistema de archivos [proyecto]) como la ubicación del paquete, también deberá volver a introducir las propiedades del administrador de conexiones confidenciales para asignarles valores en los archivos de configuración o en esta pestaña.If you used the EncryptSensitiveWithUserKey protection level when you created your package via SQL Server Data Tools and File System (Package) or File System (Project) is selected as your package location, you also need to reenter your sensitive connection manager properties to assign values to them in configuration files or on this tab.

    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.When you assign values to your connection manager properties, you can add dynamic content by using expressions, functions, Data Factory system variables, and Data Factory pipeline parameters or variables. También puede usar secretos almacenados en el almacén de claves como sus valores (ver antes).Alternatively, you can use secrets stored in your key vault as their values (see previous).

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

  7. En la pestaña Property Overrides (Reemplazos de propiedad) de la actividad de ejecución de paquetes SSIS, escriba las rutas de acceso de las propiedades existentes en el paquete seleccionado una por una para asignarles valores manualmente.On the Property Overrides tab for the Execute SSIS Package activity, enter the paths of existing properties in your selected package one by one to assign values to them manually. Asegúrese de que existen y que se han escrito correctamente para que la ejecución del paquete se realice satisfactoriamente.Make sure that they exist and are correctly entered for your package execution to succeed. 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.For example, to override the value of your user variable, enter its path in the following format: \Package.Variables[User::<variable name>].Value.

    Si ha usado el nivel de protección EncryptSensitiveWithUserKey al crear el paquete a través de SQL Server Data Tools y se ha seleccionado File System (Package) (Sistema de archivos [paquete]) o File System (Project) (Sistema de archivos [proyecto]) como la ubicación del paquete, también deberá volver a introducir las propiedades confidenciales para asignarles valores en los archivos de configuración o en esta pestaña.If you used the EncryptSensitiveWithUserKey protection level when you created your package via SQL Server Data Tools and File System (Package) or File System (Project) is selected as your package location, you also need to reenter your sensitive properties to assign values to them in configuration files or on this tab.

    Al asignar valores a las propiedades, 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.When you assign values to your properties, you can add dynamic content by using expressions, functions, Data Factory system variables, and Data Factory pipeline parameters or variables.

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

    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).The values assigned in configuration files and on the SSIS Parameters tab can be overridden by using the Connection Managers or Property Overrides tabs. 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).The values assigned on the Connection Managers tab can also be overridden by using the Property Overrides tab.

  8. Para validar la configuración de la canalización, seleccione Validate (Validar) en la barra de herramientas.To validate the pipeline configuration, select Validate on the toolbar. Para cerrar Pipeline Validation Report (Informe de comprobación de la canalización), seleccione >> .To close the Pipeline Validation Report, select >>.

  9. Para publicar la canalización en Data Factory, seleccione Publish All (Publicar todo).To publish the pipeline to Data Factory, select Publish All.

Ejecución de la canalizaciónRun the pipeline

En este paso, desencadenará una ejecución de canalización.In this step, you trigger a pipeline run.

  1. Para desencadenar una ejecución de canalización, seleccione Trigger (Desencadenar) en la barra de herramientas y en Trigger now (Desencadenar ahora).To trigger a pipeline run, select Trigger on the toolbar, and select Trigger now.

    Trigger now (Desencadenar ahora)

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

Supervisar la canalizaciónMonitor the pipeline

  1. Cambie a la pestaña Monitor (Supervisar) de la izquierda.Switch to the Monitor tab on the left. 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.You see the pipeline run and its status along with other information, such as the Run Start time. Para actualizar la vista, seleccione Refresh (Actualizar).To refresh the view, select Refresh.

    Ejecuciones de la canalización

  2. Seleccione el vínculo View Activity Runs (Ver ejecuciones de actividad) en la columna Actions (Acciones).Select the View Activity Runs link in the Actions column. Solo verá una ejecución de actividad porque la canalización solo tiene una actividad.You see only one activity run because the pipeline has only one activity. Es la actividad de ejecución de paquetes de SSIS.It's the Execute SSIS Package activity.

    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.Run the following query against the SSISDB database in your SQL server to verify that the package executed.

    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.You can also get the SSISDB execution ID from the output of the pipeline activity run and use the ID to check more comprehensive execution logs and error messages in SQL Server Management Studio.

    Obtenga el identificador de ejecución.

Programación de la canalización con un desencadenadorSchedule the pipeline with a trigger

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.You can also create a scheduled trigger for your pipeline so that the pipeline runs on a schedule, such as hourly or daily. 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).For an example, see Create a data factory - Data Factory UI.

Ejecución de un paquete con PowerShellRun a package with PowerShell

En esta sección, usará Azure PowerShell para crear una canalización de Data Factory con una actividad de ejecución de paquetes de SSIS que ejecuta un paquete SSIS.In this section, you use Azure PowerShell to create a Data Factory pipeline with an Execute SSIS Package activity that runs your SSIS package.

Instale los módulos de Azure PowerShell más recientes siguiendo las instrucciones paso a paso que se indican en Cómo instalar y configurar Azure PowerShell.Install the latest Azure PowerShell modules by following the step-by-step instructions in How to install and configure Azure PowerShell.

Creación de una factoría de datos con Azure-SSIS IRCreate a data factory with Azure-SSIS IR

Puede usar una factoría de datos existente que ya tenga Azure-SSIS IR aprovisionado o crear una nueva factoría de datos con Azure-SSIS IR.You can either use an existing data factory that already has Azure-SSIS IR provisioned or create a new data factory with Azure-SSIS IR. Siga las instrucciones detalladas en el Tutorial: Implementación de paquetes SSIS en Azure mediante PowerShell.Follow the step-by-step instructions in the Tutorial: Deploy SSIS packages to Azure via PowerShell.

Creación de una canalización con una actividad Ejecutar paquete de SSISCreate a pipeline with an Execute SSIS Package activity

En este paso se crea una canalización con una actividad Ejecutar paquete de SSIS.In this step, you create a pipeline with an Execute SSIS Package activity. La actividad ejecuta el paquete de SSIS.The activity runs your SSIS package.

  1. Cree un archivo JSON con el nombre RunSSISPackagePipeline.json en la carpeta C:\ADF\RunSSISPackage con un contenido similar al del siguiente ejemplo.Create a JSON file named RunSSISPackagePipeline.json in the C:\ADF\RunSSISPackage folder with content similar to the following example.

    Importante

    Reemplace los nombres de objeto, descripciones, rutas de acceso, valores de propiedades y parámetros, contraseñas y otros valores de variables antes de guardar el archivo.Replace object names, descriptions, and paths, property or parameter values, passwords, and other variable values before you save the file.

    {
        "name": "RunSSISPackagePipeline",
        "properties": {
            "activities": [{
                "name": "MySSISActivity",
                "description": "My SSIS package/activity description",
                "type": "ExecuteSSISPackage",
                "typeProperties": {
                    "connectVia": {
                        "referenceName": "MyAzureSSISIR",
                        "type": "IntegrationRuntimeReference"
                    },
                    "executionCredential": {
                        "domain": "MyExecutionDomain",
                        "username": "MyExecutionUsername",
                        "password": {
                            "type": "SecureString",
                            "value": "MyExecutionPassword"
                        }
                    },
                    "runtime": "x64",
                    "loggingLevel": "Basic",
                    "packageLocation": {
                        "packagePath": "MyFolder/MyProject/MyPackage.dtsx",
                        "type": "SSISDB"
                    },
                    "environmentPath": "MyFolder/MyEnvironment",
                    "projectParameters": {
                        "project_param_1": {
                            "value": "123"
                        },
                        "project_param_2": {
                            "value": {
                                "value": "@pipeline().parameters.MyProjectParameter",
                                "type": "Expression"
                            }
                        }
                    },
                    "packageParameters": {
                        "package_param_1": {
                            "value": "345"
                        },
                        "package_param_2": {
                            "value": {
                                "type": "AzureKeyVaultSecret",
                                "store": {
                                    "referenceName": "myAKV",
                                    "type": "LinkedServiceReference"
                                },
                                "secretName": "MyPackageParameter"
                            }
                        }
                    },
                    "projectConnectionManagers": {
                        "MyAdonetCM": {
                            "username": {
                                "value": "MyConnectionUsername"
                            },
                            "password": {
                                "value": {
                                    "type": "SecureString",
                                    "value": "MyConnectionPassword"
                                }
                            }
                        }
                    },
                    "packageConnectionManagers": {
                        "MyOledbCM": {
                            "username": {
                                "value": {
                                    "value": "@pipeline().parameters.MyConnectionUsername",
                                    "type": "Expression"
                                }
                            },
                            "password": {
                                "value": {
                                    "type": "AzureKeyVaultSecret",
                                    "store": {
                                        "referenceName": "myAKV",
                                        "type": "LinkedServiceReference"
                                    },
                                    "secretName": "MyConnectionPassword",
                                    "secretVersion": "MyConnectionPasswordVersion"
                                }
                            }
                        }
                    },
                    "propertyOverrides": {
                        "\\Package.MaxConcurrentExecutables": {
                            "value": 8,
                            "isSensitive": false
                        }
                    }
                },
                "policy": {
                    "timeout": "0.01:00:00",
                    "retry": 0,
                    "retryIntervalInSeconds": 30
                }
            }]
        }
    }
    

    Para ejecutar los paquetes almacenados en sistemas de archivos, recursos compartidos de archivos o Azure Files, escriba los valores de las propiedades de la ubicación del paquete y del registro como se indica a continuación:To execute packages stored in file systems, file shares, or Azure Files, enter the values for your package and log location properties as follows:

    {
        {
            {
                {
                    "packageLocation": {
                        "packagePath": "//MyStorageAccount.file.core.windows.net/MyFileShare/MyPackage.dtsx",
                        "type": "File",
                        "typeProperties": {
                            "packagePassword": {
                                "type": "SecureString",
                                "value": "MyEncryptionPassword"
                            },
                            "accessCredential": {
                                "domain": "Azure",
                                "username": "MyStorageAccount",
                                "password": {
                                    "type": "SecureString",
                                    "value": "MyAccountKey"
                                }
                            }
                        }
                    },
                    "logLocation": {
                        "logPath": "//MyStorageAccount.file.core.windows.net/MyFileShare/MyLogFolder",
                        "type": "File",
                        "typeProperties": {
                            "accessCredential": {
                                "domain": "Azure",
                                "username": "MyStorageAccount",
                                "password": {
                                    "type": "AzureKeyVaultSecret",
                                    "store": {
                                        "referenceName": "myAKV",
                                        "type": "LinkedServiceReference"
                            },
                                    "secretName": "MyAccountKey"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    

    Para ejecutar los paquetes de proyectos almacenados en sistemas de archivos, recursos compartidos de archivos o Azure Files, escriba los valores de la propiedad de la ubicación del paquete como se indica a continuación:To execute packages within projects stored in file systems, file shares, or Azure Files, enter the values for your package location property as follows:

    {
        {
            {
                {
                    "packageLocation": {
                        "packagePath": "//MyStorageAccount.file.core.windows.net/MyFileShare/MyProject.ispac:MyPackage.dtsx",
                        "type": "File",
                        "typeProperties": {
                            "packagePassword": {
                                "type": "SecureString",
                                "value": "MyEncryptionPassword"
                            },
                            "accessCredential": {
                                "domain": "Azure",
                                "userName": "MyStorageAccount",
                                "password": {
                                    "type": "SecureString",
                                    "value": "MyAccountKey"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    

    Para ejecutar paquetes insertados, escriba los valores de la propiedad de ubicación del paquete de la siguiente manera:To execute embedded packages, enter the values for your package location property as follows:

    {
        {
            {
                {
                    "packageLocation": {
                        "type": "InlinePackage",
                        "typeProperties": {
                            "packagePassword": {
                                "type": "SecureString",
                                "value": "MyEncryptionPassword"
                            },
                            "packageName": "MyPackage.dtsx",
                            "packageContent":"My compressed/uncompressed package content",
                            "packageLastModifiedDate": "YYYY-MM-DDTHH:MM:SSZ UTC-/+HH:MM"
                        }
                    }
                }
            }
        }
    }
    
  2. En Azure PowerShell, cambie a la carpeta C:\ADF\RunSSISPackage.In Azure PowerShell, switch to the C:\ADF\RunSSISPackage folder.

  3. Para crear la canalización RunSSISPackagePipeline, ejecute el cmdlet Set-AzDataFactoryV2Pipeline.To create the pipeline RunSSISPackagePipeline, run the Set-AzDataFactoryV2Pipeline cmdlet.

    $DFPipeLine = Set-AzDataFactoryV2Pipeline -DataFactoryName $DataFactory.DataFactoryName `
                                                   -ResourceGroupName $ResGrp.ResourceGroupName `
                                                   -Name "RunSSISPackagePipeline"
                                                   -DefinitionFile ".\RunSSISPackagePipeline.json"
    

    Esta es la salida de ejemplo:Here's the sample output:

    PipelineName      : Adfv2QuickStartPipeline
    ResourceGroupName : <resourceGroupName>
    DataFactoryName   : <dataFactoryName>
    Activities        : {CopyFromBlobToBlob}
    Parameters        : {[inputPath, Microsoft.Azure.Management.DataFactory.Models.ParameterSpecification], [outputPath, Microsoft.Azure.Management.DataFactory.Models.ParameterSpecification]}
    

Ejecución de la canalizaciónRun the pipeline

Use el cmdlet Invoke-AzDataFactoryV2Pipeline para ejecutar la canalización.Use the Invoke-AzDataFactoryV2Pipeline cmdlet to run the pipeline. El cmdlet devuelve el identificador de ejecución de la canalización para realizar una supervisión en un futuro.The cmdlet returns the pipeline run ID for future monitoring.

$RunId = Invoke-AzDataFactoryV2Pipeline -DataFactoryName $DataFactory.DataFactoryName `
                                             -ResourceGroupName $ResGrp.ResourceGroupName `
                                             -PipelineName $DFPipeLine.Name

Supervisar la canalizaciónMonitor the pipeline

Ejecute el script de PowerShell siguiente para comprobar continuamente el estado de ejecución de la canalización hasta que termine de copiar los datos.Run the following PowerShell script to continuously check the pipeline run status until it finishes copying the data. Copie y pegue el siguiente script en la ventana de PowerShell y seleccione Entrar.Copy or paste the following script in the PowerShell window, and select Enter.

while ($True) {
    $Run = Get-AzDataFactoryV2PipelineRun -ResourceGroupName $ResGrp.ResourceGroupName `
                                               -DataFactoryName $DataFactory.DataFactoryName `
                                               -PipelineRunId $RunId

    if ($Run) {
        if ($run.Status -ne 'InProgress') {
            Write-Output ("Pipeline run finished. The status is: " +  $Run.Status)
            $Run
            break
        }
        Write-Output  "Pipeline is running...status: InProgress"
    }

    Start-Sleep -Seconds 10
}   

También puede supervisar la canalización mediante Azure Portal.You can also monitor the pipeline by using the Azure portal. Para ver instrucciones paso a paso, consulte Supervisar la canalización.For step-by-step instructions, see Monitor the pipeline.

Programación de la canalización con un desencadenadorSchedule the pipeline with a trigger

En el paso anterior, ha ejecutado la canalización a petición.In the previous step, you ran the pipeline on demand. También puede crear un desencadenador de programación para ejecutar la canalización en una programación, como cada hora o cada día.You can also create a schedule trigger to run the pipeline on a schedule, such as hourly or daily.

  1. Cree un archivo JSON con el nombre MyTrigger.json en la carpeta C:\ADF\RunSSISPackage con el siguiente contenido:Create a JSON file named MyTrigger.json in the C:\ADF\RunSSISPackage folder with the following content:

    {
        "properties": {
            "name": "MyTrigger",
            "type": "ScheduleTrigger",
            "typeProperties": {
                "recurrence": {
                    "frequency": "Hour",
                    "interval": 1,
                    "startTime": "2017-12-07T00:00:00-08:00",
                    "endTime": "2017-12-08T00:00:00-08:00"
                }
            },
            "pipelines": [{
                "pipelineReference": {
                    "type": "PipelineReference",
                    "referenceName": "RunSSISPackagePipeline"
                },
                "parameters": {}
            }]
        }
    }    
    
  2. En Azure PowerShell, cambie a la carpeta C:\ADF\RunSSISPackage.In Azure PowerShell, switch to the C:\ADF\RunSSISPackage folder.

  3. Ejecute el cmdlet Set-AzDataFactoryV2Trigger, que crea el desencadenador.Run the Set-AzDataFactoryV2Trigger cmdlet, which creates the trigger.

    Set-AzDataFactoryV2Trigger -ResourceGroupName $ResGrp.ResourceGroupName `
                                    -DataFactoryName $DataFactory.DataFactoryName `
                                    -Name "MyTrigger" -DefinitionFile ".\MyTrigger.json"
    
  4. De manera predeterminada, el desencadenador está en estado detenido.By default, the trigger is in stopped state. Inicie el desencadenador al ejecutar el cmdlet Start-AzDataFactoryV2Trigger.Start the trigger by running the Start-AzDataFactoryV2Trigger cmdlet.

    Start-AzDataFactoryV2Trigger -ResourceGroupName $ResGrp.ResourceGroupName `
                                      -DataFactoryName $DataFactory.DataFactoryName `
                                      -Name "MyTrigger" 
    
  5. Confirme que el desencadenador se ha iniciado al ejecutar el cmdlet Get-AzDataFactoryV2Trigger.Confirm that the trigger is started by running the Get-AzDataFactoryV2Trigger cmdlet.

    Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName `
                                    -DataFactoryName $DataFactoryName `
                                    -Name "MyTrigger"     
    
  6. Ejecute el comando siguiente al comenzar la hora siguiente.Run the following command after the next hour. Por ejemplo, si la hora actual es 15:25 UTC, ejecute el comando a las 16:00 UTC.For example, if the current time is 3:25 PM UTC, run the command at 4 PM UTC.

    Get-AzDataFactoryV2TriggerRun -ResourceGroupName $ResourceGroupName `
                                       -DataFactoryName $DataFactoryName `
                                       -TriggerName "MyTrigger" `
                                       -TriggerRunStartedAfter "2017-12-06" `
                                       -TriggerRunStartedBefore "2017-12-09"
    

    Ejecute la consulta siguiente en la base de datos SSISDB en el servidor de SQL para comprobar la ejecución del paquete.Run the following query against the SSISDB database in your SQL server to verify that the package executed.

    select * from catalog.executions
    

Pasos siguientesNext steps

Vea la siguiente entrada de blog:See the following blog post: