Comentários (DMX)

Aplica-se a: SQL Server Analysis Services

Comentários nas Extensões de Mineração de Dados (DMX) são strings de texto em código de programa que o Microsoft SQL Server Analysis Services não executa. Os comentários também são conhecidos como observações. Pode usar comentários para documentar código ou para desativar temporariamente partes de uma instrução ou script DMX enquanto está a diagnosticar o código.

Usar comentários para documentar o código do seu programa facilita a manutenção do código no futuro. Pode usar comentários para registar detalhes como o nome do programa, o nome do programador que escreveu o código e as datas das principais alterações ao código. Também pode usar comentários para descrever cálculos complexos ou para um método de programação.

Seguem-se as orientações básicas para escrever comentários:

  • Pode usar quaisquer caracteres alfanuméricos ou símbolos dentro de um comentário. Os Serviços de Análise ignoram todos os caracteres que estão num comentário.

  • Não existe um comprimento máximo para um comentário dentro de uma declaração ou guião. Um comentário pode ser composto por uma ou mais linhas.

O Serviços de Análise suporta os seguintes tipos de caracteres de comentário:

  • (duplos cortes para a frente). Use estes caracteres de comentário para escrever um comentário na mesma linha que o código que vai ser executado, ou para escrever um comentário numa linha isolada. Os Serviços de Análise avaliam tudo, desde as barras duplas para a frente até ao fim da linha como parte do comentário. Para criar um comentário de várias linhas, use as barras duplas para a frente no início de cada linha de comentário. Para mais informações sobre esta personagem comentarista, veja Double Slash (Comentário) (DMX).

  • -- (hífens duplos). Use estes caracteres de comentário para escrever um comentário na mesma linha que o código que vai ser executado, ou para escrever um comentário numa linha isolada. Os Serviços de Análise avaliam tudo, desde os hífens duplos até ao fim da linha, como parte do comentário. Para criar um comentário com várias linhas, use os hífens duplos no início de cada linha de comentário. Para mais informações sobre esta personagem de comentário, veja -- (Comentário) (DMX) Resumo.

  • /* ... */ (par de caracteres com barra-asterisco para a frente). Use estes caracteres de comentário para escrever um comentário na mesma linha do código que será executado, para escrever um comentário numa linha isolada, ou até para escrever comentários dentro de código executável. O Analysis Services avalia tudo, desde o par de comentários aberto (/*) até ao par de comentários fechado (*/) 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 aberto (/*) e termine o comentário com o par de caracteres de comentário fechar (*/). Nenhuma outra personagem do comentário deve ser incluída em qualquer linha do comentário. Para mais informações sobre esta personagem comentadora, veja Slash Star (Comentário) (DMX).