Barra estrela (comentário de bloco) (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric

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

Convenções de sintaxe de Transact-SQL

Sintaxe

/*  
text_of_comment  
*/

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

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 precisam 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 AdventureWorks2022;  
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 AdventureWorks2022 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

-- (Comentário) (Transact-SQL)
Linguagem de controle de fluxo (Transact-SQL)