SUBSTRING (espressione SSIS)
Viene restituita la parte di un'espressione di caratteri che inizia in corrispondenza della posizione specificata e ha la lunghezza specificata. I parametri position e length devono restituire valori integer.
Sintassi
SUBSTRING(character_expression, position, length)
Argomenti
character_expression
Espressione di caratteri da cui estrarre i caratteri.
position
Numero intero che indica il punto iniziale della sottostringa.
length
Valore integer che specifica la lunghezza della sottostringa come numero di caratteri.
Tipi restituiti
DT_WSTR
Osservazioni
La funzione SUBSTRING utilizza un indice in base uno. Se position ha valore 1, la sottostringa inizia dal primo carattere in character_expression.
È possibile utilizzare SUBSTRING solo con il tipo di dati DT_WSTR. 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. Per gli altri tipi di dati è necessario il cast esplicito al tipo di dati DT_WSTR. Per altre informazioni, vedere Tipi di dati di Integration Services e Cast (espressione SSIS).
Se l'argomento è Null, SUBSTRING restituirà Null.
Tutti gli argomenti nell'espressione possono utilizzare variabili e colonne.
Il valore dell'argomento length può superare la lunghezza della stringa. In questo caso la funzione restituisce la parte rimanente della stringa.
Esempi di espressione
In questo esempio vengono restituiti due caratteri da un valore letterale stringa, a partire dal carattere 4. Il risultato restituito è "ph".
SUBSTRING("elephant",4,2)
In questo esempio viene restituita la parte rimanente da un valore letterale stringa, a partire dal quarto carattere. Il risultato restituito è "phant". Se il valore dell'argomento length supera la lunghezza delle stringa, non si tratta di un errore.
SUBSTRING ("elephant",4,50)
In questo esempio viene restituita la prima lettera della colonna MiddleName .
SUBSTRING(MiddleName,1,1)
In questo esempio negli argomenti position e length vengono utilizzate alcune variabili. Se Start ha valore 1 e Length ha valore 5, la funzione restituirà i primi cinque caratteri nella colonna Name .
SUBSTRING(Name,@Start,@Length)
In questo esempio vengono restituiti quattro caratteri nella variabile PostalCode , a partire dal sesto.
SUBSTRING (@PostalCode,6,4)
In questo esempio viene restituita una stringa di lunghezza zero da un valore letterale stringa.
SUBSTRING ("Redmond",4,0)