Integration Services-Datentypen in Ausdrücken

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

Bei der Ausdrucksauswertung werden Integration Services-Datentypen verwendet. Wenn Daten erstmals an einen Datenfluss in einem Integration Services-Paket weitergegeben werden, konvertiert die Datenfluss-Engine alle Spaltendaten in einen Integration Services-Datentyp, und die von einem Ausdruck verwendeten Spaltendaten weisen bereits einen Integration Services-Datentyp auf. Ausdrücke, die in den Transformationen für bedingtes Teilen und für abgeleitete Spalten verwendet werden, können auf Spalten verweisen, weil sie Teil eines Datenflusses mit Spaltendaten sind.

Variablen

In Ausdrücken können außerdem Variablen verwendet werden. Variablen weisen einen Variant-Datentyp auf, und die Ausdrucksauswertung konvertiert den Datentyp einer Variable von einem Variant-Untertyp in einen Integration Services-Datentyp, bevor der Ausdruck ausgewertet wird. Für Variablen kann nur eine Teilmenge der Integration Services-Datentypen verwendet werden. Beispielsweise ist für eine Variable kein BLOB-Datentyp (Binary Large Object Block) zulässig.

Weitere Informationen zu Integration Services-Datentypen und zum Zuordnen von Variant-Datentypen zu Integration Services-Datentypen finden Sie unter Integration Services-Datentypen.

Literale

Darüber hinaus können Ausdrücke numerische und boolesche Literale sowie Zeichenfolgenliterale einschließen. Weitere Informationen zum Konvertieren von numerischen Literalen in numerische Integration Services-Datentypen finden Sie unter Literale (SSIS).

Zeichenfolgen

Sie können entweder DT_STR oder DT_WSTR als Rückgabetyp eines Ausdrucks verwenden. Innerhalb eines Ausdrucks wird jedoch nur DT_WSTR unterstützt. DT_STR-Werte werden in DT_WSTR-Werte konvertiert. Dieses Verhalten hat mehrere Implikationen für das Schreiben eines Ausdrucks.

• Verwenden Sie in einem Ausdruck NULL(DT_WSTR, ...) anstelle von NULL(DT_STR, ...). Weitere Informationen zu dieser Funktion finden Sie unter NULL (SSIS-Ausdruck).

• Innerhalb eines Ausdrucks können Sie nur die CAST-Funktion verwenden, um einen Wert im Stamm des Ausdrucks in den DT_STR-Datentyp umzuwandeln. Der Wert wird also umgewandelt, wenn Sie das endgültige Ergebnis des Ausdrucks zurückgeben. Verwenden Sie alternativ den DT_WSTR-Datentyp innerhalb eines Ausdrucks.

Betrachten Sie die Ausdrücke im folgenden Screenshot.

1. Der erste Ausdruck wird ohne Fehler ausgeführt, weil sich die NULL(DT_STR, ...)-Funktion auf Stammebene des Ausdrucks befindet.

2. Der zweite Ausdruck wird ohne Fehler ausgeführt, weil NULL(DT_WSTR, ...) verwendet wird.

3. Der dritte Ausdruck löst einen Fehler aus, weil innerhalb des Ausdrucks NULL(DT_STR, ...) verwendet wird.

4. Der vierte Ausdruck wird ohne Fehler ausgeführt, weil das Ergebnis von NULL(DT_STR, ...) innerhalb des Ausdrucks umgewandelt wird.

   Die Ausdrucksauswertung verarbeitet diese Umwandlung auf intelligente Weise. Sie wandelt nicht in DT_STR, sondern in DT_WSTR um, da die Auswertung erkennt, dass der Vorgang nicht auf Stammebene des Ausdrucks ausgeführt wird.

Die folgenden Beispiele veranschaulichen die Auswirkungen der Umwandlung.

1. Im ersten Ausdruck wird die Umwandlung nicht auf Stammebene des Ausdrucks ausgeführt. Die Ausdrucksauswertung verarbeitet diese Umwandlung auf intelligente Weise und wandelt nicht in DT_STR, sondern in DT_WSTR um. Der Ausdruck gibt DT_WSTR zurück.

2. Im zweiten Ausdruck wird die Umwandlung auf Stammebene des Ausdrucks ausgeführt. Der Ausdruck gibt DT_STR zurück.

Implizite Datenkonvertierung

Bei einer impliziten Datentypkonvertierung konvertiert die Ausdrucksauswertung die Daten automatisch in einen anderen Datentyp. Beispielsweise wird beim Vergleich eines smallint -Datentyps mit einem int-Datentyp der smallint -Datentyp implizit in int konvertiert, bevor der Vergleich erfolgt.

Wenn die Argumente und Operanden nicht kompatible Datentypen aufweisen, kann die Ausdrucksauswertung keine implizite Datenkonvertierung ausführen. Zudem kann die Ausdrucksauswertung einen Wert nicht implizit in einen booleschen Wert konvertieren. Stattdessen müssen die Argumente und Operanden explizit mit dem Umwandlungsoperator konvertiert werden. Weitere Informationen finden Sie unter CAST (SSIS-Ausdruck).

Das folgende Diagramm zeigt den Ergebnistyp impliziter Konvertierungen von BINARY-Vorgängen. Am Schnittpunkt von Spalte und Zeile in dieser Tabelle finden Sie den Ergebnistyp einer binären Operation mit Operanden der Typen, die links (Von) und rechts (Zu) angegeben sind.

Die Schnittmenge eines integer-Werts mit Vorzeichen und eines integer-Werts ohne Vorzeichen ist ein integer-Wert, der potenziell größer als die beiden Argumente ist.

Anhand von Operatoren werden Zeichenfolgen, Datumsangaben, boolesche Werte und andere Datentypen miteinander verglichen. Bevor ein Operator zwei Werte vergleicht, führt die Ausdrucksauswertung bestimmte implizite Konvertierungen aus: Die Ausdrucksauswertung konvertiert Zeichenfolgenliterale stets in den DT_WSTR-Datentyp und boolesche Literale in den DT_BOOL-Datentyp. Alle in Anführungszeichen eingeschlossenen Werte werden von der Ausdrucksauswertung als Zeichenfolgen interpretiert. Numerische Literale werden in einen der numerischen Integration Services-Datentypen konvertiert.

Weitere Informationen finden Sie unter den folgenden Themen:

• == (Gleich) (SSIS-Ausdruck)

• != (Ungleich) (SSIS-Ausdruck)

• > (Größer als) (SSIS-Ausdruck)

• < (Kleiner als) (SSIS-Ausdruck)

• >= (Größer als oder gleich) (SSIS-Ausdruck)

• < (Kleiner als oder gleich) (SSIS-Ausdruck)

Eine Funktion mit einem einzelnen Argument gibt ein Ergebnis mit dem Datentyp des Arguments zurück, wobei folgende Ausnahmen gelten:

• DAY, MONTH und YEAR akzeptieren ein Datum und geben ein ganzzahliges Ergebnis (DT_I4) zurück.

• ISNULL akzeptiert einen Ausdruck eines beliebigen SSIS-Datentyps und gibt einen booleschen Datentyp (DT_BOOL) zurück.

• SQUARE und SQRT akzeptieren einen numerischen Ausdruck und geben ein nicht integrales numerisches (DT_R8) Ergebnis zurück.

Falls die Argumente vom gleichen Datentyp sind, gehört auch das Ergebnis zu diesem Datentyp. Die einzige Ausnahme ist das Ergebnis einer binären Operation für zwei Werte mit dem DT_DECIMAL-Datentyp. In diesem Fall wird ein Ergebnis mit dem DT_NUMERIC-Datentyp zurückgegeben.

Voraussetzungen für die Verwendung von Daten in Ausdrücken

Bei der Ausdrucksauswertung werden alle Integration Services-Datentypen unterstützt. Je nach Operation oder Funktion sind jedoch für die Operanden und Argumente bestimmte Datentypen erforderlich. Die Ausdrucksauswertung erzwingt die folgenden Datentypanforderungen für Daten, die in Ausdrücken verwendet werden:

• Operanden, die in logischen Operationen verwendet werden, müssen zu einem booleschen Wert ausgewertet werden. Beispiel: ColumnA > 1&&ColumnB < 2.

• Operanden, die in mathematischen Operationen verwendet werden, müssen zu einem numerischen Wert ausgewertet werden. Beispiel: 23.75 * 4.

• In Vergleichsoperationen, z. B. logischen und Gleichheitsoperationen, verwendete Operanden müssen zu kompatiblen Datentypen ausgewertet werden.

  In einem der Ausdrücke im folgenden Beispiel wird z. B. der DT_DBTIMESTAMPOFFSET-Datentyp verwendet:

  (DT_DBTIMESTAMPOFFSET,3) "1999-10-11 20:34:52.123 -3:30" != (DT_DBDATE)"1999-10-12"

  Der Ausdruck (DT_DBDATE)"1999-10-12"wird in DT_DBTIMESTAMPOFFSET konvertiert. In diesem Beispiel wird zu TRUE ausgewertet, weil der konvertierte Ausdruck zu "1999-10-12 00:00:00.000 +00:00" wird, was nicht dem Wert des anderen Ausdrucks entspricht, der (DT_DBTIMESTAMPOFFSET,3) "1999-10-11 20:34:52.123 -3:30"lautet.

• Argumente, die an mathematische Funktionen übergeben werden, müssen zu einem numerischen Datentyp ausgewertet werden. Je nach Funktion oder Operation kann ein bestimmter numerischer Datentyp erforderlich sein. Beispielsweise erfordert die HEX-Funktion eine ganze Zahl mit oder ohne Vorzeichen.

• Argumente, die an Zeichenfolgenfunktionen übergeben werden, müssen zu einem Zeichendatentyp ausgewertet werden: DT_STR oder DT_WSTR. Beispiel: UPPER("flower"). Manche Zeichenfolgenfunktionen, wie z. B. SUBSTRING, erfordern zusätzliche ganzzahlige Argumente für die Startposition und die Länge der Zeichenfolge.

• Argumente, die an Datums- und Zeitfunktionen übergeben werden, müssen zu einem gültigen Datum ausgewertet werden. Beispielsweise DAY(GETDATE()). Manche Funktionen, wie z. B. DATEADD, erfordern ein zusätzliches ganzzahliges Argument für die Anzahl von Tagen, die von der Funktion zu einem Datum addiert werden.

Für Operationen, bei denen ein integer-Wert ohne Vorzeichen mit der Länge von 8 Byte und ein integer-Wert mit Vorzeichen kombiniert werden, ist zum Klären des Ergebnisformats eine explizite Umwandlung erforderlich. Weitere Informationen finden Sie unter CAST (SSIS-Ausdruck).

Die Ergebnisse vieler Operationen und Funktionen können vordefinierte Datentypen aufweisen. Dies kann der Datentyp des Arguments oder der Datentyp sein, in den die Ausdrucksauswertung das Ergebnis umwandelt. Beispielsweise ist das Ergebnis eines logischen OR-Operators (||) immer ein boolescher Wert, das Ergebnis der ABS-Funktion ist der numerische Datentyp des Arguments, und das Ergebnis einer Multiplikation ist der kleinste numerische Datentyp, der das Ergebnis ohne Verlust speichern kann. Weitere Informationen zu den Datentypen von Ergebnissen finden Sie unter Operatoren (SSIS-Ausdruck) und Funktionen (SSIS-Ausdruck).

Related Tasks

Verwenden eines Ausdrucks in einer Datenflusskomponente

Verwandte Inhalte

• Technischer Artikel, SSIS Expression Cheat Sheet, auf pragmaticworks.com

• Technischer Artikel, Beispiele für SSIS-Ausdrücke