RTRIM (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric

Retorna uma cadeia de caracteres depois de truncar todos os espaços à direita.

Remove o caractere de espaço char(32) ou outros caracteres especificados do final de uma cadeia de caracteres.

Convenções de sintaxe de Transact-SQL

Sintaxe

Sintaxe para SQL Server antes do SQL Server 2022 (16.x):

RTRIM ( character_expression )

Sintaxe para o SQL Server 2022 (16.x) e versões posteriores, a Instância Gerenciada de SQL do Azure, o Banco de Dados SQL do Azure, o Azure Synapse Analytics e o Microsoft Fabric:

Importante

Você precisará do nível de compatibilidade do banco de dados definido como 160 para usar o argumento de caracteres opcionais.

RTRIM ( character_expression , [ characters ] )

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

character_expression

Uma expressão de dados binários ou de caracteres. character_expression pode ser uma constante, variável ou coluna. character_expression deve ser um tipo de dados, exceto text, ntext e image, que é implicitamente conversível em varchar. Caso contrário, use CAST para converter character_expression explicitamente.

caracteres

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores.

Uma chamada de função, variável ou literal de qualquer tipo de caractere não LOB (nvarchar, varchar, nchar ou char) contendo caracteres que devem ser removidos. Os tipos nvarchar(max) e varchar(max) não são permitidos.

Tipos de retorno

Retorna uma expressão de caractere com um tipo de argumento de cadeia nas quais o caractere de espaço char(32), ou outros caracteres, são removidos do final da character_expression. Retorna NULL se a cadeia de caracteres de entrada é NULL.

Comentários

Para habilitar o argumento posicional de caracteres opcionais, habilite o nível de compatibilidade do banco de dados 160 nos bancos de dados aos quais você está se conectando ao executar consultas.

Exemplos

a. Remover espaços à direita

O exemplo a seguir usa uma cadeia de caracteres com espaços no final da frase e retorna o texto sem os espaços no final da frase.

SELECT RTRIM('Removes trailing spaces.   ');

Este é o conjunto de resultados.

Removes trailing spaces.

B. Remover espaços à direita com uma variável

O exemplo a seguir demonstra como usar RTRIM para remover espaços à direita de uma variável de caractere.

DECLARE @string_to_trim VARCHAR(60);  
SET @string_to_trim = 'Four spaces are after the period in this sentence.    ';  
SELECT @string_to_trim + ' Next string.';  
SELECT RTRIM(@string_to_trim) + ' Next string.';  
GO

Este é o conjunto de resultados.

Four spaces are after the period in this sentence.     Next string.

Four spaces are after the period in this sentence. Next string.

C. Remova caracteres especificados do final da cadeia de caracteres

Importante

Você precisará do nível de compatibilidade do banco de dados definido como 160 para usar o argumento de caracteres opcionais.

O seguinte exemplo remove os caracteres abc. do final da cadeia de caracteres .123abc..

SELECT RTRIM('.123abc.' , 'abc.');

Este é o conjunto de resultados.

.123

Confira também