Instalação e interface do usuário do Kusto.Explorer
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
O Kusto.Explorer é software gratuito para download e uso na área de trabalho do Windows. O Kusto.Explorer permite que você confira e analise seus dados com a KQL (Linguagem de Consulta Kusto) em uma interface amigável. Esta visão geral explica como configurar o Kusto.Explorer e descreve a interface do usuário que você usará.
Com o Kusto.Explorer, você pode:
- Consultar dados.
- Pesquisar dados em tabelas.
- Visualizar dados em uma grande variedade de grafos.
- Compartilhar consultas e resultados por email ou com links profundos.
Instalação do Kusto.Explorer
Baixe e instale a ferramenta do Kusto.Explorer usando as seguintes opções:
Como alternativa, acesse seu cluster Kusto com um navegador habilitado para ClickOnce em:
https://<your_cluster>/?web=0Substitua <your_cluster> pelo URI do cluster (por exemplo,help.kusto.windows.net.)
Usando o Google Chrome e o Kusto.Explorer
Se o Google Chrome for seu navegador padrão, será necessário instalar a extensão ClickOnce para o Chrome. https://chromewebstore.google.com/detail/clickonce-for-google-chro/kekahkplibinaibelipdcikofmedafmb?hl=en-US
Se o navegador padrão for o Microsoft Edge, não será necessário instalar essa extensão. Valide suas configurações do ClickOnce nas configurações de sinalizador do Microsoft Edge.
Visão geral da interface do usuário
A interface do usuário do Kusto.Explorer foi projetada com um layout baseado em guias e painéis, semelhante ao de outros produtos da Microsoft:
- Navegue pelas guias no painel de menus para executar várias operações
- Gerencie suas conexões no painel de conexões
- Crie scripts para executar no painel de script
- Veja os resultados dos scripts no painel de resultados
Painel Conexões
O painel Conexões mostra todas as conexões de cluster configuradas. Para cada cluster, são mostrados os bancos de dados, as tabelas e os atributos (colunas) que eles armazenam. Selecione itens (que definam um contexto implícito para a pesquisa/consulta no painel principal) ou clique duas vezes neles para copiar o nome no painel de pesquisa/consulta.
Se o esquema real for grande (como um banco de dados com centenas de tabelas), pressione Ctrl+F e insira uma substring (que não diferencia maiúsculas de minúsculas) do nome da entidade que você está procurando para pesquisar o esquema.
O Kusto.Explorer dá suporte ao controle do painel de conexões na janela de consulta, o que é útil para scripts. Por exemplo, você pode iniciar um arquivo de script com um comando que instrui Kusto.Explorer a se conectar ao cluster/banco de dados que o script consulta, usando a seguinte sintaxe:
#connect cluster('help').database('Samples')
StormEvents | count
Execute cada linha usando F5 ou um equivalente.
painel Documentos de trabalho
O painel Pastas de trabalho organiza suas pastas de trabalho em um só lugar para facilitar a navegação em seu trabalho. Há dois tipos de pastas de trabalho:
- Trabalho não salvo: lista pastas para guias de consulta abertas nas quais você ainda pode estar trabalhando.
- Pastas rastreadas: lista as pastas do seu dispositivo local que você pode adicionar como bibliotecas KQL para facilitar o acesso e o gerenciamento.
Painel de menus
Guia início
A guia Página Inicial mostra as operações usadas com mais frequência. Ele inclui:
Seção de consulta
| Menu | Comportamento |
|---|---|
| Menu suspenso |
|
| Nova Guia | Abre uma nova guia para consultar a Linguagem de Consulta Kusto. |
Seção de compartilhamento
| Menu | Comportamento |
|---|---|
| Dados para a Área de Transferência | Exporta a consulta e o conjunto de dados para uma área de transferência. Se um gráfico for apresentado, ele será exportado como bitmap |
| Resultado para a Área de Transferência | Exporta o conjunto de dados para uma área de transferência. Se um gráfico for apresentado, ele será exportado como bitmap |
| Consulta para a Área de Transferência | Exporta a consulta para uma área de transferência |
Seção de visualizações
Para visualizações de variáveis, consulte o operador de renderização.
| Menu | Comportamento |
|---|---|
| Gráfico de área | Exibe um gráfico de área em que o eixo x é a primeira coluna (precisa ser numérica). Todas as colunas numéricas são mapeadas para séries diferentes (eixo y). |
| Gráfico de Colunas | Exibe um gráfico de colunas em que todas as colunas numéricas são mapeadas para séries diferentes (eixo y). A coluna de texto antes de numérica é o eixo X (pode ser controlado na interface do usuário). |
| Gráfico de Barras | Exibe um gráfico de barras em que todas as colunas numéricas são mapeadas para séries diferentes (eixo x). A coluna de texto antes de numérica é o eixo Y (pode ser controlado na interface do usuário). |
| Gráfico de áreas empilhadas | Exibe um gráfico de área empilhado em que o eixo x é a primeira coluna (precisa ser numérica). Todas as colunas numéricas são mapeadas para séries diferentes (eixo y). |
| Gráfico de Tempo | Exibe um gráfico de tempo em que o eixo x é a primeira coluna (precisa ser datetime). Todas as colunas numéricas são mapeadas para séries diferentes (eixo y). |
| Gráfico de linhas | Exibe um gráfico de linhas em que o eixo x é a primeira coluna (precisa ser numérica). Todas as colunas numéricas são mapeadas para séries diferentes (eixo y). |
| Gráfico de anomalias | Semelhante ao Gráfico de Tempo, mas encontra anomalias em dados de séries temporais, usando um algoritmo de detecção de anomalias de aprendizado de máquina. Os dados devem estar em buckets de intervalo fixo. Para a detecção de anomalias, o Kusto.Explorer usa a função series_decompose_anomalies. |
| Gráfico de pizza | Exibe um gráfico de pizza em que o eixo da cor é a primeira coluna. O eixo teta (precisa ser uma medida convertida em porcentagem) é a segunda coluna. |
| Escada de Tempo | Exibe um gráfico de escada em que o eixo x são as duas últimas colunas (precisa ser datetime). O eixo y é uma composição das outras colunas. |
| Gráfico de dispersão | Exibe um gráfico de pontos em que o eixo x é a primeira coluna (precisa ser numérica). Todas as colunas numéricas são mapeadas para séries diferentes (eixo y). |
| Gráfico dinâmico | Exibe uma tabela dinâmica e um gráfico dinâmico que oferece total flexibilidade para selecionar dados, colunas, linhas e vários tipos de gráfico. |
| Dinamização de Tempo | Navegação interativa pela linha de tempo de eventos (dinamização no eixo de tempo) |
Seção de exibição
| Menu | Comportamento |
|---|---|
| Modo de Exibição Completa | Maximiza o espaço de trabalho ocultando o menu de faixa e o painel de conexões. Saia do Modo de Exibição Completa selecionando Página Inicial>Modo de Exibição Completa ou pressionando F11. |
| Ocultar Colunas Vazias | Remove colunas vazias da grade de dados. |
| Recolher Colunas Singulares | Recolhe colunas com valores singulares. |
| Explorar Valores de Coluna | Mostra a distribuição de valores de coluna |
| Aumentar Fonte | Aumenta o tamanho da fonte da guia de consulta e da grade de dados de resultados. |
| Diminuir Fonte | Diminui o tamanho da fonte da guia de consulta e da grade de dados de resultados. |
Observação
Configurações de Exibição de Dados:
o Kusto.Explorer controla quais configurações são usadas por conjunto exclusivo de colunas. Quando as colunas são reordenadas ou removidas, a exibição de dados é salva e será usada novamente sempre que os dados com as mesmas colunas forem recuperados. Para redefinir a exibição para as configurações padrão, selecione Redefinir Exibição na guia Exibição.
Guia Arquivo
| Menu | Comportamento |
|---|---|
| ---------Consultar Script--------- | |
| Nova Guia | Abre uma nova janela de guia para consultar o Kusto. |
| Abrir arquivo | Carrega dados de um arquivo *.kql para o painel de script ativo. |
| Salvar em Arquivo | Salva o conteúdo do painel de script ativo no arquivo *.kql. |
| Fechar Guia | Fecha a janela da guia atual |
| ---------Perfis--------- | |
| Importar Perfil | Importe um perfil Kusto.Explorer. |
| Perfil de Exportação | Exporte um perfil Kusto.Explorer. |
| ---------Salvar Dados--------- | |
| Dados para CSV | Exporta dados para um arquivo CSV (valores separados por vírgula). |
| Dados para JSON | Exporta dados para um arquivo formatado em JSON. |
| Dados para o Excel | Exporta dados para um arquivo XLSX (Excel). |
| Dados para Texto | Exporta dados para um arquivo TXT (texto). |
| Dados para Script KQL | Exporta Query para um arquivo de script. |
| Dados para Resultados | Exporta a consulta e os dados para um arquivo Resultados (QRES). |
| Executar Consulta em CSV | Executa uma consulta e salva os resultados em um arquivo CSV local. |
| ---------Carregar dados--------- | |
| Dos Resultados | Carrega a consulta e os dados de um arquivo de resultados (QRES). |
| ---------Área de transferência--------- | |
| Consulta e Resultados para a Área de Transferência | Exporta a consulta e o conjunto de dados para uma área de transferência. Se um gráfico for apresentado, ele exportará o gráfico como um bitmap. |
| Resultado para a Área de Transferência | Exporta o conjunto de dados para uma área de transferência. Se um gráfico for apresentado, ele exportará o gráfico como um bitmap. |
| Consulta à área de transferência | Exporta a consulta para uma área de transferência. |
| Resultados para a área de transferência (datatable()) | Exporta os resultados da consulta para uma área de transferência. O valor máximo permitido da célula é 30000. |
| ---------Resultados--------- | |
| Limpar Cache de Resultados | Limpa os resultados armazenados em cache de consultas executadas anteriormente. |
Guia Conexões
| Menu | Comportamento |
|---|---|
| ---------Grupos--------- | |
| Adicionar grupo | Adiciona um novo grupo do Kusto Server. |
| ---------Clusters--------- | |
| Importar Conexões | Importa conexões de um arquivo especificando conexões. |
| Exportar Conexões | Exporta conexões para um arquivo. |
| Adicionar Conexão | Adiciona uma nova conexão do Kusto Server. |
| Editar Conexão | Abre uma caixa de diálogo para edição de propriedades de conexão do Kusto Server. |
| Remover Conexão | Remove a conexão existente com o Kusto Server. |
| Atualizar | Atualiza as propriedades de uma conexão de servidor Kusto. |
| ---------Perfis--------- | |
| Importar Perfil | Importe um perfil Kusto.Explorer. |
| Perfil de Exportação | Exporte um perfil Kusto.Explorer. |
| ---------Segurança--------- | |
| Inspecionar Sua Entidade de Segurança do ADD | Mostra os detalhes do usuário ativo atual. |
| Sair | Desconecta o usuário atual da conexão com a ID do Microsoft Entra. |
| ---------Escopo de Dados--------- | |
| Escopo do cache |
|
| Coluna de datetime | Nome de uma coluna que pode ser usada para pré-filtro de tempo. |
| Filtro de tempo | Valor do pré-filtro de tempo. |
Guia Exibir
| Menu | Comportamento |
|---|---|
| ---------Aparência--------- | |
| Modo de Exibição Completa | Maximiza o espaço de trabalho ocultando o menu de faixa e o painel de conexões. Saia do Modo de Exibição Completa selecionando Página Inicial>Modo de Exibição Completa ou pressionando F11. |
| Aumentar Fonte | Aumenta o tamanho da fonte da guia de consulta e da grade de dados de resultados. |
| Diminuir Fonte | Diminui o tamanho da fonte da guia de consulta e da grade de dados de resultados. |
| Redefinir Layout | Redefine o layout dos controles e janelas de encaixe da ferramenta. |
| Renomear Guia de Documento | Renomeie a guia selecionada. |
| ---------Exibição de Dados--------- | |
| Redefinir Exibição | Redefine as configurações de exibição de dados para seus padrões. |
| Explorar Valores de Coluna | Mostra a distribuição de valores de coluna. |
| Foco em Estatísticas de Consulta | Altera o foco para estatísticas de consulta em vez de resultados de consulta após a conclusão da consulta. |
| Ocultar Duplicatas | Alterna a remoção das linhas duplicadas dos resultados da consulta. |
| Ocultar Colunas Vazias | Remove colunas vazias dos resultados da consulta. |
| Recolher Colunas Singulares | Recolhe colunas com valores singulares. |
| Seleção de linha | Permite a seleção de linhas específicas no painel Resultados |
| Cor por coluna | Agrupa registros idênticos na primeira coluna por cor. |
| Quebra de Texto Automática | Formata as células para encapsular os dados para ajustá-los à largura da coluna. |
| ---------Filtro de Dados--------- | |
| Filtrar Linhas na Pesquisa | Alterna a opção de mostrar apenas linhas correspondentes na pesquisa de resultados da consulta (Ctrl+F). |
| ---------Visualizações--------- | |
| Visualizações | Confira Visualizações. |
Observação
Configurações de Exibição de Dados:
o Kusto.Explorer controla as configurações usadas por conjunto exclusivo de colunas. Quando as colunas são reordenadas ou removidas, a exibição de dados é salva e será usada novamente sempre que os dados com as mesmas colunas forem recuperados. Para redefinir a exibição para as configurações padrão, selecione Redefinir Exibição na guia Exibição.
Guia Ferramentas
| Menu | Comportamento |
|---|---|
| ---------IntelliSense--------- | |
| Habilitar o IntelliSense | Habilita e desabilita o IntelliSense no Painel de Script. |
| Lista de Problemas | Lista os problemas no painel Script. |
| ---------Automação--------- | |
| Adicionar nova automação | Produz um relatório de análise que fornece insights sobre a consulta. |
| ---------Utilidades--------- | |
| Ferramentas da linha de comando | Abre o prompt de comando no computador. |
| Compactar arquivo LZ4 | Compacta arquivos usando o algoritmo LZ4. |
| Descompactar arquivo LZ4 | Descompacta arquivos usando o algoritmo LZ4. |
| ---------Análise--------- | |
| Relatórios Analíticos | Abre um painel com vários relatórios pré-criados para análise de dados. |
| ---------Translate--------- | |
| Consulta no Power BI | Converte uma consulta em um formato adequado para uso no Power BI. |
| ---------Opções--------- | |
| Redefinir Opções | Define as configurações do aplicativo para valores padrão. |
| Opções | Abre uma ferramenta para definir as configurações do aplicativo. Para saber mais, consulte Opções do Kusto.Explorer. |
Cores de linha da tabela
O Kusto.Explorer tenta interpretar o nível de gravidade ou de detalhamento de cada linha no painel de resultados e colori-las adequadamente. Ele faz isso combinando os valores distintos de cada coluna com um conjunto de padrões conhecidos ("Aviso", "Erro" e assim por diante).
Para modificar o esquema de cores de saída ou desativar esse comportamento, no menu Ferramentas, selecione Opções>Esquema de cores do detalhamento do visualizador>de resultados.
| Legenda do esquema de cores do Excel | Legenda do esquema de cores Vívido |
|---|---|
|
|
Guia Monitoramento
| Menu | Comportamento |
|---|---|
| ---------Monitorar--------- | |
| Diagnóstico de Cluster | Mostra um resumo de integridade para o Grupo de Servidores atualmente selecionado no Painel Conexões. |
| Dados mais recentes: Todas as tabelas | Mostra um resumo dos dados mais recentes em todas as tabelas do banco de dados selecionado no momento. |
| Dados mais recentes: Tabela selecionada | Mostra na barra de status os dados mais recentes na tabela selecionada. |
Guia Gerenciamento
| Menu | Comportamento |
|---|---|
| ---------Entidades de Segurança Autorizadas--------- | |
| Gerenciar Entidades de Segurança Autorizadas por Banco de Dados | Permite o gerenciamento de entidades de segurança de um banco de dados para usuários autorizados. |
| Gerenciar Entidades de Segurança Autorizadas por Tabela | Permite gerenciar as entidades de segurança de uma tabela para usuários autorizados. |
| Gerenciar Entidade de Segurança Autorizada por Função | Permite o gerenciamento das entidades de segurança de uma função para usuários autorizados. |
Guia Ajuda
| Menu | Comportamento |
|---|---|
| ---------Documentação--------- | |
| Ajuda | Abre um link para a documentação online do Kusto. |
| Novidades | Abre um documento que lista todas as alterações do Kusto.Explorer. |
| Relatar Problema | Abre uma caixa de diálogo com duas opções:
|
| Atalhos do teclado | Abre um link para a lista de atalhos de teclado do Kusto.Explorer. |
| Mostrar EULA | Abre um link para o artigo Informações Legais do Microsoft Azure. |
Controlar a identidade do usuário que se conecta ao Kusto.Explorer
O modelo de segurança padrão para novas conexões é a segurança federada de ID do Microsoft Entra. A autenticação é feita por meio da ID do Microsoft Entra usando a experiência de usuário padrão do Microsoft Entra.
Se você precisar de um controle mais preciso sobre os parâmetros de autenticação, poderá expandir a caixa de edição "Avançado: Cadeias de conexão" e fornecer um valor de cadeia de conexão Kusto válido.
Por exemplo, os usuários com presença em vários locatários do Microsoft Entra às vezes precisam usar uma "projeção" específica de suas identidades para um locatário específico do Microsoft Entra, o que pode ser feito por meio da cadeia de conexão (substitua as palavras IN CAPITALS por valores específicos):
Data Source=https://CLUSTER_NAME.kusto.windows.net;Initial Catalog=DATABASE_NAME;AAD Federated Security=True;Authority Id=AAD_TENANT_OF_CLUSTER;User=USER_DOMAIN
AAD_TENANT_OF_CLUSTERé um nome de domínio ou ID de locatário do Microsoft Entra (um GUID) do locatário no qual o cluster está hospedado. Por exemplo,contoso.com.- USER_DOMAIN é a identidade do usuário convidado para esse locatário (por exemplo,
user@example.com).
Observação
O nome de domínio do usuário não é necessariamente o mesmo do locatário que hospeda o cluster.
