Partilhar via


DIREITA (expressão SSIS)

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

Retorna o número especificado de caracteres da parte mais à direita da expressão de caractere fornecida.

Sintaxe

  
RIGHT(character_expression,integer_expression)  

Argumentos

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

integer_expression
É uma expressão inteira que indica o número de caracteres a serem retornados.

Tipos de resultados

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 caracteres de comprimento zero.

Se integer_expression for um número negativo, a função retornará um erro.

O argumento integer_expression pode ter variáveis e colunas.

RIGHT funciona apenas 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).

RIGHT retorna um resultado nulo se qualquer argumento for null.

Exemplos de expressões

O exemplo a seguir usa um literal de cadeia de caracteres. O resultado do retorno é "Bike".

RIGHT("Mountain Bike", 4)  

O exemplo a seguir retorna o número de caracteres mais à direita especificado 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)  

O exemplo a seguir também retorna o número de caracteres mais à direita especificado 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 converte o valor de 4,32 em 4 e, em seguida, retorna os quatro caracteres mais à direita.

RIGHT(Name, (DT_I2)@Times))  

Ver também

LEFT (Expressão SSIS)
funções (expressão SSIS)