LEFT (Transact-SQL)

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 de SQL no Microsoft Fabric Warehouse no Microsoft Fabric

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

Convenções de sintaxe de Transact-SQL

Sintaxe

LEFT ( character_expression , integer_expression )  

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

Caso string_expression seja do tipo binary ou varbinary, LEFT executará uma conversão implícita em varchar, 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) .

O parâmetro integer_expression conta um caractere alternativo de UTF-16 como um caractere.

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.

Comentários

Durante o uso de ordenações SC, o parâmetro integer_expression conta um par alternativo UTF-16 como um caractere. Para obter mais informações, consulte Suporte a ordenações e a Unicode.

Exemplos

a. Usando LEFT com uma coluna

O exemplo a seguir retorna os cinco caracteres mais à esquerda do nome de cada produto na tabela Product do banco de dados AdventureWorks2022.

SELECT LEFT(Name, 5)   
FROM Production.Product  
ORDER BY ProductID;  
GO  

B. Usando LEFT com uma cadeia de caracteres

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

SELECT LEFT('abcdefg',2);  
GO  

Este é o conjunto de resultados.

--   
ab   
  
(1 row(s) affected)  

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

C. Usando LEFT com uma coluna

O exemplo a seguir retorna os cinco caracteres mais à esquerda do nome de cada produto.

-- Uses AdventureWorks  
  
SELECT LEFT(EnglishProductName, 5)   
FROM dbo.DimProduct  
ORDER BY ProductKey;  

D. Usando LEFT com uma cadeia de caracteres

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

-- Uses AdventureWorks  
  
SELECT LEFT('abcdefg',2) FROM dbo.DimProduct;  

Este é o conjunto de resultados.

--   
ab  

Consulte Também

LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)
CAST e CONVERT (Transact-SQL)
Tipos de dados (Transact-SQL)
Funções de cadeia de caracteres (Transact-SQL)