Slash-ster (blokcommentaar) (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-eindpunt in Microsoft FabricMagazijn in Microsoft FabricSQL-database in Microsoft Fabric Preview

Geeft de door de gebruiker verstrekte tekst aan. De tekst tussen de /* en */ wordt niet geëvalueerd door de server.

Transact-SQL syntaxis-conventies

Syntax

/*  
text_of_comment  
*/  

Arguments

text_of_comment
Is de tekst van de opmerking. Dit zijn een of meer tekenreeksen.

Remarks

Opmerkingen kunnen worden ingevoegd op een afzonderlijke regel of binnen een Transact-SQL instructie. Opmerkingen met meerdere regels moeten worden aangegeven door /* en */. Een stijlconventie die vaak wordt gebruikt voor opmerkingen met meerdere regels, is om de eerste regel te beginnen met /*, volgende regels met **en eindigen met */.

Er is geen maximale lengte voor opmerkingen.

Geneste opmerkingen worden ondersteund. Als het /* tekenpatroon zich ergens in een bestaande opmerking voordoet, wordt het beschouwd als het begin van een geneste opmerking en is daarom een afsluitende */ opmerkingsmarkering vereist. Als de opmerkingsmarkering sluiten niet bestaat, wordt er een fout gegenereerd.

Met de volgende code wordt bijvoorbeeld een fout gegenereerd.

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

Als u deze fout wilt omzeilen, moet u de volgende wijziging aanbrengen.

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

Examples

In het volgende voorbeeld worden opmerkingen gebruikt om uit te leggen wat de sectie van de code moet doen.

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

-- (Opmerking) (Transact-SQL)
Control-of-Flow Language (Transact-SQL)