SUBSTRING (espressione SSIS)

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

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 di risultato

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. Un argomento character_expression costituito da una stringa letterale o da una colonna di dati con tipo di dati DT_STR viene convertito implicitamente nel tipo di dati DT_WSTR prima che SUBSTRING esegua l'operazione. Gli altri tipi di dati devono essere convertiti in modo esplicito nel tipo di dati DT_WSTR. Per altre informazioni, vedere Tipi di dati di Integration Services e Cast (espressione SSIS).

SUBSTRING restituisce un risultato null se l'argomento è 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

Questo esempio restituisce due caratteri, a partire dal carattere 4, da una stringa letterale. Il risultato restituito è "ph".

SUBSTRING("elephant",4,2)  

Questo esempio restituisce il resto di una stringa letterale, 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 gli ultimi quattro caratteri dalla variabile PostalCode, a partire dal sesto carattere.

SUBSTRING (@PostalCode,6,4)  

In questo esempio viene restituita una stringa di lunghezza zero da un valore letterale stringa.

SUBSTRING ("Redmond",4,0)