ESQUERDA (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Ponto de extremidade de análise de SQL no Microsoft FabricDepósito no Microsoft FabricBanco de dados SQL 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 )  

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 de cada nome de produto na Product tabela do banco de dados AdventureWorks2025.

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  

Veja a seguir 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;  

Veja a seguir o conjunto de resultados.

--   
ab  

Confira também

LTRIM (Transact-SQL)
DIREITA (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)