ESQUERDA (Transact-SQL) - SQL Server | Microsoft Docs

03/13/2017
2 minutos para ler
ul>
>div id=”74464e8e8e14″>c
j
r
M
r
+8

/li>

P>Candidata-se a: SQL Server (todas as versões suportadas) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Parallel Data Warehouse

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

p> Iconexões de ligação óptica Convenções de sintaxe Transact-SQL

Sintaxe

LEFT ( character_expression , integer_expression )

Nota

Para ver a sintaxe Transact-SQL para o SQL Server 2014 e anteriores, ver documentação de versões anteriores.

Argumentos

caracter_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 dados, excepto texto ou ntext, que pode ser implicitamente convertido para varchar ou nvarchar. Caso contrário, utilizar a função CAST para converter explicitamente a expressão_de_caracteres.

Nota

Se a expressão_de_caracteres for do tipo binário ou varbinário, a ESQUERDA efectuará uma conversão implícita para varchar, e portanto não preservará a entrada binária.

expressão_inteira
É um inteiro positivo que especifica quantos caracteres da expressão_de_caracteres serão devolvidos. Se a expressão_expressão_inteira for negativa, é devolvido um erro. Se a expressão_expressão_inteira é do tipo bigint e contém um grande valor, a expressão_de_caracteres deve ser de um grande tipo de dados como varchar(max).

O parâmetro expressão_inteira conta um carácter substituto UTF-16 como um carácter.

Tipos de retorno

Retorna varchar quando a expressão_de_caracteres é um tipo de dado de carácter não-Unicode.

Retorna nvarchar quando a expressão_de_caracteres é um tipo de dado de carácter Unicode.

Remarks

Ao utilizar as colações SC, o parâmetro de expressão_inteira conta um par UTF-16 como um carácter. Para mais informações, ver Collation and Unicode Support.

Exemplos

A. Usando LEFT com uma coluna

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

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

B. Usando a ESQUERDA com uma cadeia de caracteres

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

SELECT LEFT('abcdefg',2); GO

Aqui está o resultado definido.

-- ab (1 row(s) affected)

Exemplos: Azure Synapse Analytics and Parallel Data Warehouse

C. Usando a ESQUERDA com uma coluna

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

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

D. Usando a ESQUERDA com uma cadeia de caracteres

O exemplo seguinte usa LEFT para retornar os dois caracteres mais à esquerda da cadeia de caracteres abcdefg.

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