Freigeben über

Eigenständige SQL Server Integration Service (SSIS)-DevOps-Tools

Eigenständige SSIS-DevOps-Tools bieten eine Reihe von ausführbaren Dateien für SSIS-CI/CD-Aufgaben. Ohne die Abhängigkeit von der Installation von Visual Studio oder SSIS-Runtime können diese ausführbaren Dateien problemlos in jede CICD-Plattform integriert werden. Die bereitgestellten ausführbaren Dateien sind:

  • SSISBuild.exe: Erstellen von SSIS-Projekten in einem Projektbereitstellungs- oder Paketbereitstellungsmodell
  • SSISDeploy.exe: Bereitstellen von ISPAC-Dateien in SSIS-Katalogen oder von DTSX-Dateien mit ihren Abhängigkeiten im Dateisystem.

Installation

.NET Framework 4.6.2 oder höher ist erforderlich.

Laden Sie das neueste Installationsprogramm aus dem Download Center herunter. Außerdem steht ein direkter Downloadlink für das Automatisierungsskript zur Verfügung.

Führen Sie dann die Installation über den Assistenten oder die Befehlszeile durch:

  • Installieren per Assistent

Doppelklicken Sie auf die zu installierende .exe Datei, und geben Sie dann einen Ordner an, um die ausführbaren Dateien und Abhängigkeitsdateien zu extrahieren.

Installationsort

  • Installieren über die Befehlszeile
SSISDevOpsTools.exe /Q /C /T:<full path>

Installationsbefehlszeile

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

Parameter

Parameter Beschreibung
-project |-p:<dtproj file path> Dateipfad der zu erstellenden dtproj-Datei.
-configuration|-c:<configuration name> Der Name der Projektkonfiguration, die für den Build verwendet werden soll. Wenn nicht angegeben, wird standardmäßig die erste definierte Projektkonfiguration in der dtproj-Datei verwendet.
-projectPassword|-pp:<project password> Kennwort des SSIS-Projekts und der zugehörigen Pakete. Dieses Argument ist nur gültig, wenn die Schutzebene des SSIS-Projekts und Pakete "EncryptSensitiveWithPassword" oder "EncryptAllWithPassword" lautet. Für das Paketbereitstellungsmodell müssen alle Pakete das mit diesem Argument angegebene Kennwort gemeinsam verwenden.
-stripSensitive|-ss Konvertieren Sie die Schutzebene des SSIS-Projekts zu DontSaveSensitive. Wenn die Schutzebene "EncryptSensitiveWithPassword" oder "EncryptAllWithPassword" lautet, muss das Argument -projectPassword richtig festgelegt sein. Diese Option ist nur für das Projektbereitstellungsmodell gültig.
-output|-o:<output path> Der Ausgabepfad des Buildartefakts Der Wert dieses Arguments überschreibt den Standardausgabepfad in der Projektkonfiguration.
-log|-l:<Protokollebene>[;<Protokollpfad>] Protokollbezogene Einstellungen
  • Protokollebene: Nur Protokolle mit gleicher oder höherer Protokollierungsebene werden in die Protokolldatei geschrieben. Es gibt vier Protokollierungsebenen (von niedrig bis hoch): DIAG, INFO, WRN, ERR. Ohne andere Angabe ist der Standardprotokolliergrad „INFO“.
  • Protokollpfad: Pfad der Datei zum Speichern von Protokollen. Die Protokolldatei wird nicht generiert, wenn der Pfad nicht angegeben ist.
    		•
    -quiet|-q Zeigen Sie keine Protokolle in der Standardausgabe an.
    -help|-h|-? Zeigen Sie detaillierte Nutzungsinformationen dieses Befehlszeilenprogramms an.

    Beispiele

    • Erstellen eines DTPROJ mit der zuerst definierten Projektdefinition, nicht mit Kennwort verschlüsselt:

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

    • Erstellen eines DTPROJ mit der Konfiguration „DevConfiguration“, mit einem Kennwort verschlüsselt, und Ausgeben der Buildartefakte in einem bestimmten Ordner:

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

    • Ein DTPROJ mit der Konfiguration „DevConfiguration“ erstellen, mit einem Kennwort verschlüsseln, seine vertraulichen Daten verbergen und Protokolliergrad DIAG anwenden:

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

    Parameter

    Parameter Beschreibung
    -source|-s:<source path> Lokaler Dateipfad der bereitzustellenden Artefakte ISPAC, DTSX, der Pfad des Ordners für DTSX und SSISDeploymentManifest sind zulässig.
    -destination|-d:<type>;<path>[;server] Zieltyp, Zielordnerpfad und Servername des SSIS-Katalogs, in den die Quelldatei bereitgestellt werden wird. Aktuell werden die folgenden zwei Zieltypen unterstützt:
  • CATALOG: Bereitstellen einer oder mehrerer ISPAC-Dateien im angegebenen SSIS-Katalog Der Pfad des CATALOG-Ziels sollte in diesem Format angegeben werden:
    /SSISDB/<Ordnername>[/<Projektname>]
    Der optionale <Projektname> ist nur gültig, wenn die Quelle einen einzelnen ISPAC-Dateipfad angibt. Als CATALOG-Ziel muss der Servername angegeben werden.
  • FILE: Bereitstellen von SSIS-Paketen oder -Dateien, die in einer einzelnen oder in mehreren SSISDeploymentManifest-Dateien angegeben sind, im angegebenen Pfad im Dateisystem Der Pfad des FILE-Ziels kann ein lokaler Ordnerpfad oder ein Netzwerkordnerpfad in einem solchen Format sein:
    \\<Computername>\<Ordnername>[\<Unterordnername>...]
    		•
    -authType|-at:<auth type name> Authentifizierungstyp für den Zugriff auf SQL Server. Für das CATALOG-Ziel zwingend erforderlich Folgende Typen werden unterstützt:
  • WIN: Windows-Authentifizierung
  • SQL: SQL Server-Authentifizierung
  • ADPWD: Active Directory – Kennwort
  • ADINT: Active Directory – Integriert
    		•
    -connectionStringSuffix|-css:<connection string suffix> Suffix der Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit dem SSIS-Katalog verwendet wird.
    -projectPassword|-pp:<project password> Kennwort zum Entschlüsseln der ISPAC- oder DTSX-Dateien.
    -username|-u:<username> Benutzername für den Zugriff auf den angegebenen SSIS-Katalog oder dateisystem. Für den Dateisystemzugriff ist ein Präfix mit dem Domänennamen zulässig.
    -password|-p:<password> Kennwort für den Zugriff auf den angegebenen SSIS-Katalog oder dateisystem.
    -log|-l:<Protokollebene>[;<Protokollpfad>] Protokolleinstellungen für die Ausführung dieses Hilfsprogramms
  • Protokollebene: Nur Protokolle mit gleicher oder höherer Protokollierungsebene werden in die Protokolldatei geschrieben. Es gibt vier Protokollierungsebenen (von niedrig bis hoch): DIAG, INFO, WRN, ERR. Ohne andere Angabe ist der Standardprotokolliergrad „INFO“.
  • Protokollpfad: Pfad der Datei zum Speichern von Protokollen. Die Protokolldatei wird nicht generiert, wenn der Pfad nicht angegeben ist.
    		•
    -quiet|-q Zeigen Sie keine Protokolle in der Standardausgabe an.
    -help|-h|-? Zeigen Sie detaillierte Nutzungsinformationen dieses Befehlszeilenprogramms an.

    Beispiele

    • Bereitstellen eine einzelnen ISPAC-Datei, nicht mit einem Kennwort verschlüsselt, im SSIS-Katalog mit Windows-Authentifizierung

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

    • Stellen Sie einen einzelnen ISPAC mit Kennwort im SSIS-Katalog mit SQL-Authentifizierung bereit, und benennen Sie den Projektnamen um.

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

    • Bereitstellen eines einzelnen SSISDeploymentManifest und der zugehörigen Dateien in einer Azure-Dateifreigabe

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

    • Stellen Sie einen Ordner mit DTSX-Dateien im lokalen Dateisystem bereit.

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

    Versionshinweise

    Version 1.0.0.0

    Veröffentlichungsdatum: 1. September 2021

    • Release zur allgemeinen Verfügbarkeit (GA)

    Version 0.1.3.1 Vorschau

    Veröffentlichungsdatum: 10. Juni 2021

    • Es wurde ein Problem behoben, bei dem SSISDeploy.exe keine SSIS-Projekte bereitstellen konnte und der Fehler „Unhandled Exception: System.IO.FileLoadException: Could not load file or assembly 'Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. („Ausnahmefehler: System.IO.FileLoadException: Die Datei oder Assembly 'Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' oder eine ihrer Abhängigkeiten konnte nicht geladen werden. Fehler bei der Überprüfung des starken Namens (Ausnahme von HRESULT: 0x8013141A) ---> System.Security.SecurityException: Fehler bei der Überprüfung des starken Namens (Ausnahme von HRESULT: 0x8013141A)".

    Version 0.1.3 Vorschau

    Veröffentlichungsdatum: 2. Juni 2021

    • Es wurde ein Problem behoben, bei dem mit SSISBuild.exe keine Projekte erstellt werden konnten und der Fehler „Fehler bei der Überprüfung der Projektkonsistenz. Die folgenden Inkonsistenzen wurden festgestellt:“ ausgegeben wurde, wenn der Paketname im Projekt Sonderzeichen enthielt.
    • Es wurde ein Problem behoben, bei dem mit SSISBUild.exe keine Projekte erstellt werden konnten, wenn der Name in dtproj und der Dateiname nicht übereinstimmen.
    • Es wurde ein Problem behoben, bei dem SSISBuild.exe keine Projekte mit der Schutzebene „encryptSensitiveWithPassword/EncryptAllWithPassword“ erstellen konnte, wenn das Projekt SQL Server 2016 als Ziel hat.

    Version 0.1.2 Vorschau

    Veröffentlichungsdatum: 14. Januar 2021

    • Es wurde ein Problem behoben, bei dem „SSISBuild.exe“ ein Projekt mit einer NullReference-Ausnahme nicht erstellen kann, wenn die Metadaten des Paketparameters in der SSIS-Projektdatei und dem SSIS-Paket nicht übereinstimmen.
    • Es wurde ein Problem behoben, bei dem das Paket nicht ausgeführt werden konnte, und die Fehlermeldung „Fehler beim Entschlüsseln des geschützten XML-Knotens“ ausgegeben wurde, obwohl das Paket erfolgreich mit „SSISDeploy.exe“ für SSISDB bereitgestellt werden konnte. Dabei enthält das SSIS-Projekt das Paket, das mit EncryptSensitiveWithUserKey verschlüsselt ist und CM mit vertraulichen Daten enthält.

    Version 0.1.1 Vorabversion

    Veröffentlichungsdatum: 11. November 2020

    • Es wurde ein Problem behoben, bei dem „SSISDeploy.exe“ bei der Bereitstellung von „ispac“ im SSIS-Katalog keine Assembly laden kann.

    Version 0.1.0 Vorschau

    Veröffentlichungsdatum: 16. Oktober 2020

    Erstes Previewrelease der eigenständigen SSIS-DevOps-Tools

    Nächste Schritte