Freigeben über

Referenz zur Benutzeroberfläche des Paketausführungs-Hilfsprogramms (DtExecUI)

  • Artikel

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 Studio im Menü Ansicht auf Objekt-Explorer.

  2. Klicken Sie im Objekt-Explorer auf Verbinden, und klicken Sie dann 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 Pakete und dessen Unterordner, klicken Sie mit der rechten Maustaste auf das Paket, das Sie ausführen möchten, und klicken Sie dann auf Paket ausführen.

So öffnen Sie das Paketausführungsprogramm an der Eingabeaufforderung

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

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 username und /PASSWORD password hinzugefügt.

    Dateisystem

    Wählen Sie diese Option, wenn das Paket im Dateisystem gespeichert ist.

    SSIS-Paketspeicher

    Wählen Sie diese Option, 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 auf diese Schaltfläche, 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.

      Wichtiger HinweisWichtig

      Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

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

Package Source = File System

  • Paket
    Geben Sie den Namen des Pakets ein, oder klicken Sie auf die Schaltfläche mit den drei Punkten, 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-Paketspeicher gespeichertes Paket ausführen.

  • Paket
    Geben Sie den Namen des Pakets ein, oder klicken Sie auf die Schaltfläche mit den drei Punkten (...), 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.

Optionen

  • 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.

    HinweisHinweis

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

  • 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.

  • Entfernen
    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 auf diese Schaltfläche, 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.

Optionen

  • 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.

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

  • Entfernen
    Wählen Sie im Textfeld eine Befehlsdatei aus, und entfernen Sie sie dann mithilfe der Schaltfläche Entfernen.

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

  • Schließen
    Klicken Sie auf diese Schaltfläche, 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.

Optionen

  • 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 auf diese Schaltfläche, 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.

Optionen

  • 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 auf diese Schaltfläche, 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.

Optionen

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

    • Keine
      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.

    • Informationen
      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 auf diese Schaltfläche, um das Paket auszuführen.

  • Schließen
    Klicken Sie auf diese Schaltfläche, 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 /LOGGER classid hinzugefügt.

Optionen

  • 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.

  • Entfernen
    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 auf diese Schaltfläche, 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 /SET propertypath;value hinzugefügt.

Optionen

  • 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.

  • Entfernen
    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 auf diese Schaltfläche, 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.

Optionen

  • 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 auf diese Schaltfläche, 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.

Optionen

  • 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

Konzepte

dtexec (Hilfsprogramm)