СЛЕВА (Transact-SQL)

Применимо к:SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsСистема платформы аналитики (PDW)Конечная точка SQL аналитики в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric

Возвращает указанное число символов символьного выражения слева.

Соглашения о синтаксисе Transact-SQL

Синтаксис

LEFT ( character_expression , integer_expression )  

Аргументы

character_expression
Выражение символьных или двоичных данных. character_expression может быть константой, переменной или столбцом. character_expression может иметь любой тип данных, который может быть неявно преобразован в varchar или nvarchar, кроме text или ntext. В противном случае используйте функцию CAST для явного преобразования типа аргумента character_expression.

Примечание.

Если string_expression имеет тип binary или varbinary, LEFT выполняет неявное преобразование в тип varchar и, следовательно, двоичные входные данные не сохраняются.

integer_expression
Положительное целое число, указывающее количество символов выражения character_expression, которое будет возвращено. Если аргумент integer_expression отрицателен, возвращается ошибка. Если аргумент integer_expression имеет тип bigint и содержит большое значение, аргумент character_expression должен иметь длинный тип данных, например varchar(max).

Параметр integer_expression обрабатывает суррогатный символ UTF-16 как один символ.

Типы возвращаемых данных

Возвращает значение типа varchar, если character_expression имеет символьный тип данных, отличный от Юникода.

Возвращает значение типа nvarchar, если character_expression имеет символьный тип данных Юникода.

Замечания

При использовании параметров сортировки SC в параметре integer_expression суррогатная пара UTF-16 рассматривается как один символ. Дополнительные сведения см. в статье Collation and Unicode Support.

Примеры

А. Применение функции LEFT со столбцом

Следующий пример возвращает пять самых левых символов каждого названия продукта в Product таблице базы данных AdventureWorks2025.

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

B. Применение функции LEFT с символьной строкой

Следующий пример показывает, как функция LEFT используется для получения двух первых символов из символьной строки abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

Вот результирующий набор.

--   
ab   
  
(1 row(s) affected)  

Примеры: Azure Synapse Analytics и система платформы аналитики (PDW)

В. Применение функции LEFT со столбцом

В следующем примере возвращаются пять первых символов от каждого из названий продуктов.

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

D. Применение функции LEFT с символьной строкой

Следующий пример показывает, как функция LEFT используется для получения двух первых символов из символьной строки abcdefg.

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

Вот результирующий набор.

--   
ab  

См. также

LTRIM (Transact-SQL)
ПРАВЫЙ (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
ПОДСТРОКА (Transact-SQL)
TRIM (Transact-SQL)
CAST и CONVERT (Transact-SQL)
Типы данных (Transact-SQL)
Строковые функции (Transact-SQL)