Editor für den Task 'SQL ausführen' (Seite Allgemein)

Mithilfe der Seite Allgemein des Dialogfeldes Editor für den Task 'SQL ausführen' können Sie den Task 'SQL ausführen' konfigurieren und die SQL-Anweisung bereitstellen, die vom Task ausgeführt wird.

Informationen, um sich mit diesem Thema vertraut zu machen, finden Sie unter SQL ausführen (SSIS-Task), Arbeiten mit Parametern und Rückgabecodes im Task „SQL ausführen“ und Arbeiten mit Resultsets im Task „SQL ausführen“. Weitere Informationen zur Transact-SQL-Abfragesprache finden Sie unter Transact-SQL-Referenz (Datenbankmodul).

Statische Optionen

  • Name
    Geben Sie einen eindeutigen Namen für den Task 'SQL ausführen' im Workflow an. Der angegebene Name wird im SSIS-Designer angezeigt.

  • Beschreibung
    Beschreiben Sie den Task 'SQL ausführen'. Die bewährte Methode ist hierbei, die Verbindung zweckbezogen zu beschreiben, sodass Pakete selbsterklärend und leichter zu verwalten sind.

  • TimeOut
    Gibt die maximale Ausführungsdauer in Sekunden an, bevor ein Timeout für den Task eintritt. Der Wert 0 steht für eine unbegrenzte Dauer. Der Standardwert ist 0.

    HinweisHinweis

    Bei gespeicherten Prozeduren tritt kein Timeout ein, wenn diese die Funktionalität des Ruhezustands dadurch emulieren, dass sie mehr Zeit für das Herstellen von Verbindungen und das Abschließen von Transaktionen bereitstellen, als durch den Wert für TimeOut angegeben wird. Gespeicherte Prozeduren, die Abfragen ausführen, unterliegen jedoch immer den durch den Wert für Timeout angegebenen Zeitbeschränkungen.

  • CodePage
    Geben Sie die Codepage an, die beim Übersetzen von Unicode-Werten in Variablen verwendet werden soll. Der Standardwert ist die Codepage des lokalen Computers.

    HinweisHinweis

    Wenn der Task "SQL ausführen" einen ADO- oder ODBC-Verbindungs-Manager verwendet, ist die Codepage-Eigenschaft nicht verfügbar. Wenn Ihre Projektmappe eine Codepage erfordert, verwenden Sie einen OLE DB- oder einen ADO.NET-Verbindungs-Manager mit dem Task "SQL ausführen".

  • ResultSet
    Geben Sie den von der auszuführenden SQL-Anweisung erwarteten Ergebnistyp an. Wählen Sie zwischen Einzelne Zeile, Vollständiges Resultset, XML und Keine aus.

  • ConnectionType
    Wählen Sie den Typ des Verbindungs-Managers aus, der zum Herstellen der Verbindung mit der Datenquelle verwendet werden soll. Zu den verfügbaren Verbindungstypen zählen: OLE DB, ODBC, ADO, ADO.NET und SQLMOBILE.

    Verwandte Themen: OLE DB Connection Manager, ODBC Connection Manager, ADO Connection Manager, ADO.NET Connection Manager, SQL Server Mobile Connection ManagerOLE DB-Verbindungs-Manager, ODBC-Verbindungs-Manager, ADO-Verbindungs-Manager, ADO.NET-Verbindungs-Manager, SQL Server Compact Edition-Verbindungs-Manager

  • Connection
    Wählen Sie die Verbindung aus einer Liste definierter Verbindungs-Manager aus. Zum Erstellen einer neuen Verbindung wählen Sie die Option <Neue Verbindung...> aus.

  • SQLSourceType
    Wählen Sie den Quelltyp der SQL-Anweisung aus, die von dem Task ausgeführt wird.

    Je nachdem, welchen Verbindungs-Manager-Typ der Task SQL ausführen verwendet, müssen Sie bestimmte Parametermarkierungen in parametrisierten SQL-Anweisungen verwenden.

    Verwandte Themen: Abschnitt "Ausführen parametrisierter SQL-Befehle" in SQL ausführen (SSIS-Task)

    Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar.

    Wert

    Beschreibung

    Direct input

    Legen Sie als Quelle eine Transact-SQL-Anweisung fest. Bei Auswahl dieses Wertes wird die dynamische Option SQLStatement angezeigt.

    File connection

    Wählen Sie eine Datei aus, die eine Transact-SQL-Anweisung enthält. Nach Festlegen dieser Option wird die dynamische Option FileConnection angezeigt.

    Variable

    Legen Sie als Quelle eine Variable fest, die die Transact-SQL-Anweisung definiert. Bei Auswahl dieses Wertes wird die dynamische Option SourceVariable angezeigt.

  • QueryIsStoredProcedure
    Zeigt an, ob die angegebene auszuführende SQL-Anweisung eine gespeicherte Prozedur ist. Diese Eigenschaft weist nur dann den Lese-/Schreibmodus auf, wenn der Task den ADO-Verbindungs-Manager verwendet. Andernfalls ist die Eigenschaft schreibgeschützt und ihr Wert ist auf false festgelegt.

  • BypassPrepare
    Zeigt an, ob die SQL-Anweisung vorbereitet ist: true lässt die Vorbereitung aus; false bereitet die SQL-Anweisung vor der Ausführung vor. Diese Option ist nur für OLE DB-Verbindungen verfügbar, die die Vorbereitung unterstützen.

    Verwandte Themen: Vorbereitete Ausführung

  • Durchsuchen
    Suchen Sie mithilfe des Dialogfeldes Öffnen eine Datei, die eine SQL-Anweisung enthält. Wählen Sie eine Datei aus, um den Dateiinhalt als SQL-Anweisung in die Eigenschaft SQLStatement zu kopieren.

  • Abfrage erstellen
    Erstellen Sie mithilfe des Dialogfeldes Abfrage-Generator, einem grafischen Tool zum Erstellen von Abfragen, eine SQL-Anweisung. Diese Option ist verfügbar, wenn die Option SQLSourceType auf Direct input festgelegt ist.

  • Abfrage analysieren
    Überprüft die Syntax der SQL-Anweisung.

SQLSourceType (dynamische Optionen)

SQLSourceType = Direct input

  • SQLStatement
    Geben Sie die auszuführende SQL-Anweisung in das Optionsfeld ein, oder klicken Sie auf die Schaltfläche zum Durchsuchen (…), um die SQL-Anweisung in das Dialogfeld SQL-Abfrage eingeben einzugeben, oder klicken Sie auf Abfrage erstellen, um die Anweisung mithilfe des Dialogfeldes Abfrage-Generator zusammenzustellen.

    Verwandte Themen: Query Builder Box Abfrage-Generator

SQLSourceType = File connection

  • FileConnection
    Wählen Sie einen vorhandenen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung…>, um einen neuen Verbindungs-Manager zu erstellen.

    Verwandte Themen: File Connection Manager, File Connection Manager EditorDateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

SQLSourceType = Variable