Convenciones de sintaxis de Transact-SQL (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

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.
| (barra vertical) Separa los elementos de sintaxis escritos entre corchetes o llaves. Solo puede utilizar uno de los elementos.
[ ] (corchetes) Elemento opcional de sintaxis.
{} (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 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.
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 que se podría usar el bloque de sintaxis se indica con la etiqueta situada entre comillas angulares: <label>.

Un conjunto es una colección de expresiones, por ejemplo <conjunto de agrupación>; una lista es una colección de conjuntos, por ejemplo, <lista de elementos compuestos>.

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.

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_name.database_name.schema_name.object_name Nombre de cuatro partes.
server_name.database_name..object_name Se omite el nombre del esquema.
server_name..schema_name.object_name Se omite el nombre de la base de datos.
server_name...object_name Se omiten los nombres de la base de datos y el esquema.
database_name.schema_name.object_name Se omite el nombre del servidor.
database_name..object_name Se omiten los nombres del servidor y el esquema.
schema_name.object_name Se omiten los nombres del servidor y la base de datos.
object_name 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"

Los artículos de referencia de Transact-SQL se refieren a varias versiones de SQL Server a partir de SQL Server 2008 (10.0.x), así como Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics y Analytics Platform System (PDW).

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.

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