LEFT (Transact-SQL)LEFT (Transact-SQL)

DIESES THEMA GILT FÜR: jaSQL Server (ab 2008)jaAzure SQL-DatenbankjaAzure SQL Data Warehouse jaParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Gibt den linken Teil einer Zeichenfolge mit der angegebenen Anzahl von Zeichen zurück.Returns the left part of a character string with the specified number of characters.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

LEFT ( character_expression , integer_expression )  

ArgumenteArguments

character_expressioncharacter_expression
Ist ein Ausdruck von Zeichen- oder Binärdaten darstellen.Is an expression of character or binary data. Character_expression kann eine Konstante, Variable oder Spalte sein.character_expression can be a constant, variable, or column. Character_expression kann einen beliebigen Datentyp aufweisen, mit Ausnahme von Text oder Ntext, implizit zu konvertiert werden können Varchar oder Nvarchar.character_expression can be of any data type, except text or ntext, that can be implicitly converted to varchar or nvarchar. Verwenden Sie andernfalls die Umwandlung Funktion explizit konvertieren Character_expression.Otherwise, use the CAST function to explicitly convert character_expression.

integer_expressioninteger_expression
Eine positive ganze Zahl, die angibt, wie viele Zeichen von der Character_expression zurückgegeben werden.Is a positive integer that specifies how many characters of the character_expression will be returned. Wenn Integer_expression ist negativ ist, wird ein Fehler zurückgegeben.If integer_expression is negative, an error is returned. Wenn Integer_expression Typ "bigint" und enthält einen hohen Wert Character_expression muss einen Datentyp mit umfangreichen wie z. B. varchar(max).If integer_expression is type bigint and contains a large value, character_expression must be of a large data type such as varchar(max).

Die Integer_expression Parameter wird ein UTF-16-Ersatzzeichen als ein Zeichen gezählt.The integer_expression parameter counts a UTF-16 surrogate character as one character.

RückgabetypenReturn Types

Gibt Varchar Wenn Character_expression ein nicht-Unicode-Zeichendatentyp ist.Returns varchar when character_expression is a non-Unicode character data type.

Gibt Nvarchar Wenn Character_expression ein Unicode-Zeichendatentyp ist.Returns nvarchar when character_expression is a Unicode character data type.

HinweiseRemarks

Bei Verwendung von SC-Sortierungen der Integer_expression Parameter wird ein UTF-16-Ersatzpaar als ein Zeichen gezählt.When using SC collations, the integer_expression parameter counts a UTF-16 surrogate pair as one character. Weitere Informationen finden Sie unter Collation and Unicode Support.For more information, see Collation and Unicode Support.

BeispieleExamples

A.A. Verwenden von LEFT mit einer SpalteUsing LEFT with a column

Im folgenden Beispiel werden die fünf am weitesten links stehenden Zeichen jedes Produktnamens in der Product-Tabelle der AdventureWorks2012AdventureWorks2012-Datenbank zurückgegeben.The following example returns the five leftmost characters of each product name in the Product table of the AdventureWorks2012AdventureWorks2012 database.

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

B.B. Verwenden von LEFT mit einer ZeichenfolgeUsing LEFT with a character string

Im folgenden Beispiel wird LEFT zur Rückgabe der beiden ersten Zeichen der Zeichenfolge abcdefg verwendet.The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

Im Folgenden finden Sie das Resultset.Here is the result set.

--   
ab   

(1 row(s) affected)  

Beispiele: Azure SQL Data WarehouseAzure SQL Data Warehouse und Parallel Data WarehouseParallel Data WarehouseExamples: Azure SQL Data WarehouseAzure SQL Data Warehouse and Parallel Data WarehouseParallel Data Warehouse

C.C. Verwenden von LEFT mit einer SpalteUsing LEFT with a column

Im folgenden Beispiel werden die ersten fünf Zeichen der Produktnamen zurückgegeben.The following example returns the five leftmost characters of each product name.

-- Uses AdventureWorks  

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

D.D. Verwenden von LEFT mit einer ZeichenfolgeUsing LEFT with a character string

Im folgenden Beispiel wird LEFT zur Rückgabe der beiden ersten Zeichen der Zeichenfolge abcdefg verwendet.The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

-- Uses AdventureWorks  

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

Im Folgenden finden Sie das Resultset.Here is the result set.

--   
ab  

Siehe auchSee Also

CAST und CONVERT ( Transact-SQL ) CAST and CONVERT (Transact-SQL)
Datentypen (Transact-SQL) Data Types (Transact-SQL)
Zeichenfolgenfunktionen ( Transact-SQL )String Functions (Transact-SQL)