Versione autonoma di SQL Server Integration Services (SSIS) DevOps Tools (anteprima)Standalone SQL Server Integration Service (SSIS) DevOps Tools (Preview)

La versione autonoma di SSIS DevOps Tools offre un set di file eseguibili per eseguire attività CI/CD di SSIS.Standalone SSIS DevOps Tools provide a set of executables to do SSIS CICD tasks. Senza dipendere dall'installazione di Visual Studio o dal runtime SSIS, questi file eseguibili possono essere facilmente integrati con qualsiasi piattaforma CI/CD.Without the dependency on the installation of Visual Studio or SSIS runtime, these executables can be easily integrated with any CICD platform. Gli eseguibili disponibili sono i seguenti:The executables provided are:

  • SSISBuild.exe: compila i progetti SSIS nel modello di distribuzione del progetto o nel modello di distribuzione del pacchetto.SSISBuild.exe: build SSIS projects in project deployment model or package deployment model.
  • SSISDeploy.exe: distribuisce i file ISPAC nel catalogo SSIS o i file DTSX e le relative dipendenze in file system.SSISDeploy.exe: deploy ISPAC files to SSIS catalog, or DTSX files and their dependencies to file system.

InstallazioneInstallation

È necessario .NET Framework 4.6.2 o versione successiva..NET framework 4.6.2 or higher is required.

Scaricare il programma di installazione più recente dall'area download, quindi eseguire l'installazione tramite la procedura guidata o la riga di comando:Download the latest installer from download center, then install via wizard or command line:

  • Eseguire l'installazione tramite la procedura guidataInstall via wizard

Fare doppio clic sul file con estensione exe per eseguire l'installazione, quindi specificare una cartella in cui estrarre i file eseguibili e i file di dipendenza.Double-click the .exe file to install, then specify a folder to extract the executables and dependency files.

Percorso di installazione

  • Eseguire l'installazione tramite la riga di comandoInstall via command line
SSISDevOpsTools.exe /Q /C /T:<full path>

Riga di comando dell'installazione

SSISBuild.exeSSISBuild.exe

SintassiSyntax

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|-?]

ParametriParameters

ParametroParameter DescrizioneDescription
-project |-p:<dtproj file path>-project |-p:<dtproj file path> Percorso del file dtproj da compilare.File path of the dtproj file to be built.
-configuration|-c:<configuration name>-configuration|-c:<configuration name> Nome della configurazione di progetto da usare per la compilazione.Name of the project configuration to be used for build. Se non viene specificata, per impostazione predefinita viene assegnata la prima configurazione di progetto definita nel file dtproj.If not supplied, it defaults to the first defined project configuration in the dtproj file.
-projectPassword|-pp:<project password>-projectPassword|-pp:<project password> Password del progetto SSIS e dei relativi pacchetti.Password of the SSIS project and its packages. Questo argomento è valido solo quando il livello di protezione del progetto e dei pacchetti SSIS è EncryptSensitiveWithPassword o EncryptAllWithPassword.This argument is only valid when the protection level of the SSIS project and packages is EncryptSensitiveWithPassword or EncryptAllWithPassword. Per il modello di distribuzione del pacchetto, tutti i pacchetti devono condividere la stessa password specificata da questo argomento.For package deployment model, all packages must share the same password specified by this argument.
-stripSensitive|-ss-stripSensitive|-ss Converte il livello di protezione del progetto SSIS in DontSaveSensitve.Convert the protection level of the SSIS project to DontSaveSensitve. Quando il livello di protezione è EncryptSensitiveWithPassword o EncryptAllWithPassword, è necessario che l'argomento -projectPassword sia impostato correttamente.When protection level is EncryptSensitiveWithPassword or EncryptAllWithPassword, the argument -projectPassword must be correctly set. Questa opzione è valida solo per il modello di distribuzione del progetto.This option is only valid for project deployment model.
-output|-o:<output path>-output|-o:<output path> Percorso di output dell'artefatto della compilazione.Output path of the build artifact. Il valore di questo argomento sovrascrive il percorso di output predefinito nella configurazione del progetto.The value of this argument will overwrite the default output path in the project configuration.
-log|-l:<log level>[;<log path>]-log|-l:<log level>[;<log path>] Impostazioni relative al log.Log related settings.
  • Livello di log: solo i log con livello di registrazione uguale o superiore vengono scritti nel file di log.log level: Only logs with equal or higher logging level will be written to the log file. Esistono quattro livelli di registrazione (da basso ad alto): DIAG, INFO, WRN, ERR.There are four logging levels (from low to high): DIAG, INFO, WRN, ERR. Se non è specificato, il livello di registrazione predefinito è INFO.The default logging level is INFO if it's not specified.
  • Percorso log: percorso del file per il salvataggio permanente dei log.log path: Path of the file to persist logs. Il file di log non viene generato se non viene specificato il percorso.Log file will not be generated if the path is not specified.
  • -quiet|-q-quiet|-q Nell'output standard non vengono visualizzi log.Do not display any logs to the standard output.
    -help|-h|-?-help|-h|-? Vengono visualizzate informazioni dettagliate sull'utilizzo di questa utilità della riga di comando.Show detailed usage information of this command-line utility.

    esempiExamples

    • Compilare un file dtproj con la prima configurazione di progetto definita, non crittografata con la password:Build a dtproj with the first defined project configuration, not encrypted with password:

      SSISBuild.exe -p:"C:\projects\demo\demo.dtproj"
      
    • Compilare un file dtproj con la configurazione "DevConfiguration" crittografata con la password e restituire gli artefatti della compilazione in una cartella specifica:Build a dtproj with configuration "DevConfiguration", encrypted with password, and output the build artifacts to a specific folder:

      SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -o:D:\folder
      
    • Compilare un file dtproj con la configurazione "DevConfiguration" crittografato con password, striping dei dati sensibili e livello di registrazione DIAG:Build a dtproj with configuration "DevConfiguration", encrypted with password, striping its sensitive data, and log level DIAG:

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

    SSISDeploy.exeSSISDeploy.exe

    SintassiSyntax

    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|-?]
    

    ParametriParameters

    ParametroParameter DescrizioneDescription
    -source|-s:<source path>-source|-s:<source path> Percorso del file locale degli artefatti da distribuire.Local file path of artifacts to be deployed. Sono consentiti ISPAC, DTSX, il percorso della cartella per DTSX e SSISDeploymentManfiest.ISPAC, DTSX, path of folder for DTSX, SSISDeploymentManfiest are allowed.
    -destination|-d:<type>;<path>[;server]-destination|-d:<type>;<path>[;server] Tipo di destinazione, percorso della cartella di destinazione e nome del server del catalogo SSIS in cui viene distribuito il file di origine.Destination type, path of the destination folder, and server name of the SSIS catalog where the source file will be deployed to. Attualmente sono supportati i due tipi di destinazione seguenti:Currently we support following two destination types:
  • CATALOG: è possibile distribuire uno o più file ISPAC nel catalogo SSIS specificato.CATALOG: deploy single or multiple ISPAC files to the specified SSIS catalog. Il percorso della destinazione CATALOG deve avere il formato seguente:The path of CATALOG destination should be in such format:
    /SSISDB/<folder name>[/<project name>]/SSISDB/<folder name>[/<project name>]
    Il valore facoltativo è valido solo quando l'origine specifica un singolo percorso del file ISPAC.The optional is only valid when the source specifies a single ISPAC file path. Per la destinazione CATALOG è necessario specificare il nome del server.Server name must be specified for CATALOG destination.
  • FILE: è possibile distribuire i pacchetti SSIS o i file specificati in uno o più file SSISDeploymentManifest nel percorso specificato del file system.FILE: deploy SSIS packages or files specified in a single or multiple SSISDeploymentManifest files to the specified path of the file system. Il percorso di destinazione FILE può essere un percorso di cartella locale o un percorso di cartella di rete nel formato seguente:The path of FILE destination can be a local folder path or a network folder path in such format:
    \\<machine name>\<folder name>[\<sub folder name>...]\\<machine name>\<folder name>[\<sub folder name>...]
  • -authType|-at:<auth type name>-authType|-at:<auth type name> Tipo di autenticazione per accedere a SQL Server.Authentication type to access SQL Server. Obbligatorio per la destinazione CATALOG.Mandatory for CATALOG destination. Sono supportati i tipi seguenti:Following types are supported:
  • WIN: Autenticazione di WindowsWIN: Windows Authentication
  • SQL: Autenticazione di SQL ServerSQL: SQL Server Authentication
  • ADPWD: Active Directory - PasswordADPWD: Active Directory - Password
  • ADINT: Active Directory - IntegrataADINT: Active Directory - Integrated
  • -connectionStringSuffix|-css:<connection string suffix>-connectionStringSuffix|-css:<connection string suffix> Suffisso della stringa di connessione usata per la connessione al catalogo SSIS.Suffix of the connection string, which is used to connect to the SSIS catalog.
    -projectPassword|-pp:<project password>-projectPassword|-pp:<project password> Password per decrittografare i file ISPAC o DTSX.Password to decrypt the ISPAC or DTSX files.
    -username|-u:<username>-username|-u:<username> Nome utente per accedere al file system o al catalogo SSIS specificato.Username to access the specified SSIS catalog or file system. Per accedere al file system è consentito il prefisso con nome di dominio.Prefix with domain name is allowed for file system access.
    -password|-p:<password>-password|-p:<password> Password per accedere al file system o al catalogo SSIS specificato.Password to access the specified SSIS catalog or file system.
    -log|-l:<log level>[;<log path>]-log|-l:<log level>[;<log path>] Impostazioni relative al log per l'esecuzione di questa utilità.Log related settings for running this utility.
  • Livello di log: solo i log con livello di registrazione uguale o superiore vengono scritti nel file di log.log level: Only logs with equal or higher logging level will be written to the log file. Esistono quattro livelli di registrazione (da basso ad alto): DIAG, INFO, WRN, ERR.There are four logging levels (from low to high): DIAG, INFO, WRN, ERR. Se non è specificato, il livello di registrazione predefinito è INFO.The default logging level is INFO if it's not specified.
  • Percorso log: percorso del file per il salvataggio permanente dei log.log path: Path of the file to persist logs. Il file di log non viene generato se non viene specificato il percorso.Log file will not be generated if the path is not specified.
  • -quiet|-q-quiet|-q Nell'output standard non vengono visualizzi log.Do not display logs to the standard output.
    -help|-h|-?-help|-h|-? Vengono visualizzate informazioni dettagliate sull'utilizzo di questa utilità della riga di comando.Show detailed usage information of this command-line utility.

    esempiExamples

    • Distribuire un singolo file ISPAC non crittografato con la password nel catalogo SSIS usando l'autenticazione di Windows.Deploy a single ISPAC not encrypted with password to SSIS catalog with Windows authentication.

      SSISDeploy.exe -s:D:\myfolder\demo.ispac -d:catalog;/SSISDB/destfolder;myssisserver -at:win
      
    • Distribuire un singolo file ISPAC crittografato con la password nel catalogo SSIS usando l'autenticazione SQL e rinominare il nome del progetto.Deploy a single ISPAC encrypted with password to SSIS catalog with SQL authentication, and rename the project name.

      SSISDeploy.exe -s:D:\myfolder\test.ispac -d:catalog;/SSISDB/folder/testproj;myssisserver -at:sql -u:sqlusername -p:sqlpassword -pp:encryptionpassword
      
    • Distribuire un singolo file SSISDeploymentManifest e i relativi file associati nella condivisione file di Azure.Deploy a single SSISDeploymentManifest and its associated files to Azure file share.

      SSISDeploy.exe -s:D:\myfolder\mypackage.SSISDeploymentManifest -d:file;\\myssisshare.file.core.windows.net\destfolder -u:Azure\myssisshare -p:storagekey
      
    • Distribuire una cartella di file DTSX in file system locali.Deploy a folder of DTSX files to on-premises file system.

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

    Note sulla versioneRelease notes

    Versione 0.1.2 - AnteprimaVersion 0.1.2 Preview

    Data di rilascio: 14 gennaio 2021Release Date: January 14, 2021

    • Correzione di un problema a causa del quale SSISBuild.exe non riesce a compilare il progetto con eccezione NullReference quando i metadati dei parametri del pacchetto nel file di progetto SSIS e nel pacchetto SSIS non corrispondono.Fixed an issue that SSISBuild.exe fails to build project with NullReference exception when package parameter metadata in SSIS project file and SSIS package mismatches.
    • Correzione di un problema a causa del quale il pacchetto non può essere eseguito con un messaggio di errore che inizia "Impossibile decrittografare il nodo XML protetto " anche se il pacchetto viene distribuito correttamente in SSISDB con SSISDeploy.exe, quando il progetto SSIS contenente il pacchetto è crittografato con EncryptSensitiveWithUserKey e il pacchetto contiene CM con dati sensibili.Fixed an issue that package fails to be executed with error starting with “Failed to decrypt protected XML node” though the package is deployed to SSISDB successfully with SSISDeploy.exe, when the SSIS project containing the package is encrypted with EncryptSensitiveWithUserKey and the package contains CM with sensitive data.

    Version 0.1.1 (anteprima)Version 0.1.1 Preview

    Data di rilascio: 11 novembre 2020Release Date: November 11, 2020

    • Correzione di un problema a causa del quale SSISDeploy.exe non riesce a caricare un assembly durante la distribuzione di ispac nel catalogo SSIS.Fixed an issue that SSISDeploy.exe fails to load an assembly when deploying ispac to SSIS catalog.

    Version 0.1.0 (anteprima)Version 0.1.0 Preview

    Data di rilascio: 16 ottobre 2020Release Date: October 16, 2020

    Versione di anteprima iniziale autonoma di SSIS DevOps Tools.Initial preview release of standalone SSIS DevOps Tools.

    Passaggi successiviNext steps