• Artigo

SUBSTRING (expressão SSIS)

Retorna a parte de uma expressão de caractere que se 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 é uma literal de cadeia ou uma coluna de dados com o tipo de dados DT_STR é implicitamente convertido para o tipo de dados DT_WSTR antes de SUBSTRING executar sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, consulte Tipos de dados do Integration Services e Cast (expressão SSIS): Converter tipos de dados 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

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)