Utilizar o Kusto.Explorer

  • Artigo

O Kusto.Explorer é uma aplicação de ambiente de trabalho que lhe permite explorar os seus dados com o Linguagem de Pesquisa Kusto numa interface de utilizador fácil de utilizar. Este artigo mostra-lhe como utilizar modos de pesquisa e consulta, partilhar as suas consultas e gerir clusters, bases de dados e tabelas.

Modo Procurar++

O modo Procurar++ permite-lhe procurar um termo através da sintaxe de pesquisa numa ou mais tabelas.

  1. Na lista pendente Consulta no separador Base , selecione Procurar++.

  2. Selecione Várias tabelas.

  3. Em Escolher tabelas, defina as tabelas a procurar e, em seguida, selecione OK.

  4. Na caixa de edição, introduza a sua expressão de pesquisa e selecione Ir.

    Um mapa térmico da tabela/grelha de intervalo de tempo mostra os termos que aparecem e onde aparecem.

    Pesquisa + + Kusto Explorer

  5. Selecione uma célula na grelha e selecione Ver Detalhes para mostrar as entradas relevantes no painel de resultados.

    Kusto Explorer Search + + resultados

Modo de consulta

O Kusto.Explorer inclui um poderoso modo de consulta que lhe permite escrever, editar e executar consultas inline. O modo de consulta inclui realce de sintaxe e IntelliSense, para que possa aumentar rapidamente os seus conhecimentos sobre o Linguagem de Pesquisa Kusto.

Esta secção descreve como executar consultas básicas no Kusto.Explorer e como adicionar parâmetros às suas consultas.

Consultas básicas

Se tiver registos de tabelas, pode começar a explorá-los:

StormEvents | count

Quando o cursor está nesta linha, fica cinzento colorido. Prima F5 para executar a consulta.

Eis mais algumas consultas de exemplo:

// Take 10 lines from the table. Useful to get familiar with the data
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take sample of 10 lines
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Consulta básica do Kusto Explorer.

Para saber mais sobre o Linguagem de Pesquisa Kusto, consulte Linguagem de Pesquisa Kusto.

Nota

As linhas em branco na expressão de consulta podem afetar a parte da consulta que é executada.

Se não tiver texto selecionado, presume-se que a consulta ou o comando está separado por linhas vazias. Se o texto estiver selecionado, o texto selecionado é executado.

Parametrização de consulta do lado do cliente

Nota

Existem dois tipos de técnicas de parametrização de consultas no Kusto:

  • A parametrização de consulta integrada em linguagem é implementada do lado do servidor e destina-se a ser utilizada por aplicações que consultam o serviço através de programação. Este método não está descrito neste documento.

  • A parametrização de consulta do lado do cliente, descrita abaixo, é uma funcionalidade apenas da aplicação Kusto.Explorer. É equivalente a utilizar operações de substituição de cadeias nas consultas antes de as enviar para serem executadas pelo serviço. A sintaxe descrita abaixo não faz parte da própria linguagem de consulta e não pode ser utilizada ao enviar consultas para o serviço por outros meios que não o Kusto.Explorer.

Se utilizar o mesmo valor em múltiplas consultas ou em vários separadores, é altamente inconveniente alterar esse valor em todos os localmente utilizados. É por isso que o Kusto.Explorer suporta parâmetros de consulta. Os parâmetros de consulta são partilhados entre separadores para que possam ser facilmente reutilizados. Os parâmetros são indicados por {} parênteses. Por exemplo, {parameter1}.

Pode definir e editar facilmente parâmetros de consulta existentes:

Captura de ecrã do editor de consultas a mostrar uma consulta com parâmetros. A opção editor de consultas intitulada Parâmetros de consulta está realçada.

Captura de ecrã da janela Parâmetros de consulta que mostra os parâmetros definidos.

Pode ter vários conjuntos de parâmetros (listados na caixa de combinação Conjunto de Parâmetros ). Selecione Adicionar novo ou Eliminar atual para manipular a lista de conjuntos de parâmetros.

Lista de conjuntos de parâmetros.

Partilhar consultas e resultados

No Kusto.Explorer, pode partilhar consultas e resultados por e-mail. Também pode criar ligações profundas que abrem e executam uma consulta no browser.

Partilhar consultas e resultados por e-mail

O Kusto.Explorer fornece uma forma conveniente de partilhar consultas e consultar resultados por e-mail.

  1. Execute a consulta no Kusto.Explorer.

  2. No separador Base, na secção Partilhar, selecione Consulta e Resultados na Área de Transferência (ou prima Ctrl+Shift+C).

    Exportar para a área de transferência.

    O Kusto.Explorer copia o seguinte para a área de transferência:

    • A sua consulta
    • Os resultados da consulta (tabela ou gráfico)
    • Os detalhes da ligação para o cluster e a base de dados do Kusto
    • Uma ligação que execute novamente a consulta automaticamente

  3. Cole o conteúdo da área de transferência numa nova mensagem de e-mail.

    Partilhar resultados por e-mail.

Consultas de ligação profunda

Pode criar um URI que, quando aberto num browser, abre o Kusto.Explorer localmente e executa uma consulta específica numa base de dados kusto especificada.

Nota

Por motivos de segurança, a ligação profunda está desativada para comandos de gestão.

A forma mais fácil de criar uma ligação profunda é criar a consulta no Kusto.Explorer e, em seguida, utilizar Export to Clipboard para copiar a consulta (incluindo a ligação profunda e os resultados) para a área de transferência. Em seguida, pode partilhá-lo por e-mail.

Quando copiada para um e-mail, a ligação profunda é apresentada num tipo de letra pequeno. Por exemplo:

https://help.kusto.windows.net/Samples [Executar a consulta]

A primeira ligação abre o Kusto.Explorer e define adequadamente o contexto do cluster e da base de dados. A segunda ligação (Run the query) é a ligação profunda. Se mover a ligação para uma mensagem de e-mail e premir CTRL+K, poderá ver o URL real:

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAEAAsuyS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d

Pode utilizar consultas parametrizadas com ligação profunda.

  1. Criar uma consulta a ser formada como uma consulta parametrizada (por exemplo, KustoLogs | where Timestamp > ago({Period}) | count)

  2. Forneça um parâmetro para cada parâmetro de consulta no URI, como:

    https://<your_cluster>.kusto.windows.net/MyDatabase? web=0&query=KustoLogs+%7c+where+Timestamp+>+ago({Period})+%7c+count&Period=1h

    Substitua <your_cluster> pelo nome do cluster do Azure Data Explorer.

Limitações

As consultas estão limitadas a ~2000 carateres devido a limitações do browser, proxies HTTP e ferramentas que validam ligações, como o Microsoft Outlook. A limitação é aproximada porque depende do comprimento do nome do cluster e da base de dados. Para obter mais informações, consulte https://support.microsoft.com/kb/208427.

Para reduzir as probabilidades de atingir o limite de carateres, veja Obter Ligações Mais Curtas.

O formato do URI é: https://<ClusterCname>.kusto.windows.net/<DatabaseName>web=0?query=<QueryToExecute>

Por exemplo: https://help.kusto.windows.net/Samples?web=0query=StormEvents+%7c+limit+10

Este URI irá abrir o Kusto.Explorer, ligar ao cluster do Help Kusto e executar a consulta especificada na Samples base de dados. Se já existir uma instância do Kusto.Explorer em execução, a instância em execução abrirá um novo separador e executará a consulta na mesma.

As consultas podem tornar-se longas. Para reduzir a probabilidade de a consulta exceder o comprimento máximo, utilize o String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) método disponível na Biblioteca de Cliente kusto. Este método produz uma versão mais compacta da consulta. O formato mais curto também é reconhecido pelo Kusto.Explorer.

https://help.kusto.windows.net/Samples?web=0& query=H4sIAAAAAAAEAAsuyS%2fKdS1LzSspVuDlqlEoLs3NTSzKrEpVSM4vzSvR0FRIqlRIyszTCC5JLCoJycxN1VEwT9EEKS1KzUtJLVIoAYolZwAlFQCB3oo%2bTAAAAA%3d%3d

A consulta torna-se mais compacta ao aplicar a transformação seguinte:

 UrlEncode(Base64Encode(GZip(original query)))

Argumentos da linha de comandos kusto.Explorer

Os argumentos da linha de comandos são utilizados para configurar a ferramenta para executar funções adicionais no arranque. Por exemplo, carregue um script e ligue-se a um cluster. Como tal, os argumentos da linha de comandos não substituem nenhuma funcionalidade do Kusto.Explorer.

Os argumentos da linha de comandos são transmitidos como parte do URL utilizado para abrir a aplicação, de forma semelhante a consultar a ligação profunda.

Sintaxe do argumento da linha de comandos

O Kusto.Explorer suporta vários argumentos da linha de comandos na seguinte sintaxe (a ordem é importante):

[LocalScriptFile] [QueryString]

  • LocalScriptFile é o nome de um ficheiro de script no seu computador local, que tem de ter a extensão .kql. Se esse ficheiro existir, o Kusto.Explorer carrega automaticamente este ficheiro quando é iniciado.
  • QueryString é uma cadeia que utiliza formatação de cadeia de consulta HTTP. Este método fornece propriedades adicionais, conforme descrito na tabela abaixo.

Por exemplo, para iniciar o Kusto.Explorer com um ficheiro de script chamado c:\temp\script.kql e configurado para comunicar com o cluster help, base de dados Samples, utilize o seguinte comando:

Kusto.Explorer.exe c:\temp\script.kql uri=https://help.kusto.windows.net/Samples;Fed=true&name=Samples
Argumento Description
Consulta a executar
query A consulta a executar (gzipped e, em seguida, codificada em base64; consulte "Obter ligações mais curtas" acima). Se estiver vazio, utilize querysrc.
querysrc O URL HTTP de um ficheiro/blob que contém a consulta a executar (se query estiver vazia).
Ligação ao cluster do Kusto
uri O cadeia de ligação do cluster do Kusto ao qual ligar.
name O nome a apresentar da ligação ao cluster do Kusto.
Grupo de ligação
path O URL de um ficheiro de grupo de ligação a transferir (codificado por URL).
group O nome do grupo de ligação.
filename O ficheiro local que contém o grupo de ligação.

Gerir bases de dados, tabelas ou principais autorizados para funções

Importante

Apenas os administradores podem adicionar ou remover principais autorizados no seu próprio âmbito.

  1. Para ver a lista de principais autorizados, clique com o botão direito do rato na entidade de destino no painel Ligações e selecione Gerir Principais Autorizados da Base de Dados. (Também pode selecionar esta opção no Menu gestão.)

    Captura de ecrã do menu pendente entidade. As opções intituladas Gerir Principais Autorizados de Base de Dados estão realçadas.

  2. Selecione Adicionar principal para adicionar um principal autorizado. Captura de ecrã a mostrar a janela Gerir principais autorizados. As opções intituladas Remover principal e Adicionar principal estão realçadas.

  3. Indique os detalhes principais e, em seguida, selecione Adicionar principal.

    Captura de ecrã a mostrar a janela Adicionar principal autorizado. O botão intitulado Adicionar principal está realçado.

  4. Confirme que pretende adicionar o principal autorizado.

    Captura de ecrã da janela Rever Principal a mostrar um pedido de confirmação para adicionar um principal autorizado.

Para remover um principal autorizado existente, selecione Remover principal e confirme a ação.

Captura de ecrã da janela Remover principal a mostrar um pedido de confirmação para remover um principal autorizado.

Conteúdo relacionado