query dados no Lakewatch
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.
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:
Favorito : Marque a query como favorita para acesso rápido mais tarde.
Permissões : gerencie quem pode abrir a query e o nível de permissão deles.
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 .
Ações da query : selecione Copiar Link , Duplicar query (abre uma cópia em uma nova tab), história da query ou Excluir .
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 paraIN_TIMERANGE()deve ser um tipoTIMESTAMPouDATE. Cada tabela Lakewatch tem uma colunatime, entãoIN_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 oinRange()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:
-
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.
-
Escreva a sua query SQL no editor. Inclua as cláusulas nos Requisitos de query.
-
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.
-
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
WHEREpara filtrar,ORDER BYpara classificar ouAGGREGATEpara agrupar e resumir resultados. - Para mover refinamentos para sua SQL query principal, clique em
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 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.
Navegação na tabela
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.