— (комментарий) (Transact-SQL)
Обозначает текст комментария пользователя. Комментарии можно вставить в отдельную строку, вложенную в конец командной строки Transact-SQL или в инструкции Transact-SQL. Сервер не обрабатывает комментарий.
Синтаксис
-- text_of_comment Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.
Аргументы
text_of_comment
Строка, содержащая текст комментария.
Замечания
Используйте два дефиса (—) для однострочных или вложенных комментариев. Комментарии, вставляемые с использованием символов —, завершаются новой строкой, которая задается символом возврата каретки (U+000A), символом перевода строки (U+000D) или сочетанием этих двух символов. Длина комментариев не ограничена. В следующей таблице перечислены сочетания клавиш, используемые для комментирования и раскомментирования текста.
| Действие | Standard |
|---|---|
| Преобразование выделенного текста в комментарий | CTRL + K, CTRL + C |
| Снять комментарий с выделенного текста | CTRL + K, CTRL + U |
Дополнительные сведения о сочетаниях клавиш см. в статье Сочетания клавиш среды SQL Server Management Studio.
Примеры
В следующем примере используются символы комментария —.
-- Choose the AdventureWorks2022 database. USE AdventureWorks2022; GO -- Choose all columns and all rows from the Address table. SELECT * FROM Person.Address ORDER BY PostalCode ASC; -- We do not have to specify ASC because -- that is the default. GO Комментарии в SQL
Примечание:
Во всех статьях текущей категории уроков по SQL используются примеры и задачи, основанные на учебной базе данных.
Приступая к изучению данного материала, рекомендуется ознакомиться с описанием учебной БД.
Когда пользователь работает с большим количеством запросов или пишет их для третьих лиц, либо запросы имеют достаточно сложную логику, то в SQL-коде желательно использовать комментарии, вставляя их непосредственно в запрос.
Комментарии могут быть двух типов: однострочные и многострочные. В зависимости от типа применяется различный синтаксис. Однострочные начинаются с сочетания двух тире (—) и продолжаются до конца строки. Многострочные комментарии начинаются с сочетания символов слеша и звездочки (/*) и заканчиваются ими же, но в другой последовательности (*/).
-- Пример однострочного комментария /* Комментарий на несколько строк */ /* Многострочный комментарий в одну строку */
Синтаксис комментариев зависит от системы, к которой выполняется запрос. Приведенные выше примеры подходят для систем MS SQL Server и Oracle, являющимися самыми распространенными.
Найдите комментарии в следующем SQL-коде и выполните его на учебной базе данных:
USE CallCenter -- Переключение контекста базы данных /* Вывод количества обработанных звонков по дням для каждого сотрудника */ SELECT CAST(З.Дата_Время AS DATE) AS Дата, Фамилия + ' ' + LEFT(Имя, 1) + '.' + ISNULL(' ' + LEFT(Отчество, 1) + '.', '')/* Объединение ФИО */ AS Сотрудник, COUNT(З.Линия) AS [Кол-во звонков] FROM Звонки AS З, Сотрудники AS С WHERE З.Сотрудник = С.id GROUP BY Фамилия, Имя, Отчество, CAST(З.Дата_Время AS DATE)
- Объединение таблиц – UNION
- Соединение таблиц – операция JOIN и ее виды
- Тест на знание основ SQL
Если материалы office-menu.ru Вам помогли, то поддержите, пожалуйста, проект, чтобы я мог развивать его дальше.
�� Как закомментировать в SQL: простой способ для начинающих
Добро пожаловать в мир SQL! Сегодня мы разберемся, как комментировать код в SQL. Закомментированный код является очень важным инструментом для организации кода и легкого чтения. Он также помогает объяснить, что делает определенный кусок кода. В SQL есть несколько способов закомментировать код, которые мы рассмотрим ниже.
Однострочные комментарии
Простейшим и наиболее распространенным способом комментирования кода является использование однострочных комментариев. Они начинаются с символов двойного тире (—) и продолжаются до конца строки.
-- Это однострочный комментарий в SQL SELECT * FROM users; -- Запрос для выборки всех пользователей
Многострочные комментарии
Иногда однострочных комментариев может быть недостаточно, и вам потребуется возможность комментировать несколько строк кода. В SQL можно использовать многострочные комментарии, которые начинаются с символов /* и заканчиваются символами */.
/* Это многострочный комментарий в SQL. SELECT * FROM users; Запрос для выборки всех пользователей */
Комментарии для описания структуры таблиц
Кроме того, комментарии в SQL могут использоваться для описания структуры таблиц. Они помогают вам и вашей команде лучше понять смысл и цель каждого столбца в таблице.
CREATE TABLE users ( id INT COMMENT 'Уникальный идентификатор пользователя', name VARCHAR(50) COMMENT 'Имя пользователя', email VARCHAR(100) COMMENT 'Электронная почта пользователя' );
Комментарии для хранимых процедур и функций
В SQL также можно комментировать хранимые процедуры и функции, чтобы описать их функциональность и использование.
-- Комментарий для хранимой процедуры CREATE PROCEDURE get_users() BEGIN -- Комментарий для выборки всех пользователей SELECT * FROM users; END; -- Комментарий для хранимой функции CREATE FUNCTION get_user_count() RETURNS INT BEGIN -- Комментарий для подсчета количества пользователей RETURN (SELECT COUNT(*) FROM users); END;
Заключение
В этой статье мы рассмотрели различные способы комментирования кода в SQL. Однострочные комментарии, многострочные комментарии, комментарии для описания структуры таблиц и комментарии для хранимых процедур и функций — все эти инструменты позволяют нам создавать более читаемый и понятный код. Закомментированный код является неотъемлемой частью разработки ПО, поэтому помните использовать комментарии в своих проектах, чтобы облегчить поддержку кода и сделать его более доступным для других разработчиков. Удачи в программировании!
Косая черта-звездочка (блочный комментарий) (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