RIGHT (Expressão SSIS)

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

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))  

Consulte Também

LEFT (Expressão SSIS)
Funções (Expressão SSIS)