LEFT (Transact-SQL)

Artikel
10/31/2024

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL Analytics-Endpunkt in Microsoft Fabric Warehouse in Microsoft Fabric

Gibt den linken Teil einer Zeichenfolge mit der angegebenen Anzahl von Zeichen zurück.

Transact-SQL-Syntaxkonventionen

Syntax

LEFT ( character_expression , integer_expression )

Argumente

character_expression
Ein Ausdruck aus Zeichen- oder Binärdaten. character_expression kann eine Konstante, Variable oder Spalte sein. character_expression kann von einem beliebigen Datentyp sein, ausschließlich text oder ntext, der implizit in varchar oder nvarchar konvertiert werden kann. Verwenden Sie in allen anderen Fällen die CAST-Funktion zur expliziten Konvertierung von character_expression.

Hinweis

Wenn string_expression den Typ binary oder varbinary aufweist, führt LEFT eine implizite Konvertierung in varchar aus und behält daher die binäre Eingabe nicht bei.

integer_expression
Ein positiver Integer, der angibt, wie viele Zeichen von character_expression zurückgegeben werden. Wenn integer_expression negativ ist, wird ein Fehler zurückgegeben. Wenn integer_expression vom Typ bigint ist und einen hohen Wert hat, muss character_expression von einem umfangreicheren Datentyp wie z.B. varchar(max) sein.

Für den integer_expression-Parameter wird ein UTF-16-Ersatzzeichen als ein Zeichen gezählt.

Rückgabetypen

Gibt varchar zurück, wenn es sich bei character_expression um einen Zeichendatentyp handelt, der Unicode nicht unterstützt.

Gibt nvarchar zurück, wenn es sich bei character_expression um einen Zeichendatentyp handelt, der Unicode nicht unterstützt.

Bemerkungen

Bei Verwendung von SC-Sortierungen zählt der integer_expression-Parameter ein UTF-16-Ersatzpaar als ein Zeichen. Weitere Informationen finden Sie unter Collation and Unicode Support.

Beispiele

A. Verwenden von LEFT mit einer Spalte

Im folgenden Beispiel werden die fünf am weitesten links stehenden Zeichen der einzelnen Produktnamen in der Tabelle Product der AdventureWorks2022-Datenbank zurückgegeben.

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

B. Verwenden von LEFT mit einer Zeichenfolge

Im folgenden Beispiel wird LEFT zur Rückgabe der beiden ersten Zeichen der Zeichenfolge abcdefg verwendet.

SELECT LEFT('abcdefg',2);  
GO

Hier sehen Sie das Ergebnis.

--   
ab   
  
(1 row(s) affected)

Beispiele: Azure Synapse Analytics und Analytics-Plattformsystem (PDW)

C. Verwenden von LEFT mit einer Spalte

Im folgenden Beispiel werden die ersten fünf Zeichen der Produktnamen zurückgegeben.

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

D: Verwenden von LEFT mit einer Zeichenfolge