query dados no Lakewatch

info

Visualização

O Lakewatch está na Prévia privada. Para solicitar acesso, entre em contato com a equipe da sua account Databricks.

A página de query é um hub central para pesquisar, filtrar e analisar dados de segurança usando SQL. A interface permite que você escreva queries personalizadas, aplique filtros em tempo real e visualize resultados ao longo do tempo.

O Genie Code pode ajudá-lo a explorar dados, refinar resultados, otimizar consultas e interpretar descobertas. Para obter ideias, consulte os prompts de exemplo do Genie Code.

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.

Introdução

Ao abrir query sem tab de query abertas, você acessa a página de queries, que lista suas queries salvas e rascunhos não salvos com controles de pesquisa e filtro:

• Pesquise queries por nome ou filtre por Criado por ou Warehouse .
• A lista mostra o Nome , o Criado por , o warehouse e os Timestamp de Criação e Atualização de cada query. Clique no nome de uma query para abri-la.

Começar uma nova query para abrir uma tab de query. Suas tabs de query abertas persistem entre as navegações: se você deixar uma tab aberta e for para outra página, ela ainda estará lá quando você retornar à página de queries. Para retornar à lista de query, feche suas tab abertas. Fechar a última o traz de volta.

Usando tab de query

As tab de query permitem que você trabalhe com várias query simultaneamente, facilitando a comparação de resultados ou a manutenção de diferentes fluxos de trabalho analíticos.

Trabalhando com tabs

• Create new tab : Clique no botão + ao lado das tab abertas para abrir uma query nova, existente ou recente
• Renomear tab : Clique diretamente no nome da tab ativa para editar (nomes duplicados não são permitidos)
• Fechar tab : clique no X à direita do nome da query para fechar uma tab. As queries que você executou são salvas em Recents . Uma query cuja execução você nunca fez é armazenada em cache apenas no seu navegador e não pode ser aberta em outra máquina até que você faça uma execução uma vez.
• Reabrir query fechadas : reabra uma query fechada recentemente em Acesso rápido na página inicial de query ou, se você tiver uma tab aberta, use o botão + para abrir uma query existente ou recente.
• Monitorar o progresso : os ícones de tab exibem o status da query com um indicador circular de progresso ou uma marca de verificação quando concluída

Controles de tab

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

• Favorita (estrela): marque a query como favorita para acesso rápido posteriormente.
• Compartilhar (bloqueio): gerenciar quem pode abrir a query e seu nível de permissão.
• História de query : Ver a história de execução da query, disponível na barra de ferramentas da tab e no menu de overflow.
• Menu flutuante ( ⋮ ): copie um link para a query, mova-a ou exclua-a.

nota

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

Escrevendo e executando consultas

As query são escritas em SQL dentro das tab de query.

Requisitos de query

Para resultados rápidos e estáveis, inclua esses dois componentes em todas as query:

• Um filtro de intervalo de tempo. Use WHERE IN_TIMERANGE(time) para delimitar a query ao intervalo que você selecionar no seletor de data/hora. Você não precisa escrever os horários de início e término na query. A coluna passada para IN_TIMERANGE() deve ser do tipo TIMESTAMP ou DATE; todas as tabelas do Lakewatch têm garantidamente uma coluna time, portanto, IN_TIMERANGE(time) sempre funciona. O intervalo é semiaberto: uma linha cujo timestamp é igual ao começar do seletor é incluída, mas uma que é igual ao final é excluída. (IN_TIMERANGE() substitui o inRange() mais antigo, que filtra em um intervalo inclusivo.)
• ORDER BY time - Habilita o comportamento estável de paginação e linha do tempo

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.

Executando queries

• Defina os parâmetros de tempo usando o seletor de data/hora. Sua query tem execução sobre os dados destes intervalos de tempo

  • Opções de fuso horário : escolha entre UTC ou horário local (detectado automaticamente no seu dispositivo)
  • Intervalos predefinidos : selecione entre opções predefinidas (por exemplo, "Últimas 24 horas")
  • Intervalos personalizados : Use o seletor de calendário para definir datas e horas específicas de início/fim

• Escreva sua query SQL no editor, incluindo as cláusulas SQL listadas acima para tornar sua query execução

• Escolha o SQL warehouse no qual executar a query usando o seletor de compute na barra de ferramentas da query. É necessário selecionar um warehouse: se você não selecionar um, a query não entrará em execução e o Lakewatch solicitará que você selecione um SQL warehouse.

• Clique no botão Executar query para começar a execução

• Clique em Cancelar para parar uma query em execução

Refinamentos: Filtragem e análise

Os refinamentos permitem que você filtre, classifique e agrupe dinamicamente os resultados da query sem modificar ou executar novamente sua query original, fornecendo uma maneira rápida de explorar diferentes perspectivas de dados enquanto economiza custos de compute. Você pode encadear vários refinamentos para filtragem complexa.

Gerenciando refinamentos

Na barra de refinamentos:

• Adicione expressões de filtro diretamente usando sintaxe de pipe SQL e pressione Enter para executar
• Para promover refinamentos em sua query SQL principal, clique no botão de seta para cima no canto superior direito do editor de refinamentos.
• Para remover um refinamento, passe o mouse sobre o refinamento para exibir o botão excluir (X).

Da tabela de resultados:

• Clique com o botão direito nos cabeçalhos das colunas para classificar em ordem ascendente/descendente ou agrupar por.
• Clique com o botão direito nos valores da célula para Filtrar ou Excluir por esse valor específico.
• Para campos JSON, você também pode filtrar por campos aninhados.

Visualização da linha do tempo

O histograma da linha do tempo fornece uma visão geral visual dos resultados da sua query distribuídos ao longo do tempo, facilitando a identificação de padrões, anomalias e períodos de interesse em grandes datasets. A linha do tempo aparece automaticamente quando sua query inclui colunas baseadas em tempo.

Usando a linha do tempo

• Passe o mouse sobre as barras para ver as contagens de eventos e os Timestamp de intervalos específicos
• Clique em qualquer barra para pular para os resultados daquele momento específico
• Clique e arraste para aumentar o zoom em uma janela de tempo para uma análise detalhada
• Use o botão de zoom in ou zoom out (canto superior direito) para ajustar o intervalo que você está visualizando

Visualizando e explorando resultados na tabela

A interface de resultados foi projetada para a exploração eficiente de grandes conjuntos de dados, com gerenciamento flexível de colunas e recursos detalhados de inspeção de linhas.

Navegação na tabela

• Os resultados são carregados automaticamente conforme você rola grandes dataset.
• Use a coluna Campos para mostrar/ocultar, reordenar ou fazer pin nas colunas.
• Clique para expandir objetos e matrizes JSON para leitura confortável.

Detalhes da linha

• Clique em qualquer linha para abrir a gaveta de detalhes à direita
• Abrir a partir de uma célula específica destaca essa propriedade na gaveta

Ações rápidas

Os menus de contexto de clique com o botão direito oferecem acesso instantâneo a operações comuns:

• Células : copie valores, filtre/exclua por valor ou remova colunas
• Cabeçalhos : Classificar dados ou agrupar por valores de coluna
• Linhas inteiras : Copie os dados completos da linha no formato JSON

Resolução de problemas

• Nenhum resultado retornado : Verifique seu intervalo de data/hora e refinamentos. Tente ampliar os parâmetros
• Cronograma ausente : Verifique se sua query inclui colunas baseadas em tempo nos resultados
• Erros de query : revise os detalhes do erro exibidos na página e ajuste a sintaxe SQL ou as configurações
• Cancelamento atrasado : Aguarde um momento para que os processos de limpeza sejam concluídos ao cancelar consultas
• Perda de trabalho : reabra query fechadas no Acesso rápido na página inicial de query