Pular para o conteúdo principal

query dados no Lakewatch

info

Beta

O Lakewatch está em Beta. Os administradores do Workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias no nível do workspace.

Use a página de query para pesquisar, filtrar e analisar dados de segurança com SQL. Você pode escrever queries personalizadas, refinar resultados sem executá-los novamente e ver como os resultados estão distribuídos ao longo do tempo.

nota

As query salvas no Lakewatch não aparecem no editor do Databricks SQL. O Lakewatch armazena suas queries em um catálogo interno do Lakewatch por workspace que não é mostrado no Catalog Explorer e as gerencia por meio do aplicativo Lakewatch.

Localizar e abrir queries​

Quando você abre o Query sem nenhuma tab aberta, você vê a lista de queries. Ele mostra suas queries salvas e rascunhos não salvos, com o Nome , Criado por , warehouse e os Timestamp de Criado e Atualizado de cada query.

  • Para encontrar uma query, pesquise pelo nome ou filtre por Criado por ou Warehouse .
  • Para abrir uma query, clique no seu nome.
  • Para começar uma nova query, clique em Nova SQL query .

Cada query abre em sua própria query tab. Suas tab abertas permanecem abertas quando você deixa Query , e elas ainda estão lá quando você volta. Para retornar à lista de queries, feche todas as tab abertas.

Usar tab de query​

Com tab de query, você pode trabalhar em várias queries ao mesmo tempo para comparar resultados ou manter análises separadas abertas.

Trabalhar com tab​

Você pode criar, renomear, fechar e reabrir tab de query:

  • Criar uma tab : Clique em Adicionar tab de query ( + ) ao lado das suas tab abertas para abrir uma query nova, existente ou recente.
  • Renomear uma tab : Clique no nome da tab ativa para editar. Cada nome de tab deve ser exclusivo.
  • Fechar uma tab : Clique no X à direita do nome da query. Queries que você executou são salvas em Recents . Uma query que você nunca execução é armazenada em cache apenas no seu navegador, e você não pode abri-la de outra máquina até que você a execução uma vez.
  • Reabrir uma query fechada : abra uma query fechada recentemente em Acesso rápido na lista de queries. Se você tiver uma tab aberta, clique em + para abrir uma query existente ou recente.
  • Monitorar o progresso : Cada ícone de tab mostra um indicador de progresso circular enquanto sua query está em execução, e uma marca de verificação quando a query é concluída.

Controles de tab​

Cada tab de query aberta possui uma barra de ferramentas com estes controles:

  • Ícone de estrela. Favorito : Marque a query como favorita para acesso rápido mais tarde.
  • Ícone de bloqueio. Permissões : gerencie quem pode abrir a query e o nível de permissão deles.
  • Ícone de história. Ver história de query : Ver a história de execução da query. Ele também está no menu Ações de query como História de query .
  • Ícone de menu Kebab. Ações da query : selecione Copiar Link , Duplicar query (abre uma cópia em uma nova tab), história da query ou Excluir .
nota

Favorito , Permissões , História de query e Duplicar query funcionam apenas em uma query salva. Uma query é salva na primeira vez que você a executa.

Escrever e execução queries​

Você escreve queries em SQL em uma tab de query. Para obter ajuda na escrita, depuração ou otimização de uma query com o Genie Code, consulte os prompts de exemplo do Genie Code.

Requisitos de query​

Para resultados rápidos e estáveis, inclua ambas estas cláusulas em cada query:

  • Um filtro de intervalo de tempo : use WHERE IN_TIMERANGE(time) para limitar a query ao intervalo que você selecionar no seletor de data e hora. Você mesmo não escreve as horas de começar e fim na query. A coluna passada para IN_TIMERANGE() deve ser um tipo TIMESTAMP ou DATE. Cada tabela Lakewatch tem uma coluna time, então IN_TIMERANGE(time) funciona em qualquer tabela Lakewatch. O intervalo é semiaberto. Uma linha cujo Timestamp é igual ao começar do seletor é incluída, mas uma linha cujo Timestamp é igual ao fim é excluída. IN_TIMERANGE() substitui o inRange() mais antigo, que filtra em um intervalo inclusivo.
  • ORDER BY time : Mantém a paginação e a linha do tempo estáveis.

Se você omitir qualquer cláusula, o Lakewatch solicitará que você a adicione antes que a query seja executada, mas você pode executar a query de qualquer maneira.

IN_TIMERANGE() também é a maneira recomendada de definir o escopo das regras de detecção em sua janela de execução. Veja Definir escopo de regras para um intervalo de tempo.

Fazer uma execução de query​

Para executar uma query:

  1. Defina o intervalo de tempo com o selecionador de data e hora. A query é executada sobre dados neste intervalo. Você pode definir estas opções:

    • Fuso horário : escolha UTC ou horário local, que é detectado no seu dispositivo.
    • Intervalos predefinidos : selecione um intervalo predefinido, como Últimas 24 horas .
    • Intervalos personalizados : Use o seletor de calendário para definir datas e horários de começar e término específicos.
  2. Escreva a sua query SQL no editor. Inclua as cláusulas nos Requisitos de query.

  3. Escolha o SQL Warehouse para execução a partir do seletor de compute na barra de ferramentas da query. Se você não selecionar um warehouse, a query não será execução e o Lakewatch solicitará que você selecione um.

  4. Clique em execução query .

Para parar uma query em execução, clique em Cancelar . O cancelamento pode levar um momento enquanto a limpeza é concluída.

Refinar resultados​

Os refinamentos filtram, classificam e agrupam os resultados da query sem alterar ou executar novamente a query original, para que você possa explorar os resultados sem usar mais compute. Você pode encadear vários refinamentos para restringir ainda mais os resultados.

Gerenciar refinamentos na barra de refinamentos​

A barra de refinamentos fica acima dos resultados da query:

  • Para adicionar um refinamento, insira uma operação de pipe usando sintaxe de pipe SQL e pressione Enter . Por exemplo, use WHERE para filtrar, ORDER BY para classificar ou AGGREGATE para agrupar e resumir resultados.
  • Para mover refinamentos para sua SQL query principal, clique em Ícone de seta para cima. Mover refinamentos para a query no canto superior direito do editor de refinamentos.
  • Para remover um refinamento, passe o mouse sobre ele e clique em Ícone de fechar pequeno. ícone de remover.

Refinar resultados da tabela de resultados​

Você também pode adicionar refinamentos de filtro da tabela de resultados:

  • Clique com o botão direito em um valor de célula para filtrar ou excluir por esse valor.
  • Para campos JSON, você também pode filtrar por campos aninhados.

Visualização da linha do tempo​

O histograma da linha do tempo mostra como os resultados da sua query são distribuídos ao longo do tempo, para que você possa encontrar padrões, anomalias e períodos de interesse em grandes datasets. A linha do tempo aparece quando os resultados da sua query incluem colunas baseadas em tempo.

Use a linha do tempo​

Você pode explorar a linha do tempo destas formas:

  • Passe o mouse sobre uma barra para ver a contagem de eventos e os Timestamp desse intervalo.
  • Clique em uma barra para saltar para os resultados daquele momento.
  • Clique e arraste para ampliar uma janela de tempo.
  • Use o botão de aumentar ou diminuir o zoom no canto superior direito para ajustar o intervalo que você está visualizando.

Explorar resultados na tabela​

A tabela de resultados carrega os resultados à medida que você rola a página, e você pode gerenciar colunas e inspecionar linhas individuais.

Você pode trabalhar com a tabela das seguintes formas:

  • Role para carregar mais resultados.
  • Use o painel Campos para mostrar, ocultar ou reordenar as colunas.
  • Clique em um objeto ou matriz JSON para expandi-lo.

Detalhes da linha​

Clique em qualquer linha para abrir a gaveta de detalhes à direita. Se você abrir a gaveta de uma célula específica, a gaveta destaca essa propriedade.

Ações rápidas​

Clique com o botão direito em uma célula ou linha para abrir um menu de ações comuns:

  • Células : copie o valor ou a linha como JSON, filtre ou exclua pelo valor, procure pelo valor ou agrupe pelo campo.
  • Linhas : Copie a linha como JSON.

Resolução de problemas​

Se uma query não se comportar conforme o esperado, verifique estas causas comuns:

  • Nenhum resultado retornado : verifique o intervalo de tempo e os refinamentos. Tente um intervalo de tempo mais amplo.
  • Linha do tempo ausente : certifique-se de que os resultados da sua query incluam uma coluna baseada em tempo.
  • Erros de query : Analise os detalhes do erro na página e ajuste o seu SQL ou as suas configurações.
  • Cancelamento lento : cancelar uma query pode levar um momento até que a limpeza seja concluída.
  • Acesso não atualizado após uma alteração de permissão : se você alterar as permissões de uma query e visualizar As permissões foram atualizadas, mas seu acesso não pôde ser atualizado , selecione Tentar novamente no aviso. Até que o refresh seja bem-sucedido, você não poderá editar, execução ou excluir a query.
  • Trabalho perdido : reabra queries fechadas no Acesso rápido na lista de queries.