RIGHT (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

Retourne la partie de droite d'une chaîne de caractères avec le nombre spécifié de caractères.

Conventions de la syntaxe Transact-SQL

Syntaxe

RIGHT ( character_expression , integer_expression )

Arguments

expression_caractère
Expression de données binaires ou caractères. character_expression peut être une constante, une variable ou une colonne. character_expression peut être de n’importe quel type de données, à l’exception de text et ntext, qui peut être converti implicitement en varchar ou nvarchar. Sinon, utilisez la fonction CAST pour convertir explicitement character_expression.

Notes

Si string_expression est de type fixe ou variable, RIGHT effectuera une conversion implicite vers varchar, et ne préservera donc pas l'entrée fixe.

integer_expression
Entier positif qui spécifie le nombre de caractères de character_expression à retourner. Si integer_expression est négatif, une erreur est retournée. Si integer_expression est de type bigint et contient une valeur de grande taille, character_expression doit être d’un type de données de grande taille, tel que varchar(max) .

Types de retour

Retourne varchar quand character_expression est un type de données caractères non-Unicode.

Retourne nvarchar quand character_expression est un type de données caractères Unicode.

Caractères supplémentaires (paires de substitution)

Lors de l'utilisation de classements SC, la fonction RIGHT compte une paire de substitution UTF-16 comme un caractère unique. Pour plus d’informations, consultez Prise en charge d’Unicode et du classement.

Exemples

A : Utilisation de RIGHT avec une colonne

L’exemple suivant retourne les cinq derniers caractères les plus à droite du prénom de chaque personne dans la base de données AdventureWorks2022.

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

Voici le jeu de résultats.

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

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

B. Utilisation de RIGHT avec une colonne

L’exemple suivant retourne les cinq caractères les plus à droite de chaque nom de famille dans la table DimEmployee.

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

Voici un jeu de résultats partiel.

Name
-----
lbert
Brown
rello
lters

C. Utilisation de RIGHT avec une chaîne de caractères

L’exemple suivant utilise RIGHT pour retourner les deux caractères les plus à droite de la chaîne de caractères abcdefg.

SELECT RIGHT('abcdefg', 2);