Compartir a través de

Barra diagonal y asterisco (comentario de bloque) (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

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

Convenciones 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 AdventureWorks2022;  
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 AdventureWorks2022 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

Vea también

-- (Comentarios) (Transact-SQL)
Lenguaje de control de flujo (Transact-SQL)