Narzędzie dtexec

The dtexec command prompt utility is used to configure and execute SQL Server Integration Services packages.The dtexec utility provides access to all the pakiet konfiguracja and execution features, such as connections, properties, variables, logging, and progress indicators.The dtexec utility lets you load packages from three sources: a Microsoft SQL Server database, the SSIS service, and the file system.

Uwaga

Podczas korzystania z wersją dtexec Narzędzie jest wyposażony wSQL Server 2008 Aby uruchomić SQL Server 2005 Integration Services (SSIS) w przypadku pakiet Integration Services tymczasowo uaktualnień pakiet do SQL Server 2008 Integration Services (SSIS). Nie można jednak użyć dtexec narzędzie, aby zapisać te uaktualniony zmian.Aby uzyskać więcej informacji dotyczących sposobu uaktualniania trwale SQL Server 2005 pakiet SQL Server 2008, zobacz Upgrading Integration Services Packages.

Uwagi dotyczące instalacji na komputerach 64-bitowych

Na komputerze z 64-bitowych Integration Services Instaluje wersja 64-bitowych dtexec narzędzie (dtexec.exe).Jeśli do uruchamiania niektórych pakietów w trybie 32-bitowe, trzeba zainstalować 32-bitową wersja dtexec narzędzie.Aby zainstalować 32-bitową wersja dtexec narzędzie, musisz wybrać klient narzędzia lub Business Intelligence Development Studio Podczas instalacji.

Domyślnie komputer 64-bitowy, ma zarówno 64-bitowych i 32-bitowych wersjach Integration Services zainstalowanego narzędzia wiersz polecenia zostanie uruchomione w 32-bitowej wersja w wiersz polecenia. 32-Bitowa wersja jest uruchamiana, ponieważ ścieżka katalogu dla wersji 32-bitowej pojawia się w zmiennej środowiskowej ścieżka przed ścieżka katalogu dla 64-bitowej wersji.(Zazwyczaj ścieżkę katalogu w 32-bitowy jest <dysk>: \Program \Microsoft SQL Server\100\DTS\Binn plików (x 86), gdy jest to ścieżka do katalogu 64-bitowych <dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn.)

Uwaga

Uruchom narzędzie za pomocą programu SQL Server Agent programu SQL Server Agent automatycznie używa wersja 64-bitowe narzędzia.Agenta programu SQL Server używa rejestru nie zmiennej środowiskowej ścieżka, aby zlokalizować poprawny plik wykonywalny dla tego narzędzia.

Aby upewnić się, uruchomić 64-bitowa wersja narzędzia wiersz polecenia, należy wykonać jedną z następujących czynności:

  • Otwórz okno wiersz polecenia, przejdź do katalogu zawierającego wersja 64-bitowych (narzędzie<dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn), a następnie uruchomić narzędzie z tej lokalizacji.

  • W wiersz polecenia Uruchom narzędzie wprowadzając (pełna ścieżka<dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn) do 64-bitowej wersja narzędzia.

  • Zmienia kolejność ścieżka w zmiennej środowiskowej ścieżka, umieszczając (64-bitowych ścieżka<dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn) przed (32-bitowe ścieżka<dysk>:\ Program Files (x 86) \Microsoft SQL Server\100\DTS\Binn) w zmiennej.

Fazy wykonanie

Narzędzie to ma cztery fazy przechodzą przez jak je wykonuje.Dostępne są następujące fazy:

  1. Faza sourcing polecenia: Wiersz polecenia odczytuje listę opcji i argumenty, które zostały określone. Wszystkie kolejne fazy są pomijane, jeśli /? or / POMOCY opcji zostanie osiągnięty.

  2. Faza ładunek pakiet: Pakiet, określony przez / SQL, / PLIKU, or / DTS opcji jest ładowany.

  3. Faza konfiguracja: Opcje są przetwarzane w następującej kolejności:

    • Opcji zestaw pakiet flag, zmiennych i właściwości.

    • Opcje sprawdzania wersja pakiet i kompilacji.

    • Opcje konfigurowania uruchamiania-czas działanie narzędzia, takie jak raportowania.

  4. Sprawdzanie poprawności i wykonanie fazy: Pakiet jest uruchomiony lub sprawdzania poprawności bez uruchamiania, jeśli / SPRAWDZANIE POPRAWNOŚCI opcji została określona.

Kody wyjściowe zwracane z narzędzia dtexec

Po uruchomieniu pakiet dtexec może zwrócić kod błędu.Kod wyjścia jest używany do wypełniania zmiennej ERRORLEVEL, których wartość może być następnie testowana w instrukcji warunkowych lub gałęzi logikę w pliku wsadowym.W poniższej tabela znajduje się lista wartości, dtexec narzędzie zestaw podczas zamykania.

Wartość

Description

0

Pakiet, została wykonana pomyślnie.

1

Pakiet nie powiodło się.

3

Pakiet został anulowany przez użytkownika.

4

Narzędzie to nie może zlokalizować żądany pakiet.Nie można odnaleźć pakiet.

5

Narzędzie to nie może załadować żądanego pakiet.Nie można załadować pakiet.

6

Narzędzie wystąpił błąd wewnętrzny błędów semantycznych lub składni w wierszu polecenia.

Składnia narzędzia Zasady

Wszystkie opcje musi zaczynać się od kreski ułamkowej (/) lub znak minus (-).Opcje, które są wyświetlane w tym polu zaczynają się od ukośnika (/), ale może być zastąpiona znak minus (-).

Argument musi być ujęty w cudzysłów zawiera spację.Jeśli argument nie jest ujęty w cudzysłów, argument nie może zawierać spacji.

Podwójna znaków cudzysłowu w cudzysłowach ciągi reprezentują oznaczenie pojedynczy cudzysłów.

Argumentów i opcji nie jest uwzględniana wielkość liter, z wyjątkiem dla hasła.

Za pomocą dtexec z xp_cmdshell

Można uruchomić dtexec z xp_cmdshell wiersza.W poniższym przykładzie pokazano, jak uruchomić pakiet o nazwie UpsertData.dtsx i zignorować kod zwrotny:

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

W poniższym przykładzie pokazano, jak uruchomić ten sam pakiet i przechwytywać zwracane kody:

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

In Microsoft SQL Server, the xp_cmdshell option is disabled by default on new installations.Opcja może być włączone, uruchamiając sp_configure systemu procedura przechowywana.Aby uzyskać więcej informacji zobaczxp_cmdshell Option.

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

Parameters

To understand how the command prompt options used with the SQL Server 2000dtsrun utility map to the command prompt options used with the SQL Serverdtexec utility, see Mapping dtsrun Options to dtexec Options.

Opcja

Description

/?[option_name]

(Opcjonalne).Wyświetla opcje wiersz polecenia lub wyświetla Pomoc dotyczącą określonego option_name a następnie zamknięcie tego narzędzia.

Jeśli określisz option_name argument, dtexec starts SQL Server Książki online i wyświetla Narzędzie dtexec temat.

/CheckF[ile]filespec

(Opcjonalne).Zestawy CheckpointFileName właściwość pakiet, który ma ścieżka oraz plik określony w filespec. Ten plik jest używany po ponownym uruchomieniu tego pakiet.Jeśli ta opcja zostanie określona wartość nie podano nazwy pliku CheckpointFileName pakiet jest zestaw na pusty ciąg. Jeśli ta opcja nie zostanie określona, wartości w polach pakiet są zachowywane.

/ CheckP [ointing]{on\off}

(Opcjonalne).Ustawia wartość, która określa, czy pakiet będzie używał punktów kontrolnych podczas wykonywania pakietu.Wartość na Określa, że należy ponownie uruchomić pakiet nie powiodło się.Gdy ponownie pakietu nie powiodło się, uruchom-czas aparat używa pliku punkt kontrolny o ponowne uruchomienie pakietu z punktem awarii.

Wartością domyślną jest na, jeżeli opcja jest zadeklarowany jako bez wartości.Pakiet wykonywanie zakończy się niepowodzeniem, jeśli wartość jest zestaw do włączony i nie można odnaleźć pliku punkt kontrolny.Jeśli ta opcja nie zostanie określona, wartość jest ustawiana pakiet jest zachowywana.Aby uzyskać więcej informacji zobaczZa pomocą kontrolnych w pakietach.

The /CheckPointing on option of dtexec is equivalent to setting the SaveCheckpoints właściwość of the pakiet to True, and the CheckpointUsage właściwość to Always.

/Com[mandFile]filespec

(Opcjonalne).Specifies that during the command sourcing phase of the utility, the file specified in filespec is opened, options from the file are read until EOF is found in the file.filespec is a text file that contains additional dtexec command options.The filespec argument specifies the file name and ścieżka of the command file to associate with the execution of the pakiet.

/Conf[igFile]filespec

(Opcjonalne).Określa plik konfiguracja wyodrębnić wartości.Użycie tej opcji, zestaw konfiguracja czas wykonania, która różni się od konfiguracja, który został określony dla tego pakiet w czasie projektowania.Można przechowywać ustawienia różnych konfiguracja w pliku XML, konfiguracja i następnie załadować ustawień przed wykonaniem pakiet przy użyciu / ConfigFile opcji.

Można użyć / ConfigFile opcję, aby załadować dodatkowe konfiguracje przy uruchomieniu czas nie określony w projekcie czas.Nie można jednak użyć / ConfigFile opcję, aby zastąpić skonfigurowane wartości, które również określić w projekcie czas.Aby dowiedzieć się, jak są stosowane konfiguracje pakiet, zobacz Package Configurations i Behavior Changes to Integration Services Features in SQL Server 2008.

/Conn[ection]id_or_name;connection_string [[;id_or_name;connection_string]…]

(Opcjonalne).Określa, że Menedżer połączeń o określonej nazwie lub identyfikator GUID znajduje się w pakiecie i określa ciąg połączenia.

Ta opcja wymaga określenia oba parametry: należy podać nazwę menedżer połączeń lub identyfikator GUID w id_or_name należy określić argument i ciąg połączenia ważne w connection_string argument. Aby uzyskać więcej informacji zobaczPołączenia usług integracja.

W czasie wykonywania, można użyć / Połączenie opcję, aby załadować konfiguracji pakiet z lokalizacji innych niż określone w czasie projektowania.Wartości te konfiguracje Zastąp wartości, które pierwotnie zostały określone.Można jednak użyć / Połączenie opcji tylko w przypadku konfiguracji, takie jak SQL Server konfiguracje, które używają menedżer połączeń. Aby dowiedzieć się, jak są stosowane konfiguracje pakiet, zobacz Package Configurations i Behavior Changes to Integration Services Features in SQL Server 2008.

/ Wad [oleLog [displayoptions];[list_options;src_name_or_guid]...

(Opcjonalne).Wyświetla określone wpisy dziennika do konsoli podczas wykonywania pakiet.Jeżeli ta opcja zostanie pominięta, nie ma wpisów dziennika są wyświetlane w konsoli.Jeśli opcja jest określona bez parametrów, które ograniczają wyświetlania, każdy wpis w dzienniku będą wyświetlane.Aby ograniczyć wpisy, które są wyświetlane w konsoli, można określić kolumny do pokazywania za pomocą displayoptions parametr, jak i limit wpisu dziennika wpisuje się przy użyciu list_options parametr.

The displayoptions values are as follows:

  • N (nazwa)

  • C (komputer)

  • O (operator)

  • S (nazwa urządzenie źródłowe)

  • K (urządzenie źródłowe GUID)

  • X (wykonanie GUID)

  • M (wiadomości)

  • T (czas początkowy i końcowy)

The list_options values are as follows:

  • I — Określa lista dołączania.Rejestrowane są wyłącznie nazwy źródeł lub identyfikatorów GUID, które są określone.

  • E — Określa listy wykluczeń.urządzenie źródłowe nazwy lub identyfikatory GUID określone nie jest zalogowany.

  • The src_name_or_guid parameter specified for inclusion or exclusion is an zdarzenie name, urządzenie źródłowe name, or urządzenie źródłowe GUID.

Jeśli używasz wielu / ConsoleLog opcji dostępnych na tym samym wiersz polecenia, współdziałają w następujący sposób:

  • Ich porządek wyświetlania nie powoduje żadnych zmian.

  • Jeżeli nie list dołączania znajdują się w wierszu polecenia, list wykluczeń są rozliczane między wszystkie rodzaje wpisów dziennika.

  • W przypadku wszelkich list dołączania w wierszu polecenia, list wykluczeń są rozliczane między sumę wszystkich list dołączania.

Przykłady kilku / ConsoleLog opcji, zobacz temat Uwagi sekcji.

/D[ts]package_path

(Opcjonalne).Ładuje pakiet z magazynu pakiet SSIS.The package_path argument specifies the relative ścieżka of the SSIS pakiet, starting at the root of the SSIS pakiet Store, and includes the name of the SSIS pakiet. Jeśli nazwa pliku lub ścieżka określona w package_path argument zawiera spacje, należy umieścić w cudzysłowie package_path argument.

The /DTS option cannot be used together with the /File or /SQL option.Jeśli określono wiele opcji dtexec kończy się niepowodzeniem.

/De [crypt] password

(Opcjonalne).Ustawia hasło odszyfrowywania używaną podczas ładowania pakiet z szyfrowanie haseł.

/ automatyczna kopia zapasowaerror code

(Opcjonalnie) Tworzy pliki automatyczna kopia zapasowa debugowania, .mdmp i .tmp, po wystąpieniu jednego lub większej liczby określonych zdarzeń po uruchomieniu tego pakiet.The error code argument specifies the type of zdarzenie code—error, warning, or information—that will trigger the system to create the debug automatyczna kopia zapasowa files. Aby określić wiele zdarzenie kodów, oddzielić od siebie error code argument średnikiem (;).

Domyślnie Integration Services w folderze, są przechowywane pliki automatyczna kopia zapasowa debugowania <dysk>: \Program Files\Microsoft SQL Server\100\Shared\ErrorDumps.

NoteNote:
Debugowania automatyczna kopia zapasowa pliki mogą zawierać poufne informacje.Użyj listy kontroli dostępu (ACL) w celu ograniczenia dostępu do plików lub skopiować pliki do folderu z ograniczonym dostępem.Na przykład przed wysłaniem plików debugowania do firmy Microsoft pomocy technicznej, zaleca usunięcie wszelkie informacje osobiste lub poufne.

Aby zastosować tę opcję do wszystkich pakietów dtexec Uruchamia narzędzie , dodać DumpOnCodes Wartość REG_SZ HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath klucz rejestru.Wartości danych DumpOnCodes określa kod błędu lub kody, które wyzwoli systemu, aby utworzyć debugowania automatyczna kopia zapasowa plików.Wiele kodów błędów muszą być oddzielone średnikiem (;).

Jeśli dodasz DumpOnCodes wartości do klucz rejestru, a następnie użyj / automatyczna kopia zapasowa opcji, system tworzy pliki automatyczna kopia zapasowa debugowania, które są oparte na oba ustawienia.

Aby uzyskać więcej informacji na temat plików automatyczna kopia zapasowa debugowania zobacz Working with Debug Dump Files.

/ DumpOnError

(Opcjonalnie) Tworzy pliki automatyczna kopia zapasowa debugowania, .mdmp i .tmp, gdy wystąpi jakiś błąd po uruchomieniu tego pakiet.

Domyślnie Integration Services w folderze, są przechowywane pliki automatyczna kopia zapasowa debugowania <dysk>: \Program Files\Microsoft SQL Server\100\Shared\ErrorDumps folderu.

NoteNote:
Debugowania automatyczna kopia zapasowa pliki mogą zawierać poufne informacje.Użyj listy kontroli dostępu (ACL) w celu ograniczenia dostępu do plików lub skopiować pliki do folderu z ograniczonym dostępem.Na przykład przed wysłaniem plików debugowania do firmy Microsoft pomocy technicznej, zaleca usunięcie wszelkie informacje osobiste lub poufne.

Aby zastosować tę opcję do wszystkich pakietów dtexec Uruchamia narzędzie , dodać DumpOnError Wartość parametru REG_DWORD HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath klucz rejestru.Wartość DumpOnError Wartość REG_DWORD Określa, czy / DumpOnError Opcja musi być używany z dtexec utility:

  • Wartość różną od zera oznacza, że system utworzy pliki automatyczna kopia zapasowa debugowania, gdy wystąpi jakiś błąd, niezależnie od tego, czy używasz / DumpOnError opcjidtexec narzędzie.

  • Wartość zerowa danych oznacza, że system nie utworzy debug pliki automatyczna kopia zapasowa o ile nie użyto / DumpOnError opcjidtexec narzędzie.

Aby uzyskać więcej informacji na temat plików automatyczna kopia zapasowa debugowania zobacz Working with Debug Dump Files.

/F[ile]filespec

(Opcjonalne).Ładuje pakiet, który jest zapisany w systemie plików.The filespec argument specifies the ścieżka and file name of the pakiet. Aby określić ścieżkę, jak ścieżka uniwersalnej konwencja nazewnictwa (UNC) lub ścieżkę lokalną.Jeśli nazwa pliku lub ścieżka określona w filespec argument zawiera spacje, należy umieścić w cudzysłowie filespec argument.

The /File option cannot be used together with the /DTS or /SQL option.Jeśli określono wiele opcji dtexec kończy się niepowodzeniem.

/H[elp] [option_name]

(Opcjonalne).Wyświetla Pomoc dotyczącą opcji, lub wyświetla Pomoc dotyczącą określonego option_name i zamknięcie tego narzędzia.

Jeśli określisz option_name argument, dtexec starts SQL Server Książki online i wyświetla Narzędzie dtexec temat.

/L[ogger]classid_orprogid;configstring

(Opcjonalne).Kojarzy jednego lub kilku dostawców dzienników z realizacji SSIS pakiet. The classid_orprogid parameter specifies the dostawca dziennika, and can be specified as a class GUID. The configstring is the ciąg that is used to configure the log dostawca.

Na poniższej liście przedstawiono dostępne włączeni:

  • Plik tekstowy:

    • Programu: DTS.LogProviderTextFile.1

    • Identyfikatora klasy: {59B2C6A5-663F-4 C C83F9B72E2EB DO 8863 20}

  • SQL Server Profiler:

    • Programu: DTS.LogProviderSQLProfiler.1

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

  • SQL Server:

    • Programu: DTS.LogProviderSQLServer.1

    • Identyfikatora klasy: {6AA833A1-E4B2-4431-831B-DE695049DC61}

  • Dziennik zdarzeń systemu Windows:

    • Programu: DTS.LogProviderEventLog.1

    • Identyfikatora klasy: {97634F75-1DC7-4F1F-8A4C-DAF0E13AAA22}

  • Plik XML:

    • Programu: DTS.LogProviderXMLFile.1

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

/M[axConcurrent]concurrent_executables

(Opcjonalne).Określa liczbę plików wykonywalnych, które jednocześnie mogą działać pakiet.Określona wartość musi być nieujemną liczbą całkowitą lub -1.Wartość -1 oznacza, że SSIS Umożliwia maksymalną liczbę jednocześnie uruchomionych plików wykonywalnych, które jest równa całkowitej liczby procesorów w komputerze wykonywania pakiet plus dwa.

/P[assword]password

(Opcjonalne).Umożliwia pobieranie pakiet, który jest chroniony SQL Server Uwierzytelnianie. Ta opcja jest używana wraz z / Użytkowników opcji.Jeśli / Hasło pominięto opcję a / Użytkowników opcja jest używana, używane jest hasło puste.The password value may be quoted.

Security noteSecurity Note:
When possible, use Windows Authentication.

/Remcomment

(Opcjonalne).Zawiera komentarze w wiersz polecenia lub pliki poleceń.Argument jest opcjonalny.Wartość comment to ciąg, który musi być ujęty w znaki cudzysłowu lub zawierać nie odstępów. If no argument is specified, a blank line is inserted.comment values are discarded during the command sourcing phase.

/Rep[orting]level [;event_guid_or_name[;event_guid_or_name[...]]

(Opcjonalne).Określa, jakie rodzaje komunikatów do raportu.Dostępne opcje raportowania level są następujące:

N    Nie raportowania.

E    Błędy są zgłaszane.

W    Zgłaszane są ostrzeżenia.

I    Zgłaszane są komunikaty informacyjne.

C    Zdarzenia niestandardowe są raportowane.

D    Zgłaszane są zdarzenia zadanie przepływ danych.

P    Po zgłoszeniu postępu.

V    Raportowanie informacji pełnej.

Argumenty V i N wzajemnie się wykluczają do wszystkich argumentów, należy samodzielnie określić ich.Jeśli / Raportowanie nie określono opcji jest domyślny poziomE (błędy) W (ostrzeżenia) i P (postępu).

Wszystkie zdarzenia są poprzedzone znakiem sygnaturę czasową w formacie gg: mm: „ RR/MM/DD ss", a identyfikator GUID lub przyjazną nazwę, jeśli są dostępne.

Parametr opcjonalny event_guid_or_name jest to lista wyjątków od dostawców dzienników. Ta zasada Określa zdarzenia, które nie są rejestrowane, które w przeciwnym razie może zostać zarejestrowany.

Nie trzeba wykluczyć zdarzenia, jeśli zdarzenie to nie jest zwykle rejestrowane domyślnie

/ Res [rozpoczęcia {deny | force | ifPossible}

(Opcjonalne).Określa nową wartość dla CheckpointUsage() właściwość pakiet. Znaczenie parametry są następujące:

Deny   Zestawy CheckpointUsage() Właściwość DTSCU_NEVER().

Force   Zestawy CheckpointUsage() Właściwość DTSCU_ALWAYS().

ifPossible   Zestawy CheckpointUsage() Właściwość DTSCU_IFEXISTS().

Wartość domyślna Wymuszanie jest używana, jeśli nie określono wartości.

/SetpropertyPath;value

(Opcjonalne).Zastępuje konfiguracja zmiennej, właściwość, kontener, dostawca dziennika, moduł wyliczający Foreach lub połączenia w ramach pakiet.Gdy ta opcja jest używana, / zestaw zmienia siępropertyPath argument na wartość określoną. Wiele / zestaw można określić opcje.

Można określić wartość propertyPath uruchamiając Kreatora konfiguracja pakiet. Ścieżki dla wybranych elementów są wyświetlane na ostatni Kończenie pracy Kreatora strona i może być skopiowany i wklejony.Jeśli Kreator był używany tylko w tym celu, po skopiowaniu ścieżki można anulować działanie kreatora.

Poniżej przedstawiono przykład wykonywania pakiet oraz dostarczanie nowych wartości dla zmiennej:

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

Można użyć / zestaw opcję, aby zmienić lokalizację, z której pakiet konfiguracje są ładowane.Nie można jednak użyć / zestaw opcję, aby zastąpić wartość, która została określona w konfiguracja w czasie projektowania.Aby dowiedzieć się, jak są stosowane konfiguracje pakiet, zobacz Package Configurations i Behavior Changes to Integration Services Features in SQL Server 2008.

/Ser[ver]server

(Opcjonalne).Gdy / SQL or / DTS opcja zostanie określona, opcja ta określa nazwę serwera, z których można pobrać pakiet bazy danych.Jeśli pominięto / Serwer Opcja a / SQL or / DTS opcja zostanie określona, wykonanie pakiet zostanie podjęta próba na lokalnym serwerze.The server_instance value may be quoted.

/SQ[L]package_path

Ładuje pakiet, który jest przechowywany w SQL Server. The package_path argument specifies the name of the pakiet to retrieve. Jeśli foldery znajdują się w ścieżce, są one zakończyła ukośników odwrotnych ("\").The package_path value can be quoted.Jeśli nazwa pliku lub ścieżka określona w package_path argument zawiera spacje, należy umieścić w cudzysłowie package_path argument.

Można użyć / Użytkowników, / Hasło, and / Serwer opcje / SQL opcji.

Jeśli pominięto / Użytkowników opcję Uwierzytelnianie systemu Windows umożliwia dostęp do pakiet.Jeśli używasz / Użytkowników opcji/ Użytkowników Określona nazwa logowania -skojarzony jestSQL Server Uwierzytelnianie.

The /Password option is used only together with the /User option.Jeśli używasz / Hasło opcji, pakiet jest dostępny przy użyciu udostępnionych informacji nazwy i hasła użytkownika.Jeśli pominięto / Hasło opcja, puste hasło jest używana.

Security noteSecurity Note:
When possible, use Windows Authentication.

Jeśli / Serwer opcja zostanie pominięta, lokalnym domyślnym wystąpienie SQL Server przyjęto, że.

The /SQL option cannot be used together with the /DTS or /File option.Jeśli określono wiele opcji dtexec kończy się niepowodzeniem.

/Su [m]

(Opcjonalne).Pokazuje przyrostowe licznika, zawierającą liczbę wierszy, które będą odbierane przez składnik następnej.

/U[ser]user_name

(Opcjonalne).Umożliwia pobieranie pakiet, który jest chroniony SQL Server Uwierzytelnianie. Ta opcja jest używana tylko wtedy, gdy / SQL określono opcję. The user_name value can be quoted.

Security noteSecurity Note:
When possible, use Windows Authentication.

/Va [lidate]

(Opcjonalne).Zatrzymuje wykonywanie pakiet po fazie niepoprawny bez faktycznie uruchomienia pakiet.Podczas sprawdzania poprawności, należy użyć programu / WarnAsError Opcja powoduje, żedtexec traktowanie ostrzeżenie jako błąd; w związku z tym pakiet kończy się niepowodzeniem, jeśli pojawia się komunikat ostrzegawczy podczas sprawdzania poprawności.

/VerifyB[uild]major[;minor[;build]]

(Opcjonalne).Sprawdza numer kompilacji pakiet przed numerów kompilacji, które zostały określone w trakcie fazy weryfikacji w major, minor, a build argumenty. Jeśli wystąpi niezgodność, pakiet nie będzie wykonać.

Wartości to liczby całkowite długie.Argument może mieć jeden z trzech formularzach o wartości dla major zawsze jest to wymagane:

  • major

  • major;minor

  • major; minor; build

/VerifyP[ackageID]packageID

(Opcjonalne).Sprawdza identyfikator GUID pakiet mają być zrealizowane przez porównanie z wartości określonej w polu package_id argument.

/ VerifyS [igned]

(Opcjonalne).Powoduje, że Integration Services Aby sprawdzić, czy podpis cyfrowy do pakiet. Jeżeli pakiet nie jest podpisany lub podpis nie jest prawidłowy, pakiet nie powiedzie się.Aby uzyskać więcej informacji zobaczUsing Digital Signatures with Packages.

Important noteImportant Note:
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.
NoteNote:
Opcjonalny BlockedSignatureStates wartości rejestru może określić ting zestaw, który jest bardziej restrykcyjne, niż opcja podpis cyfrowy zestaw w Business Intelligence Development Studio lub na dtexec wiersz polecenia.W takim przypadku bardziej restrykcyjne ustawienia rejestru zastępuje inne ustawienia.

/VerifyV[ersionID]versionID

(Opcjonalne).Weryfikuje wersja identyfikator GUID pakiet mają być zrealizowane przez porównanie z wartości określonej w polu version_id argument podczas fazy sprawdzania poprawności pakiet.

/ VLog[Filespec]

(Opcjonalne).Zapisuje wszystkie zdarzenia pakiet usług integracja Services dostawców dzienników, które zostały włączone, gdy został zaprojektowany do pakiet.Aby integracja Services włączyć dostawca dziennika w przypadku plików tekstowych i zapisać dziennika zdarzeń w pliku określony tekst, należy dołączyć ścieżka i nazwę, jak Filespec parametr.

Jeżeli nie dołączono Filespec Parametr integracja Services nie umożliwi dostawca dziennika dla plików tekstowych. Integracja usług będzie zapisywać tylko zdarzenia z dziennika do dostawców dzienników, które zostały włączone, gdy został zaprojektowany do pakiet.

/W [arnAsError]

(Opcjonalne).Powoduje, że pakiet, aby wziąć pod uwagę ostrzeżenie jako błąd; dlatego pakiet zawiedzie, jeżeli pojawia się komunikat ostrzegawczy podczas sprawdzania poprawności.Jeśli podczas sprawdzania poprawności nie ostrzeżenia, / Sprawdzanie poprawności opcja nie zostanie określona, pakiet jest wykonywane.

DLA KOMPUTERÓW Z PROCESORAMI X 86

(Opcjonalne).Powoduje, że SQL Server Agent, aby uruchomić pakiet w trybie 32-bitowe na komputerze 64-bitowym. Ta opcja jest zestaw przez SQL Server Agent, gdy są spełnione następujące warunki:

  • Dla zadanie typu krok Pakiet usług SQL Server integracja Services.

  • The Use 32 bit runtime option on the Execution options tab of the New zadanie Step dialog box is selected.

Można także ustawić tę opcję dla SQL Server Etap zadania agenta za pomocą przechowywane procedury lub obiektów SQL Server Management Objects (SMO) programowo utworzyć zadanie.

Ta opcja jest używana tylko przez SQL Server Agent. Opcja ta jest ignorowana, jeżeli uruchamiasz dtexec narzędzie w wiersz polecenia.

Remarks

Kolejność, w której zostanie określone opcje polecenia może mieć wpływ sposób, w którym wykonuje pakiet:

  • Opcje są przetwarzane w kolejności, wystąpi w wierszu polecenia.Pliki poleceń są odczytywane w jak występują one w wierszu polecenia.Polecenia w pliku poleceń również są przetwarzane w kolejności, są one napotkał.

  • Opcja, parametr lub zmienna znajduje się w tej samej instrukcja wiersza polecenia więcej niż jeden raz, pierwszeństwo ma opcja ostatnie wystąpienie.

  • / zestaw and / ConfigFile opcje są przetwarzane w kolejności ich wystąpią.

Przykłady

Uruchamianie pakiety

Aby wykonać SSIS pakiet zapisany SQL Server przy użyciu uwierzytelnianie systemu Windows, należy użyć następującego kodu:

dtexec /sq pkgOne /ser productionServer

Aby wykonać SSIS pakiet zapisany w folderze systemu plików w magazynie pakietu SSIS, należy użyć następującego kodu:

dtexec /dts "\File System\MyPackage"

Aby sprawdzić poprawność pakiet, który korzysta z uwierzytelnianie systemu Windows i zostanie zapisany w SQL Server bez wykonywania pakietu, należy użyć następującego kodu:

dtexec /sq pkgOne /ser productionServer /va

Aby wykonać SSIS pakiet, który jest zapisywany w systemie plików, należy użyć następującego kodu:

dtexec /f "c:\pkgOne.dtsx" 

Aby wykonać SSIS pakiet, który jest zapisywany w systemie plików i określ opcje rejestrowania, użyj następującego kodu:

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

Aby uruchomić pakiet, który korzysta z uwierzytelnianie systemu Windows i zostanie zapisany z lokalnym domyślnym wystąpienie z SQL Serveri sprawdzić wersja przed jego wykonaniem, należy użyć następującego kodu:

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

Aby wykonać SSIS pakiet, który jest zapisany w systemie plików i skonfigurowany zewnętrznie, należy użyć następującego kodu:

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

Uwaga

The package_path or filespec arguments of the /SQL, /DTS, or /FILE options must be enclosed in quotation marks if the ścieżka or file name contains a space. Jeśli argument nie jest ujęty w cudzysłów, argument nie może zawierać spacji.

Opcje rejestrowania

W przypadku logowania trzy typy zapisów a, B i C, następujące ConsoleLog opcji bez parametrów wyświetla wszystkie trzy typy dzienników z wszystkich pól:

/CONSOLELOG

Następująca opcja wyświetla wszystkie typy dziennika, ale tylko kolumny Nazwa i wiadomości:

/CONSOLELOG NM

Następująca opcja wyświetla wszystkie kolumny, ale tylko dla wpisu dziennika wpisz A:

/CONSOLELOG I;LogEntryTypeA

Następująca opcja wyświetla tylko dziennika zapis typu A, w kolumnach Nazwa i wiadomości:

/CONSOLELOG NM;I;LogEntryTypeA

Następująca opcja wyświetla pozycje dziennika dla typów zapisów dziennika A i B:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB

Możesz osiągnąć to samo wyniki przy użyciu wielu ConsoleLog options:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB

Jeśli ConsoleLog opcja jest używana bez parametrów, wyświetlane są wszystkie pola.Włączenie list_options Parametr powoduje, że następujące wyświetla tylko dziennika zapis typu A, z wszystkich pól:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG

Następujące Wyświetla wszystkie wpisy dziennika z wyjątkiem rejestrowania typ wpisu A: oznacza to wyświetla typy zapisów dziennika B i C:

/CONSOLELOG E;LogEntryTypeA

W poniższym przykładzie uzyskuje ten sam rezultat co przy użyciu wielu ConsoleLog opcji i pojedyncze wykluczenia:

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

Poniższy przykład przedstawia nie wiadomości dziennika, ponieważ, gdy typ pliku dziennika znajduje się na listach dołączone i wykluczone, zostaną wykluczone.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA

Opcja zestaw

Poniżej przedstawiono sposób użycia / zestaw opcja, która pozwala na zmianę wartości właściwość pakiet lub zmiennej podczas uruchamiania pakiet z wiersza polecenia.

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

Historia zmian

Microsoft Learning

  • Opis każdej odpowiedniej opcji dodanej akapitu, w którym wyjaśniono sposób używania / ConfigFile, / Połączenie, and / zestaw opcji przy uruchomieniu czas.