Partilhar via

Criar um bloco de anotações parametrizado usando a ação Executar com parâmetros

  • Artigo

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

Este artigo mostra como criar e executar um bloco de anotações parametrizado no Azure Data Studio usando o kernel do Python.

Nota

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

Pré-requisitos

Executar com a ação Parâmetros

Quando você usa a ação Executar com parâmetros do bloco de anotações, o usuário pode inserir novos parâmetros na interface do usuário para definir rapidamente novos parâmetros para seu bloco de anotações. O usuário pode então executar o bloco de anotações com os novos parâmetros.

Nota

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

Exemplo de parametrização

Você pode usar um arquivo de bloco de anotações de exemplo para percorrer as etapas neste artigo:

  1. Vá para o arquivo do bloco de anotações no GitHub. Selecione Raw.
  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 bloco de notas para parametrização

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

  1. Crie um novo bloco de notas. Altere o kernel para Python 3:

    Captura de tela que mostra a opção de menu Novo bloco de anotações e a configuração do valor do Kernel como Python 3.

  2. Se você for solicitado a atualizar seus pacotes Python quando os pacotes precisarem de atualização, selecione Sim:

    Captura de tela que mostra o prompt de diálogo para atualizar pacotes Python.

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

    Captura de tela que mostra o valor do kernel para Python 3.

  4. Crie uma nova 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 nova célula de parâmetros com Parâmetros selecionados.

  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 será semelhante a este exemplo:

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

  6. Salve o bloco de anotações como Input.ipynb:

    Captura de ecrã que mostra a gravação do ficheiro do bloco de notas.

Executar o bloco de notas com parâmetros

  1. Na barra de ferramentas do bloco de anotações, 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 para 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, exiba o novo bloco de anotações 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 # Injected-Parameters contém os novos valores de parâmetro que foram passados:

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

Próximos passos

Saiba mais sobre notebooks e parametrização: