Versione autonoma di SQL Server Integration Services (SSIS) DevOps Tools

  • Articolo

La versione autonoma di SSIS DevOps Tools offre un set di file eseguibili per eseguire attività CI/CD di SSIS. Senza dipendere dall'installazione di Visual Studio o dal runtime SSIS, questi file eseguibili possono essere facilmente integrati con qualsiasi piattaforma CI/CD. Gli eseguibili disponibili sono i seguenti:

  • SSISBuild.exe: compila i progetti SSIS nel modello di distribuzione del progetto o nel modello di distribuzione del pacchetto.
  • SSISDeploy.exe: distribuisce i file ISPAC nel catalogo SSIS o i file DTSX e le relative dipendenze in file system.

Installazione

È necessario .NET Framework 4.6.2 o versione successiva.

Scaricare il programma di installazione più recente dall'Area download. È inoltre disponibile il collegamento di download diretto per lo script di automazione.

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

  • Eseguire l'installazione tramite la procedura guidata

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.

Installation location

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

Installation command ine

SSISBuild.exe

Sintassi

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 Descrizione
-project |-p:<dtproj file path> Percorso del file dtproj da compilare.
-configuration|-c:<configuration name> Nome della configurazione di progetto da usare per la compilazione. Se non viene specificata, per impostazione predefinita viene assegnata la prima configurazione di progetto definita nel file dtproj.
-projectPassword|-pp:<project password> Password del progetto SSIS e dei relativi pacchetti. Questo argomento è valido solo quando il livello di protezione del progetto e dei pacchetti SSIS è EncryptSensitiveWithPassword o EncryptAllWithPassword. Per il modello di distribuzione del pacchetto, tutti i pacchetti devono condividere la stessa password specificata da questo argomento.
-stripSensitive|-ss Converte il livello di protezione del progetto SSIS in DontSaveSensitve. Quando il livello di protezione è EncryptSensitiveWithPassword o EncryptAllWithPassword, è necessario che l'argomento -projectPassword sia impostato correttamente. Questa opzione è valida solo per il modello di distribuzione del progetto.
-output|-o:<output path> Percorso di output dell'artefatto della compilazione. Il valore di questo argomento sovrascrive il percorso di output predefinito nella configurazione del progetto.
-log|-l:<log level>[;<log path>] Impostazioni relative al log.
  • livello log: solo i log con livello di registrazione uguale o superiore vengono scritti nel file di log. Esistono quattro livelli di registrazione (da basso ad alto): DIAG, INFO, WRN, ERR. Se non è specificato, il livello di registrazione predefinito è INFO.
  • percorso del file: percorso del file per il salvataggio permanente dei log. Il file di log non viene generato se non viene specificato il percorso.
    		•
    -quiet|-q Nell'output standard non vengono visualizzi log.
    -help|-h|-? Vengono visualizzate informazioni dettagliate sull'utilizzo di questa utilità della riga di comando.

    Esempi

    • Compilare un file dtproj con la prima configurazione di progetto definita, non crittografata con la 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:

      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, rimozione dei dati sensibili e livello di registrazione DIAG:

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

    SSISDeploy.exe

    Sintassi

    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 Descrizione
    -source|-s:<source path> Percorso del file locale degli artefatti da distribuire. Sono consentiti ISPAC, DTSX, il percorso della cartella per DTSX e SSISDeploymentManfiest.
    -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. Attualmente sono supportati i due tipi di destinazione seguenti:
  • CATALOG: è possibile distribuire uno o più file ISPAC nel catalogo SSIS specificato. Il percorso della destinazione CATALOG deve avere il formato seguente:
    /SSISDB/<nome cartella>[/<nome progetto>]
    Il valore <nome progetto> facoltativo è valido solo quando l'origine specifica un singolo percorso del file ISPAC. Per la destinazione CATALOG è necessario specificare il nome del server.
  • FILE: è possibile distribuire i pacchetti SSIS o i file specificati in uno o più file SSISDeploymentManifest nel percorso specificato del file system. Il percorso di destinazione del FILE può essere un percorso di cartella locale o un percorso di cartella di rete nel formato seguente:
    \\<nome computer>\<nome cartella>[\<nome sottocartella>...]
    		•
    -authType|-at:<auth type name> 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 - Integrata
    		•
    -connectionStringSuffix|-css:<connection string suffix> Suffisso della stringa di connessione usata per la connessione al catalogo SSIS.
    -projectPassword|-pp:<project password> Password per decrittografare i file ISPAC o DTSX.
    -username|-u:<username> Nome utente per accedere al file system o al catalogo SSIS specificato. Per accedere al file system è consentito il prefisso con nome di dominio.
    -password|-p:<password> Password per accedere al file system o al catalogo SSIS specificato.
    -log|-l:<log level>[;<log path>] Impostazioni relative al log per l'esecuzione di questa utilità.
  • livello log: solo i log con livello di registrazione uguale o superiore vengono scritti nel file di log. Esistono quattro livelli di registrazione (da basso ad alto): DIAG, INFO, WRN, ERR. Se non è specificato, il livello di registrazione predefinito è INFO.
  • percorso del file: percorso del file per il salvataggio permanente dei log. Il file di log non viene generato se non viene specificato il percorso.
    		•
    -quiet|-q Nell'output standard non vengono visualizzi log.
    -help|-h|-? Vengono visualizzate informazioni dettagliate sull'utilizzo di questa utilità della riga di comando.

    Esempi

    • Distribuire un singolo file ISPAC non crittografato con la password nel catalogo SSIS usando 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 la password nel catalogo SSIS usando 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 in file system locali.

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

    Note sulla versione

    Versione 1.0.0.0

    Data di rilascio: 1 settembre 2021

    • Versione disponibile a livello generale.

    Versione 0.1.3.1 Preview

    Data di rilascio: 10 giugno 2021

    • È stato risolto un problema a causa del quale SSISDeploy.exe non riesce distribuire progetti SSIS con l'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 - Anteprima

    Data di rilascio: 2 giugno 2021

    • È stato risolto un problema a causa del 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 a causa del quale SSISBUild.exe non riusciva a compilare progetti in caso di mancata corrispondenza tra il nome in dtproj e il nome del file.
    • È stato risolto un problema a causa del quale SSISBuild.exe non riusciva a compilare progetti con il livello di protezione encryptSenstiveWithPassword/EncryptAllWithPassword quando il progetto era destinato SQL Server 2016.

    Versione 0.1.2 - Anteprima

    Data di uscita: 14 gennaio 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.
    • 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.

    Version 0.1.1 (anteprima)

    Data di uscita: 11 novembre 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.

    Version 0.1.0 (anteprima)

    Data di uscita: 16 ottobre 2020

    Versione di anteprima iniziale autonoma di SSIS DevOps Tools.

    Passaggi successivi