批註 (MDX 語法)
批註是程式碼中未執行的文字字串。 (評論也稱為備註)。 您可以使用批註來記錄程式碼,或暫時停用要診斷的多維度運算式 (MDX) 語句和腳本部分。 藉由使用批註來記錄程式碼,您可以更輕鬆地進行未來的程式碼維護。 您經常使用批註來記錄程式名稱、作者名稱和主要程式碼變更的日期。 您也可以使用批註來描述複雜的計算,或說明程式設計方法。
MDX 中的批註遵循下列指導方針:
所有英數位元或符號都可以在批註內使用。 批註中的所有字元都會被忽略。
語句或腳本內的批註長度沒有上限。 批註可以由一或多行組成。
MDX 支援三種類型的批註字元:
(雙斜線)
這些批註字元可以用於與程式碼執行相同的行,或自行在行上使用。 從雙斜線到行尾的所有專案都是批註的一部分。 對於多行批註,雙斜線必須出現在每個批註行的開頭。 如需詳細資訊,請參閱 (批註)(MDX)。
-- (雙連字號)
這些批註字元可以用於與程式碼執行相同的行,或自行在行上使用。 從雙連字號到行尾的所有專案都是批註的一部分。 對於多行批註,雙連字號必須出現在每個批註行的開頭。 如需詳細資訊,請參閱 -- (批註) (MDX) 。
/* ... */ (正斜線星號字元組)
這些批註字元可以用於與程式碼執行相同的行、逐行執行,甚至是在可執行程式碼內使用。 從開放式批註組 (/*) 到關閉批註組 (*/) 的所有專案都會被視為批註的一部分。 對於多行批註,開啟批註字元組 (/*) 必須啟動批註,而關閉批註字元組 (*/) 必須結束批註。 沒有其他批註字元可以出現在批註的任何行上。 如需詳細資訊,請參閱 /*...*/ (批註)。
範例
下列查詢顯示這三種批註類型的範例:
//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]