Komentarze (DMX)

Dotyczy: usług SQL Server Analysis Services

Komentarze w Data Mining Extensions (DMX) to ciągi tekstowe w kodzie programu, których Microsoft SQL Server Analysis Services nie wykonuje. Komentarze są również znane jako uwagi. Możesz używać komentarzy do dokumentowania kodu lub tymczasowego wyłączania części instrukcji czy skryptu DMX podczas diagnozowania kodu.

Używanie komentarzy do dokumentowania kodu programu ułatwia jego utrzymanie w przyszłości. Możesz użyć komentarzy do zapisywania szczegółów, takich jak nazwa programu, nazwisko twórcy kodu oraz daty głównych zmian w kodzie. Możesz też używać komentarzy do opisu złożonych obliczeń lub metody programowania.

Poniżej znajdują się podstawowe zasady pisania komentarzy:

  • Możesz użyć dowolnych znaków alfanumerycznych lub symboli w komentarzu. Usługi Analizy ignorują wszystkie znaki znajdujące się w komentarzu.

  • Nie ma maksymalnej długości komentarza w oświadczeniu lub scenariuszu. Komentarz może składać się z jednej lub kilku linijek.

Usługi analizy obsługują następujące typy znaków komentarzy:

  • (podwójne cięcia do przodu). Użyj tych znaków komentarza, aby napisać komentarz na tej samej linii, co kod ma być wykonywany, lub aby napisać komentarz na jednej linii osobno. Analysis Services ocenia wszystko od podwójnych ukośników do końca linii w ramach komentarza. Aby stworzyć komentarz wielolinijkowy, użyj podwójnych ukośników na początku każdej linijki komentarza. Więcej informacji o tej postaci z komentarza można znaleźć w artykule Double Slash (Comment) (DMX).

  • -- (podwójne myślniki). Użyj tych znaków komentarza, aby napisać komentarz na tej samej linii, co kod ma być wykonywany, lub aby napisać komentarz na jednej linii osobno. Analysis Services ocenia wszystko od podwójnych łączników po koniec linii w ramach komentarza. Aby stworzyć komentarz wielolinijkowy, użyj podwójnych myślników na początku każdej linijki komentarza. Więcej informacji o tej postaci w komentarzu znajdziesz w -- (Komentarz) (DMX) Podsumowanie.

  • /* ... */ (pary znaków z ukośnikiem do przodu). Użyj tych znaków komentarza, aby napisać komentarz na tej samej linii, co kod ma być wykonywany, aby napisać komentarz na jednej linii osobno, a nawet do pisania komentarzy w kodzie wykonywalnym. Usługi analizy oceniają wszystko od otwartej pary komentarzy (/*) po zamkniętą parę komentarzy (*/) jako część komentarza. Aby stworzyć komentarz wielolinijkowy, rozpocznij komentarz od pary znaków otwartego komentarza (/*) i zakończ komentarz parą znaków zakończonego komentarza (*/). Na żadnej linijce komentarza nie powinny pojawiać się inne postacie w komentarzu. Więcej informacji o tej postaci w komentarzu znajdziesz w Slash Star (Comment) (DMX).