LEFT (Transact-SQL)

13.03.2017
2 Minuten zu lesen
- c
- j
- r
- M
- r
- +8

Gilt für: SQL Server (alle unterstützten Versionen) Azure SQL Datenbank Azure SQL Managed Instance Azure Synapse Analytics Parallel Data Warehouse

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

Themenverknüpfungssymbol Transact-SQL-Syntaxkonventionen

Syntax

LEFT ( character_expression , integer_expression )

Hinweis

Um die Transact-SQL-Syntax für SQL Server 2014 und früher zu sehen, lesen Sie die Dokumentation zu früheren Versionen.

Argumente

Zeichenausdruck
Ist ein Ausdruck von Zeichen- oder Binärdaten. zeichenausdruck kann eine Konstante, Variable oder Spalte sein. zeichenausdruck kann von jedem Datentyp sein, außer text oder ntext, die implizit in varchar oder nvarchar konvertiert werden können. Andernfalls verwenden Sie die Funktion CAST, um character_expression explizit zu konvertieren.

Hinweis

Wenn string_expression vom Typ binary oder varbinary ist, führt LEFT eine implizite Konvertierung nach varchar durch und behält daher die binäre Eingabe nicht bei.

integer_expression
Ist eine positive Ganzzahl, die 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 großen Wert enthält, muss character_expression von einem großen Datentyp wie varchar(max) sein.

Der Parameter integer_expression zählt ein UTF-16-Surrogatzeichen als ein Zeichen.

Rückgabetypen

Gibt varchar zurück, wenn character_expression ein Nicht-Unicode-Zeichen-Datentyp ist.

Gibt nvarchar zurück, wenn character_expression ein Unicode-Zeichen-Datentyp ist.

Bemerkungen

Bei Verwendung von SC-Sortierungen zählt der Parameter integer_expression ein UTF-16-Surrogatpaar als ein Zeichen. Weitere Informationen finden Sie unter Kollationierung und Unicode-Unterstützung.

Beispiele

A. Verwenden von LEFT mit einer Spalte

Das folgende Beispiel gibt die fünf am weitesten links stehenden Zeichen jedes Produktnamens in der Product-Tabelle der AdventureWorks2012-Datenbank zurück.

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

B. LEFT mit einer Zeichenkette verwenden

Das folgende Beispiel verwendet LEFT, um die beiden ganz linken Zeichen der Zeichenkette abcdefg zurückzugeben.

SELECT LEFT('abcdefg',2); GO

Hier ist die Ergebnismenge.

-- ab (1 row(s) affected)

Beispiele: Azure Synapse Analytics und Parallel Data Warehouse

C. Verwenden von LEFT mit einer Spalte

Das folgende Beispiel gibt die fünf am weitesten links stehenden Zeichen jedes Produktnamens zurück.

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

D. Verwendung von LEFT mit einer Zeichenkette

Das folgende Beispiel verwendet LEFT, um die zwei am weitesten links stehenden Zeichen der Zeichenkette abcdefg zurückzugeben.

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