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

Aplica-se a:SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsEndpoint 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

Conteúdo relacionado

  • Last updated on