Sdílet prostřednictvím

Vytvoření parametrizovaného poznámkového bloku pomocí identifikátoru URI poznámkového bloku

  • Článek

Parametrizace v Nástroji Azure Data Studio spouští stejný poznámkový blok s jinou sadou parametrů.

V tomto článku se dozvíte, jak vytvořit a spustit parametrizovaný poznámkový blok v Nástroji Azure Data Studio pomocí jádra Pythonu.

Poznámka:

V současné době můžete použít parametrizaci s jádry Python, PySpark, PowerShell a .NET Interactive.

Požadavky

Parametrizace identifikátoru URI

Parametrizace identifikátoru URI programově přidává do dotazu identifikátoru URI nástroje Azure Data Studio parametry pro otevření poznámkového bloku v nástroji Azure Data Studio s novými parametry.

Identifikátor URI poznámkového bloku Azure Data Studio podporuje schéma HTTPS, HTTP a FILE URI a používá tento formát:

azuredatastudio://microsoft.notebook/open?url=

Pokud chcete předat parametry pomocí identifikátoru URI poznámkového bloku Azure Data Studio, použijte tento formát:

azuredatastudio://microsoft.notebook/open?url=LinkToNotebook?x=1&y=2

V dotazu URI použijte & k označení nového parametru, který má být vložen.

Příklad parametrizace

Ukázkový soubor poznámkového bloku můžete použít k procházení kroků v tomto článku:

  1. Přejděte do souboru poznámkového bloku na GitHubu. Vyberte Nezpracovaný.
  2. Vyberte Ctrl+S nebo klikněte pravým tlačítkem myši a uložte soubor s příponou .ipynb.
  3. Otevřete soubor v Nástroji Azure Data Studio.

Tady je obsah a struktura poznámkového bloku:

x = 2.0
y = 5.0

addition = x + y
multiply = x * y

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

Nastavení poznámkového bloku pro parametrizaci

Můžete začít s ukázkovým poznámkovým blokem otevřeným v Azure Data Studiu nebo provedením následujících kroků vytvořte poznámkový blok. Pak zkuste použít jiné parametry. Všechny kroky se spouštějí v poznámkovém bloku Azure Data Studio.

  1. První buňka kódu musí být označena parametry. Pokud používáte nový soubor poznámkového bloku, vytvořte novou buňku kódu. Vyberte Parametry a označte buňku jako buňku parametrů.

    Snímek obrazovky znázorňující vytvoření nové buňky parametrů s vybranou možností Parametry

  2. Pomocí vyhledávacího panelu libovolného prohlížeče nebo buňky Markdownu můžete otevřít odkaz URI poznámkového bloku. Pomocí identifikátoru URI poznámkového bloku Azure Data Studio (viz další) můžete parametrizovat ukázkový vstupní poznámkový blok na GitHubu.

    Zkopírujte následující identifikátor URI poznámkového bloku, který parametrizuje ukázkový vstupní poznámkový blok na GitHubu s novými hodnotami pro x a y. Vložte identifikátor URI do panelu hledání v prohlížeči:

    azuredatastudio://microsoft.notebook/open?url=https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/applications/azure-data-studio/parameterization.ipynb?x=10&y=20

    Snímek obrazovky znázorňující odkaz URI na panelu hledání v prohlížeči

    Když otevřete odkaz z webového prohlížeče, zobrazí se výzva k otevření poznámkového bloku v Nástroji Azure Data Studio. Vyberte Otevřít Azure Data Studio.

    Snímek obrazovky s výzvou ke stažení

  3. Zobrazí se výzva ke stažení a otevření poznámkového bloku s novými parametry.

    Vyberte Ano a pak zobrazte nový parametrizovaný poznámkový blok. Na panelu nástrojů vyberte Spustit vše a spusťte všechny buňky a podívejte se na nový výstup.

    Nová buňka s popiskem # Injected-Parameters obsahuje nové hodnoty parametrů, které byly předány:

    Snímek obrazovky znázorňující výstup pro nové parametry

Další kroky

Další informace o poznámkových blocích a parametrizaci: