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

GILT FÜR: jaSQL Server (ab 2008) jaAzure SQL-DatenbankjaAzure SQL Data Warehouse jaParallel Data WarehouseAPPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database yesAzure 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
Ein Ausdruck aus Zeichen- oder Binärdaten.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 von einem beliebigen Datentyp sein, ausschließlich text oder ntext, der implizit in varchar oder nvarchar konvertiert werden kann.character_expression can be of any data type, except text or ntext, that can be implicitly converted to varchar or nvarchar. Verwenden Sie in allen anderen Fällen die CAST-Funktion zur expliziten Konvertierung von character_expression.Otherwise, use the CAST function to explicitly convert character_expression.

integer_expressioninteger_expression
Ein positiver Integer, der angibt, wie viele Zeichen von character_expression zurückgegeben werden.Is a positive integer that specifies how many characters of the character_expression will be returned. Wenn integer_expression negativ ist, wird ein Fehler zurückgegeben.If integer_expression is negative, an error is returned. 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.If integer_expression is type bigint and contains a large value, character_expression must be of a large data type such as varchar(max).

Für den 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 zurück, wenn es sich bei character_expression um einen Zeichendatentyp handelt, der Unicode nicht unterstützt.Returns varchar when character_expression is a non-Unicode character data type.

Gibt nvarchar zurück, wenn es sich bei character_expression um einen Zeichendatentyp handelt, der Unicode nicht unterstützt.Returns nvarchar when character_expression is a Unicode character data type.

RemarksRemarks

Bei Verwendung von SC-Sortierungen zählt der integer_expression-Parameter ein UTF-16-Ersatzpaar als ein Zeichen.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 Warehouse.Examples: 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  

Weitere Informationen finden Sie unterSee Also

LTRIM (Transact-SQL)LTRIM (Transact-SQL)
RIGHT (Transact-SQL)RIGHT (Transact-SQL)
RTRIM (Transact-SQL)RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)TRIM (Transact-SQL)
CAST und CONVERT (Transact-SQL) CAST and CONVERT (Transact-SQL)
Datentypen (Transact-SQL) Data Types (Transact-SQL)
String Functions (Transact-SQL) (Zeichenfolgenfunktionen (Transact-SQL))String Functions (Transact-SQL)