Share via

Criar um notebook parametrizado usando a ação Executar com Parâmetros

  • Artigo

A parametrização no Azure Data Studio está executando o mesmo notebook com um conjunto diferente de parâmetros.

Este artigo mostra como criar e executar um notebook parametrizado no Azure Data Studio usando o kernel do Python.

Observação

Atualmente, você pode usar a parametrização com o Python, o PySpark, o PowerShell e os kernels interativos do .NET.

Pré-requisitos

Ação Executar com Parâmetros

Quando você usa a ação de notebook Executar com Parâmetros, o usuário pode inserir novos parâmetros na interface do usuário para definir rapidamente novos parâmetros para o notebook. Em seguida, o usuário poderá executar o notebook com os novos parâmetros.

Observação

É importante formatar a célula de parâmetro com cada novo parâmetro em uma nova linha.

Exemplo de parametrização

Você pode usar um arquivo de notebook de exemplo para percorrer as etapas neste artigo:

  1. Acesse o arquivo do notebook no GitHub. Selecione a opção Bruto.
  2. Selecione Ctrl + S ou clique com o botão direito do mouse e salve o arquivo com a extensão .ipynb.
  3. Abra o arquivo no Azure Data Studio.

Configurar um notebook para parametrização

Você pode começar com o notebook de exemplo aberto no Azure Data Studio ou concluir as etapas a seguir para criar um notebook. Em seguida, tente usar parâmetros diferentes. Todas as etapas são executadas dentro de um notebook do Azure Data Studio.

  1. Crie um novo bloco de anotações. Altere Kernel para Python 3:

    Screenshot that shows the New notebook menu option and setting the Kernel value to Python 3.

  2. Se for solicitado que você atualize os pacotes do Python quando os seus pacotes precisarem ser atualizados, selecione Sim:

    Screenshot that shows the dialog prompt to update Python packages.

  3. Verifique se o Kernel está definido como Python 3:

    Screenshot that shows the Kernel value to Python 3.

  4. Crie uma célula de código. Selecione Parâmetros para marcar a célula como uma célula de parâmetros.

    x = 2.0
y = 5.0

    Screenshot that shows creating a new parameters cell with Parameters selected.

  5. Adicione outras células para testar parâmetros diferentes:

    addition = x + y
multiply = x * y

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

    A saída parecerá com o seguinte:

    Screenshot that shows the output of cells added to test new parameters.

  6. Salve o notebook como Input.ipynb:

    Screenshot that shows saving the notebook file.

Executar o notebook com parâmetros

  1. Na barra de ferramentas do notebook, selecione o ícone Executar com Parâmetros:

    Screenshot that shows the Run with Parameters icon selected on the toolbar.

  2. Uma série de novas caixas de diálogo solicita que você insira novos parâmetros em x e y:

    Screenshot that shows entering a new parameter for x.

    Screenshot that shows entering a new parameter for y.

  3. Depois de inserir os novos parâmetros, veja o novo notebook parametrizado. Na barra de ferramentas, selecione Executar tudo para executar todas as células e ver a nova saída. Uma nova célula rotulada como # Injected-Parameters contém os novos valores de parâmetro que foram passados:

    Screenshot that shows the output for new parameters.

Próximas etapas

Saiba mais sobre notebooks e parametrização: