LEFT (Transact-SQL)
Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse 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)
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de