Snedstrecksstjärna (blockkommentar) (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-analysslutpunkt i Microsoft FabricLager i Microsoft FabricSQL-databas i Förhandsversion av Microsoft Fabric

Anger text från användaren. Texten mellan /* och */ utvärderas inte av servern.

Transact-SQL syntaxkonventioner

Syntax

/*  
text_of_comment  
*/  

Arguments

text_of_comment
Är texten i kommentaren. Det här är en eller flera teckensträngar.

Remarks

Kommentarer kan infogas på en separat rad eller inom en Transact-SQL-instruktion. Kommentarer med flera rader måste anges med /* och */. En stilistisk konvention som ofta används för kommentarer med flera rader är att börja den första raden med /*, efterföljande rader med **, och avsluta med */.

Det finns ingen maximal längd för kommentarer.

Kapslade kommentarer stöds. Om teckenmönstret /* inträffar någonstans i en befintlig kommentar behandlas det som början på en kapslad kommentar och kräver därför ett avslutande */ kommentarsmärke. Om den avslutande kommentarsmarkeringen inte finns genereras ett fel.

Följande kod genererar till exempel ett fel.

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

Du kan undvika det här felet genom att göra följande ändring.

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

Examples

I följande exempel används kommentarer för att förklara vad avsnittet i koden ska göra.

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  

See Also

-- (Kommentar) (Transact-SQL)
Kontroll av flödesspråk (Transact-SQL)