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)