ESQUERDA (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsEndpoint 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

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

Conteúdo relacionado

  • Last updated on