CITAT (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-analysslutpunkt i Microsoft FabricLager i Microsoft FabricSQL-databas i Microsoft Fabric

Returnerar en Unicode-sträng med avgränsare tillagda för att göra indatasträngen till en giltig SQL Server-avgränsad identifierare.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

'character_string'
Är en sträng av Unicode-teckendata. character_string är sysname och är begränsat till 128 tecken. Indata större än 128 tecken returnerar NULL.

'quote_character'
Är en enteckenssträng att använda som avgränsare. Kan vara ett enda citattecken ( ' ), en vänster eller höger hakparentes ( []), ett dubbelcitattecken ( " ), en vänster eller höger parentes ( ()) , ett större eller mindre än-tecken ( >< ), ett vänster- eller högerförstävningstecken ( {} ) eller en backtick ( ` ). NULL återkommer om ett oacceptabelt tecken tillhandahålls. Om quote_character inte anges används hakparenteser.

Returtyper

Nvarchar(258)

Examples

Följande exempel tar teckensträngen abc[]def och använder och ] tecknen [ för att skapa en giltig SQL Server-avgränsad identifierare.

SELECT QUOTENAME('abc[]def');

Här är resultatet.

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

Observera att högra bracketen i strängen abc[]def dubbleras för att indikera ett escape-tecken.

Följande exempel förbereder en citerad sträng för att använda vid namngivning av en kolumn.

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

EXEC sp_executesql @sql

Exempel: Azure Synapse Analytics and Analytics Platform System (PDW)

Följande exempel tar teckensträngen abc def och använder och ] tecknen [ för att skapa en giltig SQL Server-avgränsad identifierare.

SELECT QUOTENAME('abc def');   

Här är resultatet.

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

Se även

PARSENAME (Transact-SQL)
CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)
ERSÄTT (Transact-SQL)
OMVÄND (Transact-SQL)
STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)
SAKER (Transact-SQL)
ÖVERSÄTTA (Transact-SQL)
Strängfunktioner (Transact-SQL)