Lomítko hvězdička (blokový komentář) (Transact-SQL)

Platí pro:SQL ServerAzure SQL DatabaseSpravovaná instance Azure SQLAzure Synapse AnalyticsAnalytics Platform System (PDW)Koncový bod analýzy SQL v Microsoft FabricSklad v Microsoft FabricDatabáze SQL v Microsoft Fabric

Označuje text zadaný uživatelem. Text mezi /* serverem a */ není vyhodnocen.

Transact-SQL konvence syntaxe

Syntax

/*  
text_of_comment  
*/  

Arguments

text_of_comment
Je text komentáře. Jedná se o jeden nebo více řetězců znaků.

Remarks

Komentáře lze vložit na samostatný řádek nebo do Transact-SQL příkazu. Víceřádkové komentáře musí být označené znakem /* a */. Stylistické konvence, které se často používají pro víceřádkové komentáře, je začátek prvního řádku na /*, následné řádky s ** a končí */.

Komentáře nemají maximální délku.

Podporují se vnořené komentáře. Pokud se vzor znaku /* vyskytuje kdekoli v existujícím komentáři, považuje se za začátek vnořeného komentáře, a proto vyžaduje pravou značku */komentář. Pokud uzavírací značka komentáře neexistuje, vygeneruje se chyba.

Například následující kód vygeneruje chybu.

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

Pokud chcete tuto chybu obejít, proveďte následující změnu.

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

Examples

Následující příklad používá komentáře k vysvětlení toho, co má část kódu dělat.

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  

Viz také

-- (komentář) (Transact-SQL)
Jazyk řízení toku (Transact-SQL)