RIGHT (Expressão SSIS)
Retorna o número especificado de caracteres da parte mais à direita da expressão character especificada.
Sintaxe
RIGHT(character_expression,integer_expression)
Argumentos
character_expression
É uma expressão de caractere da qual extrair caracteres.
integer_expression
É uma expressão de inteiro que indica o número de caracteres retornados.
Tipos de resultado
DT_WSTR
Comentários
Se integer_expression for maior que o comprimento de character_expression, a função retornará character_expression.
Se integer_expression for zero, a função retornará uma cadeia de comprimento zero.
Se integer_expression for um número negativo, a função retornará um erro.
O argumento integer_expression pode assumir variáveis e colunas.
RIGHT 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 RIGHT 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).
RIGHT retornará um resultado nulo se o argumento for nulo.
Exemplos de expressões
O exemplo a seguir usa um literal de cadeia de caracteres. O resultado de retorno é "Bike".
RIGHT("Mountain Bike", 4)
Este exemplo retorna o número dos caracteres na extrema direita que são especificados na variável Times , da coluna Name . Se Name for Touring Front Wheel e Times for 5, o resultado de retorno será "Wheel".
RIGHT(Name, @Times)
Este exemplo a seguir retorna o número dos caracteres na extrema direita que são especificados na variável Times , da coluna Name . Times tem um tipo de dados não inteiro e a expressão inclui uma conversão explícita para o tipo de dados DT_I2. Se Name for Touring Front Wheel e Times for 4.32, o resultado de retorno será "heel" porque a função RIGHT converterá o valor de 4.32 para 4, e então retornará os quatro caracteres na extrema direita.
RIGHT(Name, (DT_I2)@Times))