Barra diagonal y asterisco (comentario de bloque) (Transact-SQL)
Se aplica a: punto de conexión de SQL Server
Azure SQL Database
Azure SQL Instancia administrada
punto de conexión de SQL Analytics Analytics Platform System (PDW) de SQL Analytics
System (PDW)
de SQL Server en Microsoft Fabric
Warehouse 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
*/
Nota:
Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.
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)
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios