Comentarios (sintaxis MDX)

Los comentarios son cadenas de texto no ejecutables en el código del programa. (Los comentarios también se conocen como comentarios). Puedes usar comentarios para documentar código o desactivar temporalmente partes de sentencias y scripts de Expresiones Multidimensionales (MDX) que se están diagnosticando. Al usar los comentarios para documentar el código, puedes facilitar el mantenimiento futuro del código del programa. Frecuentemente usas los comentarios para registrar el nombre del programa, el nombre del autor y las fechas de los cambios importantes en el código. También puedes usar comentarios para describir cálculos complejos o explicar un método de programación.

Los comentarios en MDX siguen estas directrices:

  • Todos los caracteres alfanuméricos o símbolos pueden usarse dentro del comentario. Todos los personajes dentro de un comentario son ignorados.

  • No hay una longitud máxima para un comentario dentro de una afirmación o guion. Un comentario puede estar compuesto por una o más líneas.

MDX admite tres tipos de personajes que comentan:

(doble corte hacia adelante)
Estos caracteres de comentario pueden usarse en la misma línea que el código a ejecutar o en una línea por sí solos. Todo, desde los dobles cortes hacia adelante hasta el final de la línea, forma parte del comentario. Para un comentario de varias líneas, las barras dobles hacia adelante deben aparecer al inicio de cada línea de comentario. Para más información, véase (Comentario) (MDX).

-- (guion doble)
Estos caracteres de comentario pueden usarse en la misma línea que el código a ejecutar o en una línea por sí solos. Todo, desde los guiones dobles hasta el final de la línea, forma parte del comentario. Para un comentario de varias líneas, los guiones dobles deben aparecer al inicio de cada línea de comentario. Para más información, véase -- (Comentario) (MDX).

/* ... */ (emparejamiento de caracteres con barra delante-asterisco)
Estos caracteres de comentario pueden usarse en la misma línea que el código a ejecutar, en líneas independientes o incluso dentro de código ejecutable. Todo, desde el par de comentarios abierto (/*) hasta el par cerrado de comentarios (*/), se considera parte del comentario. Para un comentario de varias líneas, el par de caracteres de comentario abierto (/*) debe iniciar el comentario, y el par de caracteres de comentario cerrado (*/) debe terminar el comentario. No pueden aparecer otros caracteres de comentario en ninguna línea del comentario. Para más información, véase /*...*/ (Comentario).

Example

La siguiente consulta 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-hyphen  

/*An example of a  
multi-line  
comment*/  

SELECT  
  {[Measures].[Internet Sales Amount]} ON Columns,  
  [Date].[Calendar].MEMBERS ON Rows  
FROM [Adventure Works]