— (комментарий) (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.
Синтаксис использования символов — (два тире)
Синтаксис для создания комментария в SQL с использованием символов — .
— здесь пишется комментарий
Комментарий, начинающийся с символов — , должен находиться в конце строки в вашем операторе SQL с разрывом строки после него. Этот метод комментирования может занимать только одну строку в вашем SQL и должен находиться в конце строки.
Синтаксис использования символов /* и */
Синтаксис для создания комментария в SQL с использованием символов /* и */ .
/* здесь пишется комментарий */
Комментарий, который начинается с символа /* и заканчивается */ и может находиться в любом месте вашего SQL оператора. Этот метод комментирования может занимать несколько строк в вашем SQL.
Пример комментария в одной строку
Рассмотрим пример комментария в SQL, который находится на одной строке.
Например.
Вот комментарий, который появляется в SQL в отдельной строке.
SQL — Однострочные и многострочные комментарии
Комментарии используются для пояснения разделов операторов SQL или для предотвращения выполнения операторов во время отладки запросов.
Однострочные комментарии
Однострочные комментарии начинаются со знака — . Любой текст между — и концом строки будет проигнорирован (не будет выполнен).
В следующем примере в качестве объяснения используется однострочный комментарий:
Пример:
--Select all: SELECT * FROM users;В следующем примере используется однострочный комментарий для игнорирования конца строки:
Пример:
SELECT * FROM users -- WHERE balance = 1000;В следующем примере используется однострочный комментарий для игнорирования оператора:
Пример:
--SELECT * FROM users SELECT * FROM users;Многострочные комментарии
Многострочные комментарии начинаются с / * и заканчиваются на * /. Любой текст между / * и * / будет проигнорирован. В следующем примере в качестве объяснения используется многострочный комментарий:
Пример:
/* Этот запрос выведет данные всех пользователей */ SELECT * FROM users;В следующем примере используется многострочный комментарий для игнорирования многих операторов:
Пример:
/*SELECT * FROM users; SELECT * FROM product; SELECT * FROM invoice;*/ SELECT * FROM category;