SUBSTRING (espressione SSIS)SUBSTRING (SSIS Expression)

Viene restituita la parte di un'espressione di caratteri che inizia in corrispondenza della posizione specificata e ha la lunghezza specificata.Returns the part of a character expression that starts at the specified position and has the specified length. I parametri position e length devono restituire valori integer.The position parameter and the length parameter must evaluate to integers.

SintassiSyntax


SUBSTRING(character_expression, position, length)  

ArgomentiArguments

character_expressioncharacter_expression
Espressione di caratteri da cui estrarre i caratteri.Is a character expression from which to extract characters.

positionposition
Numero intero che indica il punto iniziale della sottostringa.Is an integer that specifies where the substring begins.

lengthlength
Valore integer che specifica la lunghezza della sottostringa come numero di caratteri.Is an integer that specifies the length of the substring as number of characters.

Tipi restituitiResult Types

DT_WSTRDT_WSTR

OsservazioniRemarks

La funzione SUBSTRING utilizza un indice in base uno.SUBSTRING uses a one-based index. Se position ha valore 1, la sottostringa inizia dal primo carattere in character_expression.If position is 1, the substring begins with the first character in character_expression.

È possibile utilizzare SUBSTRING solo con il tipo di dati DT_WSTR.SUBSTRING works only with the DT_WSTR data type. Se l'argomento character_expression è un valore letterale stringa o una colonna di dati con tipo di dati DT_STR, prima di eseguire l'operazione prevista da SUBSTRING verrà eseguito il cast implicito al tipo di dati DT_WSTR.A character_expression argument that is a string literal or a data column with the DT_STR data type is implicitly cast to the DT_WSTR data type before SUBSTRING performs its operation. Per gli altri tipi di dati è necessario il cast esplicito al tipo di dati DT_WSTR.Other data types must be explicitly cast to the DT_WSTR data type. Per altre informazioni, vedere Tipi di dati di Integration Services e Cast (espressione SSIS).For more information, see Integration Services Data Types and Cast (SSIS Expression).

Se l'argomento è Null, SUBSTRING restituirà Null.SUBSTRING returns a null result if the argument is null.

Tutti gli argomenti nell'espressione possono utilizzare variabili e colonne.All arguments in the expression can use variables and columns.

Il valore dell'argomento length può superare la lunghezza della stringa.The length argument can exceed the length of the string. In questo caso la funzione restituisce la parte rimanente della stringa.In that case, the function returns the remainder of the string.

Esempi di espressioneExpression Examples

In questo esempio vengono restituiti due caratteri da un valore letterale stringa, a partire dal carattere 4.This example returns two characters, beginning with character 4, from a string literal. Il risultato restituito è "ph".The return result is "ph".

SUBSTRING("elephant",4,2)  

In questo esempio viene restituita la parte rimanente da un valore letterale stringa, a partire dal quarto carattere.This example returns the remainder of a string literal, beginning at the fourth character. Il risultato restituito è "phant".The return result is "phant". Se il valore dell'argomento length supera la lunghezza delle stringa, non si tratta di un errore.It is not an error for the length argument to exceed the length of the string.

SUBSTRING ("elephant",4,50)  

In questo esempio viene restituita la prima lettera della colonna MiddleName .This example returns the first letter from the MiddleName column.

SUBSTRING(MiddleName,1,1)  

In questo esempio negli argomenti position e length vengono utilizzate alcune variabili.This example uses variables in the position and length arguments. Se Start ha valore 1 e Length ha valore 5, la funzione restituirà i primi cinque caratteri nella colonna Name .If Start is 1 and Length is 5, the function returns the first five characters in the Name column.

SUBSTRING(Name,@Start,@Length)  

In questo esempio vengono restituiti quattro caratteri nella variabile PostalCode , a partire dal sesto.This example returns the last four characters from the PostalCode variable beginning at the sixth character.

SUBSTRING (@PostalCode,6,4)  

In questo esempio viene restituita una stringa di lunghezza zero da un valore letterale stringa.This example returns a zero-length string from a string literal.

SUBSTRING ("Redmond",4,0)  

Vedere ancheSee Also

Funzioni ( Espressione SSIS )Functions (SSIS Expression)