註解 (DMX)
資料採礦延伸模組 (DMX) 中的註解,是程式碼當中 Microsoft SQL Server Analysis Services 不會執行的文字字串。 註解也稱為備註。 您可以使用註解提供程式碼說明,或者在診斷程式碼時,暫時停用部份 DMX 陳述式或指令碼。
使用註解提供程式碼說明,未來維護程式碼會比較容易。 您可以使用註解記錄詳細資料,例如程式的名稱、撰寫程式碼的開發人員名稱,以及主要程式碼變更的日期。 您也可以使用註解描述複雜的計算或設計方法的程式。
下列是撰寫註解的基本指導方針:
您可以在註解中使用任何英數字元或符號。 Analysis Services 會忽略註解中的所有字元。
陳述式或指令碼中的註解並無長度上限。 一個註解可以由一或多行組成。
Analysis Services 支援下列註解字元類型:
**// (雙斜線)。**使用這些註解字元在要執行之程式碼的同一行撰寫註解,或者在單獨一行撰寫註解。 Analysis Services 會將雙斜線開始到該行結束的所有內容評估為註解的一部分。 若要建立多行註解,請在註解的每一行開頭使用雙斜線。 如需有關這個註解字元的詳細資訊,請參閱<// (註解) (DMX)>。
**-- (雙連字號)。**使用這些註解字元在要執行之程式碼的同一行撰寫註解,或者在單獨一行撰寫註解。 Analysis Services 會將雙連字號開始到該行結束的所有內容評估為註解的一部分。 若要建立多行註解,請在註解的每一行開頭使用雙連字號。 如需有關這個註解字元的詳細資訊,請參閱<-- (註解) (DMX)>。
**/* ...*/ (正斜線-星號字元配對)。**使用這些註解字元在要執行之程式碼的同一行撰寫註解,或者單獨一行撰寫註解,甚至在可執行程式碼中撰寫註解。 Analysis Services 會將開啟註解配對 (/*) 到關閉註解配對 (*/) 間的所有內容評估為註解的一部分。 若要建立多行註解,請以開啟註解字元配對 (/*) 開始註解,並以關閉註解字元配對 (*/) 結束註解。 任一行註解中不應包含其他任何註解字元。 如需有關這個註解字元的詳細資訊,請參閱</*...*/ (註解) (DMX)>。