Freigeben über

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

  • Artikel

Mithilfe der Seite Allgemein des Dialogfelds 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 (Task), Parameter und Rückgabecodes im Task 'SQL ausführen' und 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".

  • TypeConversionMode
    Wenn Sie diese Eigenschaft auf Allowed festlegen, wird anhand des Tasks "SQL ausführen" versucht, Ausgabeparameter sowie Abfrageergebnisse in den Datentyp der Variablen zu konvertieren, der die Ergebnisse zugewiesen sind. Dies gilt für den Resultsettyp Einzelne Zeile.

  • 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-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. Wählen Sie zum Erstellen einer neuen Verbindung die Option <Neue Verbindung...>.

  • 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 (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
    Geben Sie an, ob die SQL-Anweisung vorbereitet ist. true überspringt die Vorbereitung. Mit false wird die SQL-Anweisung vor dem Ausführen vorbereitet. 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 Dialogfelds Ö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 Dialogfelds 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 Dialogfelds Abfrage-Generator zusammenzustellen.

    Verwandte Themen: Abfrage-Generator

SQLSourceType = File connection

SQLSourceType = Variable

Siehe auch

Verweis

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

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

Konzepte

Fehler- und Meldungsreferenz von Integration Services