Transformation für OLE DB-Befehl

Aktualisiert: 12. Dezember 2006

Die Transformation für OLE DB-Befehl führt eine SQL-Anweisung für jede Zeile in einem Datenfluss aus. Beispielsweise können Sie eine SQL-Anweisung ausführen, die Zeilen in einer Datenbanktabelle einfügt, aktualisiert oder löscht.

Es gibt folgende Möglichkeiten, um die Transformation für OLE DB-Befehl zu konfigurieren:

• Stellen Sie die SQL-Anweisung bereit, die die Transformation für jede Zeile ausführt.
• Geben Sie an, nach wie vielen Sekunden ein Timeout bei der SQL-Anweisung eintritt.
• Geben Sie die Standardcodepage an.

In der Regel enthält die SQL-Anweisung Parameter. Die Parameterwerte sind in externen Spalten in der Transformationseingabe gespeichert, und beim Zuordnen einer Eingabespalte zu einer externen Spalte wird eine Eingabespalte einem Parameter zugeordnet. Angenommen, Sie möchten Zeilen in der DimProduct-Tabelle anhand des Wertes in der ProductKey-Spalte suchen und diese dann löschen. Hierzu können Sie die externe Spalte Param_0 der ProductKey-Eingabespalte zuordnen und anschließend den SQL-Befehl DELETE FROM DimProduct WHERE ProductKey = ? ausführen. Die Transformation für OLE DB-Befehl stellt die Parameternamen bereit, die nicht geändert werden können. Die Parameternamen lauten Param_0, Param_1 usw.

Wenn Sie die Transformation für OLE DB-Befehl mithilfe des Dialogfeldes Erweiterter Editor konfigurieren, können die Parameter in der SQL-Anweisung automatisch externen Spalten in der Transformationseingabe zugeordnet und die Merkmale jedes Parameters definiert werden, indem Sie auf die Schaltfläche Aktualisieren klicken. Wenn jedoch der von der Transformation für OLE DB-Befehl verwendete OLE DB-Anbieter das Ableiten von Parameterinformationen von dem Parameter nicht unterstützt, müssen Sie die externen Spalten manuell konfigurieren. Das heißt, Sie müssen der Transformation für jeden Parameter zur externen Eingabe eine Spalte hinzufügen, die Spaltennamen aktualisieren, um Namen wie Param_0 zu verwenden, den Wert der DBParamInfoFlags-Eigenschaft angeben sowie die Eingabespalten, die Parameterwerte enthalten, den externen Spalten zuordnen.

Der Wert von DBParamInfoFlags stellt die Merkmale des Parameters dar. Beispielsweise gibt der Wert 1 an, dass der Parameter ein Eingabeparameter ist, und der Wert 65 gibt an, dass der Parameter ein Eingabeparameter ist und einen NULL-Wert enthalten kann. Die Werte müssen mit den Werten in der OLE DB-Enumeration DBPARAMFLAGSENUM übereinstimmen. Weitere Informationen finden Sie in der OLE DB-Referenzdokumentation.

Die Transformation für OLE DB-Befehl schließt die benutzerdefinierte Eigenschaft SQLCommand ein. Diese Eigenschaft kann beim Laden des Pakets mithilfe eines Eigenschaftsausdrucks aktualisiert werden. Weitere Informationen finden Sie unter Referenzinformationen zu SQL Server Integration Services-Ausdrücken, Verwendung von Eigenschaftsausdrücken in Paketen und Transformation Custom Properties.

Diese Transformation weist eine Eingabe, eine reguläre Ausgabe und eine Fehlerausgabe auf.

Problembehandlung der Transformation für OLE DB-Befehl

Seit Microsoft SQL Server 2005 Service Pack 2 (SP2) können Sie die von der Transformation für OLE DB-Befehl an externe Datenprovider gerichteten Aufrufe protokollieren. Mithilfe dieser neuen Protokollierungsfunktionen können Sie Probleme bei Verbindungen mit externen Datenquellen und bei Befehlen an externe Datenquellen durch die Transformation für OLE DB-Befehl behandeln. Aktivieren Sie zum Protokollieren der von der Transformation für OLE DB-Befehl an einen externen Datenprovider gerichteten Aufrufe die Paketprotokollierung, und wählen Sie das Diagnostic-Ereignis auf Paketebene aus. Weitere Informationen finden Sie unter Paketausführung (Problembehandlung).

Konfigurieren der Transformation für OLE DB-Befehl

Eigenschaften können Sie mit dem SSIS-Designer oder programmgesteuert festlegen.

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im Dialogfeld Erweiterter Editor oder programmgesteuert festlegen können:

• Common Properties
• Transformation Custom Properties

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum Festlegen von Eigenschaften zu erhalten:

• Vorgehensweise: Konfigurieren der Transformation für OLE DB-Befehl
• Vorgehensweise: Festlegen der Eigenschaften einer Datenflusskomponente im Eigenschaftenfenster
• Vorgehensweise: Festlegen der Eigenschaften einer Datenflusskomponente mithilfe des erweiterten Editors

Siehe auch

Konzepte

Erstellen eines Paketdatenflusses
SQL Server Integration Services-Transformationen

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
12. Dezember 2006	Neuer Inhalt: Es wurden Informationen hinzugefügt, dass SQL Server 2005 SP2 neue Meldungen für die Protokollierung enthält, mit denen Benutzer Probleme bei Aufrufen behandeln können, die von der Transformation an externe Datenprovider gerichtet werden.
05. Dezember 2005	Neuer Inhalt: Es wurden Informationen über das Verwenden von Eigenschaftsausdrücken mit der benutzerdefinierten Eigenschaft SQLCommand hinzugefügt.