Share via


RIGHT (expressão SSIS)

Retorna a parte de uma expressão de caracteres que começa e está à direita de uma contagem de posição de caracteres específica a partir da direita.

ObservaçãoObservação

Use a função SUBSTRING para extrair vários caracteres da esquerda. Para obter mais informações, consulte SUBSTRING (expressão SSIS).

Sintaxe

RIGHT(character_expression,integer_expression)

Argumentos

  • character_expression
    É uma expressão de caractere da qual extrair caracteres.

  • number
    É 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 number pode obter 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 de RIGHT 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.

RIGHT retornará um resultado nulo se o argumento for nulo.

Exemplos

Este exemplo usa um literal de cadeia de caracteres. O resultado de retorno é "Bicicleta".

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 Roda Dianteira de Passeio e o Times for 5, o resultado de retorno será "Roda".

RIGHT(Name, @Times)

Este exemplo também 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 de DT_I2. Se Name for Roda Dianteira de Passeio e o Times for 4.32, o resultado de retorno será "Salto de Sapato". O valor 4.32 é convertido para 4 e os quatro caracteres da direita são retornados.

RIGHT(Name, (DT_I2)@Times))