CYTAT (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punkt końcowy analizy SQL w usłudze Microsoft FabricHurtownia danych w usłudze Microsoft FabricBaza danych SQL w usłudze Microsoft Fabric

Zwraca ciąg Unicode z dodanymi ogranicznikami, aby łańcuch wejściowy stał się poprawnym identyfikatorem rozdzielonym SQL Server.

Transact-SQL konwencje składni

Składnia

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

Arguments

'character_string'
To ciąg znaków Unicode. character_string to nazwa systemu i jest ograniczona do 128 znaków. Dane wejściowe powyżej 128 znaków zwracają NULL.

'quote_character'
To ciąg jednoznakowy używany jako separator. Może to być pojedynczy cudzysłów ( ' ), nawiasów w lewej lub prawej ( [], podwójny cudzysłów ( " ), nawiasów w lewym lub prawym ( (), znak większy lub mniejszy niż ( >< ), nawias w lewej lub prawej ławie ( {} ) lub odciska ( ` ). NULL wraca, jeśli podano znak nieakceptowalny. Jeśli quote_character nie jest określona, stosuje się nawiasy.

Typy zwracane

nvarchar(258)

Przykłady

Poniższy przykład bierze ciąg abc[]def znaków i używa znaków [ oraz ] do utworzenia poprawnego identyfikatora rozdzielonego SQL Server.

SELECT QUOTENAME('abc[]def');

Oto zestaw wyników.

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

Zwróć uwagę, że prawy nawias w ciągu abc[]def jest podwojony, aby wskazać znak ucieczki.

Poniższy przykład przygotowuje cytatowany ciąg do użycia do nazewnictwa kolumny.

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

EXEC sp_executesql @sql

Przykłady: Azure Synapse Analytics and Analytics Platform System (PDW)

Poniższy przykład bierze ciąg abc def znaków i używa znaków [ oraz ] do utworzenia poprawnego identyfikatora rozdzielonego SQL Server.

SELECT QUOTENAME('abc def');   

Oto zestaw wyników.

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

Zobacz też

PARSENAME (Transact-SQL)
CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)
ZASTĄPNIJ (Transact-SQL)
ODWRÓT (Transact-SQL)
STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)
RZECZY (Transact-SQL)
TŁUMACZ (Transact-SQL)
funkcje ciągów (Transact-SQL)