Косая черта-звездочка (блочный комментарий) (Transact-SQL)

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Управляемый экземпляр SQL Azure Конечная точка аналитики аналитики Synapse Analytics Analytics (PDW)SQL Analyticsв Microsoft FabricХранилище в Microsoft Fabric

Обозначает текст комментария пользователя. Текст между /* сервером не */ вычисляется.

Соглашения о синтаксисе Transact-SQL

Синтаксис

/*  
text_of_comment  
*/

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

text_of_comment
Текст комментария. Это одна или более символьных строк.

Замечания

Комментарии могут вставляться в отдельную строку или в пределах инструкции Transact-SQL. Несколько строковый комментарий должны быть указаны в /* и */. Стилистическое соглашение часто используется для нескольких строковый комментарий, заключается в том, чтобы начать первую строку с /*, последующие строки с **, и заканчиваться */.

Длина комментариев не ограничена.

Поддерживаются вложенные комментарии. Если шаблон символов /* возникает в любом месте существующего комментария, он рассматривается как начало вложенного комментария и, следовательно, требует закрытия */примечание. Если метки, закрывающей комментарий, нет, выдается ошибка.

Например, следующий код вызовет ошибку:

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

Чтобы избежать этой ошибки, внесите следующее изменение:

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

Примеры

В приведенном ниже примере комментарии используются для пояснения действий, выполняемых блоком кода.

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

См. также

-- (комментарий) (Transact-SQL)
Язык управления потоком (Transact-SQL)