Compartir a través de

Herramientas de DevOps de SQL Server Integration Service (SSIS) independientes

Las herramientas independientes de SSIS DevOps proporcionan un conjunto de ejecutables para realizar tareas de CICD de SSIS. Sin la dependencia de la instalación de Visual Studio o el entorno de ejecución de SSIS, estos ejecutables se pueden integrar fácilmente con cualquier plataforma CICD. Los ejecutables proporcionados son:

  • SSISBuild.exe: compile proyectos de SSIS en el modelo de implementación del proyecto o en el modelo de implementación de paquetes.
  • SSISDeploy.exe: implemente archivos ISPAC en el catálogo de SSIS o archivos DTSX y sus dependencias en el sistema de archivos.

Installation

Se requiere .NET Framework 4.6.2 o posterior.

Descargue el instalador más reciente desde el centro de descarga. Además, el vínculo de descarga directa está disponible para el script de automatización.

A continuación, instale mediante el asistente o la línea de comandos:

  • Instalar mediante asistente

Haga doble clic en el archivo .exe que desea instalar y, a continuación, especifique una carpeta para extraer los archivos ejecutables y de dependencia.

Ubicación de instalación

  • Instalación a través de la línea de comandos
SSISDevOpsTools.exe /Q /C /T:<full path>

Comando de instalación ine

SSISBuild.exe

Sintaxis

SSISBuild.exe -project|-p:<dtproj file path> [-configuration|-c:<configuration name>] [-projectPassword|-pp:<project password>] [-stripSensitive|-ss] [-output|-o:<output path>] [-log|-l:<log level>[;<log path>]] [-quiet|-q] [-help|-h|-?]

Parámetros

Parámetro Description
-project |-p:<dtproj file path> Ruta de acceso del archivo dtproj que se va a compilar.
-configuration|-c:<nombre de configuración> Nombre de la configuración del proyecto que se va a usar para la compilación. Si no se proporciona, el valor predeterminado es la primera configuración del proyecto definida en el archivo dtproj.
-projectPassword|-pp:<contraseña del proyecto> Contraseña del proyecto de SSIS y sus paquetes. Este argumento solo es válido cuando el nivel de protección del proyecto de SSIS y los paquetes es EncryptSensitiveWithPassword o EncryptAllWithPassword. Para el modelo de implementación de paquetes, todos los paquetes deben compartir la misma contraseña especificada por este argumento.
-stripSensitive|-ss Convierta el nivel de protección del proyecto de SSIS en DontSaveSensitive. Cuando el nivel de protección es EncryptSensitiveWithPassword o EncryptAllWithPassword, el argumento -projectPassword debe establecerse correctamente. Esta opción solo es válida para el modelo de implementación de proyectos.
-output|-o:<ruta de salida> Ruta de salida del artefacto de compilación. El valor de este argumento sobrescribirá la ruta de acceso de salida predeterminada en la configuración del proyecto.
-log|-l:<nivel de registro>[;<ruta del registro>] Configuración relacionada con el registro.
  • nivel de registro: solo los registros con el nivel de registro igual o superior se escribirán en el archivo de registro. Hay cuatro niveles de registro (de bajo a alto): DIAG, INFO, WRN, ERR. El nivel de registro predeterminado es INFO si no se especifica.
  • ruta de acceso del registro: ruta de acceso del archivo para conservar los registros. No se generará el archivo de registro si no se especifica la ruta de acceso.
    		•
    -quiet|-q No muestre ningún registro en la salida estándar.
    -help|-h|-? Mostrar información de uso detallada de esta utilidad de línea de comandos.

    Examples

    • Compile un dtproj con la primera configuración del proyecto definida, no cifrada con contraseña:

      SSISBuild.exe -p:"C:\projects\demo\demo.dtproj"

    • Compile un dtproj con la configuración "DevConfiguration", cifrado con contraseña y genere los artefactos de compilación en una carpeta específica:

      SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -o:D:\folder

    • Cree un dtproj con la configuración "DevConfiguration", cifrada con contraseña, quitando sus datos confidenciales y nivel de registro DIAG:

      SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -ss -l:diag

    SSISDeploy.exe

    Sintaxis

    SSISDeploy.exe -source|-s:<source path> -destination|-d:<type>;<path>[;server] [-authType|-at:<auth type name>] [-connectionStringSuffix|-css:<connection string suffix>] [-projectPassword|-pp:<project password>] [-username|-u:<username>] [-password|-p:<password>] [-log|-l:<log level>[;<log path>]] [-quiet|-q] [-help|-h|-?]

    Parámetros

    Parámetro Description
    -source|-s:<ruta de origen> Ruta de archivo local de los artefactos que se van a implementar. Se permiten ISPAC, DTSX, ruta de la carpeta para DTSX, SSISDeploymentManifest.
    -destination|-d:<type>;<path>[; servidor] Tipo de destino, ruta de acceso de la carpeta de destino y nombre del servidor del catálogo de SSIS en el que se implementará el archivo de origen. Actualmente se admiten dos tipos de destino siguientes:
  • CATALOG: implemente archivos ISPAC únicos o múltiples en el catálogo de SSIS especificado. La ruta de acceso del destino CATALOG debe tener este formato:
    /SSISDB/<nombre de carpeta>[/<nombre del proyecto>]
    El nombre< de proyecto opcional >solo es válido cuando el origen especifica una única ruta de acceso al archivo ISPAC. El nombre del servidor debe especificarse para el destino CATALOG.
  • FILE: implemente archivos o paquetes SSIS especificados en uno o varios archivos SSISDeploymentManifest en la ruta de acceso especificada del sistema de archivos. La ruta de acceso del destino FILE puede ser una ruta de acceso de carpeta local o una ruta de acceso de carpeta de red con este formato:
    \\<nombre de máquina>\<nombre de carpeta>[\<nombre de subcarpeta>...]
    		•
    -authType|-at:<nombre del tipo de autenticación> Tipo de autenticación para acceder a SQL Server. Obligatorio para el destino CATALOG. Se admiten los siguientes tipos:
  • WIN: Autenticación de Windows
  • SQL: Autenticación de SQL Server
  • ADPWD: Active Directory - Contraseña
  • ADINT: Active Directory - Integrado
    		•
    -connectionStringSuffix|-css:<connection string suffix> Sufijo de la cadena de conexión, que se usa para conectarse al catálogo de SSIS.
    -projectPassword|-pp:<contraseña del proyecto> Contraseña para descifrar los archivos ISPAC o DTSX.
    -nombredeusuario|-u:<nombredeusuario> Nombre de usuario para acceder al sistema de archivos o catálogo de SSIS especificado. Se permite el prefijo con nombre de dominio para el acceso al sistema de archivos.
    -password|-p:<contraseña> Contraseña para acceder al catálogo o sistema de archivos de SSIS especificado.
    -log|-l:<nivel de registro>[;<ruta del registro>] Configuración relacionada con el registro para ejecutar esta utilidad.
  • nivel de registro: solo los registros con el nivel de registro igual o superior se escribirán en el archivo de registro. Hay cuatro niveles de registro (de bajo a alto): DIAG, INFO, WRN, ERR. El nivel de registro predeterminado es INFO si no se especifica.
  • ruta de acceso del registro: ruta de acceso del archivo para conservar los registros. No se generará el archivo de registro si no se especifica la ruta de acceso.
    		•
    -quiet|-q No muestre los registros en la salida estándar.
    -help|-h|-? Mostrar información de uso detallada de esta utilidad de línea de comandos.

    Examples

    • Despliegue un único ISPAC no cifrado con contraseña en el catálogo de SSIS con autenticación de Windows.

      SSISDeploy.exe -s:D:\myfolder\demo.ispac -d:catalog;/SSISDB/destfolder;myssisserver -at:win

    • Implemente un único ISPAC cifrado con contraseña en el catálogo de SSIS con autenticación de SQL y cambie el nombre del proyecto.

      SSISDeploy.exe -s:D:\myfolder\test.ispac -d:catalog;/SSISDB/folder/testproj;myssisserver -at:sql -u:sqlusername -p:sqlpassword -pp:encryptionpassword

    • Implemente un único SSISDeploymentManifest y sus archivos asociados en el recurso compartido de archivos de Azure.

      SSISDeploy.exe -s:D:\myfolder\mypackage.SSISDeploymentManifest -d:file;\\myssisshare.file.core.windows.net\destfolder -u:Azure\myssisshare -p:storagekey

    • Implemente una carpeta de archivos DTSX en el sistema de archivos local.

      SSISDeploy.exe -s:D:\myfolder -d:file;\\myssisshare\destfolder

    Notas de lanzamiento

    Versión 1.0.0.0

    Fecha de lanzamiento: 1 de septiembre de 2021

    • Versión de disponibilidad general (GA).

    Versión preliminar 0.1.3.1

    Fecha de lanzamiento: 10 de junio de 2021

    • Se ha corregido un problema que SSISDeploy.exe no podía implementar proyectos de SSIS con el error "Excepción no controlada: System.IO.FileLoadException: No se pudo cargar el archivo o ensamblado "Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" o una de sus dependencias. Error de validación de nombre seguro. (Excepción de HRESULT: 0x8013141A) ---> System.Security.SecurityException: validación de nombre fuerte fallida. (Excepción de HRESULT: 0x8013141A)".

    Versión preliminar 0.1.3

    Fecha de lanzamiento: 2 de junio de 2021

    • Se ha corregido un problema que SSISBuild.exe no pudo compilar proyectos con el error "Error en la comprobación de coherencia del proyecto. Se detectaron las siguientes incoherencias" cuando el nombre del paquete del proyecto contiene caracteres especiales.
    • Se ha corregido un problema que SSISBUild.exe no pudo compilar proyectos cuando no hay coincidencia entre el nombre de dtproj y el nombre de archivo.
    • Se ha corregido un problema que SSISBuild.exe no pudo compilar proyectos con el nivel de protección encryptSensitiveWithPassword/EncryptAllWithPassword cuando el proyecto tiene como destino SQL Server 2016.

    Versión preliminar 0.1.2

    Fecha de lanzamiento: 14 de enero de 2021

    • Se ha corregido un problema donde SSISBuild.exe no puede compilar el proyecto debido a una excepción de tipo NullReference cuando los metadatos del parámetro del paquete en el archivo del proyecto de SSIS y en el paquete SSIS no coinciden.
    • Se ha corregido un problema que provocaba que el paquete no se ejecutara con el error "No se pudo descifrar el nodo XML protegido", aunque el paquete se implementa correctamente en SSISDB con SSISDeploy.exe, cuando el proyecto de SSIS que contiene el paquete se cifra con EncryptSensitiveWithUserKey y el paquete contiene CM con datos confidenciales.

    Versión preliminar 0.1.1

    Fecha de lanzamiento: 11 de noviembre de 2020

    • Se ha corregido un problema en el que SSISDeploy.exe no pudo cargar un ensamblado al implementar el archivo ispac en el catálogo de SSIS.

    Versión preliminar 0.1.0

    Fecha de lanzamiento: 16 de octubre de 2020

    Primera versión preliminar de las herramientas SSIS DevOps independientes.

    Pasos siguientes

    • Last updated on