Compartilhar via

QUOTENAME (Transact-SQL)

Applies to:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL analytics no Microsoft FabricWarehouse no banco de dados Microsoft FabricSQL em Microsoft Fabric

Retorna uma cadeia de caracteres Unicode com os delimitadores adicionados para tornar a cadeia de caracteres de entrada um identificador SQL Server delimido válido.

Transact-SQL convenções de sintaxe

Sintaxe

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

Argumentos

'character_string'

Uma cadeia de caracteres de dados de caractere Unicode. character_string é sysname e está limitado a 128 caracteres. Entradas maiores que 128 caracteres retornam NULL.

'quote_character'

Uma cadeia de caracteres de um caractere a ser usada como delimitador. Pode ser uma única aspa ('), um colchete esquerdo ou direito ([ ou ]), uma aspa dupla ("), um parêntese esquerdo ou direito (( ou )), um sinal maior ou menor que (> ou <), uma chave esquerda ou direita ({ ou }) ou um backtick ('').

Se você fornecer um caractere de aspas inaceitável, NULL será retornado. Se quote_character não for especificado, os colchetes serão usados.

Tipos de retorno

nvarchar(258)

Exemplos

O exemplo a seguir usa a cadeia de caracteres abc[]def e usa os caracteres [ e ] para criar um identificador delimitado SQL Server válido.

SELECT QUOTENAME('abc[]def');

Veja a seguir o conjunto de resultados.

[abc[]]def]

O colchete direito na cadeia de caracteres abc[]def é dobrado para indicar um caractere de escape.

O exemplo a seguir prepara uma cadeia de caracteres entre aspas para usar ao nomear uma coluna.

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;

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

O exemplo a seguir usa a cadeia de caracteres abc def e usa os caracteres [ e ] para criar um identificador delimitado SQL Server válido.

SELECT QUOTENAME('abc def');

Veja a seguir o conjunto de resultados.

[abc def]

Conteúdo relacionado

  • Last updated on