LEFT (Transact-SQL)LEFT (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure simSQL Data Warehouse do Azure simParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Retorna a parte da esquerda de uma cadeia de caracteres com o número de caracteres especificado.Returns the left part of a character string with the specified number of characters.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

LEFT ( character_expression , integer_expression )  

ArgumentosArguments

character_expressioncharacter_expression
É uma expression de dados binários ou de caracteres.Is an expression of character or binary data. character_expression pode ser uma constante, variável ou coluna.character_expression can be a constant, variable, or column. character_expression pode ser de qualquer tipo de dados, exceto text ou ntext, que pode ser convertido implicitamente em varchar ou nvarchar .character_expression can be of any data type, except text or ntext, that can be implicitly converted to varchar or nvarchar. Caso contrário, use a função CAST para converter explicitamente character_expression.Otherwise, use the CAST function to explicitly convert character_expression.

integer_expressioninteger_expression
É um inteiro positivo que especifica quantos caracteres da character_expression serão retornados.Is a positive integer that specifies how many characters of the character_expression will be returned. Se integer_expression for negativa, um erro será retornado.If integer_expression is negative, an error is returned. 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) .If integer_expression is type bigint and contains a large value, character_expression must be of a large data type such as varchar(max).

O parâmetro integer_expression conta um caractere alternativo de UTF-16 como um caractere.The integer_expression parameter counts a UTF-16 surrogate character as one character.

Tipos de retornoReturn Types

Retorna varchar quando character_expression é um tipo de dados de caractere não Unicode.Returns varchar when character_expression is a non-Unicode character data type.

Retorna nvarchar quando character_expression é um tipo de dados de caractere Unicode.Returns nvarchar when character_expression is a Unicode character data type.

RemarksRemarks

Durante o uso de ordenações SC, o parâmetro integer_expression conta um par alternativo UTF-16 como um caractere.When using SC collations, the integer_expression parameter counts a UTF-16 surrogate pair as one character. Para obter mais informações, consulte Suporte a ordenações e a Unicode.For more information, see Collation and Unicode Support.

ExemplosExamples

A.A. Usando LEFT com uma colunaUsing LEFT with a column

O exemplo a seguir retorna os cinco caracteres mais à esquerda do nome de cada produto na tabela Product do banco de dados AdventureWorks2012AdventureWorks2012.The following example returns the five leftmost characters of each product name in the Product table of the AdventureWorks2012AdventureWorks2012 database.

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

B.B. Usando LEFT com uma cadeia de caracteresUsing LEFT with a character string

O exemplo a seguir usa LEFT para retornar os dois caracteres mais à esquerda da cadeia de caracteres abcdefg.The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

Aqui está o conjunto de resultados.Here is the result set.

--   
ab   
  
(1 row(s) affected)  

Exemplos: Azure SQL Data WarehouseAzure SQL Data Warehouse e Parallel Data WarehouseParallel Data WarehouseExamples: Azure SQL Data WarehouseAzure SQL Data Warehouse and Parallel Data WarehouseParallel Data Warehouse

C.C. Usando LEFT com uma colunaUsing LEFT with a column

O exemplo a seguir retorna os cinco caracteres mais à esquerda do nome de cada produto.The following example returns the five leftmost characters of each product name.

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

D.D. Usando LEFT com uma cadeia de caracteresUsing LEFT with a character string

O exemplo a seguir usa LEFT para retornar os dois caracteres mais à esquerda da cadeia de caracteres abcdefg.The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

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

Aqui está o conjunto de resultados.Here is the result set.

--   
ab  

Consulte TambémSee Also

LTRIM (Transact-SQL)LTRIM (Transact-SQL)
RIGHT (Transact-SQL)RIGHT (Transact-SQL)
RTRIM (Transact-SQL)RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)TRIM (Transact-SQL)
CAST e CONVERT (Transact-SQL) CAST and CONVERT (Transact-SQL)
Tipos de dados (Transact-SQL) Data Types (Transact-SQL)
Funções de cadeia de caracteres (Transact-SQL)String Functions (Transact-SQL)