Partilhar via

ACABAMENTO (Transact-SQL)

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL analytics endpoint in Microsoft FabricWarehouse em Microsoft FabricSQL database in Microsoft Fabric

Remove o caractere char(32) de espaço ou outros caracteres especificados do início e do fim de uma cadeia de caracteres.

A partir do SQL Server 2022 (16.x), opcionalmente remove o caractere char(32) de espaço ou outros caracteres especificados do início, do fim ou de ambos os lados de uma cadeia de caracteres.

Transact-SQL convenções de sintaxe

Sintaxe

Sintaxe para SQL Server 2019 (15.x) e versões anteriores, e Azure Synapse Analytics:

TRIM ( [ characters FROM ] string )

Sintaxe para SQL Server 2022 (16.x) e versões posteriores, Azure SQL Managed Instance, Azure SQL Database e Microsoft Fabric:

Importante

Você precisa que o nível de compatibilidade do banco de dados esteja definido para 160 usar as LEADINGpalavras-chave , TRAILINGou BOTH .

TRIM ( [ LEADING | TRAILING | BOTH ] [characters FROM ] string )

Arguments

[ LIDERANÇA | TRAILING | AMBOS ]

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores, Azure SQL Managed Instance, Azure SQL Database e Microsoft Fabric:

O primeiro argumento opcional especifica qual lado da cadeia de caracteres deve ser cortado:

  • LEADING Remove caracteres especificados do início de uma cadeia de caracteres.

  • TRAILING Remove caracteres especificados do final de uma cadeia de caracteres.

  • BOTH (comportamento posicional padrão) remove caracteres especificados do início e do fim de uma cadeia de caracteres.

Personagens

Uma chamada literal, variável ou função 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.

string

Uma expressão de qualquer tipo de caractere (nvarchar, varchar, nchar ou char) onde os caracteres devem ser removidos.

Tipos de devolução

Retorna uma expressão de caractere com um tipo de argumento de cadeia de caracteres em que o caractere char(32) de espaço ou outros caracteres especificados são removidos de ambos os lados. Retorna NULL se a cadeia de caracteres de entrada for NULL.

Observações

Por padrão, a TRIM função remove o caractere de espaço do início e do fim da cadeia de caracteres. Esse comportamento é equivalente a LTRIM(RTRIM(@string)).

Para habilitar os argumentos opcionaisLEADINGTRAILING, ou BOTH posicionais no SQL Server 2022 (16.x), você deve habilitar o nível 160 de compatibilidade do banco de dados no banco de dados ao qual está se conectando ao executar consultas.

  • Com argumento posicional opcional LEADING , o comportamento é equivalente a LTRIM(@string, characters).
  • Com argumento posicional opcional TRAILING , o comportamento é equivalente a RTRIM(@string, characters).

Examples

A. Remova o caractere de espaço de ambos os lados da cadeia de caracteres

O exemplo a seguir remove espaços de antes e depois da palavra test.

SELECT TRIM( '     test    ') AS Result;

Aqui está o conjunto de resultados.

test

B. Remover caracteres especificados de ambos os lados da cadeia de caracteres

O exemplo a seguir fornece uma lista de caracteres possíveis para remover de uma cadeia de caracteres.

SELECT TRIM( '.,! ' FROM '     #     test    .') AS Result;

Aqui está o conjunto de resultados.

#     test

Neste exemplo, apenas o período à direita e os espaços de antes # e depois da palavra test foram removidos. Os outros caracteres foram ignorados porque não existiam na string.

C. Remover caracteres especificados do início de uma cadeia de caracteres

Importante

Você precisa que o nível de compatibilidade do banco de dados esteja definido para 160 usar as LEADINGpalavras-chave , TRAILINGou BOTH .

O exemplo a seguir remove a entrelinha . do início da cadeia de caracteres antes da palavra test.

SELECT TRIM(LEADING '.,! ' FROM  '     .#     test    .') AS Result;

Aqui está o conjunto de resultados.

#     test    .

D. Remover caracteres especificados do final de uma cadeia de caracteres

Importante

Você precisa que o nível de compatibilidade do banco de dados esteja definido para 160 usar as LEADINGpalavras-chave , TRAILINGou BOTH .

O exemplo a seguir remove o trailing . do final da cadeia de caracteres após a palavra test.

SELECT TRIM(TRAILING '.,! ' FROM '     .#     test    .') AS Result;

Aqui está o conjunto de resultados.

     .#     test

E. Remover caracteres especificados do início e do fim de uma cadeia de caracteres

Importante

Você precisa que o nível de compatibilidade do banco de dados esteja definido para 160 usar as LEADINGpalavras-chave , TRAILINGou BOTH .

O exemplo a seguir remove os caracteres 123 do início e do fim da cadeia de caracteres 123abc123.

SELECT TRIM(BOTH '123' FROM '123abc123') AS Result;

Aqui está o conjunto de resultados.

abc

Conteúdo relacionado

  • Last updated on