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

  • Artículo

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento 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 o UPPERCASE 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.
<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: <etiqueta>.

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.

Tipos de datos

Cuando se usa en línea en un artículo, los tipos de datos se representan en minúsculas y en negrita. Por ejemplo, int, varchar(255)y bit.

Cuando se usa en bloques de código transact-SQL, los tipos de datos se representan en mayúsculas. Por ejemplo:

DECLARE @int_example AS INT;
DECLARE @varchar_example AS VARCHAR(255);
DECLARE @bit_example AS BIT;

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 probaron en servidores que ejecutan un criterio de ordenación que distingue mayúsculas de 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. Es posible que esta página de códigos predeterminada no reconozca 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).

Una sección cerca de la parte superior de cada artículo indica qué productos admiten 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 CREATE USER instrucción en cualquier producto de SQL Server; sin embargo, la WITH PASSWORD sintaxis no se puede usar con versiones anteriores. Extra Se aplica a las secciones se insertan en las descripciones de argumentos adecuadas en el cuerpo del artículo.

Contenido relacionado