Samostatné nástroje SQL Server Integration Service (SSIS) pro DevOps

Samostatné SSIS DevOps Tools poskytují sadu spustitelných souborů pro úlohy SSIS CICD. Bez závislosti na instalaci sady Visual Studio nebo modulu runtime SSIS je možné tyto spustitelné soubory snadno integrovat s libovolnou platformou CICD. Zadané spustitelné soubory jsou:

  • SSISBuild.exe: Sestavujte projekty SSIS pomocí modelu nasazení projektu nebo modelu nasazení balíčku.
  • SSISDeploy.exe: Nasaďte soubory ISPAC do katalogu SSIS nebo soubory DTSX a jejich závislosti do systému souborů.

Instalace

Vyžaduje se rozhraní .NET Framework 4.6.2 nebo vyšší.

Stáhněte si nejnovější instalační program z webu download center. K dispozici je také přímý odkaz ke stažení pro automatizační skript.

Pak proveďte instalaci pomocí průvodce nebo příkazového řádku.

  • Instalace prostřednictvím průvodce

Poklikejte na soubor .exe, který chcete nainstalovat, a zadejte složku pro extrahování spustitelných souborů a souborů závislostí.

umístění instalace

  • Instalace přes příkazový řádek
SSISDevOpsTools.exe /Q /C /T:<full path>

instalační příkazový řádek

SSISBuild.exe

syntaxe

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

parametrů

Parametr Popis
-project |-p:<cesta k souboru dtproj> Cesta k souboru dtproj, který má být sestaven.
-configuration|-c:<název konfigurace> Název konfigurace projektu, která se má použít pro sestavení. Pokud není zadáno, nastaví se ve výchozím nastavení první definovaná konfigurace projektu v souboru dtproj.
-projectPassword|-pp:<heslo projektu> Heslo projektu SSIS a jeho balíčků Tento argument je platný pouze v případě, že úroveň ochrany projektu SSIS a balíčků je EncryptSensitiveWithPassword nebo EncryptAllWithPassword. V případě modelu nasazení balíčku musí všechny balíčky sdílet stejné heslo určené tímto argumentem.
-stripSensitive|-ss Převeďte úroveň ochrany projektu SSIS na DontSaveSensitive. Pokud je úroveň ochrany EncryptSensitiveWithPassword nebo EncryptAllWithPassword, musí být argument -projectPassword správně nastaven. Tato možnost je platná pouze pro model nasazení projektu.
-output|-o:<výstupní cesta> Výstupní cesta artefaktu sestavení Hodnota tohoto argumentu přepíše výchozí výstupní cestu v konfiguraci projektu.
-log|-l:<úroveň protokolu>[; cesta k protokolu<>] Nastavení související s logy
  • úroveň protokolu: Do souboru protokolu se zapíšou pouze protokoly se stejnou nebo vyšší úrovní protokolování. Existují čtyři úrovně protokolování (od nízkého po vysoké): DIAG, INFO, WRN, ERR. Výchozí úroveň protokolování je INFO, pokud není zadána.
  • cesta k logu: Cesta k souboru pro ukládání logů. Pokud není zadaná cesta, soubor protokolu se negeneruje.
    		•
    -quiet|-q Nezobrazujte žádné protokoly do standardního výstupu.
    -pomoc|-h|-? Zobrazí podrobné informace o využití tohoto nástroje příkazového řádku.

    Příklady

    • Sestavte dtproj s první definovanou konfigurací projektu, nešifrovanou heslem:

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

    • Sestavte dtproj s konfigurací "DevConfiguration", zašifrujte jej pomocí hesla a uložte artefakty sestavení do konkrétní složky.

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

    • Sestavte dtproj s konfigurací DevConfiguration, zašifrujte pomocí hesla, odstraňte citlivá data a diagnostiku na úrovni protokolu:

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

    SSISDeploy.exe

    syntaxe

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

    parametrů

    Parametr Popis
    -source|-s:<zdrojová cesta> Místní cesta k souborům artefaktů, které se mají nasadit. Je povolené použití ISPAC, DTSX, cesta ke složce pro DTSX a SSISDeploymentManifest.
    -destination|-d:<typ>;<cesta>[;server] Cílový typ, cesta cílové složky a název serveru katalogu SSIS, do kterého se zdrojový soubor nasadí. V současné době podporujeme následující dva cílové typy:
  • katalog: nasaďte do zadaného katalogu SSIS jeden nebo více souborů ISPAC. Cesta cíle KATALOGU by měla být v takovém formátu:
    /SSISDB/<název složky>[/ název projektu<>]
    Volitelný název projektu <> je platný pouze v případě, že zdroj určuje jednu cestu k souboru ISPAC. Název serveru musí být zadán pro umístění KATALOGU.
  • FILE: Nasaďte balíčky nebo soubory SSIS zadané v jednom nebo několika souborech SSISDeploymentManifest do zadané cesty systému souborů. Cesta cíle FILE může být cesta k místní složce nebo cesta k síťové složce v takovém formátu:
    \\<název počítače>\<název složky>[\<název podsložky>...]
    		•
    -authType|-at:<název typu ověřování> Typ ověřování pro přístup k SQL Serveru Povinné pro destinaci KATALOG. Podporují se následující typy:
  • WIN: Ověřování systému Windows
  • SQL: Ověřování SQL Serveru
  • ADPWD: Active Directory – heslo
  • ADINT: Active Directory – integrované
    		•
    -connectionStringSuffix|-css:<přípona připojovacího řetězce> Přípona připojovacího řetězce, který se používá pro připojení k katalogu SSIS.
    -projectPassword|-pp:<heslo projektu> Heslo k dešifrování souborů ISPAC nebo DTSX
    -username|-u:<uživatelské jméno> Uživatelské jméno pro přístup k zadanému katalogu SSIS nebo systému souborů. Pro přístup k systému souborů je povolena předpona s názvem domény.
    -password|-p:<heslo> Heslo pro přístup k zadanému katalogu SSIS nebo systému souborů.
    -log|-l:<úroveň protokolu>[; cesta k protokolu<>] Nastavení protokolování pro spuštění tohoto nástroje
  • úroveň protokolu: Do souboru protokolu se zapíšou pouze protokoly se stejnou nebo vyšší úrovní protokolování. Existují čtyři úrovně protokolování (od nízkého po vysoké): DIAG, INFO, WRN, ERR. Výchozí úroveň protokolování je INFO, pokud není zadána.
  • cesta k logu: Cesta k souboru pro ukládání logů. Pokud není zadaná cesta, soubor protokolu se negeneruje.
    		•
    -quiet|-q Nezobrazujte protokoly do standardního výstupu.
    -pomoc|-h|-? Zobrazí podrobné informace o využití tohoto nástroje příkazového řádku.

    Příklady

    • Nasaďte jeden soubor ISPAC nešifrovaný heslem do katalogu SSIS s ověřováním systému Windows.

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

    • Nasaďte jeden soubor ISPAC zašifrovaný heslem do katalogu SSIS s ověřováním SQL a přejmenujte název projektu.

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

    • Nasaďte jeden soubor SSISDeploymentManifest a jeho přidružené soubory do sdílené složky Azure.

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

    • Nasaďte složku souborů DTSX do místního systému souborů.

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

    Poznámky k vydání

    Verze 1.0.0.0

    Datum vydání: 1. září 2021

    • Vydání obecné dostupnosti (GA).

    Verze 0.1.3.1 Preview

    Datum vydání: 10. června 2021

    • Opravili jsme problém, kdy se projektu SSISDeploy.exe nepodařilo nasadit projekty SSIS s chybou "Neošetřená výjimka: System.IO.FileLoadException: Nelze načíst soubor nebo sestavení 'Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' nebo některou z jejích závislostí." Ověření silného názvu se nezdařilo. (Výjimka z HRESULT: 0x8013141A) ---> System.Security.SecurityException: Ověření silného jména selhalo. (Výjimka z HRESULT: 0x8013141A)".

    Verze 0.1.3 Předběžná verze

    Datum vydání: 2. června 2021

    • Opravili jsme problém, kvůli kterému se SSISBuild.exe nepodařilo sestavit projekty s chybou "Kontrola konzistence projektu se nezdařila." Když název balíčku v projektu obsahuje speciální znaky, byly zjištěny následující nekonzistence.
    • Opravili jsme problém, kdy se SSISBUild.exe nepodařilo sestavit projekty při neshodě mezi názvem v dtproj a názvem souboru.
    • Opravili jsme problém, kvůli kterému se SSISBuild.exe nedařilo sestavit projekty s úrovní ochrany encryptSensitiveWithPassword/EncryptAllWithPassword, když projekty cílovaly na SQL Server 2016.

    Verze 0.1.2 Preview

    Datum vydání: 14. ledna 2021

    • Opravili jsme problém, který SSISBuild.exe se nepovedlo sestavit projekt s výjimkou NullReference, když metadata parametrů balíčku v souboru projektu SSIS a neshody balíčků SSIS.
    • Opravili jsme problém, kvůli kterému se nepodařilo spustit balíček s chybovou zprávou začínající na "Failed to decrypt protected XML node" ("Nepodařilo se dešifrovat chráněný uzel XML"), i když byl balíček úspěšně nasazen do SSISDB s SSISDeploy.exe. K tomu dochází, když je projekt SSIS obsahující balíček zašifrovaný pomocí EncryptSensitiveWithUserKey a balíček obsahuje CM s citlivými daty.

    Verze 0.1.1 Preview

    Datum vydání: 11. listopadu 2020

    • Opravili jsme problém, kdy SSISDeploy.exe nenačetl sestavení při nasazování souboru ispac do katalogu SSIS.

    Verze 0.1.0 Preview

    Datum vydání: 16. října 2020

    Počáteční verze preview nástrojů SSIS DevOps pro samostatné použití.

    Další kroky

    • Získejte samostatné nástroje SSIS DevOps
    • Pokud máte dotazy, navštivte Q&A
    • Last updated on