Поделиться через

  • Статья

/*...*/ (комментарий) (Transact-SQL)

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

Значок ссылки на разделСоглашения о синтаксисе в Transact-SQL

Синтаксис

/*
text_of_comment
*/

Аргументы

  • 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 AdventureWorks;
GO
/*
This section of the code joins the 
Contact table with the Address table, by using the Employee table in the middle 
to get a list of all the employees in the AdventureWorks database and their 
contact information.
*/
SELECT c.FirstName, c.LastName, a.AddressLine1, a.AddressLine2, a.City
FROM Person.Contact c 
JOIN HumanResources.Employee e ON c.ContactID = e.ContactID 
JOIN HumanResources.EmployeeAddress ea ON e.EmployeeID = ea.EmployeeID
JOIN Person.Address a ON ea.AddressID = a.AddressID;
GO