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