Compartilhar via


SUBSTRING (Expressão SSIS)

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Retorna a parte de uma expressão de caractere que inicia na posição especificada e tem o comprimento especificado. O parâmetro position e o parâmetro length devem ser avaliados como inteiros.

Sintaxe

  
SUBSTRING(character_expression, position, length)  

Argumentos

character_expression
É uma expressão de caractere da qual extrair caracteres.

position
É um inteiro que especifica onde a subcadeia de caracteres começa.

length
É um inteiro que especifica o comprimento da subcadeia de caracteres como o número de caracteres.

Tipos de resultado

DT_WSTR

Comentários

SUBSTRING usa um único índice. Se position for 1, a subcadeia de caracteres começará com o primeiro caractere em character_expression.

SUBSTRING só funciona com o tipo de dados DT_WSTR. Um argumento character_expression que é um literal de cadeia de caracteres ou uma coluna de dados com o tipo de dados DT_STR é implicitamente convertido para o tipo de dados DT_WSTR antes que SUBSTRING execute sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, confira Tipos de dados do Integration Services e Cast (Expressão do SSIS).

SUBSTRING retorna um resultado nulo se o argumento for nulo.

Todos os argumentos na expressão podem usar variáveis e colunas.

O argumento length pode exceder o comprimento da cadeia de caracteres. Naquele caso, a função retorna o restante da cadeia de caracteres.

Exemplos de expressões

Este exemplo retorna dois caracteres, começando com o caractere 4, de uma literal de cadeia de caracteres. O resultado de retorno é "ph".

SUBSTRING("elephant",4,2)  

Este exemplo retorna o restante de uma literal de cadeia de caracteres, começando no quarto caractere. O resultado de retorno é "phant". Isso não é um erro para o argumento length exceder o comprimento da cadeia de caracteres.

SUBSTRING ("elephant",4,50)  

Este exemplo retorna a primeira letra da coluna MiddleName .

SUBSTRING(MiddleName,1,1)  

Este exemplo usa variáveis nos argumentos position e length . Se Start for 1 e Length for 5, a função retornará os primeiros cinco caracteres na coluna Name .

SUBSTRING(Name,@Start,@Length)  

Este exemplo retorna os últimos quatro caracteres da variável PostalCode começando no sexto caractere.

SUBSTRING (@PostalCode,6,4)  

Este exemplo retorna uma cadeia de caracteres de comprimento zero de uma literal de cadeia de caracteres.

SUBSTRING ("Redmond",4,0)  

Consulte Também

Funções (Expressão SSIS)