/*...*/ (Comentário) (Transact-SQL)
Indica texto fornecido pelo usuário. O texto entre /* e */ não é avaliado pelo servidor.
.gif "Ícone de vínculo de tópico")
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
Consulte também