QUOTENAME (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)Titik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft Fabric

Mengembalikan string Unicode dengan pemisah yang ditambahkan untuk menjadikan string input sebagai pengidentifikasi yang dibatasi SQL Server yang valid.

Konvensi sintaks transact-SQL

Sintaksis

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

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

'character_string'
Adalah string data karakter Unicode. character_string adalah sysname dan dibatasi hingga 128 karakter. Input yang lebih besar dari 128 karakter mengembalikan NULL.

'quote_character'
Adalah string satu karakter untuk digunakan sebagai pemisah. Bisa berupa tanda kutip tunggal ( ' ), tanda kurung kiri atau kanan ( [] ), tanda kutip ganda ( " ), tanda kurung kiri atau kanan ( () ), tanda lebih besar dari atau kurang dari tanda ( >< ), kurung kiri atau kanan ( {} ) atau backtick ( ` ). NULL mengembalikan jika karakter yang tidak dapat diterima disediakan. Jika quote_character tidak ditentukan, tanda kurung siku digunakan.

Jenis Kembalian

nvarchar(258)

Contoh

Contoh berikut mengambil string abc[]def karakter dan menggunakan [ karakter dan ] untuk membuat pengidentifikasi berbatas SQL Server yang valid.

SELECT QUOTENAME('abc[]def');

Berikut adalah hasil yang ditetapkan.

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

Perhatikan bahwa tanda kurung siku yang tepat dalam string abc[]def digandakan untuk menunjukkan karakter escape.

Contoh berikut menyiapkan string yang dikutip untuk digunakan dalam penamaan kolom.

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

EXEC sp_executesql @sql

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

Contoh berikut mengambil string abc def karakter dan menggunakan [ karakter dan ] untuk membuat pengidentifikasi berbatas SQL Server yang valid.

SELECT QUOTENAME('abc def');   

Berikut adalah hasil yang ditetapkan.

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

Lihat Juga

PARSENAME (Transact-SQL)
CONCAT (T-SQL)
CONCAT_WS (T-SQL)
FORMATMESSAGE (Transact-SQL)
REPLACE (Transact-SQL)
TERBALIK (Transact-SQL)
STRING_AGG (T-SQL)
STRING_ESCAPE (T-SQL)
STUFF (Transact-SQL)
TERJEMAHKAN (Transact-SQL)
Fungsi String (Transact-SQL)