• Artikel

Kommentar

Kommentare sind nicht auszuführende Textzeichenfolgen im Programmcode, auch Hinweise genannt. Kommentare können verwendet werden, um Code zu dokumentieren oder um Teile von Transact-SQL-Anweisungen und Batches, für die eine Fehlerdiagnose durchgeführt wird, vorübergehend zu deaktivieren. Beim Verwenden von Kommentaren zum Dokumentieren von Code wird die künftige Wartung des Programmcodes vereinfacht. Kommentare werden häufig zum Aufzeichnen des Programmnamens, des Verfassernamens sowie der Datumsangaben wichtiger Codeänderungen verwendet. Darüber hinaus können Kommentare zum Beschreiben komplexer Berechnungen oder zum Erklären einer Programmiermethode verwendet werden.

SQL Server unterstützt zwei Arten von Kommentarzeichen:

  • -- (doppelte Bindestriche). Diese Kommentarzeichen können in derselben Zeile wie der auszuführende Code oder in einer gesonderten Zeile verwendet werden. Der gesamte Text zwischen den doppelten Bindestrichen und dem Ende der Zeile ist Teil des Kommentars. Bei einem Kommentar, der mehrere Zeilen umfasst, müssen die doppelten Bindestriche vor jede Kommentarzeile gesetzt werden. Weitere Informationen zum Verwenden der Kommentarzeichen finden Sie unter -- (Kommentar) (Transact-SQL).

  • /* ... */ (Schrägstrich/Sternchen-Zeichenpaare). Diese Kommentarzeichen können in derselben Zeile wie der auszuführende Code, in gesonderten Zeilen oder auch innerhalb des ausführbaren Codes verwendet werden. Der gesamte Text zwischen dem öffnenden Kommentarzeichen (/*) und dem schließenden Kommentarzeichen (*/) wird als Teil des Kommentars interpretiert. Bei einem Kommentar, der mehrere Zeilen umfasst, muss der Kommentar mit dem öffnenden Kommentarzeichen (/*) beginnen und mit dem schließenden Kommentarzeichen (*/) enden. Weitere Informationen zum Verwenden der Kommentarzeichen /* ... */ finden Sie unter /*...*/ (Kommentar) (Transact-SQL).

Weitere Überlegungen

Es folgen einige grundlegende Informationen zu Kommentaren:

  • Alle alphanumerischen Zeichen oder Symbole können innerhalb von Kommentaren verwendet werden. In SQL Server werden alle Zeichen in einem Kommentar ignoriert, obwohl der SQL Server Management Studio Code-Editor und sqlcmd in einem mehrzeiligen Kommentar nach Zeilen suchen, die mit GO beginnen.

  • Es gibt keine Längenbeschränkung für einen Kommentar innerhalb eines Batches. Ein Kommentar kann eine oder mehrere Zeilen enthalten.

Beispiele

Nachfolgend finden Sie einige Beispiele für gültige Kommentare.

USE AdventureWorks;
GO
-- Single line comment.

SELECT EmployeeID, Title
FROM HumanResources.Employee;
GO

/* First line of a multiple-line comment.
   Second line of a multiple-line comment. */
SELECT Name, ProductNumber, Color
FROM Production.Product;
GO

-- Using a comment in a Transact-SQL statement
-- during diagnosis.
SELECT ContactID, /* FirstName, */ LastName
FROM Person.Contact;

-- Using a comment after the code on a line.
USE AdventureWorks;
GO
UPDATE Production.Product
SET ListPrice = ListPrice * .9; -- Reduce price to build market share.
GO