Compartilhar 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:

    Captura de tela que mostra a opção de menu Novo notebook e a configuração do valor do Kernel para Python 3.

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

    Captura de tela que mostra o prompt da caixa de diálogo para atualizar os pacotes do Python.

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

    Captura de tela que mostra o valor do Kernel como 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

    Captura de tela que mostra a criação de uma célula de parâmetros com Parâmetros selecionado.

  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:

    Captura de tela que mostra a saída das células adicionadas para testar novos parâmetros.

  6. Salve o notebook como Input.ipynb:

    Captura de tela que mostra o salvamento do arquivo de notebook.

Executar o notebook com parâmetros

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

    Captura de tela que mostra o ícone Executar com Parâmetros selecionado na barra de ferramentas.

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

    Captura de tela que mostra a inserção de um novo parâmetro para x.

    Captura de tela que mostra a inserção de um novo parâmetro para 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:

    Captura de tela que mostra a saída dos novos parâmetros.

Próximas etapas

Saiba mais sobre notebooks e parametrização: