Partilhar via


Comentários (DMX)

Aplica-se a: SQL Server Analysis Services

Comentários em DMX (Data Mining Extensions) são cadeias de caracteres de texto no código do 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 que estão em 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 por 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 gravar um comentário na mesma linha como código que deve ser executado, ou para gravar um comentário em uma linha por si próprio. O Analysis Services avalia tudo, desde as 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 caractere de comentário, consulte Barra dupla (comentário) (DMX).

  • -- (hífens duplos). Use esses caracteres de comentário para gravar um comentário na mesma linha como código que deve ser executado, ou para gravar um comentário em uma linha por si próprio. O Analysis Services avalia tudo, desde os 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) Resumo.

  • /* ... */ (pares de caracteres de barra-asterisco). Use esses caracteres de comentário para gravar um comentário na mesma linha como o código que deve ser executado, para gravar um comentário em uma linha por si próprio ou até mesmo para gravar comentários dentro do código executável. O Analysis Services avalia tudo, desde o par de comentários abertos (/*) até o par de comentários fechados (*/) como parte do comentário. Para criar um comentário de várias linhas, inicie o comentário com o par de caracteres de comentário aberto (/*) e termine o comentário com o par de caracteres de comentário fechado (*/). 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 Slash Star (Comment) (DMX).

Confira também

Referência de DMX (Data Mining Extensions)
Referência de função DMX (Data Mining Extensions)
Referência do operador DMX (Data Mining Extensions)
Referência de instrução DMX (Data Mining Extensions)
Convenções de sintaxe DMX (Data Mining Extensions)
Elementos de sintaxe DMX (Data Mining Extensions)
Funções de previsão gerais (DMX)
Estrutura e uso de consultas de previsão DMX
Compreendendo a instrução DMX Select