Comentarios (sintaxis de MDX)
Los comentarios son cadenas de texto no ejecutables en código de programa. (Los comentarios también se denominan observaciones). Los comentarios permiten documentar el código o deshabilitar temporalmente partes de las instrucciones de expresiones multidimensionales (MDX) o los scripts que se estén diagnosticando. La utilización de comentarios para documentar código facilita el mantenimiento futuro del código del programa. Con frecuencia, los comentarios se usan para registrar el nombre de un programa, el nombre del autor y las fechas de los cambios importantes del código. También se pueden usar para describir cálculos complicados o explicar un método de programación.
Los comentarios MDX deben seguir las siguientes directrices:
En los comentarios se pueden usar todos los caracteres o símbolos alfanuméricos. Microsoft SQL Server Analysis Services pasa por alto todos los caracteres de un comentario.
No hay longitud máxima para un comentario dentro de una instrucción o script. Un comentario puede estar formado por una o varias líneas.
MDX admite tres tipos de caracteres para indicar comentarios:
// (barras diagonales dobles)
Estos caracteres de comentarios se pueden usar en la misma línea que el código que se va a ejecutar o en una línea aparte. Todo lo que se encuentre entre las barras diagonales dobles y el final de la línea es parte del comentario. En el caso de que un comentario ocupe varias líneas, las barras diagonales dobles deben aparecer al inicio de cada línea de comentarios. Para obtener más información, vea // (Comentario) (MDX).-- (guiones dobles)
Estos caracteres de comentarios se pueden usar en la misma línea que el código que se va a ejecutar o en una línea aparte. Todo lo que se encuentre entre los dos guiones y el final de la línea es parte del comentario. En el caso de que un comentario ocupe varias líneas, los guiones dobles deben aparecer al principio de cada línea de comentarios. Para obtener más información, vea -- (Comentario) (MDX)./* ... */ (pares de caracteres de barra diagonal y asterisco)
Estos caracteres de comentarios se pueden usar en la misma línea que el código que se va a ejecutar, en líneas separadas o, incluso, en el código ejecutable. Todo lo incluido entre el par de apertura de comentario (/*) y el par de cierre de comentario (*/) se considera parte del comentario. En un comentario de varias líneas, el par de caracteres de apertura de comentario (/*) debe iniciar el comentario y el par de caracteres de cierre de comentario (*/) debe finalizarlo. Ningún otro carácter de comentario debe aparecer en ninguna línea del comentario. Para obtener más información, vea /*...*/ (Comentario).
Ejemplo
La consulta siguiente muestra ejemplos de los tres tipos de comentario:
//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]