QUOTENAME (Transact-SQL)QUOTENAME (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

Unicode 文字列に区切り記号を追加して返すことで、入力文字列から区切り記号で囲まれた有効な SQL ServerSQL Server 識別子を作成します。Returns a Unicode string with the delimiters added to make the input string a valid SQL ServerSQL Server delimited identifier.

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

構文Syntax

QUOTENAME ( 'character_string' [ , 'quote_character' ] )   

注意

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

引数Arguments

'character_string''character_string'
Unicode 文字データの文字列を指定します。Is a string of Unicode character data. character_stringsysname 128 文字までに制限されます。character_string is sysname and is limited to 128 characters. 128 文字を超える文字を入力すると、NULL が返されます。Inputs greater than 128 characters return NULL.

'quote_character''quote_character'
区切り記号として使用する 1 つの文字を指定します。Is a one-character string to use as the delimiter. 単一引用符 ( ' )、左または右の角かっこ ( [] )、二重引用符 ( " )、左または右のかっこ ( () )、大なりまたは小なり記号 ( >< )、左または右の中かっこ ( {} )、またはバッククォート ( ` ) を指定できます。Can be a single quotation mark ( ' ), a left or right bracket ( [] ), a double quotation mark ( " ), a left or right parenthesis ( () ), a greater than or less than sign ( >< ), a left or right brace ( {} ) or a backtick ( ` ). 使用できない文字が指定された場合は、NULL が返されます。NULL returns if an unacceptable character is supplied. quote_character を指定しない場合は、角かっこが使用されます。If quote_character is not specified, brackets are used.

戻り値の型Return Types

nvarchar(258)nvarchar(258)

Examples

次の例では、文字列 abc[]def を受け取り、[ 文字と ] 文字を使用して、区切り記号で囲まれた有効な SQL ServerSQL Server 識別子を作成します。The following example takes the character string abc[]def and uses the [ and ] characters to create a valid SQL ServerSQL Server delimited identifier.

SELECT QUOTENAME('abc[]def');

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

[abc[]]def]
  
(1 row(s) affected)  

文字列 abc[]def 内の右角かっこが 2 つ続いてエスケープ文字を表していることに注意してください。Notice that the right bracket in the string abc[]def is doubled to indicate an escape character.

次の例では、列に名前を付けるために使用する引用符で囲まれた文字列を準備します。The following example prepares a quoted string to use in naming a column.

DECLARE @columnName NVARCHAR(255)='user''s "custom" name'
DECLARE @sql NVARCHAR(MAX) = 'SELECT FirstName AS ' + QUOTENAME(@columnName) + ' FROM dbo.DimCustomer'

EXEC sp_executesql @sql

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

次の例では、文字列 abc def を受け取り、[ 文字と ] 文字を使用して、区切り記号で囲まれた有効な SQL ServerSQL Server 識別子を作成します。The following example takes the character string abc def and uses the [ and ] characters to create a valid SQL ServerSQL Server delimited identifier.

SELECT QUOTENAME('abc def');   

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

[abc def]  
  
(1 row(s) affected)  

参照See Also

PARSENAME (Transact-SQL)PARSENAME (Transact-SQL)
CONCAT (Transact-SQL)CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)FORMATMESSAGE (Transact-SQL)
REPLACE (Transact-SQL)REPLACE (Transact-SQL)
REVERSE (Transact-SQL)REVERSE (Transact-SQL)
STRING_AGG (Transact-SQL)STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)STRING_ESCAPE (Transact-SQL)
STUFF (Transact-SQL)STUFF (Transact-SQL)
TRANSLATE (Transact-SQL)TRANSLATE (Transact-SQL)
文字列関数 (Transact-SQL)String Functions (Transact-SQL)