Commentaires (DMX)

Dans le langage DMX (Data Mining Extensions), les commentaires sont des chaînes de texte en code programme que Microsoft SQL Server Analysis Services n'exécute pas. Les commentaires sont également appelés remarques. Vous pouvez utiliser les commentaires pour documenter du code ou pour désactiver temporairement les composants d'une instruction ou d'un script DMX lorsque vous analysez le code.

L'utilisation des commentaires pour documenter votre code programme facilitera la gestion du code. En effet, les commentaires permettent d'enregistrer des détails tels que le nom du programme, le nom du développeur qui a écrit le code, et les dates des principales modifications du code. Vous pouvez également aussi les utiliser pour décrire des calculs complexes ou pour commenter une méthode de programmation.

Voici les règles de bases de l'écriture des commentaires :

• Vous pouvez utiliser tous les caractères ou symboles alphanumériques dans un commentaire. Analysis Services ignore tous les caractères figurant au sein d'un commentaire.

• La longueur d'un commentaire au sein d'une instruction ou d'un script n'est pas limitée. Un commentaire peut être composé d'une ou plusieurs lignes.

Analysis Services prend en charge les types de caractères de commentaire suivants :

• // (doubles barres obliques). Ces caractères de commentaire permettent d'écrire un commentaire sur la même ligne que le code à exécuter, ou d'écrire un commentaire sur une ligne séparée. Analysis Services considère tout ce qui est situé à partir des doubles barres obliques jusqu'à la fin de la ligne comme étant le commentaire. Pour créer un commentaire sur plusieurs lignes, utilisez les doubles barres obliques au début de chaque ligne de commentaire. Pour plus d'informations sur ce caractère de commentaire, consultez // (Commentaire) (DMX).

• -- (double trait d'union). Ces caractères de commentaire permettent d'écrire un commentaire sur la même ligne que le code à exécuter, ou d'écrire un commentaire sur une ligne séparée. Analysis Services considère tout ce qui est situé à partir du double trait d'union jusqu'à la fin de la ligne comme étant le commentaire. Pour créer un commentaire sur plusieurs lignes, utilisez le double trait d'union au début de chaque ligne de commentaire. Pour plus d'informations sur ce caractère de commentaire, consultez -- (Commentaire) (DMX).

• /* ... */ (paires de caractères barre oblique-astérisque). Ces caractères de commentaire permettent d'écrire un commentaire sur la même ligne que le code à exécuter, ou d'écrire un commentaire sur une ligne séparée. Analysis Services considère tout ce qui est situé à partir de la paire de caractères barre oblique-astérisque ouverte jusqu'à la paire de caractères barre oblique-astérisque fermée comme étant le commentaire. Pour créer un commentaire de plusieurs lignes, commencez le commentaire par la paire de caractères ouverte (/*) et fermez le commentaire par la paire de caractères fermée (*/). Aucun autre caractère de commentaire ne doit être inclus dans les lignes de commentaire. Pour plus d'informations sur ce caractère de commentaire, consultez /*...*/ (Commentaire) (DMX).