Partilhar via


QUOTENAME (Transact-SQL)

Aplica-se a: SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics endpoint em Microsoft FabricWarehouse em Microsoft FabricSQL database em Microsoft Fabric

Devolve uma cadeia Unicode com os delimitadores adicionados para tornar a cadeia de entrada válida SQL Server c0.

Convenções sintáticas Transact-SQL

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 sequência de um carácter para usar como delimitador. Pode ser uma aspas simples ('), um parêntese esquerdo ou direito ([]ou ), uma aspas dupla ("), um parêntese à esquerda ou à direita (( ou )), um sinal maior ou menor que (> ou <), uma chave esquerda ou direita ({ ou }) ou um backtick (''').

Se fornecer um carácter de citação inaceitável, NULL é devolvido. 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 de caracteres abc[]def e usa os caracteres [ e ] para criar um identificador delimitado SQL Server válido.

SELECT QUOTENAME('abc[]def');

Aqui está o conjunto de resultados.

[abc[]]def]

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 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: Azure Synapse Analytics e Analytics Platform System (PDW)

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

SELECT QUOTENAME('abc def');

Aqui está o conjunto de resultados.

[abc def]