Partilhar via

  • 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 freqüentemente usada para comentários de várias linhas é começar a primeira linha com /*, as linhas subseqüentes 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 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