Partilhar via

Parâmetros de texto da pasta de trabalho

  • Artigo

Os parâmetros da caixa de texto fornecem uma maneira simples de coletar entrada de texto dos usuários da pasta de trabalho. Eles são usados quando não é prático usar uma lista suspensa para coletar a entrada, por exemplo, com um limite arbitrário ou filtros genéricos. Usando uma pasta de trabalho, você pode obter o valor padrão da caixa de texto de uma consulta. Essa funcionalidade permite cenários interessantes, como definir o limite padrão com base no p95 da métrica.

Um uso comum de caixas de texto é como variáveis internas usadas por outros controles de pasta de trabalho. Você usa uma consulta para valores padrão e torna o controle de entrada invisível no modo de leitura. Por exemplo, talvez você queira que um limite venha de uma fórmula, não de um usuário, e use o limite em consultas subsequentes.

Criar um parâmetro de texto

  1. Comece com uma pasta de trabalho vazia no modo de edição.

  2. Selecione Adicionar parâmetros>Adicionar parâmetro.

  3. No novo painel de parâmetros que se abre, introduza:

    1. Nome do parâmetro: SlowRequestThreshold
    2. Tipo de parâmetro: Text
    3. Obrigatório: checked
    4. Obter dados de: None

  4. Selecione Salvar para criar o parâmetro.

    Screenshot that shows the creation of a text parameter.

Esta captura de tela mostra a aparência da pasta de trabalho no modo de leitura:

Screenshot that shows a text parameter in read mode.

Estilo do campo de parâmetro

O parâmetro text suporta os seguintes estilos de campo:

  • Padrão: um campo de texto de linha única.

    Screenshot that shows a standard text field.

  • Senha: um campo de senha de linha única. O valor da senha só fica oculto na interface do usuário quando você digita. O valor é totalmente acessível como um valor de parâmetro quando referenciado. Ele é armazenado sem criptografia quando a pasta de trabalho é salva.

    Screenshot that shows a password field.

  • Multilinha: Um campo de texto de várias linhas com suporte para IntelliSense avançado e colorização de sintaxe para os seguintes idiomas:

    • Texto
    • Markdown
    • JSON
    • SQL
    • TypeScript
    • KQL
    • TOML

    Você também pode especificar a altura para o editor de várias linhas.

    Screenshot that shows a multiline text field.

Fazer referência a um parâmetro de texto

  1. Selecione Adicionar consulta para adicionar um controle de consulta e, em seguida, selecione um recurso do Application Insights.

  2. Na caixa KQL, adicione este trecho:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= {SlowRequestThreshold}) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  3. Usando o parâmetro text com um valor de 500 juntamente com o controle de consulta, você executa efetivamente a seguinte consulta:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= 500) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  4. Execute a consulta para ver os resultados.

    Screenshot that shows a text parameter referenced in KQL.

Nota

No exemplo anterior, {SlowRequestThreshold} representa um valor inteiro. Se você estivesse consultando uma cadeia de caracteres como {ComputerName}, você precisaria modificar sua consulta Kusto para adicionar aspas "{ComputerName}" para que o campo de parâmetro aceitasse uma entrada sem aspas.

Definir os valores padrão usando consultas

  1. Comece com uma pasta de trabalho vazia no modo de edição.

  2. Selecione Adicionar parâmetros>Adicionar parâmetro.

  3. No novo painel de parâmetros que se abre, introduza:

    1. Nome do parâmetro: SlowRequestThreshold
    2. Tipo de parâmetro: Text
    3. Obrigatório: checked
    4. Obter dados de: Query

  4. Na caixa KQL, adicione este trecho:

    requests
| summarize round(percentile(duration, 95), 2)

    Esta consulta define o valor padrão da caixa de texto para a duração do percentil 95 para todas as solicitações no aplicativo.

  5. Execute a consulta para ver os resultados.

  6. Selecione Salvar para criar o parâmetro.

    Screenshot that shows a text parameter with a default value from KQL.

Nota

Embora este exemplo consulte dados do Application Insights, a abordagem pode ser usada para qualquer fonte de dados baseada em log, como o Log Analytics e o Azure Resource Graph.

Adicionar validações

Para parâmetros de texto padrão e senha, você pode adicionar regras de validação que são aplicadas ao campo de texto. Adicione um regex válido com uma mensagem de erro. Se a mensagem estiver definida, será mostrada como um erro quando o campo for inválido.

Se a correspondência for selecionada, o campo será válido se o valor corresponder ao regex. Se a correspondência não for selecionada, o campo será válido se não corresponder ao regex.

Screenshot that shows text validation settings.

Formatar dados JSON

Se JSON for selecionado como o idioma para o campo de texto de várias linhas, o campo terá um botão que formata os dados JSON do campo. Você também pode usar o atalho Ctrl + \ para formatar os dados JSON.

Se os dados forem provenientes de uma consulta, você poderá selecionar a opção para pré-formatar os dados JSON retornados pela consulta.

Screenshot that shows the option Pre-format JSON data.

Próximos passos

Introdução às Pastas de Trabalho do Azure