SUBSTRING (Expressão SSIS)

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

Devolve a parte de uma expressão de carácter que começa na posição especificada e tem o comprimento especificado. O parâmetro de posição e o parâmetro de comprimento devem ser avaliados até inteiros.

Sintaxe

  
SUBSTRING(character_expression, position, length)  

Arguments

character_expression
É uma expressão de carácter da qual extrair caracteres.

posição
É um inteiro que especifica onde a subcadeia começa.

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

Tipos de Resultados

DT_WSTR

Observações

A SUBSTRING utiliza um índice baseado em um. Se a posição for 1, a subcadeia começa com o primeiro caractere em character_expression.

SUBSTRING funciona apenas com o tipo de dado DT_WSTR. Um argumento character_expression que é um literal de cadeia ou uma coluna de dados com o tipo de dado DT_STR é implicitamente convertido para o tipo de dado DT_WSTR antes de SUBSTRING executar a sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para mais informações, consulte Tipos de Dados de Serviços de Integração e Casting (Expressão SSIS).

SUBSTRING devolve um resultado nulo se o argumento for nulo.

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

O argumento do comprimento pode exceder o comprimento da corda. Nesse caso, a função retorna o resto da cadeia de caracteres.

Exemplos de Expressões

Este exemplo devolve dois caracteres, começando pelo carácter 4, a partir de uma cadeia literal. O resultado retornado é "ph".

SUBSTRING("elephant",4,2)  

Este exemplo devolve o restante de uma sequência literal, começando no quarto carácter. O resultado é "phant". Não é erro o argumento comprimento exceder o comprimento da string.

SUBSTRING ("elephant",4,50)  

Este exemplo devolve a primeira letra da coluna MiddleName.

SUBSTRING(MiddleName,1,1)  

Este exemplo utiliza variáveis nos argumentos de posição e comprimento . Se Start for igual a 1 e Length for igual a 5, a função retorna os primeiros cinco caracteres na coluna Name.

SUBSTRING(Name,@Start,@Length)  

Este exemplo devolve os últimos quatro caracteres da variável PostalCode que começam no sexto caractere.

SUBSTRING (@PostalCode,6,4)  

Este exemplo devolve uma cadeia de caracteres de comprimento zero a partir de um literal de cadeia de caracteres.

SUBSTRING ("Redmond",4,0)  

Ver também

Funções (Expressão SSIS)