SQLServer中QUOTENAME函数返回带有分隔符的 Unicode 字符串，分隔符的加入可使输入的字符串成为有效的 SQL Server 分隔标识符。

适用于：

SQL Server
Azure SQL 数据库
Azure SQL 托管实例
Azure Synapse Analytics 分析平台系统 (PDW)
Microsoft Fabric 中的 SQL 分析端点
Microsoft Fabric 中的仓库

1、语法

sql 复制代码

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

2、参数

sql 复制代码

'character_string'
Unicode 字符数据构成的字符串。 character_string 是 sysname，且最多具有 128 个字符 。 超过 128 个字符的输入将返回 NULL。

'quote_character'
用作分隔符的单字符字符串。 可以是单引号 (')、左方括号或右方括号 ([])、双引号 (")、左圆括号或右圆括号 (())、大于或小于符号 (><)、左大括号或右大括号 ({}) 或反引号 (`)。 如果提供了不可接受的字符，则返回 NULL。 如果未指定 quote_character，则使用方括号 。

3、返回类型

sql 复制代码

nvarchar(258)

4、示例

以下示例接受字符串 abc\[\]def 并使用 $和$ 字符来创建有效的 SQL Server 分隔标识符。

sql 复制代码

SELECT QUOTENAME('Super-abc[]def') AS result_v1;
-- 返回执行结果，请注意，字符串 Super-abc[]def 中的右方括号有两个，用于指示转义符。
result_v1
-----------------------------------
[Super-abc[]]def]

(1 行受影响)

下面的示例准备一个用引号引起来的字符串，用于对列命名。

sql 复制代码

DECLARE @columnName NVARCHAR(255)='user''s "custom" name'
DECLARE @sql NVARCHAR(MAX) = 'SELECT top 10 FirstName,FirstName AS ' + QUOTENAME(@columnName) + ' FROM Person.Person '

EXEC sp_executesql @sql
-- 执行返回结果
FirstName                                          user's "custom" name
-------------------------------------------------- --------------------------------------------------
Syed                                               Syed
Catherine                                          Catherine
Kim                                                Kim
Kim                                                Kim
Kim                                                Kim
Hazem                                              Hazem
Sam                                                Sam
Humberto                                           Humberto
Gustavo                                            Gustavo
Pilar                                              Pilar

(10 行受影响)

Azure Synapse Analytics 和 Analytics Platform System (PDW)
以下示例接受字符串 abc def 并使用 $和$ 字符来创建有效的 SQL Server 分隔标识符。

sql 复制代码

SELECT QUOTENAME('superdb_abc def') AS result_v1;
-- 执行返回结果
result_v1
-----------------------------------------
[superdb_abc def]

(1 行受影响)