NOME DA CITAÇÃO (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

Devolve uma cadeia Unicode com os delimitadores adicionados para tornar a cadeia de entrada um identificador delimitado válido do SQL Server.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

'character_string'
É uma cadeia de dados de caracteres Unicode. character_string é sysname e está limitado a 128 caracteres. Entradas superiores a 128 caracteres retornam NULL.

'quote_character'
É uma cadeia de um carácter para usar como delimitador. Pode ser uma aspas simples ( ' ), um colchete esquerdo ou direito ( [] ), uma aspas dupla ( " ), um parêntese à esquerda ou à direita ( () ), um sinal maior ou menor que ( >< ), uma colchete esquerda ou direita ( {} ) ou um backtick ( ` ). O NULL retorna se for fornecido um carácter inaceitável. Se quote_character não for especificado, são usados parênteses.

Tipos de devolução

nvarchar (258)

Examples

O exemplo seguinte pega na cadeia abc[]def de caracteres e usa os [ caracteres e ] para criar um identificador delimitado válido do SQL Server.

SELECT QUOTENAME('abc[]def');

Aqui está o conjunto de resultados.

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

Note que o colchete direito na cadeia abc[]def é duplicado para indicar um carácter de escape.

O exemplo seguinte prepara uma cadeia de aspas para usar na nomeação de uma coluna.

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

EXEC sp_executesql @sql

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

O exemplo seguinte pega na cadeia abc def de caracteres e usa os [ caracteres e ] para criar um identificador delimitado válido do SQL Server.

SELECT QUOTENAME('abc def');   

Aqui está o conjunto de resultados.

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

Ver também

PARSENAME (Transact-SQL)
CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)
SUBSTITUIR (Transact-SQL)
REVERSO (Transact-SQL)
STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)
COISAS (Transact-SQL)
DEFINIÇÃO DA PALAVRA (Transact-SQL)
Funções de cadeia de caracteres (Transact-SQL)