dtexec segédprogram

A következőkre vonatkozik:SQL Server SSIS integrációs futtatókörnyezet az Azure Data Factory-ban

A dtexec parancssori segédprogram az SQL Server Integration Services-csomagok konfigurálására és végrehajtására szolgál. A dtexec segédprogram hozzáférést biztosít az összes csomagkonfigurációs és végrehajtási funkcióhoz, például paraméterekhez, kapcsolatokhoz, tulajdonságokhoz, változókhoz, naplózáshoz és folyamatjelzőkhöz. A dtexec segédprogram lehetővé teszi a csomagok betöltését ezekből a forrásokból: az Integration Services-kiszolgálóról, egy .ispac projektfájlból, egy Microsoft SQL Server-adatbázisból, az SSIS-csomagtárolóból és a fájlrendszerből.

Megjegyzés:

Ha a dtexec segédprogram aktuális verzióját használja az Integrációs szolgáltatások egy korábbi verziója által létrehozott csomag futtatásához, a segédprogram ideiglenesen frissíti a csomagot az aktuális csomagformátumra. A frissített csomag mentéséhez azonban nem használhatja a dtexec segédprogramot. További információ a csomagok aktuális verzióra való végleges frissítéséről: Integration Services-csomagok frissítése.

Ez a témakör a következő szakaszokat tartalmazza:

• Integration Services-kiszolgáló és projektfájl

• Telepítési szempontok a 64 bites számítógépeken

• Szempontok egymás melletti telepítéssel rendelkező számítógépeken

• A végrehajtás fázisai

• Visszaadott kilépési kódok

• szintaxisszabályok

• A dtexec használata az xp_cmdshell

• A dtexec használata a Bashből

• Szintaxis

• Paraméterek

• megjegyzések

• Példák

Integration Services-kiszolgáló és projektfájl

Amikor a dtexec használatával futtat csomagokat az Integration Services-kiszolgálón, a dtexec meghívja a catalog.create_execution (SSISDB Database), catalog.set_execution_parameter_value (SSISDB Database) és catalog.start_execution (SSISDB Database) tárolt eljárásokat a végrehajtás létrehozásához, a paraméterértékek beállításához és a végrehajtás elindításához. A végrehajtási naplók a kiszolgálóról a kapcsolódó nézetekben vagy az SQL Server Management Studióban elérhető standard jelentések használatával tekinthetők meg. A jelentésekkel kapcsolatos további információkért tekintse meg az Integration Services-kiszolgáló jelentéseit.

Az alábbi példa egy csomagnak az Integration Services-kiszolgálón való végrehajtására mutat be példát.

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  

Ha a dtexec használatával futtat egy csomagot az .ispac projektfájlból, a kapcsolódó beállítások a következők: /Proj[ect] és /Pack[age], amelyek a projekt elérési útjának és a csomagstream nevének megadására szolgálnak. Amikor egy projektet a projekt üzembe helyezési modelljére konvertálja az SQL Server Management Studióból a Integration Services Projektkonvertálás varázslójának futtatásával, a varázsló létrehoz egy .ispac projektfájlt. További információ: Integrációs szolgáltatások (SSIS) projektjeinek és csomagjainak üzembe helyezése.

A dtexec külső ütemezési eszközökkel ütemezheti az Integration Services-kiszolgálón üzembe helyezett csomagokat.

Telepítési szempontok a 64 bites számítógépeken

64 bites számítógépen az Integration Services telepíti a dtexec segédprogram (dtexec.exe) 64 bites verzióját. Ha bizonyos csomagokat 32 bites módban kell futtatnia, telepítenie kell a dtexec segédprogram 32 bites verzióját. A dtexec segédprogram 32 bites verziójának telepítéséhez ki kell választania az Ügyféleszközök vagy az SQL Server Data Tools (SSDT) lehetőséget a telepítés során.

Alapértelmezés szerint egy 64 bites számítógép, amelyen az Integration Services parancssori segédprogramjának 64 bites és 32 bites verziója is telepítve van, a parancssorban futtatja a 32 bites verziót. A 32 bites verzió azért fut, mert a 32 bites verzió címtár elérési útja megjelenik a PATH környezeti változóban a 64 bites verzió címtárelérési útja előtt. (A 32 bites könyvtár elérési útja <általában meghajtó>:\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn, míg a 64 bites könyvtár elérési útja <meghajtó>:\Program Files\Microsoft SQL Server\110\DTS\Binn.)

Megjegyzés:

Ha az SQL Server Agent használatával futtatja a segédprogramot, az SQL Server Agent automatikusan a segédprogram 64 bites verzióját használja. Az SQL Server Agent nem a PATH környezeti változót, hanem a beállításjegyzéket használja a segédprogram megfelelő végrehajtható fájljának megkereséséhez.

Annak érdekében, hogy a parancssorban futtassa a segédprogram 64 bites verzióját, hajtsa végre az alábbi műveletek egyikét:

• Nyisson meg egy parancssori ablakot, váltson a segédprogram 64 bites verzióját tartalmazó könyvtárra (<meghajtó>:\Program Files\Microsoft SQL Server\110\DTS\Binn), majd futtassa a segédprogramot erről a helyről.

• A parancssorban futtassa a segédprogramot úgy, hogy a segédprogram 64 bites verziójára írja be a teljes elérési utat (<meghajtó>:\Program Files\Microsoft SQL Server\110\DTS\Binn).

• A PATH környezeti változó elérési útjainak sorrendjét véglegesen módosíthatja úgy, hogy a 64 bites elérési utat (<meghajtó>:\Program Files\Microsoft SQL Server\110\DTS\Binn) a 32 bites elérési út (<meghajtó>:\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) elé helyezi a változóban.

Szempontok a párhuzamos telepítésekkel rendelkező számítógépek esetében

Ha az SQL Server 2019 Integration Services (SSIS) az SQL Server 2005 Integration Services (SSIS) vagy az SQL Server 2008 Integration Services (SSIS) rendszerrel rendelkező gépekre van telepítve, a dtexec segédprogram több verziója is telepítve lesz.

A segédprogram megfelelő verziójának futtatásához a parancssorban futtassa a segédprogramot a teljes elérési út megadásával (<meghajtó>:\Program Files\Microsoft SQL Server\<version>\DTS\Binn).

A végrehajtás fázisai

A segédprogram négy fázissal rendelkezik, amelyek végrehajtása során halad tovább. A fázisok a következők:

1. A parancs forrásának fázisa: A parancssor felolvassa a megadott beállítások és argumentumok listáját. A rendszer kihagyja az összes további fázist, ha /? vagy /HELP lehetőség van.

2. Csomagbetöltési fázis: A /SQL, /FILE vagy /DTS beállítás által megadott csomag betöltődik.

3. Konfigurációs fázis: A beállítások feldolgozása ebben a sorrendben történik:

   • A csomagjelölőket, változókat és tulajdonságokat jelölő beállítások.

   • A csomagverziót és a buildet ellenőrző beállítások.

   • A segédprogram futásidejű viselkedését konfiguráló beállítások, például jelentéskészítés.

4. Érvényesítési és végrehajtási fázis: A csomag futtatása vagy ellenőrzése futtatás nélkül történik, ha a /VALIDATE beállítás meg van adva.

Visszaadott kilépési kódok

A dtexec segédprogramból visszaadott kilépési kódok

Amikor egy csomag fut, a dtexec visszaadhat egy kilépési kódot. A kilépési kód az ERRORLEVEL változó feltöltésére szolgál, amelynek értéke ezután feltételes utasításokban vagy elágaztatási logikában tesztelhető egy kötegfájlban. Az alábbi táblázat felsorolja azokat az értékeket, amelyeket a dtexec segédprogram megadhat kilépéskor.

Érték	Leírás
0	A csomag végrehajtása sikeresen megtörtént.
1	A csomag nem érkezett meg.
3	A csomagot a felhasználó megszakította.
4	A segédprogram nem tudta megtalálni a kért csomagot. A csomag nem található.
5	A segédprogram nem tudta betölteni a kért csomagot. A csomag nem tölthető be.
6	A segédprogram belső szintaktikai vagy szemantikai hibákat észlelt a parancssorban.

Szintaxisszabályok

Közműszintaxis-szabályok

Minden beállításnak perjellel (/) vagy mínuszjellel (-) kell kezdődnie. Az itt látható beállítások perjellel (/) kezdődnek, de a mínuszjel (-) helyettesíthető.

Ha szóközt tartalmaz, az argumentumot idézőjelek közé kell foglalni. Ha az argumentum nincs idézőjelekbe téve, az argumentum nem tartalmazhat szóközt.

A megduplázott idézőjelek idézett szövegekben az egyes idézőjelek kicserélését jelentik.

A beállítások és az argumentumok nem megkülönböztetik a kis- és nagybetűket, kivéve a jelszavakat.

A dtexec használata a xp_cmdshell

A dtexec használata az xp_cmdshell

A dtexec a xp_cmdshell parancssorból futtatható. Az alábbi példa bemutatja, hogyan futtathat upsertData.dtsx nevű csomagot, és figyelmen kívül hagyhatja a visszatérési kódot:

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

Az alábbi példa bemutatja, hogyan futtathatja ugyanazt a csomagot, és rögzítheti a visszatérési kódot:

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

Fontos

A Microsoft SQL Serverben a xp_cmdshell beállítás alapértelmezés szerint le van tiltva az új telepítések esetében. A beállítás a sp_configure rendszer által tárolt eljárás futtatásával engedélyezhető. További információ: xp_cmdshell kiszolgálókonfigurációs beállítás.

A dtexec használata a Bashből

A Bash-rendszerhéj linuxos népszerű rendszerhéj. Windows rendszeren is használható. A dtexec parancsot a Bash-parancssorból futtathatja. Figyelje meg, hogy a pontosvessző (;) a Bash parancselválasztó operátora. Ez különösen akkor fontos, ha értékeket ad át a csomagnak az /Conn[ection] or vagy /Par[arameter] '/Set beállításokkal, mivel a pontosvesszővel elválasztják a megadott elem nevét és értékét. Az alábbi példa bemutatja, hogyan kerülheti el megfelelően a pontosvesszőt és más elemeket a Bash használatakor, és hogyan adhat át értékeket egy csomagnak:

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

Szemantika

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

Paraméterek

• /? [option_name]: (Nem kötelező). Megjeleníti a parancssori beállításokat, vagy megjeleníti a megadott option_name súgóját, majd bezárja a segédprogramot.

  Ha option_name argumentumot ad meg, a dtexec elindítja az SQL Server Books Online-t, és megjeleníti a dtexec segédprogram témakörét.

• /Ca[llerInfo]: (Nem kötelező). A csomagvégrehajtás további információit adja meg. Amikor sql Server-ügynökkel futtat egy csomagot, az ügynök beállítja ezt az argumentumot, amely azt jelzi, hogy a csomag végrehajtását az SQL Server Agent hívja meg. Ezt a paramétert a rendszer figyelmen kívül hagyja, amikor a dtexec segédprogram fut a parancssorból.

• /CheckF[ile]filespec: (Nem kötelező). A csomag CheckpointFileName tulajdonságát a filepecben megadott elérési útra és fájltípusra állítja. Ezt a fájlt a csomag újraindításakor használja a rendszer. Ha ez a beállítás meg van adva, és nincs megadva érték a fájlnévhez, a csomag CheckpointFileName értéke üres sztringre van állítva. Ha ez a beállítás nincs megadva, a csomag értékei megmaradnak.

• /CheckP[ointing]{on\off} : (Nem kötelező). Beállít egy értéket, amely meghatározza, hogy a csomag ellenőrzőpontokat használ-e a csomag végrehajtása során. A rajta lévő érték azt határozza meg, hogy egy sikertelen csomagot újra kell futtatni. A sikertelen csomag újrafuttatásakor a futásidejű alkalmazás az ellenőrző fájl segítségével indítja újra a csomagot a meghibásodási pontról.

  Az alapértelmezett érték be van kapcsolva, ha a beállítás érték nélkül van deklarálva. A csomag végrehajtása meghiúsul, ha az érték igen-re van állítva, és az ellenőrzőpontfájl nem található. Ha ez a beállítás nincs megadva, a csomagban beállított érték megmarad. További információ: Csomagok újraindítása ellenőrzőpontok használatával.

  A /CheckPointing on opció a dtexec-ben egyenértékű azzal, ha a csomag SaveCheckpoints tulajdonságát True értékre, és a CheckpointUsage tulajdonságot Always értékre állítjuk.

• /Com[mandFile]filespec: (Nem kötelező). Megadja a dtexec használatával futtatott parancsbeállításokat. A fájlban megadott fájl megnyílik, és a fájl beállításai mindaddig beolvasva lesznek, amíg az EOF nem található a fájlban. A filespec egy szöveges fájl. A filespec argumentum a parancsfájl fájlnevét és elérési útját adja meg, amely a csomag végrehajtásához társítható.

• /Conf[igFile]filespec: (Nem kötelező). Egy konfigurációs fájlt ad meg, amelyből értékeket nyerhet ki. Ezzel a beállítással olyan futásidejű konfigurációt állíthat be, amely eltér a csomag tervezési idején megadott konfigurációtól. Különböző konfigurációs beállításokat tárolhat egy XML-konfigurációs fájlban, majd a /ConfigFile beállítással betöltheti a beállításokat a csomag végrehajtása előtt.

  A /ConfigFile beállítással további konfigurációkat tölthet be futásidőben, amelyeket a tervezéskor nem adott meg. A /ConfigFile beállítással azonban nem helyettesítheti a tervezéskor megadott konfigurált értékeket. A csomagkonfigurációk alkalmazásának megismeréséhez tekintse meg a Csomagkonfigurációk című témakört.

• /Conn[ection]id_or_name; connection_string [[; id_or_name; connection_string]...]: (Nem kötelező). Megadja, hogy a megadott névvel vagy GUID azonosítóval rendelkező kapcsolatkezelő a csomagban található-e, és megadja a kapcsolati sztringet.

  Ehhez a beállításhoz mindkét paramétert meg kell adni: a kapcsolatkezelő nevét vagy a GUID azonosítót meg kell adni a id_or_name argumentumban, és érvényes kapcsolati sztringet kell megadni a connection_string argumentumban. További információért tekintse meg a Integration Services (SSIS) kapcsolatok részleteit.

  Futásidőben a /Kapcsolat beállítással a csomagkonfigurációkat a tervezéskor megadott helytől eltérő helyről töltheti be. A konfigurációk értékei ezután lecserélik az eredetileg megadott értékeket. A /Connection lehetőséget azonban csak olyan konfigurációkhoz használhatja, mint például az SQL Server-konfigurációk, amelyek kapcsolatkezelőt használnak. A csomagkonfigurációk alkalmazásának megismeréséhez tekintse meg az SQL Server 2016 Integrációs szolgáltatásokcsomagkonfigurációinak és viselkedésének változásai című témakört.

• /Cons[oleLog] [[displayoptions];[list_options; src_name_or_guid]...]: (Opcionális). A megadott naplóbejegyzéseket jeleníti meg a konzolon a csomag végrehajtása során. Ha ez a beállítás nincs megadva, a konzolon nem jelennek meg naplóbejegyzések. Ha a beállítás olyan paraméterek nélkül van megadva, amelyek korlátozzák a megjelenítést, minden naplóbejegyzés megjelenik. A konzolon megjelenített bejegyzések korlátozásához megadhatja a megjelenítendő oszlopokat a displayoptions paraméterrel, és korlátozhatja a naplóbejegyzések típusait a list_options paraméterrel.

  Megjegyzés:

  Ha egy csomagot az Integration Services-kiszolgálón az /ISSERVER paraméterrel futtat, a konzol kimenete korlátozott, és a /Cons[oleLog] beállításainak többsége nem alkalmazható. A végrehajtási naplók a kiszolgálóról a kapcsolódó nézetekben vagy az SQL Server Management Studióban elérhető standard jelentések használatával tekinthetők meg. A jelentésekkel kapcsolatos további információkért tekintse meg az Integration Services-kiszolgáló jelentéseit.

  A megjelenítési értékek a következők:

  • N (Név)

  • C (Számítógép)

  • O (operátor)

  • S (forrásnév)

  • G (forrás GUID azonosítója)

  • X (Végrehajtási GUID)

  • M (Üzenet)

  • T (idő kezdete és vége)

  A list_options értékek a következők:

  • I – Megadja a felvételi listát. A rendszer csak a megadott forrásneveket vagy grafikus GUID-ket naplózza.

  • E – Meghatározza a kizárási listát. A megadott forrásneveket vagy GRAFIKUS GUID-ket a rendszer nem naplózza.

  • A src_name_or_guid paraméter, amelyet a felvételhez vagy kizáráshoz megadnak, lehet egy esemény neve, forrás neve vagy forrás GUID.

  Ha több /ConsoleLog-beállítást használ ugyanazon a parancssoron, az alábbiak szerint működnek:

  • Megjelenésük sorrendje nincs hatással.

  • Ha nincs belefoglalási lista a parancssorban, a rendszer kizáró listákat alkalmaz mindenféle naplóbejegyzésre.

  • Ha bármely belefoglalási lista szerepel a parancssorban, a rendszer kizáró listákat alkalmaz az összes belefoglalási lista egyesítésére.

  A /ConsoleLog beállításra több példát is találhat, lásd a Megjegyzések szakaszt .

• /D[ts]package_path: (Nem kötelező). Betölt egy csomagot az SSIS csomagtárolóból. Az SSIS-csomagtárolóban tárolt csomagok az örökölt csomagterjesztési modellel vannak üzembe helyezve. Az Integration Services-kiszolgálón a projekttelepítési modellel üzembe helyezett csomagok futtatásához használja az /ISServer lehetőséget. A csomag- és projekttelepítési modellekkel kapcsolatos további információkért lásd a Projektek és csomagok üzembe helyezését ismertető témakört.

  A package_path argumentum az SSIS-csomag relatív elérési útját adja meg az SSIS-csomagtároló gyökerétől kezdve, és tartalmazza az SSIS-csomag nevét. Ha a package_path argumentumban megadott elérési út vagy fájlnév szóközt tartalmaz, idézőjeleket kell elhelyeznie a package_path argumentumban.

  A /DTS beállítás nem használható együtt a /File vagy /SQL beállítással. Ha több beállítás is meg van adva, a dtexec sikertelen lesz.

• /De[crypt]password: (Nem kötelező). Beállítja a jelszótitkosítással rendelkező csomagok betöltésekor használt visszafejtési jelszót.

• (Nem kötelező) Létrehozza a hibakeresési memóriaképfájlokat (.mdmp és .tmp), ha a csomag futtatása közben egy vagy több megadott esemény történik. A hibakód argumentum megadja az eseménykód, a figyelmeztetés vagy az információ típusát, amely aktiválja a rendszert a hibakeresési memóriaképfájlok létrehozásához. Több eseménykód megadásához különítse el az egyes hibakód-argumentumokat pontosvesszővel (;). Ne használjon idézőjeleket a hibakód argumentumánál.

  Az alábbi példa a hibakeresési memóriaképfájlokat hozza létre a DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER hiba előfordulásakor.

  /Dump 0xC020801C  
  

  /Dumphibakód: Alapértelmezés szerint az Integration Services tárolja a hibakeresési memóriaképfájlokat a mappában, <meghajtó>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps.

  Megjegyzés:

  A hibakeresési memóriaképfájlok bizalmas információkat tartalmazhatnak. Hozzáférés-vezérlési lista (ACL) használatával korlátozhatja a fájlokhoz való hozzáférést, vagy átmásolhatja a fájlokat egy korlátozott hozzáférésű mappába. Mielőtt például elküldi a hibakeresési fájlokat a Microsoft támogatási szolgáltatásainak, javasoljuk, hogy távolítsa el a bizalmas vagy bizalmas információkat.

  Ha ezt a beállítást a dtexec segédprogram által futtatott összes csomagra szeretné alkalmazni, adjon hozzá egy DumpOnCodes REG_SZ értéket a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath beállításkulcshoz. A DumpOnCodes adatértéke megadja azt a hibakódot vagy kódokat, amelyek hibakeresési memóriaképfájlok létrehozásához aktiválják a rendszert. Több hibakódot kettősponttal (;)) kell elválasztani.

  Ha hozzáad egy DumpOnCodes-értéket a beállításkulcshoz, és a /Dump lehetőséget használja, a rendszer mindkét beállításon alapuló hibakeresési memóriaképfájlokat hoz létre.

  A memóriaképfájlok hibakeresésével kapcsolatos további információkért lásd: Memóriaképfájlok létrehozása a csomagvégrehajtáshoz.

• /DumpOnError: (Nem kötelező) Létrehozza a hibakeresési memóriaképfájlokat (.mdmp és .tmp), amikor hiba történik a csomag futtatása közben.

  Az Integration Services alapértelmezés szerint a hibakeresési memóriaképfájlokat a következő mappában <tárolja: meghajtó>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps mappa.

  Megjegyzés:

  A hibakeresési memóriaképfájlok bizalmas információkat tartalmazhatnak. Hozzáférés-vezérlési lista (ACL) használatával korlátozhatja a fájlokhoz való hozzáférést, vagy átmásolhatja a fájlokat egy korlátozott hozzáférésű mappába. Mielőtt például elküldi a hibakeresési fájlokat a Microsoft támogatási szolgáltatásainak, javasoljuk, hogy távolítsa el a bizalmas vagy bizalmas információkat.

  Ha ezt a beállítást a dtexec segédprogram által futtatott összes csomagra szeretné alkalmazni, adjon hozzá egy DumpOnError REG_DWORD értéket a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath beállításkulcshoz. A DumpOnError REG_DWORD érték határozza meg, hogy a /DumpOnError beállítást a dtexec segédprogrammal kell-e használni:

  • A nem nulla adatérték azt jelzi, hogy a rendszer hiba esetén hibakeresési memóriaképfájlokat hoz létre, függetlenül attól, hogy a /DumpOnError lehetőséget használja-e a dtexec segédprogrammal.

  • A nulla adatérték azt jelzi, hogy a rendszer nem hozza létre a hibakeresési memóriaképfájlokat, hacsak nem használja a /DumpOnError lehetőséget a dtexec segédprogrammal.

  A memóriaképfájlok hibakeresésével kapcsolatos további információkért lásd: Memóriaképfájlok létrehozása csomagvégrehajtáshoz

• /Env[Referencia]környezeti referenciaazonosító: (Nem kötelező). Megadja a csomagvégrehajtás által használt környezeti referenciát (ID) egy, az Integration Services-kiszolgálón üzembe helyezett csomaghoz. A változókhoz való kötésre konfigurált paraméterek a környezetben található változók értékeit használják.

  A /Env[Referencia] lehetőséget az /ISServer és a /Server beállításokkal együtt használhatja.

  Ezt a paramétert az SQL Server Agent használja.
  -- /F[ile]filespec: (Nem kötelező). Betölt egy, a fájlrendszerben mentett csomagot. A fájlrendszerben mentett csomagok az örökölt csomagterjesztési modellel vannak üzembe helyezve. Az Integration Services-kiszolgálón a projekttelepítési modellel üzembe helyezett csomagok futtatásához használja az /ISServer lehetőséget. A csomag- és projekttelepítési modellekkel kapcsolatos további információkért lásd: Projektek és csomagok üzembe helyezése

A filespec argumentum a csomag elérési útját és fájlnevét adja meg. Az elérési utat univerzális elnevezési konvenció (UNC) vagy helyi elérési útként is megadhatja. Ha a filespec argumentumban megadott elérési út vagy fájlnév szóközt tartalmaz, idézőjeleket kell elhelyeznie a filespec argumentumban.

• A /Fájl beállítás nem használható együtt a /DTS vagy /SQL beállítással. Ha több beállítás is meg van adva, a dtexec sikertelen lesz.

• /H[elp] [option_name]: (Nem kötelező). Megjeleníti a beállítások súgóját, vagy megjeleníti a megadott option_name súgóját, és bezárja a segédprogramot.

  Ha option_name argumentumot ad meg, a dtexec elindítja az SQL Server Books Online-t, és megjeleníti a dtexec segédprogram témakörét.

• /ISServerpackagepath: (Nem kötelező). Az Integration Services-kiszolgálón üzembe helyezett csomagot futtatja. A PackagePath argumentum az Integration Services-kiszolgálón üzembe helyezett csomag teljes elérési útját és fájlnevét adja meg. Ha a PackagePath argumentumban megadott elérési út vagy fájlnév szóközt tartalmaz, idézőjeleket kell elhelyeznie a PackagePath argumentumban.

  A csomag formátuma a következő:

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

  A /Server lehetőséget az /ISSERVER beállítással együtt használja. Csak a Windows-hitelesítés hajthat végre csomagot az SSIS-kiszolgálón. A rendszer a jelenlegi Windows-felhasználót használja a csomag eléréséhez. Ha a /Server beállítás nincs megadva, a rendszer az SQL Server alapértelmezett helyi példányát feltételezi.

  Az /ISSERVER beállítás nem használható együtt a /DTS, /SQL vagy /File beállítással. Ha több beállítás is meg van adva, a dtexec sikertelen lesz.

  Ezt a paramétert az SQL Server Agent használja.

• /L[ogger]classid_orprogid; configstring: (Nem kötelező). Egy vagy több naplószolgáltatót társít egy SSIS-csomag végrehajtásához. A classid_orprogid paraméter megadja a naplószolgáltatót, és megadható osztály GUID azonosítójaként. A konfigurációs sztring a naplószolgáltató konfigurálásához használt sztring.

  Az alábbi lista az elérhető naplószolgáltatókat jeleníti meg:

  • Szövegfájl:

    • ProgID: DTS. LogProviderTextFile.1

    • Osztályazonosító: {59B2C6A5-663F-4C20-8863-C83F9B72E2EB}

  • SQL Server Profiler:

    • ProgID: DTS. LogProviderSQLProfiler.1

    • ClassID: {5C0B8D21-E9AA-462E-BA34-30FF5F7A42A1}

  • SQL Server:

    • ProgID: DTS. LogProviderSQLServer.1

    • Osztályazonosító: {6AA833A1-E4B2-4431-831B-DE695049DC61}

  • Windows eseménynapló:

    • ProgID: DTS. LogProviderEventLog.1

    • Osztályazonosító: {97634F75-1DC7-4F1F-8A4C-DAF0E13AAA22}

  • XML-fájl:

    • ProgID: DTS. LogProviderXMLFile.1

    • ClassID: {AFED6884-619C-484F-9A09-F42D56E1A7EA}

• /M[axConcurrent]concurrent_executables: (Nem kötelező). Megadja, hogy a csomag hány végrehajtható fájlt futtathat egyszerre. A megadott értéknek nem negatív egész számnak vagy -1 értéknek kell lennie. A -1 értéke azt jelenti, hogy az SSIS lehetővé teszi az egyidejűleg futó végrehajtható fájlok maximális számát, amely megegyezik a csomagot végrehajtó számítógépen található processzorok teljes számával, plusz kettő.

• /Pack[age]PackageName: (Nem kötelező). Megadja a végrehajtott csomagot. Ez a paraméter elsősorban akkor használatos, ha a csomagot a Visual Studióból hajtja végre.

• /P[assword]password: (Nem kötelező). Lehetővé teszi az SQL Server-hitelesítéssel védett csomagok lekérését. Ezt a lehetőséget a /User beállítással együtt használja a rendszer. Ha a /Password beállítás nincs megadva, és a /User lehetőséget használja, a rendszer üres jelszót használ. A jelszó értéke idézhető.

  Fontos

  Ha lehetséges, windowsos hitelesítést használjon.

• /Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: (Nem kötelező). Paraméterértékeket ad meg. Több /paraméterbeállítás is megadható. Az adattípusok CLR TypeCodes karakterláncokként vannak megadva. Nem sztring típusú paraméter esetén az adattípus zárójelben van megadva a paraméter neve után.

  A /Paraméter beállítás csak az /ISServer beállítással használható.

  A $Package, $Project és $ServerOption előtagokkal jelölhet csomagparamétert, projektparamétert és kiszolgálóbeállítási paramétert. Az alapértelmezett paramétertípus a csomag.

  Az alábbi példa egy csomag végrehajtására és a projektparaméter (myparam) myvalue értékének megadására, valamint a csomagparaméter 12 egész számának (másikparam) megadására szolgál.

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

  A kapcsolatkezelő tulajdonságait paraméterekkel is beállíthatja. A CM előtaggal egy kapcsolatkezelő paramétert jelölhet.

  Az alábbi példában a SourceServer kapcsolatkezelő InitialCatalog tulajdonsága a következőre ssisdbvan állítva.

  /parameter CM.SourceServer.InitialCatalog;ssisdb  
  

  Az alábbi példában a SourceServer kapcsolatkezelő ServerName tulajdonsága pont (.) értékre van állítva a helyi kiszolgáló jelzésére.

  /parameter CM.SourceServer.ServerName;.  
  

• /Proj[ect]ProjectFile: (Nem kötelező). Azt a projektet adja meg, amelyből lekérheti a végrehajtott csomagot. A ProjectFile argumentum az .ispac fájlnevet adja meg. Ez a paraméter elsősorban akkor használatos, ha a csomagot a Visual Studióból hajtja végre.

• /Remmegjegyzés: (Nem kötelező). Megjegyzéseket tartalmaz a parancssorban vagy a parancsfájlokban. Az argumentum megadása nem kötelező. A megjegyzés értéke olyan sztring, amelyet idézőjelek közé kell foglalni, vagy nem tartalmazhat szóközt. Ha nincs megadva argumentum, beszúr egy üres sort. A parancs forrásmegadási fázisában a megjegyzésértékek elvesznek.

• /Rep[orting]level [;event_guid_or_name[;event_guid_or_name[...]]: (Nem kötelező). Meghatározza, hogy milyen típusú üzeneteket szeretne jelenteni. A szinthez elérhető jelentéskészítési lehetőségek a következők:

  N Nincs jelentéskészítés.

  A rendszer e-hibákat jelez.

  Figyelmeztetések jelennek meg.

  I jelenti a tájékoztató üzeneteket.

  C Egyéni események jelentése.

  A haladásról jelentést teszünk.

  V részletes jelentéskészítés.

  A V és az N argumentumok kölcsönösen kizárják az összes többi argumentumot; ezeket egyedül kell megadni. Ha a /Reporting beállítás nincs megadva, akkor az alapértelmezett szint az E (hibák), a W (figyelmeztetések) és a P (folyamat).

  Minden esemény előtt szerepel egy "YY/MM/DD HH:MM:SS" formátumú időbélyeg, valamint egy GUID vagy egy rövid név, ha elérhető.

  Az opcionális event_guid_or_name paraméter a naplószolgáltatók kivételeinek listája. A kivétel azokat az eseményeket határozza meg, amelyeket a rendszer nem naplózott, amelyek máskülönben naplózva lettek volna.

  Nem kell kizárnia egy eseményt, ha az eseményt általában nem naplózza alapértelmezés szerint

• /Res[tart] {deny | force | ifPossible}: (Nem kötelező). A csomag tulajdonságának CheckpointUsage új értékét adja meg. A paraméterek jelentése a következő:

  Letiltás beállítja a CheckpointUsage tulajdonságot DTSCU_NEVER-re.

  Erő A tulajdonság beállítása CheckpointUsage .DTSCU_ALWAYS

  ifPossible Beállítja a tulajdonságot CheckpointUsage értékre DTSCU_IFEXISTS.

  Ha nincs megadva érték, akkor az erő alapértelmezett értékét használják.

• /Set [$Sensitive::]propertyPath; érték: (Nem kötelező). Felülbírálja egy paraméter, változó, tulajdonság, tároló, naplószolgáltató, Foreach enumerátor vagy kapcsolat konfigurációját egy csomagon belül. Ha ezt a beállítást használja, a /Beállítás apropertyPath argumentumot a megadott értékre módosítja. Több beállítás is megadható.

  A /Set kapcsoló /F[ile] kapcsolóval való használata mellett a /Set kapcsolót is használhatja az /ISServer kapcsolóval vagy a /Project kapcsolóval. A /Set with /Project használatakor a /Set paraméterértékek beállítása. Amikor a /Set-et az /ISServer-rel használja, a /Set tulajdonság-felülbírálásokat hajt végre. A /Set with /ISServer használata esetén az opcionális $Sensitive előtaggal jelezheti, hogy a tulajdonságot bizalmasként kell kezelni az Integration Services-kiszolgálón.

  A PropertyPath értékét a Csomagkonfiguráció varázsló futtatásával határozhatja meg. A kiválasztott elemek elérési útjai a varázsló végleges befejezése lapon jelennek meg, és másolhatók és beilleszthetők. Ha csak erre a célra használta a varázslót, az elérési utak másolása után megszakíthatja a varázslót.

  Az alábbiakban egy, a fájlrendszerben mentett csomag végrehajtására és egy változó új értékének megadására mutatunk be példát:

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

  Az alábbi példa egy csomagot futtat az .ispac projektfájlból, és beállítja a csomag és a projekt paramétereit.

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

  A /Set beállítással módosíthatja a csomagkonfigurációk betöltési helyét. A /Set beállítással azonban nem bírálhat felül egy konfiguráció által megadott értéket a tervezéskor. A csomagkonfigurációk alkalmazásának megismeréséhez tekintse meg az SQL Server 2016 Integrációs szolgáltatásokcsomagkonfigurációinak és viselkedésének változásai című témakört.

• /Ser[ver]server: (Nem kötelező). A /SQL vagy /DTS beállítás megadásakor ez a beállítás annak a kiszolgálónak a nevét adja meg, amelytől a csomagot le szeretné kérni. Ha kihagyja a /Server lehetőséget, és a /SQL vagy /DTS beállítás meg van adva, a rendszer megpróbálja végrehajtani a csomag végrehajtását a helyi kiszolgálóval. A server_instance érték idézhető.

  A /Ser[ver] beállításra az /ISServer beállítás megadásakor van szükség.

• /SQ[L]package_path: Betölti az SQL Serverben, msdb-adatbázisban tárolt csomagot. Az msdb-adatbázisban tárolt csomagok üzembe helyezése a csomagterjesztési modell használatával történik. Az Integration Services-kiszolgálón a projekttelepítési modellel üzembe helyezett csomagok futtatásához használja az /ISServer lehetőséget. A csomag- és projekttelepítési modellekkel kapcsolatos további információkért lásd a Projektek és csomagok üzembe helyezését ismertető témakört.

• A package_path argumentum a beolvasandó csomag nevét adja meg. Ha a mappák szerepelnek az elérési úton, fordított perjelek ( "\" ) zárják le őket. A package_path érték idézhető. Ha a package_path argumentumban megadott elérési út vagy fájlnév szóközt tartalmaz, idézőjeleket kell elhelyeznie a package_path argumentumban.

  A /User, / Password és /Server beállításokat az /SQL beállítással együtt használhatja.

  Ha kihagyja a /User lehetőséget, a rendszer a Windows-hitelesítést használja a csomag eléréséhez. Ha a /User lehetőséget használja, a megadott /felhasználónév az SQL Server-hitelesítéshez van társítva.

  A /Password beállítás csak a /User beállítással együtt használható. Ha a /Password lehetőséget használja, a csomag a megadott felhasználónévvel és jelszóval érhető el. Ha kihagyja a /Password lehetőséget, a rendszer üres jelszót használ.

  Fontos

  Ha lehetséges, windowsos hitelesítést használjon.

• Ha a /Server beállítás nincs megadva, a rendszer az SQL Server alapértelmezett helyi példányát feltételezi.

  Az /SQL-beállítás nem használható együtt a /DTS vagy a /File beállítással. Ha több beállítás is meg van adva, a dtexec sikertelen lesz.

• /Su[m]: (Nem kötelező). Egy növekményes számlálót jelenít meg, amely a következő összetevő által fogadott sorok számát tartalmazza.

• /U[ser]user_name: (Nem kötelező). Lehetővé teszi az SQL Server-hitelesítéssel védett csomagok lekérését. Ez a beállítás csak akkor használatos, ha az /SQL beállítás meg van adva. A user_name érték idézhető.

  Fontos

  Ha lehetséges, windowsos hitelesítést használjon.

• /Va[lidate]: (Nem kötelező). Az érvényesítési fázis után leállítja a csomag végrehajtását anélkül, hogy ténylegesen futtatta a csomagot. Az ellenőrzés során a /WarnAsError beállítás használata miatt a dtexec hibaként kezeli a figyelmeztetést; ezért a csomag meghiúsul, ha figyelmeztetés jelenik meg az ellenőrzés során.

• /VerifyB[uild]major[; minor[; build]]: (Nem kötelező). Ellenőrzi egy csomag buildszámát a korábban az ellenőrzési fázis során megadott fő, al és build argumentumokkal szemben. Ha eltérés történik, a csomag nem lesz végrehajtva.

  Az értékek hosszú egész számok. Az argumentum három formája lehet, és a fő érték mindig kötelező.

  • őrnagy

  • nagykorú;kiskorú

  • fő; alverzió; build

• /VerifyP[ackageID]packageID: (Nem kötelező). Ellenőrzi a végrehajtandó csomag GUID-azonosítóját úgy, hogy összehasonlítja az package_id argumentumban megadott értékkel.

• /VerifyS[igned]: (Nem kötelező). Az Integrációs szolgáltatások ellenőrzik a csomag digitális aláírását. Ha a csomag nincs aláírva, vagy az aláírás érvénytelen, a csomag meghiúsul. További információ: A csomagok forrásának azonosítása digitális aláírásokkal.

  Fontos

  Ha a csomag aláírásának ellenőrzésére van konfigurálva, az Integration Services csak azt ellenőrzi, hogy a digitális aláírás jelen van-e, érvényes-e, és megbízható forrásból származik-e. Az Integration Services nem ellenőrzi, hogy a csomag módosult-e.

  Megjegyzés:

  Az opcionális BlockedSignatureStates beállításjegyzék-érték megadhat egy olyan beállítást, amely szigorúbb, mint az SQL Server Data Tools (SSDT) vagy a dtexec parancssorban beállított digitális aláírási beállítás. Ebben az esetben a szigorúbb beállításjegyzék-beállítás felülírja a többi beállítást.

• /VerifyV[ersionID]versionID: (Nem kötelező). Ellenőrzi a végrehajtandó csomag guid azonosítóját úgy, hogy összehasonlítja az version_id argumentumban megadott értékkel a csomagérvényesítési fázis során.

• /VLog[Filespec]: (Nem kötelező). Az Integration Services csomag minden eseményét a csomag tervezésekor engedélyezett naplószolgáltatóknak írja. Ha azt szeretné, hogy az Integration Services engedélyezze a naplófájl-szolgáltatót szövegfájlokhoz, és naplóeseményeket írjon egy megadott szövegfájlba, adjon meg egy elérési utat és egy fájlnevet a Filespec paraméterként.

  Ha nem tartalmazza a Filespec paramétert, az Integration Services nem engedélyezi a szövegfájlok naplózási szolgáltatóját. Az Integration Services csak a csomag tervezésekor engedélyezett naplószolgáltatóknak ír naplóeseményeket.

• /W[arnAsError]: (Nem kötelező). A csomag hibaként veszi figyelembe a figyelmeztetést; ezért a csomag meghiúsul, ha figyelmeztetés lép fel az ellenőrzés során. Ha az ellenőrzés során nem történik figyelmeztetés, és a /Validate beállítás nincs megadva, a rendszer végrehajtja a csomagot.

• /X86: (Nem kötelező). Az SQL Server Agent 32 bites módban futtatja a csomagot egy 64 bites számítógépen. Ezt a beállítást az SQL Server Agent állítja be, ha a következő feltételek teljesülnek:

  • A feladat lépéstípusa az SQL Server Integration Services-csomag.

  • Az Új feladat lépés párbeszédpanel Végrehajtási beállítások lapján a 32 bites futtatókörnyezet használata lehetőség van kiválasztva.

  Ezt a beállítást az SQL Server Agent-feladatlépésekhez is beállíthatja tárolt eljárások vagy SQL Server Management Objects (SMO) használatával a feladat programozott létrehozásához.

  Ezt a beállítást csak az SQL Server Agent használja. Ez a beállítás figyelmen kívül lesz hagyva, ha a parancssorban futtatja a dtexec segédprogramot.

Megjegyzések

A parancsbeállítások megadásának sorrendje befolyásolhatja a csomag végrehajtásának módját:

• A beállítások feldolgozása a parancssorban megadott sorrendben történik. A parancsfájlokat beolvassák, ahogy feltűnnek a parancssorban. A parancsfájlban lévő parancsokat a rendszer a talált sorrendben is feldolgozzák.

• Ha ugyanaz a beállítás, paraméter vagy változó több alkalommal is megjelenik ugyanabban a parancssori utasításban, a beállítás utolsó példánya elsőbbséget élvez.

• A /Set és /ConfigFile beállítások feldolgozása a megadott sorrendben történik.

Példák

Az alábbi példák bemutatják, hogyan használható a dtexec parancssori segédprogram az SQL Server Integration Services-csomagok konfigurálására és végrehajtására.

Csomagok futtatása

Ha windowsos hitelesítéssel szeretne végrehajtani egy SQL Serverre mentett SSIS-csomagot, használja a következő kódot:

dtexec /sq pkgOne /ser productionServer  

Az SSIS-csomagtároló fájlrendszermappájába mentett SSIS-csomag végrehajtásához használja a következő kódot:

dtexec /dts "\File System\MyPackage"  

A Windows-hitelesítést használó és az SQL Serveren a csomag végrehajtása nélkül mentett csomag ellenőrzéséhez használja a következő kódot:

dtexec /sq pkgOne /ser productionServer /va  

A fájlrendszerben mentett SSIS-csomag végrehajtásához használja a következő kódot:

dtexec /f "c:\pkgOne.dtsx"   

A fájlrendszerben mentett SSIS-csomag végrehajtásához és a naplózási beállítások megadásához használja a következő kódot:

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

Windows-hitelesítést használó és az SQL Server alapértelmezett helyi példányára mentett csomag végrehajtásához és a verzió ellenőrzéséhez használja a következő kódot:

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

A fájlrendszerben mentett és külsőleg konfigurált SSIS-csomag végrehajtásához használja a következő kódot:

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

Megjegyzés:

Az /SQL, /DTS vagy /FILE beállítások package_path vagy fájlspecifikus argumentumait idézőjelek közé kell foglalni, ha az elérési út vagy fájlnév szóközt tartalmaz. Ha az argumentum nincs idézőjelekbe téve, az argumentum nem tartalmazhat szóközt.

Naplózási lehetőség

Ha az A, B és C naplóbejegyzések három típusa van, a paraméter nélküli következő ConsoleLog beállítás mindhárom naplótípust megjeleníti az összes mezővel:

/CONSOLELOG  

Az alábbi beállítás megjeleníti az összes naplótípust, de csak a Név és az Üzenet oszlopokkal:

/CONSOLELOG NM  

Az alábbi beállítás az összes oszlopot megjeleníti, de csak az A típusú naplóbejegyzés esetében:

/CONSOLELOG I;LogEntryTypeA  

Az alábbi beállítás csak az A típusú naplóbejegyzéseket jeleníti meg, név és üzenet oszlopokkal:

/CONSOLELOG NM;I;LogEntryTypeA  

Az alábbi beállítás az A és B típusú naplóbejegyzéseket jeleníti meg:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB  

Ugyanazokat az eredményeket több ConsoleLog-beállítással érheti el:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB  

Ha a ConsoleLog beállítást paraméterek nélkül használja, az összes mező megjelenik. Egy list_options paraméter felvétele esetén az alábbiak csak az A típusú naplóbejegyzést jelenítik meg az összes mezővel:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG  

Az alábbiak az A típusú naplóbejegyzés kivételével az összes naplóbejegyzést megjelenítik, vagyis a B és a C típusú naplóbejegyzéseket:

/CONSOLELOG E;LogEntryTypeA  

Az alábbi példa ugyanazt az eredményt több ConsoleLog-beállítással és egyetlen kizárással éri el:

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

Az alábbi példa nem jelenít meg naplóüzeneteket, mert ha egy naplófájltípus a belefoglalt és a kizárt listákban is megtalálható, az ki lesz zárva.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA  

BEÁLLÍTÁS választási lehetőség

Az alábbi példa bemutatja, hogyan használhatja a /SET beállítást, amely lehetővé teszi a csomagtulajdonságok vagy változók értékének módosítását a csomag parancssorból való indításakor.

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

Projektbeállítás

Az alábbi példa a /Project és a /Package lehetőséget mutatja be.

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

Az alábbi példa bemutatja, hogyan használhatja a /Project és /Package beállításokat, és hogyan állíthatja be a csomag- és projektparamétereket.

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

ISServer Option

Az alábbi példa az /ISServer beállítás használatát mutatja be.

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

Az alábbi példa bemutatja, hogyan használhatja az /ISServer lehetőséget, és hogyan állíthatja be a projekt és a kapcsolatkezelő paramétereit.

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