QUOTENAME (Transact-SQL)QUOTENAME (Transact-SQL)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data WarehouseSe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data Warehouse

Devuelve una cadena Unicode con los delimitadores agregados para convertirla en un identificador delimitado válido de SQL ServerSQL Server.Returns a Unicode string with the delimiters added to make the input string a valid SQL ServerSQL Server delimited identifier.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

ArgumentosArguments

'character_string''character_string'
Es una cadena de datos de caracteres Unicode.Is a string of Unicode character data. character_string es sysname y está limitado a 128 caracteres.character_string is sysname and is limited to 128 characters. Las entradas mayores de 128 caracteres devuelven NULL.Inputs greater than 128 characters return NULL.

'quote_character''quote_character'
Es una cadena de un solo carácter que se utiliza como delimitador.Is a one-character string to use as the delimiter. Puede ser una comilla simple ( ' ), un corchete de apertura o cierre ( [] ), comillas dobles ( " ), un paréntesis de apertura o cierre ( () ), un signo de mayor que o menor que ( >< ), una llave de apertura o cierre ( {} ) o un acento grave ( ` ).Can be a single quotation mark ( ' ), a left or right bracket ( [] ), a double quotation mark ( " ), a left or right parenthesis ( () ), a greater than or less than sign ( >< ), a left or right brace ( {} ) or a backtick ( ` ). Se devuelve NULL si se proporciona un carácter no admitido.NULL returns if an unacceptable character is supplied. Si no se especifica quote_character, se usarán corchetes.If quote_character is not specified, brackets are used.

Tipos de valor devueltoReturn Types

nvarchar(258)nvarchar(258)

EjemplosExamples

En el siguiente ejemplo se toma la cadena de caracteres abc[]def y se utilizan los caracteres [ y ] para crear un identificador delimitado de SQL ServerSQL Server válido.The following example takes the character string abc[]def and uses the [ and ] characters to create a valid SQL ServerSQL Server delimited identifier.

SELECT QUOTENAME('abc[]def');

El conjunto de resultados es el siguiente:Here is the result set.

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

Observe que el corchete derecho de la cadena abc[]def aparece dos veces para indicar que se trata de un carácter de escape.Notice that the right bracket in the string abc[]def is doubled to indicate an escape character.

En el siguiente ejemplo se prepara una cadena entrecomillada para usarla para dar nombre a una columna.The following example prepares a quoted string to use in naming a column.

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

EXEC sp_executesql @sql

Ejemplos: Azure Synapse Analytics (SQL Data Warehouse)Azure Synapse Analytics (SQL Data Warehouse) y Almacenamiento de datos paralelosParallel Data WarehouseExamples: Azure Synapse Analytics (SQL Data Warehouse)Azure Synapse Analytics (SQL Data Warehouse) and Almacenamiento de datos paralelosParallel Data Warehouse

En el siguiente ejemplo se toma la cadena de caracteres abc def y se utilizan los caracteres [ y ] para crear un identificador delimitado de SQL ServerSQL Server válido.The following example takes the character string abc def and uses the [ and ] characters to create a valid SQL ServerSQL Server delimited identifier.

SELECT QUOTENAME('abc def');   

El conjunto de resultados es el siguiente:Here is the result set.

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

Consulte tambiénSee Also

PARSENAME (Transact-SQL)PARSENAME (Transact-SQL)
CONCAT (Transact-SQL)CONCAT (Transact-SQL)
CONCAT_WS (Transact-SQL)CONCAT_WS (Transact-SQL)
FORMATMESSAGE (Transact-SQL)FORMATMESSAGE (Transact-SQL)
REPLACE (Transact-SQL)REPLACE (Transact-SQL)
REVERSE (Transact-SQL)REVERSE (Transact-SQL)
STRING_AGG (Transact-SQL)STRING_AGG (Transact-SQL)
STRING_ESCAPE (Transact-SQL)STRING_ESCAPE (Transact-SQL)
STUFF (Transact-SQL)STUFF (Transact-SQL)
TRANSLATE (Transact-SQL)TRANSLATE (Transact-SQL)
Funciones de cadena (Transact-SQL)String Functions (Transact-SQL)