Comentários (DMX)

Os comentários DMX (Data Mining Extensões) são cadeias de caracteres de texto em código de programa que o Microsoft SQL Server Analysis Services não executa. Os comentários são também conhecidos como comentários. Os comentários são usados para documentar código ou para desabilitar temporariamente partes de um script ou instrução DMX durante o diagnóstico de um código.

Usar comentários para documentar código de programa facilita a manutenção do código no futuro. Use comentários para registrar detalhes, como o nome do programa, nome do desenvolvedor que escreveu o código e as datas de alterações significativas do código. Use igualmente os comentários para descrever cálculos complexos ou para explicar um método de programação.

A seguir, as diretrizes básicas para escrever comentários:

• É possível usar todos os caracteres alfanuméricos ou símbolos em um comentário. O Analysis Services ignora todos os caracteres constantes de um comentário.

• Não há um comprimento máximo para um comentário dentro de um script ou instrução. O comentário pode ser composto de uma ou mais linhas.

O Analysis Services oferece suporte aos seguintes tipos de caracteres de comentário:

• // (barras duplas). Use esses caracteres de comentário para escrever um comentário na mesma linha, como código a ser executado, ou para escrever um comentário em uma linha distinta. O Analysis Services avalia tudo, das barras duplas até o final da linha, como parte do comentário. Para criar um comentário de várias linhas, use as barras duplas no início de cada linha de comentário. Para obter mais informações sobre esse comentário, consulte // (Comentário) (DMX).

• -- (hífens duplos). Use esses caracteres de comentário para escrever um comentário na mesma linha, como código a ser executado, ou para escrever um comentário em uma linha distinta. O Analysis Services avalia tudo, dos hífens duplos até o final da linha, como parte do comentário. Para criar um comentário de várias linhas, use os hífens duplos no início de cada linha de comentário. Para obter mais informações sobre esse caractere de comentário, consulte -- (Comentário) (DMX).

• /* ... */ (pares de caracteres de barra e asterisco). Use esses caracteres de comentário para escrever um comentário na mesma linha, como código a ser executado, para escrever um comentário em uma linha distinta, ou ainda para escrever comentários no código executável. O Analysis Services avalia tudo, desde o par de comentário de abertura (/*) até o par de comentário de fechamento (*/), como parte do comentário. Para criar um comentário de várias linhas, comece o comentário com o par de caracteres de comentário de abertura (/*) e encerre o comentário com o par de caracteres de comentário de fechamento (*/). Nenhum outro caractere de comentário deve ser incluído em qualquer linha do comentário. Para obter mais informações sobre esse caractere de comentário, consulte /*...*/ (Comentário) (DMX).