• 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.

Comentarios

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 AdventureWorks2008R2;
GO
/*
This section of the code joins the Person table with the Address table, 
by using the Employee and BusinessEntityAddress tables in the middle to 
get a list of all the employees in the AdventureWorks2008R2 database 
and their contact information.
*/
SELECT p.FirstName, p.LastName, a.AddressLine1, a.AddressLine2, a.City, a.PostalCode
FROM Person.Person AS p
JOIN HumanResources.Employee AS e ON p.BusinessEntityID = e.BusinessEntityID 
JOIN Person.BusinessEntityAddress AS ea ON e.BusinessEntityID = ea.BusinessEntityID
JOIN Person.Address AS a ON ea.AddressID = a.AddressID;
GO