Paketausführungsprogramm (dtexecui)

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Verwenden Sie das Paketausführungshilfsprogramm , um Integration Services -Pakete auszuführen. Das Hilfsprogramm führt Pakete aus, die an einem von drei Speicherorten gespeichert wurden: in der Microsoft SQL Server-Datenbank, im SSIS-Paketspeicher und im Dateisystem. Diese Benutzeroberfläche, die über SQL Server Management Studio oder durch Eingeben von dtexecui an der Eingabeaufforderung geöffnet werden kann, stellt eine Alternative zum Ausführen von Paketen mithilfe des Eingabeaufforderungstools DTExec dar.

Pakete werden im selben Prozess ausgeführt wie das dtexecui.exe -Hilfsprogramm. Da es sich bei diesem Hilfsprogramm um ein 32-Bit-Tool handelt, werden Pakete, die mithilfe von dtexecui.exe in einer 64-Bit-Umgebung ausgeführt werden, in Windows unter Win32 (WOW) ausgeführt. Beim Entwickeln und Testen von Befehlen mithilfe des Paketausführungshilfsprogramms (dtexecui.exe) auf einem 64-Bit-Computer sollten Sie die Befehle mithilfe der 64-Bit-Version von dtexec.exe im 64-Bit-Modus testen, bevor Sie die Befehle auf einem Produktionsserver bereitstellen oder deren Ausführung planen.

Das Paketausführungshilfsprogramm ist eine grafische Benutzeroberfläche für das Eingabeaufforderungs-Hilfsprogramm DTExec . Die Benutzeroberfläche erleichtert das Konfigurieren von Optionen und stellt automatisch die Befehlszeile zusammen, die an das Eingabeaufforderungs-Hilfsprogramm DTExec übergeben wird, wenn Sie das Paket unter den angegebenen Optionen ausführen.

Das Paketausführungshilfsprogramm eignet sich auch zum Erstellen von Befehlszeilen, die Sie verwenden, wenn DTExec direkt ausgeführt wird.

So öffnen Sie das Paketausführungsprogramm in SQL Server Management Studio

1. Klicken Sie in SQL Server Management Studioim Menü Ansicht auf Objekt-Explorer.

2. Klicken Sie im Objekt-Explorer auf Verbinden, und klicken Sie anschließend auf Integration Services.

3. Geben Sie im Dialogfeld Verbindung mit Server herstellen in der Liste Servername den Servernamen ein, und klicken Sie anschließend auf Verbinden.

4. Erweitern Sie den Ordner Gespeicherte Paketeund dessen Unterordner, klicken Sie mit der rechten Maustaste auf das Paket, das Sie ausführen möchten, und klicken Sie anschließend auf Paket ausführen.

So öffnen Sie das Paketausführungsprogramm an der Eingabeaufforderung

• Öffnen Sie ein Eingabeaufforderungsfenster, und führen Sie dtexecuiaus.

In den folgenden Abschnitten werden Seiten des Dialogfelds Paketausführungshilfsprogramm beschrieben.

Seite Allgemein

Auf der Seite Allgemein des Dialogfelds Paketausführungshilfsprogramm können Sie einen Namen und einen Speicherort für das Paket angeben.

Das Paketausführungshilfsprogramm (dtexecui.exe) führt Pakete immer auf dem lokalen Computer aus, auch wenn das Paket auf einem Remoteserver gespeichert ist. Falls das Remotepaket Konfigurationsdateien verwendet, die ebenfalls auf dem Remoteserver gespeichert sind, kann das Paketausführungshilfsprogramm die Konfigurationen u. U. nicht finden und das Paket nicht ausführen. Zum Vermeiden dieses Problems müssen für Verweise auf Konfigurationen UNC-Freigabenamen (Universal Naming Convention) verwendet werden, z. B. \\myserver\myfile.

Statische Optionen

Paketquelle
Geben Sie mithilfe der folgenden Optionen den Speicherort des Pakets an:

Wert	BESCHREIBUNG
SQL Server	Wählen Sie diese Option, wenn das Paket auf Microsoft SQL Server gespeichert ist. Geben Sie eine Instanz von SQL Server und einen Benutzernamen und das Kennwort für die SQL Server -Authentifizierung an. Für jeden Benutzernamen und jedes Kennwort werden an der Eingabeaufforderungen die Optionen /USER Benutzername und /PASSWORD Kennwort hinzugefügt.
Dateisystem	Wählen Sie diese Option, wenn das Paket im Dateisystem gespeichert ist.
SSIS-Paketspeicher	Wählen Sie diese Option aus, wenn das Paket im SSIS -Paketspeicher gespeichert ist.

Mit jeder dieser Auswahlmöglichkeiten sind die folgenden Optionen verbunden.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Dynamische Optionen

Package Source = SQL Server

Server
Geben Sie den Namen des Servers ein, auf dem das Paket gespeichert ist, oder wählen Sie einen Server aus der Liste aus.

Am Server anmelden
Gibt an, ob das Paket zum Herstellen der Verbindung mit SQL Server die Windows-Authentifizierung oder die SQL Server-Authentifizierung verwenden soll. Im Sinne einer größeren Sicherheit wird die Windows-Authentifizierung empfohlen. Bei der Windows-Authentifizierung müssen Sie keinen Benutzernamen und das zugehörige Kennwort angeben.

Windows-Authentifizierung verwenden
Wählen Sie diese Option aus, um die Windows-Authentifizierung zu verwenden und sich mithilfe eines Microsoft Windows-Benutzerkontos anzumelden.

SQL Server-Authentifizierung verwenden
Wählen Sie diese Option aus, um die SQL Server -Authentifizierung zu verwenden. Wenn ein Benutzer eine Verbindung mit einem angegebenen Benutzernamen und einem Kennwort von einer nicht vertrauenswürdigen Verbindung herstellt, führt SQL Server die Authentifizierung aus, indem überprüft wird, ob ein SQL Server -Anmeldekonto eingerichtet wurde und ob das angegebene Kennwort mit dem zuvor aufgezeichneten übereinstimmt. Wenn SQL Server das Anmeldekonto nicht finden kann, schlägt die Authentifizierung fehl und der Benutzer erhält eine Fehlermeldung.

Wichtig

Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

Pakete
Geben Sie den Namen des Pakets ein, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um das Paket mithilfe des Dialogfelds SSIS-Paket auswählen zu suchen.

Package Source = File System

Pakete
Geben Sie den Namen des Pakets ein, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um das Paket mithilfe des Dialogfelds „Öffnen“ zu suchen. In dem Dialogfeld werden standardmäßig nur Dateien mit der Erweiterung .dtsx aufgelistet.

Package Source = SSIS Package Store

Server
Geben Sie den Namen des Computers ein, auf dem das Paket gespeichert ist, oder wählen Sie einen Computer aus der Liste aus.

Am Server anmelden
Gibt an, ob das Paket die Microsoft Windows-Authentifizierung verwenden soll, um eine Verbindung mit der Paketquelle herzustellen. Im Sinne einer größeren Sicherheit wird die Windows-Authentifizierung empfohlen. Bei der Windows-Authentifizierung müssen Sie keinen Benutzernamen und das zugehörige Kennwort angeben.

Windows-Authentifizierung verwenden
Wählen Sie diese Option aus, um die Windows-Authentifizierung zu verwenden und sich mithilfe eines Microsoft Windows-Benutzerkontos anzumelden.

SQL Server-Authentifizierung verwenden
Diese Option ist nicht verfügbar, wenn Sie ein in SSIS-Paketspeichergespeichertes Paket ausführen.

Pakete
Geben Sie den Namen des Pakets ein, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um das Paket mithilfe des Dialogfelds SSIS-Paket auswählen zu suchen.

Konfigurationsseite

Auf der Seite Konfigurationen des Dialogfelds Paketausführungsprogramm wählen Sie die Konfigurationsdateien aus, die zur Laufzeit geladen werden sollen, und geben Sie die Reihenfolge an, in der sie geladen werden sollen.

Tastatur

Konfigurationsdateien
Listet die vom Paket verwendeten Konfigurationen auf. Durch jede der Konfigurationsdateien wird der Eingabeaufforderung eine Option /CONFIGFILE filename hinzugefügt.

Pfeiltasten
Wählen Sie eine Konfigurationsdatei in der Liste aus, und ändern Sie die Reihenfolge für den Ladevorgang mithilfe der Pfeiltasten auf der rechten Seite. Die Konfigurationen werden beginnend mit der obersten in der Listenreihenfolge geladen.

Hinweis

Wenn eine Eigenschaft durch mehrere Konfigurationen geändert wird, wird die zuletzt geladene Konfiguration verwendet.

Add (Hinzufügen)
Klicken Sie auf diese Option, um Konfigurationen mithilfe des Dialogfelds Öffnen hinzuzufügen. In dem Dialogfeld werden standardmäßig nur Dateien mit der Erweiterung .dtsconfig aufgelistet.

Remove
Wählen Sie in der Liste eine Konfigurationsdatei aus, und klicken Sie anschließend auf Entfernen.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Seite "Befehlsdateien"

Wählen Sie auf der Seite Befehlsdateien des Dialogfelds Paketausführungsprogramm die Befehlsdateien aus, die zur Laufzeit geladen werden sollen.

Tastatur

Befehlsdateien
Führt die vom Paket verwendeten Befehlsdateien auf. Ein Paket kann mehrere Dateien verwenden, um Befehlszeilenoptionen festzulegen.

Pfeiltasten
Wählen Sie eine Befehlsdatei in der Liste aus, und ändern Sie die Reihenfolge für den Ladevorgang mithilfe der Pfeiltasten auf der rechten Seite. Die Befehlsdateien werden der Reihe nach beginnend mit der obersten in der Liste geladen.

Add (Hinzufügen)
Klicken Sie auf diese Option, um eine Befehlsdatei mithilfe des Dialogfelds Öffnen hinzuzufügen.

Remove
Wählen Sie im Textfeld eine Befehlsdatei aus, und entfernen Sie sie anschließend mithilfe der Schaltfläche Entfernen .

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Seite "Verbindungs-Manager"

Auf der Seite Verbindungs-Manager des Dialogfelds Paketausführungshilfsprogramm können Sie die Verbindungszeichenfolgen der vom Paket verwendeten Verbindungs-Manager bearbeiten.

Tastatur

Verbindungs-Manager
Aktivieren Sie dieses Kontrollkästchen, um die Verbindungszeichenfolge -Spalte bearbeiten zu können.

Beschreibung
Zeigt eine Beschreibung für jeden Verbindungs-Manager an. Die Beschreibungen können nicht bearbeitet werden.

Verbindungszeichenfolge
Bearbeiten Sie die Verbindungszeichenfolge für einen Verbindungs-Manager. Dieses Feld kann nur bearbeitet werden, wenn das Kontrollkästchen Verbindungs-Manager aktiviert ist.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Seite "Ausführungsoptionen"

Auf der Seite Ausführungsoptionen des Dialogfelds Paketausführungshilfsprogramm können Sie Laufzeitoptionen für das Paket angeben.

Tastatur

Paket bei Überprüfungswarnungen fehlschlagen lassen
Gibt an, ob ein Paket fehlschlägt, wenn eine Überprüfungswarnung auftritt.

Paket ohne Ausführung überprüfen
Gibt an, ob das Paket nur überprüft wird.

Maximale Anzahl von gleichzeitig ausführbaren Dateien
Gibt an, ob Sie die maximale Anzahl der ausführbaren Dateien angeben möchten, die gleichzeitig im Paket ausgeführt werden können. Nachdem Sie dieses Kontrollkästchen aktiviert haben, verwenden Sie das Drehfeld, um die maximale Anzahl von ausführbaren Dateien anzugeben.

Paketprüfpunkte aktivieren
Gibt an, ob Paketprüfpunkte aktiviert sind.

Prüfpunktdatei
Führt die vom Paket verwendete Prüfpunktdatei auf, wenn die Paketprüfpunkte aktiviert sind.

Durchsuchen
Klicken Sie auf die Schaltfläche zum Durchsuchen (…), um die Prüfpunktdatei mithilfe des Dialogfelds Öffnen zu suchen, wenn Paketprüfpunkte aktiviert sind. Wenn bereits eine Prüfpunktdatei angegeben ist, wird diese durch die ausgewählte Datei ersetzt.

Neustartoptionen überschreiben
Gibt an, ob die Neustartoptionen überschrieben werden, wenn Sie die Paketprüfpunkte aktivieren.

Neustartoption
Wählen Sie aus, wie die Prüfpunkte verwendet werden sollen, wenn die Neustartoptionen überschrieben werden.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Berichtsseite

Auf der Seite Berichterstellung des Dialogfelds Paketausführungsprogramm können Sie angeben, welche Ereignisse und Informationen zu dem Paket beim Ausführen des Pakets an der Konsole protokolliert werden sollen.

Tastatur

Konsolenereignisse
Geben Sie die Ereignisse und Meldungstypen an, die gemeldet werden sollen.

None
Wählen Sie diese Option aus, um keinerlei Informationen zu melden.

Fehler
Wählen Sie diese Option aus, um Fehlermeldungen zu melden.

Warnungen
Wählen Sie diese Option aus, um Warnungen zu melden.

Benutzerdefinierte Ereignisse
Wählen Sie diese Option aus, um Meldungen zu benutzerdefinierten Ereignissen zu melden.

Pipelineereignisse
Wählen Sie diese Option aus, um Meldungen zu Datenflussereignissen zu melden.

Information
Wählen Sie diese Option aus, um Informationsmeldungen zu melden.

Ausführlich
Wählen Sie diese Option aus, um die ausführliche Berichterstellung zu verwenden.

Konsolenprotokollierung
Geben Sie die Informationen ein, die in das Protokoll geschrieben werden sollen, wenn das ausgewählte Ereignis eintritt.

Name
Wählen Sie diese Option aus, wenn der Name der Person gemeldet werden soll, die das Paket erstellt hat.

Computer
Wählen Sie diese Option aus, um den Namen des Computers zu melden, auf dem das Paket ausgeführt wird.

Operator
Wählen Sie diese Option aus, wenn der Name der Person gemeldet werden soll, die das Paket gestartet hat.

Quellname
Wählen Sie diese Option aus, um den Paketnamen zu melden.

Quell-GUID
Wählen Sie diese Option aus, um die GUID des Pakets zu melden.

Ausführungs-GUID
Wählen Sie diese Option aus, um die GUID der Paketausführungsinstanz zu melden.

Meldung
Wählen Sie diese Option aus, um Meldungen zu melden.

Startzeit und Beendigungszeit
Wählen Sie diese Option aus, um zu melden, wann das Paket gestartet und beendet wurde.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Protokollierungsseite

Auf der Seite Protokollierung des Dialogfelds Paketausführungsprogramm können Sie festlegen, welche Protokollanbieter dem Paket zur Laufzeit zur Verfügung stehen sollen. Stellen Sie den Typ des Paketprotokollanbieters und die Verbindungszeichenfolge für die Verbindung mit dem Protokoll bereit. Für jeden Protokollanbietereintrag wird der Eingabeaufforderung eine Instanz der Option /LOGGERclassid hinzugefügt.

Tastatur

Protokollanbieter
Wählen Sie einen Protokollanbieter aus der Liste aus.

Konfigurationszeichenfolge
Wählen Sie den Namen des Verbindungs-Managers aus dem Paket aus, das auf den Speicherort des Protokolls zeigt, oder geben Sie die Verbindungszeichenfolge für die Verbindung mit dem Protokollanbieter ein.

Remove
Wählen Sie einen Protokollanbieter aus, und klicken Sie auf ihn, um ihn zu entfernen.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Seite "Werte festlegen"

Auf der Seite Werte festlegen des Dialogfelds Paketausführungsprogramm können Sie die Eigenschaftenwerte von Paketen, ausführbaren Dateien, Verbindungen, Variablen und Protokollanbietern festlegen, indem Sie die Pfade der Eigenschaften und die Eigenschaftenwerte eingeben. Für jeden Pfadeintrag wird der Eingabeaufforderung eine Instanz der Option /SETpropertypath;value hinzugefügt.

Tastatur

Eigenschaftspfad
Geben Sie den Pfad der Eigenschaft ein. In der Pfadsyntax wird der umgekehrte Schrägstrich (\) verwendet, um zu kennzeichnen, dass es sich beim nächsten Element um einen Container handelt, durch einen Punkt (.) wird gekennzeichnet, dass das folgende Element eine Eigenschaft ist, und Klammern kennzeichnen ein Sammelelement. Das Element kann anhand seines Index oder Namens identifiziert werden. Der Eigenschaftspfad einer Paketvariablen lautet beispielsweise \Package.Variables[MyVariable].Value.

Wert
Geben Sie den Wert der Eigenschaft ein.

Remove
Wählen Sie einen Eigenschaftspfad aus, und klicken Sie darauf, um ihn zu entfernen.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Überprüfungsseite

Auf der Seite Überprüfung des Dialogfelds Paket ausführen können Sie Kriterien zum Überprüfen des Pakets festlegen.

Tastatur

Nur signierte Pakete ausführen
Wählen Sie diese Option aus, um nur signierte Pakete auszuführen.

Paketbuild überprüfen
Wählen Sie diese Option aus, um das Paketbuild zu überprüfen.

Build
Geben Sie die dem Build zugeordnete fortlaufende Buildnummer an.

Paket-ID überprüfen
Wählen Sie diese Option aus, um die Paket-ID zu überprüfen.

Paket-ID
Geben Sie die Paket-ID an.

Versions-ID überprüfen
Wählen Sie diese Option aus, um die Versions-ID zu überprüfen.

Versions-ID
Geben Sie die Versions-ID an.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Befehlszeilenseite

Auf der Seite Befehlszeile des Dialogfelds Paketausführungsprogramm können Sie die Befehlszeile bearbeiten, die von Optionen generiert wurde, die in den verschiedenen Dialogfeldern erstellt wurden.

Tastatur

Die ursprünglichen Optionen wiederherstellen
Klicken Sie hier, um den ursprünglichen Status der Befehlszeile wiederherzustellen. Verwenden Sie diese Option, wenn Sie mithilfe der Option Befehlszeile manuell bearbeiten Änderungen vorgenommen haben und nun die ursprünglichen Optionen der Befehlszeile wiederherstellen möchten.

Befehlszeile manuell bearbeiten
Klicken Sie hier, um die Befehlszeile im Textfeld Befehlszeile zu bearbeiten.

Befehlszeile
Zeigt die aktuelle Befehlszeile an. Die Befehlszeile kann nur bearbeitet werden, wenn Sie die Option zum manuellen Bearbeiten der Befehlszeile aktiviert haben.

Ausführen
Klicken Sie hier, um das Paket auszuführen.

Schließen
Klicken Sie hier, um das Dialogfeld Paketausführungshilfsprogramm zu schließen.

Siehe auch

dtexec (Hilfsprogramm)