SET QUOTED_IDENTIFIER (Transact-SQL)

Se aplica a: síSQL Server (todas las versiones admitidas) SíAzure SQL Database SíInstancia administrada de Azure SQL síAzure Synapse Analytics síAlmacenamiento de datos paralelos

Hace que SQL Server siga las reglas de ISO en cuanto a comillas delimitadoras de identificadores y cadenas literales se refiere. Los identificadores delimitados con comillas dobles pueden ser palabras clave reservadas de Transact-SQL o pueden contener caracteres normalmente no admitidos por las reglas sintácticas para identificadores de Transact-SQL.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL

Sintaxis

-- Syntax for SQL Server, Azure SQL Database and serverless SQL pool in Azure Synapse Analytics

SET QUOTED_IDENTIFIER { ON | OFF }
-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse

SET QUOTED_IDENTIFIER ON

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.

Observaciones

Cuando SET QUOTED_IDENTIFIER es ON (valor predeterminado), los identificadores pueden delimitarse con comillas dobles (" ") y los literales deben delimitarse con comillas simples (' '). Todas las cadenas delimitadas por comillas dobles se interpretan como identificadores de objetos. Por ello, los identificadores entrecomillados no tienen que seguir las reglas para identificadores de Transact-SQL. Pueden ser palabras clave reservadas e incluir caracteres que normalmente no se admiten en los identificadores de Transact-SQL. No se pueden utilizar comillas dobles para delimitar expresiones de cadenas literales; para delimitar las cadenas literales se deberán utilizar comillas simples. Si una comilla simple (') forma parte de la cadena literal, se puede representar mediante dos comillas simples ("). SET QUOTED_IDENTIFIER debe ser ON cuando se usen palabras clave reservadas como nombres de objetos de la base de datos.

Cuando SET QUOTED_IDENTIFIER es OFF, los identificadores no pueden entrecomillarse y deben seguir todas las reglas para identificadores de Transact-SQL. Para obtener más información, vea Database Identifiers. Los literales se pueden delimitar con comillas simples o dobles. Si una cadena literal se delimita con comillas dobles, podrá contener comillas simples incrustadas, como, por ejemplo, apóstrofos.

Nota

QUOTED_IDENTIFIER no afecta a los identificadores delimitados entre corchetes ([ ]).

SET QUOTED_IDENTIFIER debe ser ON al crear o cambiar índices en columnas calculadas o vista indexadas. Si SET QUOTED_IDENTIFIER es OFF, las instrucciones CREATE, UPDATE, INSERT y DELETE provocarán errores en tablas con índices en columnas calculadas o en tablas con vistas indexadas. Para obtener más información sobre las configuraciones de la opción SET requeridas con vistas indexadas e índices en columnas calculadas, consulte Consideraciones al utilizar las instrucciones SET.

SET QUOTED_IDENTIFIER debe ser ON cuando se crea un índice filtrado.

SET QUOTED_IDENTIFIER debe ser ON cuando se invocan métodos del tipo de datos XML.

El controlador ODBC de SQL Server Native Client y el proveedor OLE DB de SQL Server Native Client para SQL Server establecen automáticamente QUOTED_IDENTIFIER en ON al conectarse. Esta opción se puede configurar en los orígenes de datos ODBC, en los atributos de conexión ODBC o en las propiedades de conexión OLE DB. El valor predeterminado de SET QUOTED_IDENTIFIER es OFF para las conexiones desde aplicaciones DB-Library.

Cuando se crea una tabla, la opción QUOTED IDENTIFIER siempre se almacena como ON en los metadatos de la tabla, aunque se haya establecido en OFF al crear la tabla.

Cuando se crea un procedimiento almacenado, los valores de SET QUOTED_IDENTIFIER y SET ANSI_NULLS se capturan y se utilizan en las siguientes llamadas a ese procedimiento almacenado.

Cuando se ejecuta dentro de un procedimiento almacenado, la opción SET QUOTED_IDENTIFIER no cambia.

Cuando SET ANSI_DEFAULTS es ON, QUOTED_IDENTIFIER también es ON.

SET QUOTED_IDENTIFIER también se corresponde con el valor QUOTED_IDENTIFIER de ALTER DATABASE.

SET QUOTED_IDENTIFIER tiene efecto en tiempo de análisis de Transact-SQL y solo afecta al análisis, no a la optimización ni a la ejecución de la consulta.

Para un lote ad hoc de nivel superior, el análisis empieza usando la opción actual de la sesión para QUOTED_IDENTIFIER. Mientras se analiza el lote, cualquier aparición de SET QUOTED_IDENTIFIER cambiará el comportamiento del análisis a partir de ese punto y guardará ese valor para la sesión. Después de analizarse y ejecutarse el lote, el valor QUOTED_IDENTIFER de la sesión se establecerá según la última aparición de SET QUOTED_IDENTIFIER en el lote.

El Transact-SQL estático en un procedimiento almacenado se analiza mediante el valor QUOTED_IDENTIFIER que esté en vigor para el lote que creó o modificó el procedimiento almacenado. SET QUOTED_IDENTIFIER no tiene ningún efecto cuando aparece en el cuerpo de un procedimiento almacenado como Transact-SQL estático.

Para un lote anidado mediante sp_executesql o exec(), el análisis empieza usando el valor QUOTED_IDENTIFIER de la sesión. Si el lote anidado está dentro de un procedimiento almacenado, el análisis empieza usando el valor QUOTED_IDENTIFIER del procedimiento almacenado. Mientras se analiza el lote anidado, cualquier aparición de SET QUOTED_IDENTIFIER cambiará el comportamiento del análisis a partir de ese punto, pero no se actualizará el valor QUOTED_IDENTIFIER de la sesión.

Para ver la configuración actual de este valor, ejecute la siguiente consulta:

DECLARE @QUOTED_IDENTIFIER VARCHAR(3) = 'OFF';
IF ( (256 & @@OPTIONS) = 256 ) 
BEGIN
    SET @QUOTED_IDENTIFIER = 'ON';
END

SELECT @QUOTED_IDENTIFIER AS QUOTED_IDENTIFIER;

Permisos

Requiere la pertenencia al rol PUBLIC.

Ejemplos

A. Utilizar la opción de identificador entre comillas y nombres de objeto con palabras reservadas

En este ejemplo se muestra que, para crear y utilizar objetos cuyos nombres contienen palabras clave reservadas, SET QUOTED_IDENTIFIER debe ser ON y las palabras clave reservadas de los nombres de tabla se deben indicar entre comillas dobles.

SET QUOTED_IDENTIFIER OFF
GO

-- Create statement fails.
CREATE TABLE "select" ("identity" INT IDENTITY NOT NULL, "order" INT NOT NULL);
GO

SET QUOTED_IDENTIFIER ON;
GO

-- Create statement succeeds.
CREATE TABLE "select" ("identity" INT IDENTITY NOT NULL, "order" INT NOT NULL);
GO

SELECT "identity","order"
FROM "select"
ORDER BY "order";
GO

DROP TABLE "SELECT";
GO

SET QUOTED_IDENTIFIER OFF;
GO

B. Utilizar la opción de identificador entre comillas simples y dobles

En este ejemplo se muestra el uso de las comillas simples y dobles en las expresiones de cadena con SET QUOTED_IDENTIFIER establecido en ON y OFF.

SET QUOTED_IDENTIFIER OFF;
GO

USE AdventureWorks2012;
IF EXISTS(SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES
    WHERE TABLE_NAME = 'Test')
    DROP TABLE dbo.Test;
GO
USE AdventureWorks2012;
CREATE TABLE dbo.Test (ID INT, String VARCHAR(30)) ;
GO

-- Literal strings can be in single or double quotation marks.
INSERT INTO dbo.Test VALUES (1, "'Text in single quotes'");
INSERT INTO dbo.Test VALUES (2, '''Text in single quotes''');
INSERT INTO dbo.Test VALUES (3, 'Text with 2 '''' single quotes');
INSERT INTO dbo.Test VALUES (4, '"Text in double quotes"');
INSERT INTO dbo.Test VALUES (5, """Text in double quotes""");
INSERT INTO dbo.Test VALUES (6, "Text with 2 """" double quotes");
GO

SET QUOTED_IDENTIFIER ON;
GO

-- Strings inside double quotation marks are now treated
-- as object names, so they cannot be used for literals.
INSERT INTO dbo."Test" VALUES (7, 'Text with a single '' quote');
GO

-- Object identifiers do not have to be in double quotation marks
-- if they are not reserved keywords.
SELECT ID, String
FROM dbo.Test;
GO

DROP TABLE dbo.Test;
GO

SET QUOTED_IDENTIFIER OFF;
GO

El conjunto de resultados es el siguiente:

 ID          String
 ----------- ------------------------------
 1           'Text in single quotes'
 2           'Text in single quotes'
 3           Text with 2 '' single quotes
 4           "Text in double quotes"
 5           "Text in double quotes"
 6           Text with 2 "" double quotes
 7           Text with a single ' quote

Consulte también

CREATE DATABASE
CREATE DEFAULT
CREATE PROCEDURE
CREATE RULE
CREATE TABLE
CREATE TRIGGER
CREATE VIEW
Tipos de datos
EXECUTE
SELECT
Instrucciones SET
SET ANSI_DEFAULTS
sp_rename
Identificadores de base de datos