nástroj dtexec

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Nástroj příkazového řádku dtexec slouží ke konfiguraci a spouštění balíčků služby SQL Server Integration Services. Nástroj dtexec poskytuje přístup ke všem funkcím konfigurace a spouštění balíčků, jako jsou parametry, připojení, vlastnosti, proměnné, protokolování a indikátory průběhu. Nástroj dtexec umožňuje načíst balíčky z těchto zdrojů: server integrační služby, soubor projektu .ispac, databáze Microsoft SQL Serveru, úložiště balíčků SSIS a systém souborů.

Poznámka:

Pokud použijete aktuální verzi nástroje dtexec ke spuštění balíčku vytvořeného starší verzí integrační služby, nástroj dočasně upgraduje balíček na aktuální formát balíčku. Nemůžete ale použít nástroj dtexec k uložení upgradovaného balíčku. Další informace o trvalém upgradu balíčku na aktuální verzi najdete v tématu Upgrade balíčků integračních služeb.

Toto téma obsahuje následující části:

• Server integračních služeb a soubor projektu

• Důležité informace o instalaci v 64bitových počítačích

• Důležité informace o počítačích s souběžnými instalacemi

• Fáze provádění

• Vrácené ukončovací kódy

• pravidel syntaxe

• Použití nástroje dtexec z xp_cmdshell

• Použití nástroje dtexec z bashe

• Syntaxe

• Parametry

• Poznámky

• Příklady

Server integračních služeb a soubor projektu

Při použití dtexec ke spouštění balíčků na serveru Integration Services dtexec volá catalog.create_execution (databáze SSISDB),catalog.set_execution_parameter_value (databáze SSISDB) a catalog.start_execution (databáze SSISDB) k vytvoření provádění, nastavení parametrů a zahájení provádění. Všechny výkonnostní logy lze zobrazit ze serveru v příslušných zobrazeních nebo pomocí standardních sestav dostupných v aplikaci SQL Server Management Studio. Další informace o sestavách najdete v tématu Sestavy pro server integračních služeb.

Následuje příklad spuštění balíčku na serveru integrační služby.

DTExec /ISSERVER "\SSISDB\folderB\Integration Services Project17\Package.dtsx" /SERVER "." /Envreference 2 /Par "$Project::ProjectParameter(Int32)";1 /Par "Parameter(Int32)";21 /Par "CM.sqlcldb2.SSIS_repro.InitialCatalog";ssisdb /Par "$ServerOption::SYNCHRONIZED(Boolean)";True  

Při použití dtexec ke spuštění balíčku ze souboru projektu .ispac jsou související možnosti: /Proj[ect] a /Pack[age], které slouží k určení cesty projektu a názvu datového proudu balíčku. Když převedete projekt na model nasazení projektu spuštěním Průvodce převodem projektu integrační služby z aplikace SQL Server Management Studio, průvodce vygeneruje soubor projektu .ispac. Další informace naleznete v tématu Nasazení projektů a balíčků SSIS (Integration Services).

Pomocí dtexec s nástroji pro plánování třetích stran můžete naplánovat balíčky nasazené na server integrační služby.

Důležité informace o instalaci v 64bitových počítačích

Na 64bitovém počítači služba Integration Services nainstaluje 64bitovou verzi nástroje dtexec (dtexec.exe). Pokud potřebujete spustit určité balíčky v 32bitovém režimu, musíte nainstalovat 32bitovou verzi nástroje dtexec . Chcete-li nainstalovat 32bitovou verzi nástroje dtexec , musíte během instalace vybrat buď klientské nástroje, nebo SQL Server Data Tools (SSDT).

Ve výchozím nastavení 64bitový počítač s 64bitovou i 32bitovou verzí nástroje příkazového řádku integrační služby spustí na příkazovém řádku 32bitovou verzi. 32bitová verze se spustí, protože cesta k adresáři pro 32bitovou verzi se zobrazí v proměnné prostředí PATH před cestou k adresáři pro 64bitovou verzi. (Typicky je 32bitová cesta adresáře <jednotka>:\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn, zatímco 64bitová cesta adresáře je <jednotka>:\Program Files\Microsoft SQL Server\110\DTS\Binn.)

Poznámka:

Pokud ke spuštění nástroje používáte agenta SQL Serveru, sql Server Agent automaticky používá 64bitovou verzi nástroje. Agent SQL Serveru používá registr, nikoli proměnnou prostředí PATH, k vyhledání správného spustitelného souboru pro nástroj.

Abyste měli jistotu, že na příkazovém řádku spustíte 64bitovou verzi nástroje, můžete provést jednu z následujících akcí:

• Otevřete okno příkazového řádku, přejděte do adresáře, který obsahuje 64bitovou verzi nástroje (<jednotka>:\Program Files\Microsoft SQL Server\110\DTS\Binn) a spusťte nástroj z tohoto umístění.

• V příkazovém řádku spusťte nástroj zadáním úplné cesty (<disk>:\Program Files\Microsoft SQL Server\110\DTS\Binn) k 64bitové verzi nástroje.

• Trvale změňte pořadí cest v proměnné prostředí PATH umístěním 64bitové cesty (<jednotka>:\Program Files\Microsoft SQL Server\110\DTS\Binn) před 32bitovou cestu (<jednotka>:\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) do proměnné.

Důležité informace o počítačích s souběžnými instalacemi

Když je SQL Server 2019 Integration Services (SSIS) nainstalovaný na počítači, na který je nainstalovaný SQL Server 2005 Integration Services (SSIS) nebo SQL Server 2008 Integration Services (SSIS), nainstaluje se několik verzí nástroje dtexec .

Abyste měli jistotu, že použijete správnou verzi nástroje, zadejte v příkazovém řádku úplnou cestu ke spuštění nástroje (<jednotka>:\Program Files\Microsoft SQL Server\<version>\DTS\Binn).

Fáze provádění

Nástroj má čtyři fáze, kterými pokračuje při provádění. Fáze jsou následující:

1. Fáze zdroje příkazů: Příkazový řádek přečte seznam možností a argumentů, které byly zadány. Pokud je zjištěna možnost /? nebo /HELP , všechny další fáze se přeskočí.

2. Fáze načtení balíčku: Načte se balíček určený parametrem /SQL, /FILE nebo /DTS .

3. Fáze konfigurace: Možnosti se zpracovávají v tomto pořadí:

   • Možnosti, které nastavují příznaky balíčku, proměnné a vlastnosti

   • Možnosti, které ověřují verzi balíčku a sestavení.

   • Možnosti, které konfigurují chování nástroje za běhu, například generování sestav.

4. Fáze ověření a spuštění: Balíček se spustí nebo ověří bez spuštění, pokud byla zadána možnost /VALIDATE .

Vrácené návratové kódy

Ukončovací kódy vrácené nástrojem dtexec

Při spuštění balíčku může dtexec vrátit ukončovací kód. Ukončovací kód se používá k naplnění proměnné ERRORLEVEL, jehož hodnotu je pak možné testovat v podmíněných příkazech nebo logikě větvení v dávkovém souboru. Následující tabulka uvádí hodnoty, které může nástroj dtexec nastavit při ukončení.

Hodnota	Popis
0	Balíček se úspěšně spustil.
1	Balíček se nezdařil.
3	Balíček zrušil uživatel.
4	Nástroj nemohl najít požadovaný balíček. Balíček nebyl nalezen.
5	Nástroj nemohl načíst požadovaný balíček. Balíček nelze načíst.
6	Program narazil na vnitřní chybu syntaktické nebo sémantické povahy v příkazovém řádku.

Pravidla syntaxe

Pravidla užitečné syntaxe

Všechny možnosti musí začínat lomítkem (/) nebo znaménkem minus (-). Zde zobrazené možnosti začínají lomítkem (/), ale znaménko minus (-) je možné nahradit.

Argument musí být uzavřený v uvozovkách, pokud obsahuje mezeru. Pokud argument není uzavřený do uvozovek, argument nemůže obsahovat prázdné znaky.

Dvojité uvozovky v uvozovkách představují uvozovky s jednoduchými uvozovkami.

Možnosti a argumenty nejsou citlivé na velikost písmen, s výjimkou hesel.

Použití nástroje dtexec z xp_cmdshell

Použití nástroje dtexec z xp_cmdshell

Příkaz dtexec můžete spustit z příkazové výzvy xp_cmdshell. Následující příklad ukazuje, jak spustit balíček s názvem UpsertData.dtsx a ignorovat návratový kód:

EXEC xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'  

Následující příklad ukazuje, jak spustit stejný balíček a zachytit návratový kód:

DECLARE @returncode int  
EXEC @returncode = xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'  

Důležité

V Microsoft SQL Serveru je možnost xp_cmdshell ve výchozím nastavení v nových instalacích zakázaná. Tuto možnost lze povolit spuštěním sp_configure systémové uložené procedury. Další informace naleznete v tématu xp_cmdshell Možnost konfigurace serveru.

Použití nástroje dtexec z bashe

Prostředí Bash je oblíbené prostředí pro Linux. Dá se použít i ve Windows. Příkaz dtexec můžete spustit z příkazového řádku Bash. Všimněte si, že středník (;) je operátor oddělovače příkazů v Bash. To je zvlášť důležité při předávání hodnot do balíčku pomocí /Conn[ection] možností nebo /Par[arameter] nebo/Set , protože používají středník k oddělení názvu a hodnoty zadané položky. Následující příklad ukazuje, jak správně escapovat středník a další znaky při použití Bashe a vložení hodnot do balíčku.

dtexec /F MyPackage.dtsx /CONN "MyConnection"\;"\"MyConnectionString\""

Syntaxe

dtexec /option [value] [/option [value]]...  

Parametry

• /? [option_name]: (volitelné). Zobrazí možnosti příkazového řádku nebo zobrazí nápovědu pro zadaný option_name a potom nástroj zavře.

  Pokud zadáte argument option_name , nástroj dtexec spustí sql Server Books Online a zobrazí téma nástroje dtexec.

• /Ca[llerInfo]: (volitelné). Určuje další informace pro spuštění balíčku. Když spustíte balíček pomocí agenta SQL Serveru, agent nastaví tento argument tak, aby indikoval, že spuštění balíčku je vyvoláno agentem SQL Serveru. Tento parametr je ignorován při spuštění nástroje dtexec z příkazového řádku.

• /CheckF[ile]filespec: (volitelné). Nastaví vlastnost CheckpointFileName v balíčku na cestu a soubor specifikovaný v filespec. Tento soubor se používá při restartování balíčku. Pokud je tato možnost zadána a pro název souboru není zadána žádná hodnota, CheckpointFileName balíčku se nastaví na prázdný řetězec. Pokud tato možnost není zadaná, hodnoty v balíčku se zachovají.

• /CheckP[ointing]{on\off} : (volitelné). Nastaví hodnotu, která určuje, zda balíček používá kontrolní body během provádění balíčku. Hodnota určuje , že se má znovu spustit neúspěšný balíček. Po opětovném spuštění neúspěšného balíčku modul runtime pomocí souboru kontrolního bodu restartuje balíček z bodu selhání.

  Výchozí hodnota je zapnutá, pokud je možnost deklarována bez hodnoty. Spuštění balíčku selže, pokud je hodnota nastavená na zapnutou a soubor kontrolního bodu nebyl nalezen. Pokud tato možnost není zadaná, hodnota nastavená v balíčku se zachová. Další informace naleznete v tématu Restartování balíčků pomocí kontrolních bodů.

  Možnost /CheckPointing u dtexec je ekvivalentní nastavení vlastnosti SaveCheckpoints balíčku na True a vlastnosti CheckpointUsage na Always.

• /Com[mandFile]filespec: (volitelné). Určuje možnosti příkazu, které se spouštějí pomocí dtexec. Soubor specifikovaný ve filespec se otevře a obsah souboru se načte, dokud se nedosáhne konce souboru (EOF). filespec je textový soubor. Argument filespec určuje název souboru a cestu k souboru příkazu, který se má přidružit ke spuštění balíčku.

• /Conf[igFile]filespec: (volitelné). Určuje konfigurační soubor pro extrahování hodnot. Pomocí této možnosti můžete nastavit konfiguraci za běhu, která se liší od konfigurace zadané v době návrhu balíčku. Do konfiguračního souboru XML můžete uložit různá nastavení konfigurace a potom nastavení před spuštěním balíčku načíst pomocí možnosti /ConfigFile .

  Možnost /ConfigFile můžete použít k načtení dalších konfigurací za běhu, které jste nezadali v době návrhu. Nelze však použít možnost /ConfigFile k nahrazení nakonfigurovaných hodnot, které jste zadali také v době návrhu. Informace o tom, jak se konfigurace balíčků používají, najdete v tématu Konfigurace balíčků.

• /Conn[ection]id_or_name;connection_string [[;id_or_name;connection_string]...]: (volitelné). Určuje, že správce připojení se zadaným názvem nebo identifikátorem GUID se nachází v balíčku a určuje připojovací řetězec.

  Tato možnost vyžaduje, aby byly zadány oba parametry: v argumentu id_or_name musí být zadán název správce připojení nebo identifikátor GUID a v argumentu connection_string musí být zadán platný připojovací řetězec. Další informace najdete v tématu Připojení služby SSIS (Integration Services).

  Za běhu můžete pomocí možnosti /Connection načíst konfigurace balíčků z jiného umístění než z umístění, které jste zadali v době návrhu. Hodnoty těchto konfigurací pak nahradí hodnoty, které byly původně zadány. Možnost /Connection ale můžete použít pouze pro konfigurace, jako jsou konfigurace SQL Serveru, které používají správce připojení. Informace o tom, jak se konfigurace balíčků používají, najdete v tématu Konfigurace balíčků a změny chování funkcí integračních služeb v SQL Serveru 2016.

• /Cons[oleLog] [[displayoptions];[ list_options; src_name_or_guid]...]: (volitelné). Zobrazí zadané položky protokolu do konzoly během provádění balíčku. Pokud tuto možnost vynecháte, v konzole se nezobrazí žádné položky protokolu. Pokud je tato možnost zadána bez parametrů, které omezují zobrazení, zobrazí se každá položka protokolu. Chcete-li omezit položky zobrazené v konzole, můžete určit sloupce, které se mají zobrazit pomocí parametru displayoptions , a omezit typy položek protokolu pomocí parametru list_options .

  Poznámka:

  Při spuštění balíčku na serveru integrační služby pomocí parametru /ISSERVER je výstup konzoly omezen a většina možností /Cons[oleLog] není použitelná. Všechny výkonnostní logy lze zobrazit ze serveru v příslušných zobrazeních nebo pomocí standardních sestav dostupných v aplikaci SQL Server Management Studio. Další informace o sestavách najdete v tématu Sestavy pro server integračních služeb.

  Hodnoty zobrazení jsou následující:

  • N (název)

  • C (počítač)

  • O (operátor)

  • S (název zdroje)

  • G (zdrojový identifikátor GUID)

  • X (identifikátor GUID provádění)

  • M (zpráva)

  • T (začátek a konec času)

  Hodnoty list_options jsou následující:

  • I – Určuje seznam zahrnutí. Protokolují se pouze zadané názvy zdrojů nebo identifikátory GUID.

  • E – Určuje seznam vyloučení. Zadané názvy zdrojů nebo identifikátory GUID nejsou zaprotokolovány.

  • Parametr src_name_or_guid zadaný pro zahrnutí nebo vyloučení je název události, název zdroje nebo identifikátor GUID zdroje.

  Pokud na stejném příkazovém řádku použijete více možností /ConsoleLog , interagují následujícím způsobem:

  • Jejich pořadí vzhledu nemá žádný vliv.

  • Pokud na příkazovém řádku nejsou žádné seznamy zahrnutí, použijí se seznamy vyloučení pro všechny druhy položek protokolu.

  • Pokud jsou na příkazovém řádku přítomny nějaké seznamy zahrnutí, použijí se seznamy vyloučení proti sjednocení všech seznamů zahrnutí.

  Několik příkladů možnosti /ConsoleLog naleznete v části Poznámky .

• /D[ts]package_path: (volitelné). Načte balíček z úložiště balíčků SSIS. Balíčky uložené v úložišti balíčků SSIS se nasazují pomocí modelu nasazení starší verze balíčku. Pokud chcete spouštět balíčky nasazené na server integračních služeb pomocí modelu nasazení projektu, použijte možnost /ISServer . Další informace o modelech nasazení balíčků a projektů najdete v tématu Nasazení projektů a balíčků.

  Argument package_path určuje relativní cestu balíčku SSIS počínaje kořenem úložiště balíčků SSIS a obsahuje název balíčku SSIS. Pokud cesta nebo název souboru zadaný v argumentu package_path obsahuje mezeru, je nutné zadat uvozovky kolem argumentu package_path .

  Možnost /DTS nelze použít společně s možností /File nebo /SQL . Pokud je zadáno více možností, příkaz dtexec selže.

• /De[crypt]password: (volitelné). Nastaví dešifrovací heslo, které se použije při načítání balíčku s šifrováním hesla.

• (Volitelné) Vytvoří ladicí výpisové soubory, .mdmp a .tmp, když dojde k jedné nebo několika zadaným událostem během běhu balíčku. Argument kódu chyby určuje typ chyby, upozornění nebo informací, které aktivují systém pro vytvoření souborů výpisu stavu ladění. Pokud chcete zadat více kódů událostí, oddělte každý argument kódu chyby středníkem (;). Nezahrnujte uvozovky s argumentem kódu chyby .

  Následující příklad vygeneruje soubory výpisu stavu ladění, když dojde k chybě DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER.

  /Dump 0xC020801C  
  

  /Dumpkód chyby: Služba Integration Services ve výchozím nastavení ukládá soubory výpisu ladění do složky <disku>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps.

  Poznámka:

  Soubory výpisu paměti ladění mohou obsahovat citlivé informace. Seznam řízení přístupu (ACL) slouží k omezení přístupu k souborům nebo kopírování souborů do složky s omezeným přístupem. Například před odesláním ladicích souborů do služeb podpory Microsoftu doporučujeme odebrat citlivé nebo důvěrné informace.

  Pokud chcete tuto možnost použít u všech balíčků, které nástroj dtexec spouští, přidejte do klíče registru HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath REG_SZ hodnotu DumpOnCodes . Hodnota dat v DumpOnCodes určuje kód chyby nebo kódy, které aktivují systém pro vytvoření souborů výpisu stavu ladění. Více kódů chyb musí být odděleno středníkem (;)).

  Pokud do klíče registru přidáte hodnotu DumpOnCodes a použijete možnost /Dump , systém vytvoří soubory s výpisem ladění založené na obou nastaveních.

  Další informace o ladění souborů výpisu paměti naleznete v tématu Generování souborů výpisu paměti pro spuštění balíčku.

• /DumpOnError: (Volitelné) Vytvoří ladicí výpisové soubory, .mdmp a .tmp, pokud dojde k jakékoli chybě při spuštění balíčku.

  Integrační služby standardně ukládají soubory výpisu stavu ladění do složky <disk>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps.

  Poznámka:

  Soubory výpisu paměti ladění mohou obsahovat citlivé informace. Seznam řízení přístupu (ACL) slouží k omezení přístupu k souborům nebo kopírování souborů do složky s omezeným přístupem. Například před odesláním ladicích souborů do služeb podpory Microsoftu doporučujeme odebrat citlivé nebo důvěrné informace.

  Pokud chcete tuto možnost použít u všech balíčků, které nástroj dtexec spouští, přidejte do klíče registru HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath hodnotu DumpOnError REG_DWORD. Hodnota dumpOnError REG_DWORD určuje, zda se má možnost /DumpOnError použít s nástrojem dtexec :

  • Nenulová datová hodnota označuje, že systém vytváří soubory výpisu ladění, pokud dojde k jakékoli chybě, bez ohledu na to, jestli používáte možnost /DumpOnError s nástrojem dtexec .

  • Nulová datová hodnota značí, že systém nevytvoří soubory výpisu ladění, pokud nepoužíváte možnost /DumpOnError s nástrojem dtexec .

  Další informace o ladění souborů výpisu paměti naleznete v tématu Generování souborů výpisu paměti pro spuštění balíčku.

• /Env[Reference]ID odkazu na prostředí: (volitelné). Určuje odkaz na prostředí (ID), který je používán spuštěním balíčku pro balíček, který je nasazen na server integrační služby. Parametry nakonfigurované tak, aby se svážely s proměnnými, používají hodnoty proměnných obsažených v prostředí.

  Možnost /Env[Reference] použijete společně s možnostmi /ISServer a /Server .

  Tento parametr používá agent SQL Serveru.
  -- /F[ile]filespec: (volitelné). Načte balíček uložený v systému souborů. Balíčky uložené v systému souborů se nasazují pomocí modelu nasazení starší verze balíčku. Pokud chcete spouštět balíčky nasazené na server integračních služeb pomocí modelu nasazení projektu, použijte možnost /ISServer . Další informace o modelech nasazení balíčků a projektů najdete v tématu Nasazení projektů a balíčků.

Argument filespec určuje cestu a název souboru balíčku. Cestu můžete zadat buď jako cestu UNC (Universal Naming Convention), nebo jako místní cestu. Pokud cesta nebo název souboru zadaný v argumentu filespec obsahuje mezeru, je nutné zadat uvozovky kolem argumentu filespec .

• Možnost /Soubor nelze použít společně s možností /DTS nebo /SQL . Pokud je zadáno více možností, příkaz dtexec selže.

• /H[elp] [option_name]: (volitelné). Zobrazí nápovědu k možnostem nebo zobrazí nápovědu pro zadaný option_name a nástroj zavře.

  Pokud zadáte argument option_name , nástroj dtexec spustí sql Server Books Online a zobrazí téma nástroje dtexec.

• /ISServerpackagepath: (volitelné). Spustí balíček nasazený na server integrační služby. Argument PackagePath určuje úplnou cestu a název souboru balíčku nasazeného na server integrační služby. Pokud cesta nebo název souboru zadaný v argumentu PackagePath obsahuje mezeru, je nutné zadat uvozovky kolem argumentu PackagePath .

  Formát balíčku je následující:

  \<catalog name>\<folder name>\<project name>\package file name  
  

  Možnost /Server použijete společně s možností /ISSERVER . Balíček na serveru SSIS může spustit pouze ověřování pomocí Windows. Aktuální uživatel Systému Windows se používá pro přístup k balíčku. Pokud parametr /Server vynecháte, předpokládá se výchozí místní instance SQL Serveru.

  Možnost /ISSERVER nelze použít společně s možností /DTS, /SQL nebo /File . Pokud je zadáno více možností, příkaz dtexec selže.

  Tento parametr používá agent SQL Serveru.

• /L[ogger]classid_orprogid; configstring: (volitelné). Přidruží jednoho nebo více poskytovatelů protokolování ke spuštění balíčku SSIS. Parametr classid_orprogid určuje zprostředkovatele protokolu a lze jej zadat jako identifikátor GUID třídy. Konfigurační řetězec je řetězec, který slouží ke konfiguraci zprostředkovatele protokolování.

  V následujícím seznamu jsou uvedeni dostupní poskytovatelé protokolů:

  • Textový soubor:

    • ProgID: DTS. LogProviderTextFile.1

    • ID třídy: {59B2C6A5-663F-4C20-8863-C83F9B72E2EB}

  • SQL Server Profiler:

    • ProgID: DTS. LogProviderSQLProfiler.1

    • ID třídy: {5C0B8D21-E9AA-462E-BA34-30FF5F7A42A1}

  • SQL Server:

    • ProgID: DTS. LogProviderSQLServer.1

    • ID třídy: {6AA833A1-E4B2-4431-831B-DE695049DC61}

  • Protokol událostí systému Windows:

    • ProgID: DTS. LogProviderEventLog.1

    • Identifikátor třídy: {97634F75-1DC7-4F1F-8A4C-DAF0E13AAA22}

  • Soubor XML:

    • ProgID: DTS. LogProviderXMLFile.1

    • ID třídy: {AFED6884-619C-484F-9A09-F42D56E1A7EA}

• /M[axConcurrent]concurrent_executables: (volitelné). Určuje počet spustitelných souborů, které může balíček spustit souběžně. Zadaná hodnota musí být buď nezáporné celé číslo, nebo -1. Hodnota -1 znamená, že služba SSIS umožní maximální počet souběžně spuštěných spustitelných souborů, které se rovnají celkovému počtu procesorů v počítači, který balíček spouští, plus dvě.

• /Pack[age]PackageName: (volitelné). Určuje balíček, který se spustí. Tento parametr se používá především při spuštění balíčku ze sady Visual Studio.

• /P[assword]password: (volitelné). Umožňuje načtení balíčku chráněného ověřováním SQL Serveru. Tato možnost se používá společně s možností /User . Pokud parametr /Password vynecháte a použije se možnost /User , použije se prázdné heslo. Hodnota hesla může být citována.

  Důležité

  Pokud je to možné, použijte ověřování systému Windows.

• /Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: (volitelné). Určuje hodnoty parametrů. Je možné zadat více možností parametru /parameter . Datové typy jsou CLR TypeCodes jako řetězce. U parametru bez řetězce je datový typ zadán v závorkách za názvem parametru.

  Možnost /Parameter lze použít pouze s parametrem /ISServer .

  Pomocí předpon $Package, $Project a $ServerOption označíte parametr balíčku, parametr projektu a parametr možnosti serveru. Výchozí typ parametru je balíček.

  Následuje příklad spuštění balíčku a poskytnutí hodnoty myvalue pro parametr projektu (myparam) a celočíselné hodnoty 12 pro parametr balíčku (anotherparam).

  Dtexec /isserver "SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "." /parameter $Project::myparam;myvalue /parameter anotherparam(int32);12

  Vlastnosti správce připojení můžete také nastavit pomocí parametrů. K označení parametru správce připojení použijete předponu CM.

  V následujícím příkladu je vlastnost InitialCatalog správce připojení SourceServer nastavena na ssisdb.

  /parameter CM.SourceServer.InitialCatalog;ssisdb  
  

  V následujícím příkladu je vlastnost ServerName manažera připojení SourceServer nastavena na tečku (.), která označuje místní server.

  /parameter CM.SourceServer.ServerName;.  
  

• /Proj[ect]ProjectFile: (volitelné). Určuje projekt, ze kterého se má načíst spuštěný balíček. Argument ProjectFile určuje název souboru .ispac. Tento parametr se používá především při spuštění balíčku ze sady Visual Studio.

• /Remcomment: (Volitelné). Obsahuje komentáře na příkazovém řádku nebo v souborech příkazů. Argument je nepovinný. Hodnota komentáře je řetězec, který musí být uzavřen v uvozovkách nebo nesmí obsahovat prázdné znaky. Pokud není zadán žádný argument, vloží se prázdný řádek. hodnoty komentářů se ignorují během fáze načítání příkazů.

• /Rep[orting]úroveň [; event_guid_or_name[; event_guid_or_name[...]]: (volitelné). Určuje, jaké druhy zpráv mají být hlášeny. Dostupné možnosti reportování pro úroveň jsou následující:

  N Žádné hlášení.

  Oznamují se chyby E.

  Jsou hlášena upozornění.

  Jsou hlášeny informační zprávy.

  Jsou hlášeny vlastní události jazyka C.

  P průběh je hlášen.

  Podrobné hlášení.

  Argumenty V a N se vzájemně vylučují pro všechny ostatní argumenty; musí být zadány samostatně. Pokud není zadaná možnost /Reporting , výchozí úroveň je E (chyby), W (upozornění) a P (průběh).

  Všem událostem předchází časové razítko ve formátu "YY/MM/DD HH:MM:SS" a GUID nebo srozumitelný název, pokud je k dispozici.

  Volitelný parametr event_guid_or_name je seznam výjimek pro poskytovatele záznamů. Výjimka určuje události, které nejsou zaprotokolovány, jinak by mohly být zaprotokolovány.

  Událost nemusíte vyloučit, pokud událost není obvykle zaprotokolována ve výchozím nastavení.

• /Res[tart] {deny | force | ifPossible}: (volitelné). Určuje novou hodnotu vlastnosti CheckpointUsage v balíčku. Významy parametrů jsou následující:

  Popřít Nastaví CheckpointUsage vlastnost na DTSCU_NEVER.

  Síla Nastaví CheckpointUsage vlastnost na DTSCU_ALWAYS.

  ifPossible Nastaví CheckpointUsage vlastnost na DTSCU_IFEXISTS.

  Výchozí hodnota force se použije, pokud není zadána žádná hodnota.

• /Set [$Sensitive::]propertyPath; hodnota: (volitelné). Přepíše konfiguraci parametru, proměnné, vlastnosti, kontejneru, zprostředkovatele protokolu, enumerátoru Foreach nebo připojení v rámci balíčku. Při použití této možnosti /Set změní argument vlastnostPath na zadanou hodnotu. Lze zadat více možností /Set .

  Kromě použití možnosti /Set s možností /F[ile] můžete také použít možnost /Set s možností /ISServer nebo parametrem /Project . Při použití /Set s /Project, /Set nastaví hodnoty parametrů. Při použití /Set s /ISServer, /Set nastavuje přepsání vlastností. Kromě toho, když použijete /Set s /ISServer, můžete použít volitelnou předponu $Sensitive k označení, že vlastnost by měla být považována za citlivou na serveru integrační služby.

  Hodnotu vlastnostiPath můžete určit spuštěním Průvodce konfigurací balíčku. Cesty pro vybrané položky se zobrazí na poslední stránce Dokončení průvodce a lze je zkopírovat a vložit. Pokud jste průvodce použili pouze pro tento účel, můžete průvodce po zkopírování cest zrušit.

  Následuje příklad spuštění balíčku uloženého v systému souborů a poskytnutí nové hodnoty proměnné:

  dtexec /f mypackage.dtsx /set \package.variables[myvariable].Value;myvalue

  Následující příklad spuštění balíčku ze souboru projektu .ispac a nastavení parametrů balíčku a projektu.

  /Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1

  Pomocí možnosti /Set můžete změnit umístění, ze kterého se načítají konfigurace balíčků. Možnost /Set ale nemůžete použít k přepsání hodnoty určené konfigurací v době návrhu. Informace o tom, jak se konfigurace balíčků používají, najdete v tématu Konfigurace balíčků a změny chování funkcí integračních služeb v SQL Serveru 2016.

• /Ser[ver]server: (volitelné). Pokud je zadána možnost /SQL nebo /DTS , tato možnost určuje název serveru, ze kterého se má balíček načíst. Pokud vynecháte možnost /Server a je zadána možnost /SQL nebo /DTS , spuštění balíčku se pokusí proti místnímu serveru. Hodnota server_instance může být uvozována.

  Možnost /Ser[ver] je vyžadována, pokud je zadána možnost /ISServer .

• /SQ[L]package_path: Načte balíček uložený na SQL Serveru v databázi msdb . Balíčky uložené v databázi msdb se nasazují pomocí modelu nasazení balíčku. Pokud chcete spouštět balíčky nasazené na server integračních služeb pomocí modelu nasazení projektu, použijte možnost /ISServer . Další informace o modelech nasazení balíčků a projektů najdete v tématu Nasazení projektů a balíčků.

• Argument package_path určuje název balíčku, který se má načíst. Pokud jsou složky zahrnuté v cestě, jsou ukončeny zpětnými lomítky ("\"). Hodnotu package_path lze uvozovat. Pokud cesta nebo název souboru zadaný v argumentu package_path obsahuje mezeru, je nutné zadat uvozovky kolem argumentu package_path .

  Možnosti /User, /Password a /Server můžete použít společně s možností /SQL .

  Pokud vynecháte možnost /User , ověřování systému Windows se použije pro přístup k balíčku. Pokud použijete možnost /User , zadané přihlašovací jméno /Uživatel je přidruženo k ověřování SYSTÉMU SQL Server.

  Možnost /Heslo se používá pouze společně s možností /User . Pokud použijete možnost /Password , bude se k balíčku přistupovat s uživatelským jménem a zadanými informacemi o hesle. Pokud vynecháte možnost /Password , použije se prázdné heslo.

  Důležité

  Pokud je to možné, použijte ověřování systému Windows.

• Pokud parametr /Server vynecháte, předpokládá se výchozí místní instance SQL Serveru.

  Možnost /SQL nelze použít společně s možností /DTS nebo /File . Pokud je zadáno více možností, příkaz dtexec selže.

• /Su[m]: (volitelné). Zobrazuje přírůstkový čítač obsahující počet řádků, které budou přijaty další komponentou.

• /U[ser]user_name: (volitelné). Umožňuje načtení balíčku chráněného ověřováním SQL Serveru. Tato možnost se používá pouze v případě, že je zadána možnost /SQL . Hodnotu user_name lze uvozovat.

  Důležité

  Pokud je to možné, použijte ověřování systému Windows.

• /Va[lidate]: (volitelné). Zastaví spuštění balíčku po fázi ověření bez skutečného spuštění balíčku. Při ověřování použití parametru /WarnAsError způsobí dtexec považovat upozornění za chybu; balíček proto selže, pokud během ověřování dojde k upozornění.

• /VerifyB[uild]major[; minor[; build]]: (volitelné). Ověří číslo sestavení balíčku ve srovnání s čísly sestavení zadanými v průběhu ověřování v argumentech hlavní, vedlejší a sestavení. Pokud dojde k neshodě, balíček se nespustí.

  Hodnoty jsou dlouhá celá čísla. Argument může mít jednu ze tří forem, přičemž hodnota pro major je vždy povinná.

  • hlavní

  • major; moll

  • major; menší; vybudovat

• /VerifyP[ackageID]packageID: (volitelné). Ověří identifikátor GUID balíčku, který má být proveden, porovnáním s hodnotou zadanou v argumentu package_id .

• /VerifyS[igned]: (volitelné). Způsobí, že integrační služby zkontrolují digitální podpis balíčku. Pokud balíček není podepsaný nebo podpis není platný, balíček selže. Další informace najdete v tématu Identifikace zdroje balíčků s digitálními podpisy.

  Důležité

  Pokud je nakonfigurovaná kontrola podpisu balíčku, integrační služby zkontrolují, jestli je digitální podpis k dispozici, je platný a pochází z důvěryhodného zdroje. Integrační služby nekontrolují, jestli se balíček změnil.

  Poznámka:

  Volitelná hodnota registru BlockedSignatureStates může určit nastavení, které je více omezující než možnost digitálního podpisu nastavená v SQL Server Data Tools (SSDT) nebo na příkazovém řádku dtexec . V takovém případě více omezující nastavení registru přepíše ostatní nastavení.

• /VerifyV[ersionID]versionID: (volitelné). Ověří identifikátor GUID verze balíčku, který se má spustit, porovnáním s hodnotou zadanou v argumentu version_id během fáze ověření balíčku.

• /VLog[Filespec]: (volitelné). Zapíše všechny události balíčku integrační služby do zprostředkovatelů protokolů, které byly povoleny při návrhu balíčku. Pokud chcete, aby služba Integration Services povolila zprostředkovatele protokolu pro textové soubory a zapisovala události protokolu do zadaného textového souboru, zadejte jako parametr Filespec cestu a název souboru.

  Pokud parametr Filespec nezadáte, Integrační Služby pro textové soubory nepovolí poskytovatele protokolů. Integrační služby zapisují události protokolu pouze poskytovatelům protokolů, kteří byli povoleni při návrhu balíčku.

• /W[arnAsError]: (volitelné). Způsobí, že balíček považuje upozornění za chybu; balíček proto selže, pokud během ověřování dojde k upozornění. Pokud během ověřování nedojde k žádným upozorněním a není zadána možnost /Validate , balíček se spustí.

• /X86: (volitelné). Způsobí, že agent SQL Serveru spustí balíček v 32bitovém režimu na 64bitovém počítači. Tato možnost je nastavena agentem SQL Serveru, pokud jsou splněny následující podmínky:

  • Typ kroku úlohy je balíček služby SQL Server Integration Services.

  • Je vybrána možnost Použít 32bitový modul runtime na kartě Možnosti spuštění dialogového okna Nový krok úlohy .

  Tuto možnost můžete také nastavit pro krok úlohy agenta SQL Serveru pomocí uložených procedur nebo objektů SMO (SQL Server Management Objects) k programovému vytvoření úlohy.

  Tuto možnost používá pouze agent SQL Serveru. Tato možnost se ignoruje, pokud spustíte nástroj dtexec na příkazovém řádku.

Poznámky

Pořadí, ve kterém zadáte možnosti příkazu, může ovlivnit způsob, jakým se balíček spouští:

• Možnosti se zpracovávají v pořadí, v jakém jsou na příkazovém řádku zjištěny. Soubory příkazů se čtou, jakmile jsou nalezeny na příkazovém řádku. Příkazy v souboru příkazu se také zpracovávají v pořadí, v jakém jsou zjištěny.

• Pokud se stejná možnost, parametr nebo proměnná zobrazí ve stejném příkazu příkazového řádku vícekrát, má přednost poslední instance možnosti.

• Možnosti /Set a /ConfigFile se zpracovávají v pořadí, v jakém jsou zjištěny.

Příklady

Následující příklady ukazují, jak pomocí nástroje příkazového řádku dtexec konfigurovat a spouštět balíčky služby SQL Server Integration Services.

Spouštění balíčků

Pokud chcete spustit balíček SSIS uložený na SQL Serveru pomocí ověřování systému Windows, použijte následující kód:

dtexec /sq pkgOne /ser productionServer  

Pokud chcete spustit balíček SSIS uložený ve složce Systému souborů v úložišti balíčků SSIS, použijte následující kód:

dtexec /dts "\File System\MyPackage"  

Pokud chcete ověřit balíček, který používá ověřování systému Windows a je uložen v SQL Serveru bez spuštění balíčku, použijte následující kód:

dtexec /sq pkgOne /ser productionServer /va  

Pokud chcete spustit balíček SSIS uložený v systému souborů, použijte následující kód:

dtexec /f "c:\pkgOne.dtsx"   

Pokud chcete spustit balíček SSIS uložený v systému souborů a zadat možnosti protokolování, použijte následující kód:

dtexec /f "c:\pkgOne.dtsx" /l "DTS.LogProviderTextFile;c:\log.txt"  

Pokud chcete spustit balíček, který používá ověřování systému Windows a uloží se do výchozí místní instance SQL Serveru, a před spuštěním ověřte verzi, použijte následující kód:

dtexec /sq pkgOne /verifyv {c200e360-38c5-11c5-11ce-ae62-08002b2b79ef}  

Pokud chcete spustit balíček SSIS uložený v systému souborů a konfigurovaný externě, použijte následující kód:

dtexec /f "c:\pkgOne.dtsx" /conf "c:\pkgOneConfig.cfg"  

Poznámka:

Argumenty package_path nebo filepec parametrů /SQL, /DTS nebo /FILE musí být uzavřeny do uvozovek, pokud cesta nebo název souboru obsahuje mezeru. Pokud argument není uzavřený do uvozovek, argument nemůže obsahovat prázdné znaky.

Možnost protokolování

Pokud existují tři typy položek protokolu A, B a C, zobrazí následující možnost ConsoleLog bez parametru všechny tři typy protokolů se všemi poli:

/CONSOLELOG  

Následující možnost zobrazí všechny typy protokolů, ale pouze se sloupci Název a Zpráva:

/CONSOLELOG NM  

Následující možnost zobrazí všechny sloupce, ale jenom pro typ položky protokolu A:

/CONSOLELOG I;LogEntryTypeA  

Následující možnost zobrazí pouze typ položky protokolu A se sloupci Název a Zpráva:

/CONSOLELOG NM;I;LogEntryTypeA  

Následující možnost zobrazí položky protokolu pro typy položek protokolu A a B:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB  

Stejné výsledky můžete dosáhnout pomocí několika možností ConsoleLogu :

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB  

Pokud se používá možnost ConsoleLog bez parametrů, zobrazí se všechna pole. Zahrnutí parametru list_options způsobí, že se u všech polí zobrazí pouze typ položky protokolu A:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG  

Zobrazí se všechny položky protokolu s výjimkou položky protokolu A: to znamená, že zobrazí typy položek protokolu B a C:

/CONSOLELOG E;LogEntryTypeA  

Následující příklad dosáhne stejných výsledků pomocí více možností ConsoleLogu a jednoho vyloučení:

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG  
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG E;LogEntryTypeA  
/CONSOLELOG E;LogEntryTypeA;LogEntryTypeA  

Následující příklad nezobrazuje žádné zprávy protokolu, protože když se v zahrnutých i vyloučených seznamech najde typ souboru protokolu, bude vyloučen.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA  

Možnost SET

Následující příklad ukazuje, jak použít možnost /SET , která umožňuje změnit hodnotu jakékoli vlastnosti balíčku nebo proměnné při spuštění balíčku z příkazového řádku.

/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue  

Možnost projektu

Následující příklad ukazuje, jak použít /Project a možnost /Package .

/Project c:\project.ispac /Package Package1.dtsx  

Následující příklad ukazuje, jak používat možnosti /Project a /Package a nastavit parametry balíčku a projektu.

/Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1  
  

Možnost ISServer

Následující příklad ukazuje, jak použít /ISServer možnost.

dtexec /isserver "\SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "."  

Následující příklad ukazuje, jak použít /ISServer možnost a nastavit parametry projektu a správce připojení.

/Server localhost /ISServer "\SSISDB\MyFolder\Integration Services Project1\Package.dtsx" /Par "$Project::ProjectParameter(Int32)";1 /Par "CM.SourceServer.InitialCatalog";SourceDB