Comments (sintaxe MDX)
Comentários são cadeias de caracteres de texto não executáveis em código de programa. Os comentários também são conhecidos como observações. Use comentários para documentar códigos ou desabilitar temporariamente partes de instruções de linguagem MDX e scripts que estão sendo diagnosticados. Com a utilização de comentários para documentar códigos, fica mais fácil fazer a manutenção de códigos posterior. Frequentemente, os comentários são utilizados para registrar o nome do programa, o nome do autor e as datas de alterações de código principais. Use também os comentários para descrever cálculos complexos ou explicar um método de programação.
Os comentários em MDX seguem estas diretrizes:
Todos os caracteres alfanuméricos ou símbolos podem ser usados com o comentário. Todos os caracteres dentro de um comentário são ignorados.
Não há um comprimento máximo para um comentário dentro de um script ou instrução. O comentário pode ser composto por uma ou mais linhas.
O MDX oferece suporte a três tipos de caracteres de comentário:
// (barras duplas)
Esses caracteres de comentário podem ser utilizados na mesma linha que o código a ser executado, ou em uma linha específica. Tudo que estiver a partir das barras duplas até o final da linha faz parte do comentário. Em um comentário de várias linhas, as barras duplas devem ser exibidas no início de cada linha de comentário. Para obter mais informações, consulte (Comentário) (MDX).
-- (hífens duplos)
Esses caracteres de comentário podem ser utilizados na mesma linha que o código a ser executado, ou em uma linha específica. Tudo que estiver a partir dos hífens duplos até o final da linha faz parte do comentário. Em um comentário de várias linhas, os hífens duplos devem ser exibidos no início de cada linha de comentário. Para obter mais informações, consulte -- (Comentário) (MDX).
/* ... */ (pares de caracteres de barra/asterisco)
Esses caracteres de comentário podem ser usados na mesma linha que o código a ser executado, em linhas por conta própria ou até mesmo dentro do código executável. Tudo que estiver a partir do par de abertura do comentário (/*) até o par de fechamento (*/) faz parte do comentário. Em um comentário de várias linhas, o par de caracteres de abertura (/*) deve iniciar o comentário e o par de caracteres de fechamento (*/) deve terminar o comentário. Nenhum outro caractere de comentário pode aparecer em nenhuma linha do comentário. Para obter mais informações, consulte /*...*/ (Comentário).
Exemplo
A consulta a seguir mostra exemplos dos três tipos de comentário:
//An example of a comment using the double-forward slash
--An example of a comment using the double-hypen
/*An example of a
multi-line
comment*/
SELECT
{[Measures].[Internet Sales Amount]} ON Columns,
[Date].[Calendar].MEMBERS ON Rows
FROM [Adventure Works]