Convenciones de sintaxis de Transact-SQL (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

En la siguiente tabla se incluyen y describen las convenciones utilizadas en los diagramas de sintaxis de la referencia de Transact-SQL.

Convención Se usa para
MAYÚSCULAS Palabras clave de Transact-SQL.
cursiva Parámetros proporcionados por el usuario para la sintaxis de Transact-SQL.
Negrita Escriba los nombres de bases de datos, tablas, columnas e índices, procedimientos almacenados, utilidades, nombres de tipos de datos y texto exactamente como se muestra.
subrayado Indica el valor predeterminado que se aplica cuando la cláusula que contiene el valor subrayado se omite en la instrucción.
| (barra vertical) Separa los elementos de sintaxis escritos entre corchetes o llaves. Solo puede utilizar uno de los elementos.
[ ] (corchetes) Elementos opcionales de sintaxis. No escriba los corchetes.
{} (llaves) Elementos obligatorios de sintaxis. No escriba las llaves.
[ ,n] Indica que el elemento anterior puede repetirse n veces. Los elementos se separan por comas.
[...n] Indica que el elemento anterior puede repetirse n veces. Cada repetición se separa del siguiente con un espacio en blanco.
; Terminador de instrucción de Transact-SQL. Aunque el punto y coma no es necesario en la mayoría de las instrucciones de esta versión de SQL Server, se exigirá en una versión futura.
<label> ::= Nombre de un bloque de sintaxis. Use esta convención para agrupar y etiquetar secciones de sintaxis extensas o una unidad de sintaxis que puede usar en varias ubicaciones dentro de una instrucción. Cada ubicación en la que se podría usar el bloque de sintaxis se indica con la etiqueta entre comillas angulares: <label>.

Un conjunto es una colección de expresiones, por ejemplo, <grouping set>; una lista es una colección de conjuntos, por ejemplo, <composite element list>.

Nombres de varias partes

A menos que se especifique lo contrario, todas las referencias de Transact-SQL al nombre de un objeto de base de datos pueden ser un nombre de cuatro partes con el formato siguiente:

server_name.[database_name].[schema_name].object_name

| database_name.[schema_name].object_name

| schema_name.object_name

| object_name

server_name
Especifica un nombre de servidor vinculado o un nombre de servidor remoto.

database_name
Especifica el nombre de una base de datos de SQL Server si el objeto reside en una instancia local de SQL Server. Cuando el objeto está en un servidor vinculado, database_name especifica un catálogo de OLE DB.

schema_name
Especifica el nombre del esquema que contiene el objeto si dicho objeto se encuentra en una base de datos de SQL Server. Si el objeto se encuentra en un servidor vinculado, schema_name especifica un nombre de esquema OLE DB.

object_name
Hace referencia al nombre del objeto.

Cuando se hace referencia a un objeto específico, no siempre hay que especificar el servidor, la base de datos y el esquema del Motor de base de datos de SQL Server para identificar el objeto. No obstante, si no se encuentra el objeto, se muestra un error.

Nota

Para evitar los errores de resolución de nombres, se recomienda especificar el nombre de esquema siempre que se especifique un objeto del ámbito del esquema.

Para omitir los nodos intermedios, utilice puntos para indicar estas posiciones. En la siguiente tabla se muestran los formatos válidos para los nombres de objetos.

Formato de referencia a objetos Descripción
server.database.schema.object Nombre de cuatro partes.
server.database..object Se omite el nombre del esquema.
server..schema.object Se omite el nombre de la base de datos.
server...object Se omiten los nombres de la base de datos y el esquema.
database.schema.object Se omite el nombre del servidor.
database..object Se omiten los nombres del servidor y el esquema.
schema.object Se omiten los nombres del servidor y la base de datos.
object Se omiten los nombres del servidor, la base de datos y el esquema.

Convenciones de los ejemplos de código

A menos que se indique lo contrario, los ejemplos proporcionados en la referencia de Transact-SQL se han probado con SQL Server Management Studio y los valores predeterminados para las siguientes opciones:

  • ANSI_NULLS
  • ANSI_NULL_DFLT_ON
  • ANSI_PADDING
  • ANSI_WARNINGS
  • CONCAT_NULL_YIELDS_NULL
  • QUOTED_IDENTIFIER

La mayoría de los ejemplos de código de la referencia de Transact-SQL se han comprobado en servidores que se ejecutan en un orden que distingue entre mayúsculas y minúsculas. Normalmente, los servidores de prueba ejecutaban la página de códigos ANSI/ISO 1252.

Muchos ejemplos de código agregan como prefijo a las constantes de cadenas de caracteres Unicode la letra N. Sin el prefijo N, la cadena se convierte a la página de códigos predeterminada de la base de datos. Esta página de códigos predeterminada puede no reconocer determinados caracteres.

Referencias de "Se aplica a"

La referencia de Transact-SQL incluye temas relacionados con SQL Server (SQL Server 2008 y versiones posteriores), Azure SQL Database y Azure Synapse Analytics.

Hay una sección en la parte superior de cada artículo que indica qué productos son compatibles con el tema del artículo. Si se omite un producto, la característica descrita en el artículo no estará disponible en ese producto. Por ejemplo, los grupos de disponibilidad se introdujeron en SQL Server 2012 (11.x). En el artículo CREATE AVAILABILITY GROUP se indica que se aplica a SQL Server (SQL Server 2012 (11.x) y versiones posteriores) porque no se aplica a SQL Server 2008, SQL Server 2008 R2 o Azure SQL Database.

Se puede usar el tema general del artículo en un producto, pero no se admiten todos los argumentos en algunos casos. Por ejemplo, los usuarios de bases de datos independientes se introdujeron en SQL Server 2012 (11.x). Use la instrucción CREATE USER en cualquier producto de SQL Server; en cambio, la sintaxis WITH PASSWORD no se puede usar con versiones anteriores. Las secciones Se aplica a adicionales se insertan en las descripciones del argumento correspondiente en el cuerpo del artículo.

Consulte también

Referencia de Transact-SQL (motor de base de datos)
Palabras clave reservadas (Transact-SQL)
Problemas de diseño de Transact-SQL
Problemas de nomenclatura de Transact-SQL
Problemas de rendimiento de Transact-SQL