LEFT (Transact-SQL)

Статья
10/16/2024

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечной точке аналитики платформы Аналитики Azure Synapse Analytics (PDW) в Microsoft Fabric Хранилище в 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 таблице базы данных AdventureWorks2022.

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)

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

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

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

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

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