QUOTENAME (Transact-SQL)

Applies to:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Sistemi (PDW)SQL analiz uç noktası Microsoft FabricWarehouse in Microsoft FabricSQL database in Microsoft Fabric

Giriş dizesini geçerli bir SQL Server delimited identifier yapmak için sınırlayıcıların eklendiği bir Unicode dizesi döndürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

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

Arguments

'character_string'

Unicode karakter verisi dizesi. character_stringsysname'dir ve 128 karakterle sınırlıdır. 128 karakterden büyük girişler döndürür NULL.

'quote_character'

Sınırlayıcı olarak kullanılacak tek karakterli bir dize. Tek tırnak işareti ('), sol veya sağ köşeli ayraç ([ veya ]), çift tırnak işareti ("), sol veya sağ ayraç (( veya )), küçük veya büyük bir işaret (> veya <), sol veya sağ ayraç ({ veya ) ya da }bir backtick (''') olabilir.

Kabul edilemez bir tırnak karakteri sağlarsanız, NULL döndürülür. quote_character belirtilmezse köşeli ayraçlar kullanılır.

Dönüş türleri

nvarchar(258)

Örnekler

Aşağıdaki örnek abc[]def karakter dizesini alır ve geçerli bir SQL Server sınırlandırılmış tanımlayıcı oluşturmak için [ ve ] karakterlerini kullanır.

SELECT QUOTENAME('abc[]def');

Sonuç kümesi aşağıdadır.

[abc[]]def]

Dizedeki abc[]def sağ köşeli ayraç, kaçış karakterini göstermek için iki katına alınır.

Aşağıdaki örnek, bir sütunun adlandırılmasında kullanılacak tırnak alınmış bir diziyi hazırlar.

DECLARE @columnName AS NVARCHAR (255) = 'user''s "custom" name';

DECLARE @sql AS NVARCHAR (MAX) = 'SELECT FirstName AS ' + QUOTENAME(@columnName) + ' FROM dbo.DimCustomer';

EXECUTE sp_executesql @sql;

Örnekler: Azure Synapse Analytics ve Analiz Platformu Sistemi (PDW)

Aşağıdaki örnek abc def karakter dizesini alır ve geçerli bir SQL Server sınırlandırılmış tanımlayıcı oluşturmak için [ ve ] karakterlerini kullanır.

SELECT QUOTENAME('abc def');

Sonuç kümesi aşağıdadır.

[abc def]