ESQUERDA (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

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

Transact-SQL convenções de sintaxe

Sintaxe

LEFT ( character_expression , integer_expression )  

Arguments

character_expression
É uma expressão de carácter ou dados binários. character_expression pode ser uma constante, variável ou coluna. character_expression pode ser de qualquer tipo de dado, exceto texto ou ntext, que pode ser implicitamente convertido em varchar ou nvarchar. Caso contrário, use a função CAST para converter explicitamente character_expression.

Observação

Se string_expression for do tipo binário ou varbinário, o LEFT realizará uma conversão implícita para varchar e, portanto, não preservará a entrada binária.

integer_expression
É um inteiro positivo que especifica quantos caracteres do character_expression serão devolvidos. Se integer_expression for negativo, é devolvedo um erro. Se integer_expression for do tipo bigint e contiver um valor grande, character_expression deve ser de um tipo de dado grande como varchar(max).

O parâmetro integer_expression conta um carácter substituto UTF-16 como um único carácter.

Tipos de devolução

Devolve varchar quando character_expression é um tipo de dado de carácter não Unicode.

Devolve nvarchar quando character_expression é um tipo de dado de carácter Unicode.

Observações

Ao usar colações SC, o parâmetro integer_expression conta um par de substitutos UTF-16 como um único carácter. Para obter mais informações, consulte Collation and Unicode Support.

Examples

A. Usar ESQUERDA com uma coluna

O exemplo seguinte devolve os cinco caracteres mais à esquerda de cada nome de produto na Product tabela da base de dados AdventureWorks2025.

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

B. Usar LEFT com uma cadeia de caracteres

O exemplo seguinte usa LEFT para devolver os dois caracteres mais à esquerda da cadeia abcdefgde caracteres .

SELECT LEFT('abcdefg',2);  
GO  

Aqui está o conjunto de resultados.

--   
ab   
  
(1 row(s) affected)  

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

C. Usar ESQUERDA com uma coluna

O exemplo seguinte devolve os cinco caracteres mais à esquerda de cada nome de produto.

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

D. Usar LEFT com uma cadeia de caracteres

O exemplo seguinte usa LEFT para devolver os dois caracteres mais à esquerda da cadeia abcdefgde caracteres .

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

Aqui está o conjunto de resultados.

--   
ab  

Ver também

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