LEWE (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punkt końcowy analizy SQL w usłudze Microsoft FabricHurtownia danych w usłudze Microsoft FabricBaza danych SQL w usłudze Microsoft Fabric

Zwraca lewą część ciągu znaków o określonej liczbie znaków.

Transact-SQL konwencje składni

Składnia

LEFT ( character_expression , integer_expression )  

Arguments

character_expression
Jest wyrazem znaków lub danych binarnych. character_expression może być stałą, zmienną lub kolumną. character_expression może być dowolnego typu danych, z wyjątkiem tekstu lub ntextu, który można domyślnie przekonwertować na varchar lub nvarchar. W przeciwnym razie użyj funkcji CAST , aby jawnie przekonwertować character_expression.

Uwaga / Notatka

Jeśli string_expression jest typu binarnego lub varbinarnego, LEFT wykona niejawną konwersję na varchar, a zatem nie zachowa binarnego wejścia.

integer_expression
To dodatnia liczba całkowita, która określa, ile znaków character_expression zostanie zwróconych. Jeśli integer_expression jest ujemny, zwracany jest błąd. Jeśli integer_expression jest typem bigint i zawiera dużą wartość, character_expression musi być typu dużego typu danych, takiego jak varchar(max).

Parametr integer_expression liczy znak zastępczy UTF-16 jako jeden znak.

Typy zwracane

Zwraca varchar , gdy character_expression jest typem danych znaków nieprzypisanych Unicode.

Zwraca nvarchar , gdy character_expression jest typem danych znaków Unicode.

Uwagi

Podczas stosowania kolacji SC parametr integer_expression liczy parę zastępczą UTF-16 jako jeden znak. Aby uzyskać więcej informacji, zobacz Sortowanie i obsługa Unicode.

Przykłady

A. Używając LEFT z kolumną

Poniższy przykład zwraca pięć najbardziej lewych znaków każdej nazwy produktu w tabeli Product bazy danych AdventureWorks2025.

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

B. Używanie LEFT z ciągiem znaków

Poniższy przykład wykorzystuje LEFT zwracanie dwóch najbardziej lewych znaków ciągu abcdefgznaków .

SELECT LEFT('abcdefg',2);  
GO  

Oto zestaw wyników.

--   
ab   
  
(1 row(s) affected)  

Przykłady: Azure Synapse Analytics and Analytics Platform System (PDW)

C. Używając LEFT z kolumną

Poniższy przykład zwraca pięć najbardziej lewych znaków każdej nazwy produktu.

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

D. Używanie LEFT z ciągiem znaków

Poniższy przykład wykorzystuje LEFT zwracanie dwóch najbardziej lewych znaków ciągu abcdefgznaków .

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

Oto zestaw wyników.

--   
ab  

Zobacz też

LTRIM (Transact-SQL)
PRAWY (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
PODCIĄG (Transact-SQL)
TRIM (Transact-SQL)
RZUTOWANIE i konwertowanie (Transact-SQL)
typy danych (Transact-SQL)
funkcje ciągów (Transact-SQL)