RIGHT (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.
.gif "Observação") Observação |
|---|
Use a função SUBSTRING para extrair vários caracteres da esquerda. Para obter mais informações, consulte SUBSTRING (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 (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))