Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

Tworzenie sparametryzowanego notesu przy użyciu akcji Uruchom z parametrami

  • Artykuł
  • 08.04.2025

Ważne

Usługa Azure Data Studio zostanie wycofana 28 lutego 2026 r.. Zalecamy używanie programu Visual Studio Code. Aby uzyskać więcej informacji na temat migracji do programu Visual Studio Code, odwiedź Co się dzieje z usługą Azure Data Studio?

Parametryzacja w narzędziu Azure Data Studio polega na uruchamianiu tego samego notesu z różnymi parametrami.

W tym artykule pokazano, jak utworzyć i uruchomić sparametryzowany notes w narzędziu Azure Data Studio przy użyciu jądra języka Python.

Uwaga

Obecnie można używać parametryzacji z jądrami Python, PySpark, PowerShell i .NET Interactive.

Wymagania wstępne

Uruchamianie za pomocą akcji Parametry

Kiedy używasz akcji „Uruchom z parametrami” dla notatnika, użytkownik może wprowadzić nowe parametry w interfejsie użytkownika, aby szybko ustawić nowe wartości dla notatnika. Następnie użytkownik może uruchomić notes z nowymi parametrami.

Uwaga

Ważne jest, aby sformatować komórkę parametrów przy użyciu każdego nowego parametru w nowym wierszu.

Przykład parametryzacji

Możesz użyć przykładowego pliku notesu, aby wykonać kroki opisane w tym artykule:

  1. Przejdź do pliku notesu w usłudze GitHub. Wybierz Surowe.
  2. Wybierz Ctrl+S lub kliknij prawym przyciskiem myszy, a następnie zapisz plik z rozszerzeniem ipynb.
  3. Otwórz plik w narzędziu Azure Data Studio.

Konfigurowanie notesu na potrzeby parametryzacji

Możesz rozpocząć od otwarcia przykładowego notesu w narzędziu Azure Data Studio lub wykonać następujące kroki, aby utworzyć notes. Następnie spróbuj użyć różnych parametrów. Wszystkie kroki są uruchamiane wewnątrz notatnika Azure Data Studio.

  1. Utwórz nowy notes. Zmień Kernel na Python 3:

    Zrzut ekranu przedstawiający opcję menu Nowy notes i ustawienie wartości Jądra na Python 3.

  2. Jeśli zostanie wyświetlony monit o uaktualnienie pakietów języka Python, gdy pakiety wymagają aktualizacji, wybierz pozycję Tak:

    Zrzut ekranu przedstawiający okno dialogowe z monitem o zaktualizowanie pakietów języka Python.

  3. Sprawdź, czy Kernel jest ustawione na Python 3:

    Zrzut ekranu przedstawiający wartość jądra dla języka Python 3.

  4. Utwórz nową komórkę kodu. Wybierz pozycję Parametry , aby oznaczyć komórkę jako komórkę parametrów.

    x = 2.0
y = 5.0

    Zrzut ekranu przedstawiający tworzenie nowej komórki parametrów z wybraną pozycją Parametry.

  5. Dodaj inne komórki, aby przetestować różne parametry:

    addition = x + y
multiply = x * y

    print("Addition: " + str(addition))
print("Multiplication: " + str(multiply))

    Dane wyjściowe będą wyglądać podobnie do tego przykładu:

    Zrzut ekranu przedstawiający dane wyjściowe komórek dodanych do testowania nowych parametrów.

  6. Zapisz notatnik jako Input.ipynb:

    Zrzut ekranu przedstawiający zapisywanie pliku notesu.

Uruchamianie notesu z parametrami

  1. Na pasku narzędzi notesu wybierz ikonę Uruchom z parametrami :

    Zrzut ekranu przedstawiający ikonę Uruchom z parametrami wybraną na pasku narzędzi.

  2. Seria nowych okien dialogowych monituje o wprowadzenie nowych parametrów dla x i y:

    Zrzut ekranu przedstawiający wprowadzenie nowego parametru dla elementu x.

    Zrzut ekranu przedstawiający wprowadzenie nowego parametru dla y.

  3. Po wprowadzeniu nowych parametrów wyświetl nowy sparametryzowany notes. Na pasku narzędzi wybierz pozycję Uruchom wszystko , aby uruchomić wszystkie komórki i wyświetlić nowe dane wyjściowe. Nowa komórka oznaczona # Injected-Parameters etykietą zawiera nowe wartości parametrów, które zostały przekazane w:

    Zrzut ekranu przedstawiający dane wyjściowe dla nowych parametrów.

Następne kroki

Dowiedz się więcej o notebookach i parametryzacji: