RIGHT (Transact-SQL)

Artigo
10/31/2024

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Retorna a parte da direita de uma cadeia de caracteres com o número de caracteres especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

RIGHT ( character_expression , integer_expression )

Argumentos

character_expression
É uma expression de dados binários ou de caracteres. character_expression pode ser uma constante, variável ou coluna. character_expression pode ser de qualquer tipo de dados, exceto text ou ntext, que pode ser convertido implicitamente em varchar ou nvarchar . Caso contrário, use a função CAST para converter explicitamente character_expression.

Observação

Se string_expression for do tipo binary ou varbinary, RIGHT executará uma conversão implícita em varchar e, portanto, não preservará a entrada binária.

integer_expression
É um inteiro positivo que especifica quantos caracteres da character_expression serão retornados. Se integer_expression for negativa, um erro será retornado. Se integer_expression for do tipo bigint e contiver um valor grande, character_expression deverá ser de um tipo de dados grandes, como varchar(max) .

Tipos de retorno

Retorna varchar quando character_expression é um tipo de dados de caractere não Unicode.

Retorna nvarchar quando character_expression é um tipo de dados de caractere Unicode.

Caracteres suplementares (pares substitutos)

Ao usar ordenações SC, a função RIGHT conta cada par substituto UTF-16 como um caractere único. Para obter mais informações, consulte Suporte a ordenações e a Unicode.

Exemplos

A: Usando RIGHT com uma coluna

O exemplo a seguir retorna os cinco caracteres mais à direita do nome de cada pessoa no banco de dados AdventureWorks2022.

SELECT RIGHT(FirstName, 5) AS 'First Name'  
FROM Person.Person  
WHERE BusinessEntityID < 5  
ORDER BY FirstName;  
GO

Veja a seguir o conjunto de resultados.

First Name  
----------  
Ken  
Terri  
berto  
Rob  
  
(4 row(s) affected)

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

B. Usando RIGHT com uma coluna

O exemplo a seguir retorna os cinco caracteres mais à direita do sobrenome na tabela DimEmployee.

-- Uses AdventureWorks  
  
SELECT RIGHT(LastName, 5) AS Name  
FROM dbo.DimEmployee  
ORDER BY EmployeeKey;

Este é um conjunto de resultados parcial.

Name
-----
lbert
Brown
rello
lters

C. Usando RIGHT com uma cadeia de caracteres

O exemplo a seguir usa RIGHT para retornar os dois caracteres mais à direita da cadeia de caracteres abcdefg.

SELECT RIGHT('abcdefg', 2);