dtutil narzędzia (narzędzie SSIS)
The dtutil command prompt utility is used to manage SQL Server Integration Services packages.Narzędzie można skopiować, przenieść, usunąć lub sprawdza istnienie pakiet.Te akcje można wykonać w dowolnym SSIS pakiet, który jest przechowywany w jednym z trzech lokalizacjach: a Microsoft SQL Server database, the SSIS Package Store, and the file system.Typ magazynu pakiet jest identyfikowany przez /SQL, /FILE, i /DTS Opcje.
Ostrzeżenie
Wielu operacji wykonywanych przez dtutil można również przeprowadzić wizualnie w SQL Server Management Studio , gdy są podłączone do wystąpienie Integration Services.Aby uzyskać więcej informacji, zobacz Zarządzanie pakietami.
Opcje można wpisać w dowolnej kolejności.Potok ("|") jest znak OR operator i służy do pokazywania możliwych wartości.Należy użyć jednej z opcji, które są rozdzielone OR potoku.
Wszystkie opcje musi zaczynać się od ukośnika (/) lub znak minus (-).Jednak nie zawierają spacji między kreską ułamkową lub znak minus i tekstu dla opcji; w przeciwnym razie polecenie nie powiedzie się.
Argumenty muszą być ciągów, które są albo ujęty w znaki cudzysłowu lub zawierają niedopuszczalnych.
Podwójny cudzysłów w ramach ciągów, które są ujęte w znaki cudzysłowu reprezentują oznaczenie pojedyncze cudzysłowy.
Opcje i argumenty, z wyjątkiem przypadek haseł nie jest uwzględniana wielkość liter.
Uwagi dotyczące instalacji narzędzi SSIS na komputerach 64-bitowych
Na komputerze 64-bitowym Integration Services instaluje wersja 64-bit dtexec narzędzie (dtexec.exe) oraz dtutil narzędzie (dtutil.exe).Aby zainstalować 32-bitowe wersje tych Integration Services Narzędzia, należy wybrać albo narzędzia klienckie lub Business Intelligence Development Studio podczas instalacji.
Domyślnie komputer 64-bitowy ma zarówno 64-bitowe i 32-bitowe wersje Integration Services zainstalowanego narzędzia wiersz polecenia zostanie uruchomiony 32-bitowej wersja w wiersz polecenia.32-Bitowa wersja działa, ponieważ ścieżka katalogu dla 32-bitowej wersji pojawia się w zmiennej środowiskowej ścieżka przed ścieżka katalogu dla 64-bitowej wersji.(Zazwyczaj ścieżka katalogu 32-bitowych jest <dysku>: \Program \Microsoft SQL Server\100\DTS\Binn pliki (x 86), natomiast ścieżka katalogu 64-bitowych jest <dysku>: \Program Files\Microsoft SQL Server\100\DTS\Binn.)
Ostrzeżenie
Uruchom narzędzie za pomocą agenta programu SQL Server, SQL Server Agent automatycznie używa 64-bitowej wersja narzędzia.SQL Server Agent używa rejestru nie zmiennej środowiskowej PATH, aby zlokalizować poprawny plik wykonywalny narzędzia.
W celu zapewnienia Uruchom 64-bitowej wersja narzędzia wiersz polecenia, można wykonać jedną z następujących czynności:
Otwórz okno wiersza polecenia, przejdź do katalogu zawierającego 64-bitowej wersja narzędzia ()<dysku>: \Program Files\Microsoft SQL Server\100\DTS\Binn), a następnie uruchomić narzędzie z tej lokalizacji.
W wiersz polecenia Uruchom narzędzie, wpisując pełną ścieżka (<dysku>: \Program Files\Microsoft SQL Server\100\DTS\Binn) do 64-bitowej wersja narzędzia.
Trwale zmienić kolejność ścieżka w zmiennej środowiskowej ścieżka, umieszczając ścieżka 64-bitowych (<dysku>: \Program Files\Microsoft SQL Server\100\DTS\Binn) przed ścieżką 32-bitowe (<dysku>: \ Program \Microsoft SQL Server\100\DTS\Binn pliki (x 86)) w zmiennej.
Składnia
dtutil /option [value] [/option [value]]...
Parametry
Opcja |
Opis |
|---|---|
/? |
Wyświetla opcje wiersz polecenia. |
/C [opiuj] location;destinationPathandPackageName |
Określa akcja kopiowania na SSIS pakiet.Użycie tego parametru wymaga najpierw określić lokalizację pakiet za pomocą /FI, /SQ, lub /DT opcji.Następnie określ nazwę pakiet docelowego obiekt docelowy.destinationPathandPackageName Argument określa, gdzie SSIS pakiet jest kopiowany do.Jeśli obiekt obiekt docelowy location jest SQL, DestUser, DestPassword i DestServer argumenty muszą być również określone w polecenia. Gdy Copy akcja napotka istniejący pakiet w obiekt docelowy, dtutil monituje użytkownika o potwierdzenie usunięcia pakietu.Y Odpowiedzi zastępuje pakiet i N odpowiedź kończy program.Gdy polecenie zawiera Quiet argument nie zostanie wyświetlony monit i zastąpić dowolny pakiet. |
/ Gru [rypt] password |
(Opcjonalnie).Ustawia hasło odszyfrowywania używane podczas ładowania pakiet z szyfrowanie haseł. |
/ Del [ete] |
Usuwa pakiet określony przez SQL, DTS lub FILE opcji.Jeśli dtutil nie można usunąć pakiet zakończenia programu. |
/ DestP [assword] password |
Określa hasło używane z opcją SQL połączyć się z obiekt docelowy SQL Server wystąpienie SQL Server uwierzytelniania.Jeśli zostanie wygenerowany błąd DESTPASSWORD określonego w wierszu polecenia, który nie zawiera DTSUSER opcji. .gif "Uwaga") Uwaga:
Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows..
|
/ DestS [wierzytelnianie serwera] server_instance |
Określa nazwa serwera, która jest używana żadnych działań, który powoduje, że obiekt docelowy do zapisania SQL Server.Jest używany do identyfikacji serwera nielokalnych lub inny niż domyślny podczas zapisywania SSIS pakiet.Jest to błąd, aby określić DESTSERVER w wierszu polecenia nie ma akcja skojarzonej z SQL Server.Akcje, takie jak SIGN SQL, COPY SQL, lub MOVE SQL Opcje byłoby właściwe polecenia do łączenia z tej opcji. A SQL Server Nazwa wystąpienie może być określona przez dodanie znaku odwrotnej kreski ukośnej i nazwy instancji nazwa serwera. |
/ DestU [ser] username |
Określa nazwę użytkownika, który jest używany z SIGN SQL, COPY SQL, i MOVE SQL Opcje, aby połączyć się z SQL Server wystąpienie używający SQL Server uwierzytelniania.Jest to błąd, aby określić DESTUSER w wierszu polecenia, który nie zawiera SIGN SQL, COPY SQL, lub MOVE SQL opcji. |
/ Dump process ID |
(Opcjonalnie) Powoduje, że określony proces, albo dtexec narzędzie lub dtsDebugHost.exe proces, aby wstrzymać i tworzyć pliki automatyczna kopia zapasowa debugowania, .mdmp i .tmp. Uwaga:
Aby użyć /Dump opcji, użytkownik musi być przypisany prawo użytkownika do debugowania programów (SeDebugPrivilege).
Aby znaleźć process ID dla procesu, który chcesz wstrzymać, należy użyć Menedżera zadań Windows. Domyślnie Integration Services przechowuje pliki automatyczna kopia zapasowa debugowania w folderze <dysku>: \Program Files\Microsoft SQL Server\100\Shared\ErrorDumps. Więcej informacji o dtexec narzędzie i dtsDebugHost.exe procesu, zobacz dtexec narzędzia (narzędzie SSIS) i Budowanie, wdrażanie i debugowania obiektów niestandardowych. Aby uzyskać więcej informacji na temat debugowania plików automatyczna kopia zapasowa Zobacz Praca z plikami zrzutu debugowania. Uwaga:
Debugowania automatyczna kopia zapasowa pliki mogą zawierać poufne informacje.Użyj listy kontroli dostępu (ACL), aby ograniczyć dostęp do plików lub skopiować pliki do folderu z ograniczonym dostępem.
|
/DT [S] filespec |
Określa, że SSIS pakiet eksploatowanych na znajduje się w SSIS pakiet magazynu.filespec Argument musi zawierać ścieżka folderu, rozpoczynając od głównego SSIS pakiet magazynu.Domyślne nazwy folderów głównych w plik konfiguracji są "msdb" i "File System". Ścieżki, które zawierają spację musi rozdzielany za pomocą podwójnych cudzysłowów. Jeśli określono opcję [S] DT w wierszu polecenia jako jedną z następujących opcji, zwracany jest DTEXEC_DTEXECERROR:
|
/EN [crypt] {SQL | FILE}; Path;ProtectionLevel[;password] |
(Opcjonalnie).Szyfruje pakiet załadowany poziom ochrony określony i hasło i zapisuje go w lokalizacji określonej w Path.ProtectionLevel Określa, czy wymagane jest hasło.
ProtectionLevel opcje: Poziom 0: Paski poufnych informacji. Poziom 1: Poufne informacje są szyfrowane przy użyciu poświadczenia użytkownika lokalnego. Poziom 2: Poufne informacje są szyfrowane za pomocą hasła wymaganego. Poziom 3: Pakiet jest zaszyfrowany za pomocą hasła wymaganego. Poziom 4: Pakiet jest zaszyfrowany przy użyciu poświadczenia użytkownika lokalnego. Poziom 5 używa pakietu SQL Server Magazyn szyfrowanie. |
/Ex [ists] |
(Opcjonalnie).Used to determine whether a package exists.dtutil tries to locate the package specified by either the SQL, DTS or FILE options.Jeśli dtutil nie może zlokalizować pakiet określony, zwracany jest DTEXEC_DTEXECERROR. |
/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName |
(Opcjonalnie).Utwórz nowy folder o nazwie określonej w NewFolderName.Lokalizacja nowego folderu jest wskazywane przez ParentFolderPath. |
/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName] |
(Opcjonalnie).Usuwa z SQL Server lub SSIS , która została określona nazwa w folderze FolderName.Wskazuje lokalizację folderu, aby usunąć ParentFolderPath. |
/ FDi [rectory] {SQL | DTS};FolderPath[;S] |
(Opcjonalnie).Wyświetla zawartość folderów i pakietów w folderze na SSIS lub SQL Server.Opcjonalna FolderPath parametr określa folder, który chcesz wyświetlić zawartość.Opcjonalna S parametr określa, że chcesz wyświetlić listę zawartości podfolderów w folderze określonym w FolderPath. |
/FE[xists ] {SQL | DTS};FolderPath |
(Opcjonalnie).Sprawdza, czy podany folder istnieje w SSIS lub SQL Server.FolderPath Parametr jest ścieżka i nazwę folderu, aby zweryfikować. |
/Fi [le] filespec |
Ta opcja określa, że SSIS pakiet eksploatowanych na znajduje się w systemie plików.filespec Wartości mogą być dostarczone jako ścieżka uniwersalnej konwencji nazewnictwa (UNC) lub lokalnych ścieżką Jeśli File opcja zostanie określona w wierszu polecenia jako jedną z następujących opcji, jest zwracana DTEXEC_DTEXECERROR:
|
/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName] |
(Opcjonalnie).Zmienia nazwę folderu na SSIS lub SQL Server.ParentFolderPath Jest lokalizacją folderu do zmiany nazwy.OldFolderName Jest nazwą bieżącego folderu, a NewFolderName jest nową nazwę, aby nadać folderu. |
/H [elp] option |
Wyświetla tekst rozbudowaną pomoc, która pokazuje dtutil opcje i opisuje ich wykorzystania.Opcja argument jest opcjonalny.Jeśli argument jest włączone, tekst pomocy zawiera szczegółowe informacje na temat określonej opcji.Poniższy przykład wyświetla Pomoc dla wszystkich opcji: dtutil /H Dwa poniższe przykłady przedstawiają metody korzystania /H opcję wyświetlania rozszerzonej pomocy dla określonej opcji, /Q [uiet] opcji w tym przykładzie: dtutil /Help Quiet dtutil /H Q |
/I [DRegenerate] |
Tworzy nowy identyfikator GUID pakiet i aktualizuje właściwość identyfikator pakiet.Po skopiowaniu pakiet identyfikator pakietu pozostaje ten sam; Dlatego pliki dziennika zawierać ten sam identyfikator GUID dla obu pakietów.Ta akcja tworzy nowy identyfikator GUID pakiet nowo kopiowane do odróżnienia od oryginału. |
/M[ove] {SQL | File | DTS}; pathandname |
Określa akcja przenoszenia na SSIS pakiet.Aby używać tego parametru, należy najpierw określić lokalizację pakiet za pomocą /FI, /SQ, lub /DT opcji.Następnie należy określić Przenoszenie akcja.Ta akcja wymaga dwóch argumentów, które są oddzielone średnikami:
Gdy przenieść akcja napotka istniejący pakiet w obiekt docelowy, dtutil monituje o potwierdzenie zastąpienia pakietu.Y Odpowiedzi zastępuje pakiet i N odpowiedź kończy program.Gdy polecenie zawiera QUIET , nie zostanie wyświetlony monit i zastąpić dowolny pakiet. |
/Q [uiet] |
Zatrzymuje o potwierdzenie, wyświetlanych po tym polecenia COPY, MOVE, lub SIGN opcji jest wykonywany.Monity pojawiają się, jeśli pakiet o tej samej nazwie, jak określony pakiet już istnieje w obiekt docelowy komputera lub jeśli określony pakiet jest już zarejestrowany. |
/R [emark] text |
Dodaje komentarz do wiersza polecenia.Argument komentarz jest opcjonalny.Jeśli tekst zawiera spacje, tekst muszą być ujęte w cudzysłów.Można dołączyć wiele opcji REM w wierszu polecenia. |
/Si[gn] {SQL | File | DTS}; path; hash |
Oznaki SSIS pakiet.Akcja ta używa trzech wymagane argumenty, które są oddzielone średnikami:
Aby uzyskać więcej informacji, zobacz Podpisów cyfrowych przy użyciu pakietów. .gif "Ważna informacja") Ważne:
When configured to check the signature of the package, Integration Services only checks whether the digital signature is present, is valid, and is from a trusted source.Integration Services does not check whether the package has been changed.
|
/ SourceP [assword] password |
Określa hasło używane z SQL i SOURCEUSER Opcje umożliwiające pobierania SSIS pakiet, który jest przechowywany w bazie danych na SQL Server wystąpienie używający SQL Server uwierzytelniania.Jest to błąd, aby określić SOURCEPASSWORD w wierszu polecenia, który nie zawiera SOURCEUSER opcji. Uwaga:
Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows.
|
/ Źródeł [wierzytelnianie serwera] server_instance |
Określa nazwa serwera, który jest używany z SQL możliwość włączenia pobierania SSIS pakiet, który jest przechowywany w SQL Server.It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option. A SQL Server Nazwa wystąpienie może być określona przez dodanie znaku odwrotnej kreski ukośnej i nazwy instancji nazwa serwera. |
/ SourceU [ser] username |
Określa nazwę użytkownika, który jest używany z SOURCESERVER możliwość włączenia pobierania SSIS pakiet przechowywane w SQL Server za pomocą SQL Server uwierzytelniania.Jest to błąd, aby określić SOURCEUSER w wierszu polecenia, który nie zawiera SIGN SQL, COPY SQL, lub MOVE SQL opcji. Uwaga:
Gdy jest to możliwe, należy używać uwierzytelniania systemu Windows.
|
/SQ [L] package_path |
Określa lokalizację SSIS pakiet.Opcja ta wskazuje, że pakiet jest przechowywana w msdb bazy danych.package_path Argument określa ścieżka i nazwę SSIS pakiet.Nazwy folderów kończą ukośniki Wstecz. Jeśli SQL opcja zostanie określona w wierszu polecenia jako jedną z następujących opcji, jest zwracana DTEXEC_DTEXECERROR:
If SOURCEUSERNAME is not included, Windows Authentication is used to access the package.SOURCEPASSWORD is allowed only if SOURCEUSER is present.Jeśli SOURCEPASSWORD jest Nieuwzględnione, puste hasło jest używana. Ważne:
Nie należy używać pustego hasła. Należy używać silnego hasła.
|
dtutil (narzędzie SSIS): Kody wyjścia
dtutil ustawia kod wyjścia, który powiadamia użytkownika, kiedy wykryto błędy składni, używane są niepoprawne argumenty lub określono nieprawidłowy kombinacji opcji.W przeciwnym razie narzędzie zgłasza "Operacja została ukończona pomyślnie".W poniższej tabela przedstawiono wartości, dtutil narzędzie zestaw podczas zamykania.
Wartość |
Opis |
|---|---|
0 |
Narzędzie wykonana pomyślnie. |
1 |
Narzędzie nie powiodło się. |
4 |
Narzędzie nie może zlokalizować żądany pakiet. |
5 |
Narzędzie nie może załadować żądanego pakiet |
6 |
Narzędzie nie można rozpoznać wiersza polecenia, ponieważ zawiera błędy składni lub semantyczne. |
Uwagi
Nie można użyć polecenia plików lub przekierowanie z dtutil.
Kolejność opcji w wierszu polecenia nie ma znaczenia.
dtutil (narzędzie SSIS): Przykłady
Następujące przykłady szczegółowo wiersza polecenia typowe scenariusze użycia.
dtutil (narzędzie SSIS): Copy przykłady
Aby skopiować pakiet, który jest przechowywany w msdb lokalnego wystąpienie bazy danych SQL Server za pomocą uwierzytelniania systemu Windows do magazynu pakietu SSIS, należy użyć następującej składni:
dtutil /SQL srcPackage /COPY DTS;destFolder\destPackage
Aby skopiować pakiet z lokalizacji w systemie plików do innej lokalizacji i podać inną nazwę kopii, należy użyć następującej składni:
dtutil /FILE c:\myPackages\mypackage.dtsx /COPY FILE;c:\myTestPackages\mynewpackage.dtsx
Skopiować pakiet w systemie plik lokalny do wystąpienie SQL Server znajdujących się na innym komputerze, należy użyć następującej składni:
dtutil /FILE c:\sourcepkg.dtsx /DestServer <servername> /COPY SQL;destpkgname
Ponieważ /DestU[ser] i /DestP[assword] nie użyto opcji, przyjmowana jest uwierzytelnianie systemu Windows.
Aby utworzyć nowy identyfikator pakiet po jest kopiowana, należy użyć następującej składni:
dtutil /I /FILE copiedpkg.dtsx
Aby utworzyć nowy identyfikator dla wszystkich pakietów w określonym folderze, należy użyć następującej składni:
for %%f in (C:\test\SSISPackages\*.dtsx) do dtutil.exe /I /FILE %%f
Użyj pojedynczego znaku procentu (%), wpisując polecenia w wiersz polecenia.Jeśli polecenie jest używane wewnątrz należy użyć podwójnego znaku procentu (%) partia pliku.
dtutil (narzędzie SSIS): Usuń przykłady
Aby usunąć pakiet, który jest przechowywany w msdb bazy danych na wystąpienie SQL Server , używa uwierzytelniania systemu Windows, należy użyć następującej składni:
dtutil /SQL delPackage /DELETE
Aby usunąć pakiet, który jest przechowywany w msdb bazy danych na wystąpienie SQL Server używający SQL Server uwierzytelniania, należy użyć następującej składni:
dtutil /SQL delPackage /SOURCEUSER srcUserName /SOURCEPASSWORD #8nGs*w7F /DELETE
Ostrzeżenie
Usunąć pakiet z nazwanego serwera, należy uwzględnić SOURCESERVER opcja i argument.Serwer można określić tylko za pomocą SQL opcji.
Aby usunąć pakiet, który jest przechowywany w magazynie pakietu SSIS, należy użyć następującej składni:
dtutil /DTS delPackage.dtsx /DELETE
Aby usunąć pakiet, który jest przechowywany w systemie plików, należy użyć następującej składni:
dtutil /FILE c:\delPackage.dtsx /DELETE
dtutil (narzędzie SSIS): Istnieje przykłady
Aby określić, czy pakiet istnieje w msdb lokalnego wystąpienie bazy danych SQL Server , używa uwierzytelniania systemu Windows, należy użyć następującej składni:
dtutil /SQL srcPackage /EXISTS
Aby określić, czy pakiet istnieje w msdb lokalnego wystąpienie bazy danych SQL Server używający SQL Server uwierzytelniania, należy użyć następującej składni:
dtutil SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD *hY$d56b /EXISTS
Ostrzeżenie
Aby określić, czy pakiet istnieje na serwerze o nazwie, obejmują SOURCESERVER opcja i argument.Serwer można określić tylko przy użyciu opcji SQL.
Aby określić, czy pakiet istnieje w magazynie lokalnym pakietu, należy użyć następującej składni:
dtutil /DTS srcPackage.dtsx /EXISTS
Aby określić, czy pakiet istnieje w lokalnym systemie plików, należy użyć następującej składni:
dtutil /FILE c:\srcPackage.dtsx /EXISTS
dtutil (narzędzie SSIS): Przenieść przykłady
Aby przenieść pakiet, który jest przechowywany w magazynie pakietu SSIS do msdb lokalnego wystąpienie bazy danych SQL Server , używa uwierzytelniania systemu Windows, należy użyć następującej składni:
dtutil /DTS srcPackage.dtsx /MOVE SQL;destPackage
Aby przenieść pakiet, który jest przechowywany w msdb lokalnego wystąpienie bazy danych SQL Server używający SQL Server uwierzytelniania msdb innego lokalnego wystąpienie bazy danych SQL Server używający SQL Server uwierzytelniania, należy użyć następującej składni:
dtutil /SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD $Hj45jhd@X /MOVE SQL;destPackage /DESTUSER destUserName /DESTPASSWORD !38dsFH@v
Ostrzeżenie
Aby przenieść pakiet z jednego serwera nazwanych, obejmują SOURCES i DESTS opcji i ich argumentów.Serwery można określić tylko za pomocą SQL opcji.
Aby przenieść pakiet, który jest przechowywany w magazynie pakietu SSIS, należy użyć następującej składni:
dtutil /DTS srcPackage.dtsx /MOVE DTS;destPackage.dtsx
Aby przenieść pakiet, który jest przechowywany w systemie plików, należy użyć następującej składni:
dtutil /FILE c:\srcPackage.dtsx /MOVE FILE;c:\destPackage.dtsx
dtutil (narzędzie SSIS): Przykłady znaku
Aby zarejestrować pakiet, który jest przechowywany w SQL Server lokalnego wystąpienie bazy danych SQL Server , używa uwierzytelniania systemu Windows, należy użyć następującej składni:
dtutil /FILE srcPackage.dtsx /SIGN FILE;destpkg.dtsx;1767832648918a9d989fdac9819873a91f919
Aby znaleźć informacje dotyczące certyfikat, użyj CertMgr.Kod skrótu można wyświetlać w CertMgr narzędzie Zaznaczanie certyfikat, a następnie klikając polecenie widoku do wyświetlenia właściwości.Szczegóły karta zawiera więcej informacji o certyfikat.Thumbprintwłaściwość Jest używana jako wartość mieszania z usuniętymi spacjami.
Ostrzeżenie
Skrót używany w tym przykładzie nie jest rzeczywistym mieszania.
Aby uzyskać więcej informacji, zobacz sekcję CertMgr w podpisywania i sprawdzania kodu Authenticode.
dtutil (narzędzie SSIS): Szyfruj przykłady
Poniższy przykładowy szyfrowanie oparte na pliku PackageToEncrypt.dtsx do EncryptedPackage.dts na podstawie pliku, pełny pakiet szyfrowania przy użyciu hasła.Hasło używane do szyfrowanie jest EncPswd.
dtutil /FILE PackageToEncrypt.dtsx /ENCRYPT file;EncryptedPackage.dtsx;3;EncPswd
|
.gif "Ikona usług Integration Services (mała)")
Bieżąco z usług integracjiZobacz także