Slash Star (Bloquear comentário) (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

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

Transact-SQL convenções de sintaxe

Syntax

/*  
text_of_comment  
*/  

Arguments

text_of_comment
É o texto do comentário. Esta é uma ou mais cadeias de caracteres.

Remarks

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 estilística 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.

Comentários aninhados são suportados. Se o padrão de caractere /* ocorrer em qualquer lugar dentro de um comentário existente, ele será tratado como o início de um comentário aninhado e, portanto, exigirá 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 contornar esse erro, faça a seguinte alteração.

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

Examples

O exemplo a seguir usa comentários para explicar o que a seção do código deve 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  

Ver também

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