Strumenti DevOps autonomi di SQL Server Integration Services (SSIS)

Gli strumenti SSIS DevOps autonomi forniscono un set di eseguibili per eseguire attività CICD SSIS. Senza la dipendenza dall'installazione di Visual Studio o del runtime SSIS, questi eseguibili possono essere facilmente integrati con qualsiasi piattaforma CICD. I file eseguibili forniti sono:

  • SSISBuild.exe: compilare progetti SSIS nel modello di distribuzione del progetto o nel modello di distribuzione del pacchetto.
  • SSISDeploy.exe: distribuire i file ISPAC nel catalogo SSIS o i file DTSX e le relative dipendenze nel sistema di file.

Installazione

È necessario .NET Framework 4.6.2 o versione successiva.

Scaricare il programma di installazione più recente dall'area download. Inoltre, il collegamento diretto per il download è disponibile per lo script di automazione.

Eseguire quindi l'installazione tramite procedura guidata o riga di comando:

  • Eseguire l'installazione tramite procedura guidata

Fare doppio clic sul file .exe da installare, quindi specificare una cartella per estrarre i file eseguibili e i file di dipendenza.

Percorso di installazione

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

Comando di installazione ine

SSISBuild.exe

Syntax

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

Parametri

Parametro Description
-project |-p:<dtproj percorso del file> Percorso del file dtproj da compilare.
-configuration|-c:<nome della configurazione> Nome della configurazione del progetto da usare per la compilazione. Se non viene specificato, per impostazione predefinita viene utilizzata la prima configurazione del progetto definita nel file dtproj.
-projectPassword|-pp:<password del progetto> Password del progetto SSIS e dei relativi pacchetti. Questo argomento è valido solo quando il livello di protezione del progetto SSIS e dei pacchetti è EncryptSensitiveWithPassword o EncryptAllWithPassword. Per il modello di distribuzione del pacchetto, tutti i pacchetti devono condividere la stessa password specificata da questo argomento.
-stripSensitive|-ss Convertire il livello di protezione del progetto SSIS in DontSaveSensitive. Quando il livello di protezione è EncryptSensitiveWithPassword o EncryptAllWithPassword, l'argomento -projectPassword deve essere impostato correttamente. Questa opzione è valida solo per il modello di distribuzione del progetto.
-output|-o:<percorso di output> Percorso di output dell'artefatto di compilazione. Nella configurazione del progetto, il valore di questo argomento sovrascriverà il percorso di output predefinito.
-log|-l:<livello log>[;<percorso del log>] Impostazioni correlate al log.
  • livello di log: solo i log con livello di registrazione uguale o superiore verranno scritti nel file di log. Esistono quattro livelli di registrazione (da basso a alto): DIAG, INFO, WRN, ERR. Il livello di registrazione predefinito è INFO se non è specificato.
  • percorso del log: percorso del file per rendere persistenti i log. Il file di log non verrà generato se il percorso non è specificato.
    		•
    -silenzioso|-q Non visualizzare alcun log nell'output standard.
    -help|-h|-? Mostra informazioni dettagliate sull'utilizzo di questa utilità della riga di comando.

    Examples

    • Compilare un dtproj con la prima configurazione del progetto definita, non crittografata con password:

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

    • Compilare un dtproj con configurazione "DevConfiguration", crittografato con password e restituire gli artefatti di compilazione in una cartella specifica:

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

    • Compilare un dtproj con configurazione "DevConfiguration", crittografato con password, rimuovendo i dati sensibili e a livello DIAG per i log.

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

    SSISDeploy.exe

    Syntax

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

    Parametri

    Parametro Description
    -source|-s:<percorso di origine> Percorso del file locale degli artefatti da distribuire. Sono consentiti ISPAC, DTSX, percorso della cartella per DTSX, SSISDeploymentManifest.
    -destination|-d:<type>;<path>[; server] Tipo di destinazione, percorso della cartella di destinazione e nome del server del catalogo SSIS in cui verrà distribuito il file di origine. Attualmente sono supportati due tipi di destinazione seguenti:
  • CATALOG: distribuire singoli o più file ISPAC nel catalogo SSIS specificato. Il percorso della destinazione CATALOG deve essere in questo formato:
    /SSISDB/<nome> cartella[/<nome> progetto]
    Il nome< del progetto facoltativo >è valido solo quando l'origine specifica un singolo percorso di file ISPAC. Il nome del server deve essere specificato per la destinazione CATALOG.
  • FILE: distribuire pacchetti O file SSIS specificati in un singolo o più file SSISDeploymentManifest nel percorso specificato del file system. Il percorso della destinazione FILE può essere un percorso di cartella locale o un percorso di cartella di rete in questo formato:
    \\<nome computer>\<nome cartella>[\<cartella secondaria>...]
    		•
    -authType|-at:<nome tipo autenticazione> Tipo di autenticazione per accedere a SQL Server. Obbligatorio per la destinazione CATALOG. Sono supportati i tipi seguenti:
  • WIN: Autenticazione di Windows
  • SQL: Autenticazione di SQL Server
  • ADPWD: Active Directory - Password
  • ADINT: Active Directory - Integrato
    		•
    -connectionStringSuffix|-css:<suffisso stringa di connessione> Suffisso della stringa di connessione, usata per connettersi al catalogo SSIS.
    -projectPassword|-pp:<password del progetto> Password per decifrare i file ISPAC o DTSX.
    -username|-u:<username> Nome utente per accedere al catalogo o al file system SSIS specificato. L'uso di un prefisso con il nome di dominio è permesso per l'accesso al file system.
    -password|-p:<password> Password per accedere al catalogo o al file system SSIS specificato.
    -log|-l:<livello log>[;<percorso del log>] Registrare le impostazioni correlate per l'esecuzione di questa utilità.
  • livello di log: solo i log con livello di registrazione uguale o superiore verranno scritti nel file di log. Esistono quattro livelli di registrazione (da basso a alto): DIAG, INFO, WRN, ERR. Il livello di registrazione predefinito è INFO se non è specificato.
  • percorso del log: percorso del file per rendere persistenti i log. Il file di log non verrà generato se il percorso non è specificato.
    		•
    -silenzioso|-q Non visualizzare i log nell'output standard.
    -help|-h|-? Mostra informazioni dettagliate sull'utilizzo di questa utilità della riga di comando.

    Examples

    • Distribuire un singolo ISPAC non crittografato con password nel catalogo SSIS con l'autenticazione di Windows.

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

    • Distribuire un singolo file ISPAC crittografato con password nel catalogo SSIS con l'autenticazione SQL e rinominare il nome del progetto.

      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.

      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 nel file system locale.

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

    Note di rilascio

    Versione 1.0.0.0

    Data di rilascio: 1° settembre 2021

    • Versione di disponibilità generale (GA).

    Versione 0.1.3.1 Preview

    Data di rilascio: 10 giugno 2021

    • È stato risolto un problema che SSISDeploy.exe non è riuscito a distribuire progetti SSIS con errore "Eccezione non gestita: System.IO.FileLoadException: Impossibile caricare il file o l'assembly 'Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' o una delle relative dipendenze. Convalida del nome sicuro non riuscita. (Eccezione da HRESULT: 0x8013141A) ---> System.Security.SecurityException: convalida del nome sicuro non riuscita. (Eccezione da HRESULT: 0x8013141A)".

    Versione 0.1.3 Preview

    Data di rilascio: 2 giugno 2021

    • È stato risolto un problema per il quale SSISBuild.exe non riusciva a compilare i progetti con l'errore "Verifica coerenza del progetto non riuscita". Sono state rilevate le incoerenze seguenti" quando il nome del pacchetto nel progetto contiene caratteri speciali.
    • È stato risolto un problema per cui SSISBuild.exe non riusciva a compilare i progetti quando vi era una discrepanza tra il nome nel file dtproj e il nome del file.
    • È stato risolto un problema che SSISBuild.exe non è riuscito a compilare progetti con livello di protezione encryptSensitiveWithPassword/EncryptAllWithPassword quando il progetto è destinato a SQL Server 2016.

    Versione 0.1.2 Preview

    Data di rilascio: 14 gennaio 2021

    • È stato risolto un problema in cui SSISBuild.exe non riusciva a compilare il progetto a causa di un'eccezione NullReference, che si verificava quando i metadati dei parametri del pacchetto nel file di progetto SSIS non coincidevano con quelli del pacchetto SSIS.
    • È stato risolto un problema per cui l'esecuzione del pacchetto fallisce con l'errore "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.

    Versione 0.1.1 Preview

    Data di rilascio: 11 novembre 2020

    • È stato risolto un problema per cui SSISDeploy.exe non è in grado di caricare un assembly durante la distribuzione di ispac nel catalogo SSIS.

    Versione 0.1.0 Preview

    Data di rilascio: 16 ottobre 2020

    Versione di anteprima iniziale degli SSIS DevOps Tools indipendenti.

    Passaggi successivi

    • Last updated on