Udostępnij za pośrednictwem


Tworzenie sparametryzowanego notesu przy użyciu akcji Uruchom z parametrami

Parametryzacja w narzędziu Azure Data Studio uruchamia ten sam notes z innym zestawem parametrów.

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

Gdy używasz akcji Notes Uruchom z parametrami, użytkownik może wprowadzić nowe parametry w interfejsie użytkownika, aby szybko ustawić nowe parametry dla notesu. 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 pozycję Nieprzetworzone.
  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 notesu usługi Azure Data Studio.

  1. Utwórz nowy notes. Zmień jądro 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 jądro ma ustawioną wartość 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 notes 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 notesach i parametryzacji: