• Artigo

/*...*/ (Comentário) (Transact-SQL)

Indica texto fornecido pelo usuário. O texto entre /* e */ não é avaliado pelo servidor.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

/*
text_of_comment
*/

Argumentos

  • text_of_comment
    É o texto do comentário. É composto de uma ou mais cadeias de caracteres.

Comentários

Os comentários podem ser inseridos em uma linha separada ou dentro de uma instrução Transact-SQL. Os comentários de várias linhas devem ser indicados por /* e */. Uma convenção de estilo frequentemente usada para comentários de várias linhas é começar a primeira linha com /*, as linhas subsequentes com ** e terminar com */.

Não há comprimento máximo para comentários.

É oferecido suporte a comentários aninhados. Se o padrão de caracteres /* ocorrer em qualquer lugar dentro de um comentário existente, ele será tratado como o início de um comentário aninhado e, portanto, requer uma marca de comentário */ de fechamento. Se a marca de comentário de fechamento não existir, um erro será gerado.

Por exemplo, o código a seguir gera um erro.

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

Para solucionar esse erro, faça a seguinte alteração.

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

Exemplos

O exemplo a seguir usa comentários para explicar o que a seção do código é suposta a fazer.

USE AdventureWorks2008R2;
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 AdventureWorks2008R2 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