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

適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse

文字列の左端から、指定された数だけ文字を返します。Returns the left part of a character string with the specified number of characters.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

LEFT ( character_expression , integer_expression )  

注意

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

引数Arguments

character_expressioncharacter_expression
文字データまたはバイナリ データのを指定します。Is an expression of character or binary data. character_expression には定数、変数、または列を指定できます。character_expression can be a constant, variable, or column. character_expression には、text または ntext を除く任意のデータ型 (暗黙的に varchar または nvarchar に変換できるデータ型) を使用できます。character_expression can be of any data type, except text or ntext, that can be implicitly converted to varchar or nvarchar. それ以外の場合は、CAST 関数を使用して character_expression を明示的に変換します。Otherwise, use the CAST function to explicitly convert character_expression.

注意

string_expression の型が binaryvarbinary の場合、LEFT では、varchar への暗黙的変換が実行され、そのため、バイナリ入力は保持されません。If string_expression is of type binary or varbinary, LEFT will perform an implicit conversion to varchar, and therefore will not preserve the binary input.

integer_expressioninteger_expression
返される character_expression の文字数を指定する正の整数です。Is a positive integer that specifies how many characters of the character_expression will be returned. integer_expression が負の場合、エラーが返されます。If integer_expression is negative, an error is returned. integer_expressionbigint 型で、値が大きい場合、character_expression には 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).

integer_expression パラメーターは、UTF-16 サロゲート文字を 1 文字としてカウントします。The integer_expression parameter counts a UTF-16 surrogate character as one character.

戻り値の型Return Types

character_expression が非 Unicode 文字データ型の場合は、varchar を返します。Returns varchar when character_expression is a non-Unicode character data type.

character_expression が Unicode 文字データ型の場合は、nvarchar を返します。Returns nvarchar when character_expression is a Unicode character data type.

解説Remarks

SC 照合順序を使用する場合、integer_expression パラメーターは UTF-16 サロゲート ペアを 1 文字としてカウントします。When using SC collations, the integer_expression parameter counts a UTF-16 surrogate pair as one character. 詳細については、「 Collation and Unicode Support」を参照してください。For more information, see Collation and Unicode Support.

Examples

A.A. 列を指定した LEFT を使用するUsing LEFT with a column

次の例では、AdventureWorks2012AdventureWorks2012 データベースの Product テーブル内の各製品名の左端から 5 文字が返されます。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. 文字列を指定した LEFT を使用するUsing LEFT with a character string

次の例では、LEFT を使用して abcdefg という文字列の左端の 2 文字を返します。The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

結果セットは次のようになります。Here is the result set.

--   
ab   
  
(1 row(s) affected)  

例: Azure Synapse AnalyticsAzure Synapse AnalyticsParallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Parallel Data WarehouseParallel Data Warehouse

C.C. 列を指定した LEFT を使用するUsing LEFT with a column

次の例では、各製品名の左端の 5 文字を返します。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. 文字列を指定した LEFT を使用するUsing LEFT with a character string

次の例では、LEFT を使用して abcdefg という文字列の左端の 2 文字を返します。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;  

結果セットは次のようになります。Here is the result set.

--   
ab  

参照See 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 および CONVERT (Transact-SQL) CAST and CONVERT (Transact-SQL)
データ型 (Transact-SQL) Data Types (Transact-SQL)
文字列関数 (Transact-SQL)String Functions (Transact-SQL)