Compartir a través de

  • Artículo

/*...*/ (comentario de Transact-SQL)

Indica texto proporcionado por el usuario. El servidor no evalúa el texto situado entre /* y */.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

/*
text_of_comment
*/

Argumentos

  • text_of_comment
    Es el texto del comentario. Es una o más cadenas de caracteres.

Notas

Los comentarios se pueden insertar en una línea aparte o dentro de una instrucción Transact-SQL. Los comentarios con varias líneas deben indicarse con /* y */. Una regla de estilo que se utiliza a menudo para los comentarios de varias líneas es comenzar la primera línea con /*, las siguientes con ** y finalizar con */.

No hay límite de longitud para los comentarios.

Se admiten comentarios anidados. Si el patrón de carácter /* aparece en algún lugar de un comentario existente, se trata como el comienzo de un comentario anidado y, por tanto, requiere una marca de comentario de cierre */. Si no existe esta marca de comentario de cierre, se genera un error.

Por ejemplo, el código siguiente genera un error.

DECLARE @comment AS varchar(20);
GO
/*
SELECT @comment = '/*';
*/ 
SELECT @@VERSION;
GO

Para solucionar este error, realice el cambio siguiente.

DECLARE @comment AS varchar(20);
GO
/*
SELECT @comment = '/*';
*/ */
SELECT @@VERSION;
GO

Ejemplos

En el ejemplo siguiente se utilizan comentarios para explicar la finalidad de la sección del código.

USE AdventureWorks;
GO
/*
This section of the code joins the 
Contact table with the Address table, by using the Employee table in the middle 
to get a list of all the employees in the AdventureWorks database and their 
contact information.
*/
SELECT c.FirstName, c.LastName, a.AddressLine1, a.AddressLine2, a.City
FROM Person.Contact c 
JOIN HumanResources.Employee e ON c.ContactID = e.ContactID 
JOIN HumanResources.EmployeeAddress ea ON e.EmployeeID = ea.EmployeeID
JOIN Person.Address a ON ea.AddressID = a.AddressID;
GO