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)