Share via


註解 (DMX)

資料採礦延伸模組 (DMX) 中的註解,是程式碼當中 Microsoft SQL Server Analysis Services 不會執行的文字字串。註解也稱為備註。您可以使用註解提供程式碼說明,或者在診斷程式碼時,暫時停用部份 DMX 陳述式或指令碼。

使用註解提供程式碼說明,未來維護程式碼會比較容易。您可以使用註解記錄詳細資料,例如程式的名稱、撰寫程式碼的開發人員名稱,以及主要程式碼變更的日期。您也可以使用註解描述複雜的計算或設計方法的程式。

下列是撰寫註解的基本指導方針:

  • 您可以在註解中使用任何英數字元或符號。Analysis Services 會忽略註解中的所有字元。

  • 陳述式或指令碼中的註解並無長度上限。一個註解可以由一或多行組成。

Analysis Services 支援下列註解字元類型:

  • // (雙斜線)。 使用這些註解字元在要執行之程式碼的同一行撰寫註解,或者在單獨一行撰寫註解。Analysis Services 會將雙斜線開始到該行結束的所有內容評估為註解的一部份。若要建立多行註解,請在註解的每一行開頭使用雙斜線。如需有關這個註解字元的詳細資訊,請參閱<// (註解) (DMX)>。

  • -- (雙連字號)。 使用這些註解字元在要執行之程式碼的同一行撰寫註解,或者在單獨一行撰寫註解。Analysis Services 會將雙連字號開始到該行結束的所有內容都評估為註解的一部份。若要建立多行註解,請在註解的每一行開頭使用雙連字號。如需有關這個註解字元的詳細資訊,請參閱<-- (註解) (DMX)>。

  • /* ... */ (斜線-星號字元配對)。 使用這些註解字元在要執行之程式碼的同一行撰寫註解,或者在單獨一行撰寫註解,甚至在可執行程式碼中撰寫註解。Analysis Services 會將開啟註解配對 (/*) 到關閉註解配對 (*/) 間的所有內容評估為註解的一部份。若要建立多行註解,請以開啟註解字元配對 (/*) 開始註解,並以關閉註解字元配對 (*/) 結束註解。任一行註解中不應包含其他任何註解字元。如需有關這個註解字元的詳細資訊,請參閱</*...*/ (註解) (DMX)>。