QUOTENAME (Transact-SQL)

發行項
11/15/2023

適用于： Microsoft Fabric 中 Microsoft Fabric 倉儲中的 SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW） SQL 分析端點

傳回已新增分隔符號的 Unicode 字串，讓輸入字串成為有效的 SQL Server 分隔識別碼。

Transact-SQL 語法慣例 (部分機器翻譯)

Syntax

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

注意

若要檢視 SQL Server 2014 （12.x）和舊版的 Transact-SQL 語法，請參閱舊版檔。

引數

'character_string'
這是 Unicode 字元資料的字串。 character_string 是 sysname，且限制為 128 個字元。大於 128 個字元的輸入會傳回 NULL。

'quote_character'
這是用來當做分隔符號的單字元字串。它可以是單引號 ( ' )、左或右方括弧 ( [] )、雙引號 ( " )、左或右括弧 ( () )、大於或小於符號 ( >< )、左或右大括弧 ( {} ) 或反勾號 ( ` )。如果提供了無法接受的字元，則會傳回 NULL。如果未指定 quote_character，就會使用方括號。

傳回型別

nvarchar(258)

範例

下列範例會使用字元字串 abc[]def，且使用 [ 和 ] 字元建立有效的 SQL Server 分隔識別碼。

SELECT QUOTENAME('abc[]def');

以下為結果集。

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

請注意，abc[]def 字串中的兩個右方括號用來表示逸出字元。

下例會準備用來命名資料行的加引號字串。

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 Analytics 和 Analytics Platform System (PDW)

下列範例會使用字元字串 abc def，且使用 [ 和 ] 字元建立有效的 SQL Server 分隔識別碼。

SELECT QUOTENAME('abc def');

以下為結果集。

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

另請參閱

PARSENAME (Transact-SQL)
CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)
REPLACE (Transact-SQL)
REVERSE (Transact-SQL)
STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)
STUFF (Transact-SQL)
TRANSLATE (Transact-SQL)
字串函數 (Transact-SQL)