Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Important
O Lakewatch está em Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Veja Gerir pré-visualizações no nível do espaço de trabalho.
Utilize a página de consulta para pesquisar, filtrar e analisar dados de segurança com SQL. Podes escrever consultas personalizadas, refinar resultados sem as repetir e ver como os resultados são distribuídos ao longo do tempo.
Note
As consultas guardadas no Lakewatch não aparecem no editor SQL do Databricks. O Lakewatch armazena as suas consultas num catálogo Lakewatch interno por espaço de trabalho, que não é mostrado no Explorador de Catálogos, e gere-as através da aplicação Lakewatch.
Encontrar e abrir consultas
Quando abres Consulta sem separadores de consulta abertos, vês a lista de consultas. Mostra as tuas consultas guardadas e rascunhos não guardados, com o Nome, Criado por, Armazém e os carimbos de tempo Criado e Atualizado de cada consulta.
- Para encontrar uma consulta, pesquise por nome ou filtre por Criado por ou Armazém.
- Para abrir uma consulta, clique no nome.
- Para iniciar uma nova query, clique em Nova query SQL.
Cada consulta abre no seu próprio separador. Os separadores abertos mantêm-se abertos quando sai de Query, e continuam lá quando voltar. Para voltar à lista de consultas, feche todos os separadores abertos.
Use separadores de consulta
Com separadores de consulta, pode trabalhar várias consultas ao mesmo tempo, para comparar resultados ou manter análises separadas abertas.
Trabalhar com tabs
Utilize as seguintes ações para criar, renomear, fechar e reabrir separadores de consultas:
- Crie um separador: Clique em Adicionar separador de consulta (+) ao lado dos separadores abertos para abrir um separador de consulta novo, existente ou recente.
- Renomear um separador: Clique no nome do separador ativo para o editar. Cada aba deve ter um nome diferente.
- Fechar um separador: Clique no X à direita do nome da consulta. As consultas que executaste são guardadas em Recentes. Uma consulta que nunca executaste está apenas em cache no teu navegador, e não podes abri-la a partir de outra máquina até a executares uma vez.
- Reabrir uma consulta fechada: Abra uma consulta recentemente encerrada a partir do Acesso Rápido na lista de consultas. Se tiver um separador aberto, clique + para abrir uma consulta existente ou recente.
-
Monitorizar o progresso: Cada ícone de separador mostra um indicador circular de progresso
enquanto a sua consulta é executada, e um visto
quando a consulta termina.
Controlos de separadores
Cada separador de consulta aberto tem uma barra de ferramentas com estes controlos:
-
Favorito: Marca a consulta como favorita para acesso rápido mais tarde.
-
Permissões: Veja quem pode abrir a consulta e o seu nível de permissão. Só os utilizadores com a permissão Can manage podem alterar o acesso.
-
Ver histórico de consultas: Veja o histórico de execução da consulta. Também aparece no menu de ações de Consulta como Histórico da consulta.
-
Ações de consulta: Selecionar Copiar link, Duplicar consulta (abre uma cópia numa nova aba), Histórico de consultas ou Eliminar.
Note
Favorito, Permissões, Histórico de Consultas e Duplicar consulta funcionam apenas numa consulta guardada. Uma consulta é guardada na primeira vez que a executa.
Escrever e executar consultas
Escreve consultas em SQL numa aba de consultas. Para ajuda a escrever, depurar ou otimizar uma consulta com o Genie Code, consulte os prompts de exemplo do Genie Code.
Requisitos de consulta
Para resultados rápidos e estáveis, inclua as seguintes cláusulas em cada consulta:
-
Um filtro de intervalo temporal: Use
WHERE IN_TIMERANGE(time)para definir o âmbito da consulta para o intervalo selecionado no seletor de data e hora. Não escreves tu próprio os horários de início e fim na consulta. A coluna passada paraIN_TIMERANGE()deve ser do tipo aTIMESTAMPouDATE. Cada tabela Lakewatch tem umatimecoluna, por issoIN_TIMERANGE(time)funciona em qualquer tabela Lakewatch. O intervalo é semiaberto. Uma linha cujo carimbo temporal é igual ao início do selecionador é incluída, mas uma linha cujo carimbo temporal é igual ao fim é excluída.IN_TIMERANGE()substitui o anteriorinRange(), que filtra num intervalo inclusivo. -
ORDER BY time: Mantém a paginação e a linha temporal estáveis.
Se omitires qualquer uma das cláusulas, o Lakewatch pede-te para a adicionares antes da consulta ser executada, mas podes executar a consulta na mesma.
IN_TIMERANGE() é também a forma recomendada de definir regras de deteção ao respetivo período de execução.
Consulte as regras de âmbito a um intervalo temporal.
Executar uma consulta
Para executar uma consulta:
- Defina o intervalo temporal com o seletor de data e hora. A consulta corre sobre dados neste intervalo. O seletor inclui as seguintes opções:
- Fuso horário: Selecione UTC ou a hora local, que é detetada com base no seu dispositivo.
- Intervalos predefinidos: Selecione um intervalo pré-definido, como Últimas 24 horas.
- Intervalos personalizados: Use o seletor de calendário para definir datas e horas específicas de início e fim.
- Escreve a tua consulta SQL no editor. Inclua as cláusulas em requisitos da consulta.
- Selecione o armazém SQL a utilizar a partir do seletor de computação na barra de ferramentas de consulta. Se não selecionares um armazém, a consulta não é executada e o Lakewatch pede-te para selecionar um armazém.
- Clique em Executar consulta.
Para interromper uma consulta em curso, clique em Cancelar. Cancelar pode demorar um pouco enquanto a limpeza termina.
Refinar resultados
Os refinamentos filtram, ordenam e agrupam os resultados das consultas sem alterar ou reexecutar a sua consulta original, para que possa explorar os resultados sem usar mais cálculo. Encadeie múltiplos refinamentos para restringir ainda mais os resultados.
Gerir refinamentos na barra de refinamentos
A barra de refinamentos está acima dos resultados da consulta:
- Para adicionar um refinamento, introduza uma operação de pipe usando a sintaxe de pipe SQL e depois pressione Enter. Por exemplo, usar
WHEREpara filtrar,ORDER BYordenar ouAGGREGATEagrupar e resumir resultados. - Para mover refinamentos para a sua consulta SQL principal, clique
Mova os refinamentos para a consulta no canto superior direito do editor de refinamentos.
- Para remover um refinamento, passe o rato por cima dele e depois clique no
, o ícone de remover.
Refinar resultados a partir da tabela de resultados
Também pode adicionar refinamentos de filtro a partir da tabela de resultados:
- Clique com o botão direito num valor de célula para filtrar ou excluir por esse valor.
- Para campos JSON, também podes filtrar por campos aninhados.
Visualização da linha temporal
O histograma da linha temporal mostra como os resultados das suas consultas são distribuídos ao longo do tempo, para que possa encontrar padrões, anomalias e períodos de interesse em grandes conjuntos de dados. A linha temporal aparece quando os resultados da sua consulta incluem colunas baseadas no tempo.
Usa a linha temporal
Explore a linha temporal das seguintes formas:
- Passe o rato sobre uma barra para ver o número de eventos e os carimbos de tempo desse intervalo.
- Clique numa barra para aceder aos resultados desse momento.
- Arraste para ampliar o zoom num intervalo de tempo.
- Usa o botão de zoom in ou zoom out no canto superior direito para ajustar o intervalo que estás a ver.
Explorar os resultados na tabela
A tabela de resultados carrega os resultados à medida que deslocas, e podes gerir colunas e inspecionar linhas individuais.
Navegação na tabela
Trabalhe com a tabela das seguintes formas:
- Desloca para carregar mais resultados.
- Utilize o painel Campos para mostrar, ocultar ou reordenar colunas.
- Clique num objeto JSON ou array para o expandir.
Detalhes da linha
Clique em qualquer linha para abrir o painel de detalhes à direita. Se abrir a gaveta a partir de uma célula específica, a gaveta destaca essa propriedade.
Ações rápidas
Clique com o botão direito numa 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 o valor ou agrupe pelo campo.
- Linhas: Copie a linha como JSON.
Troubleshooting
Se uma consulta não se comportar como esperado, verifique estas causas comuns:
- Sem resultados retornados: Verifique o seu intervalo temporal e os seus refinamentos. Experimente um intervalo de tempo mais amplo.
- Linha temporal em falta: Certifique-se de que os resultados da sua consulta incluem uma coluna baseada no tempo.
- Erros de consulta: Reveja os detalhes do erro na página e depois ajuste o seu SQL ou definições.
- Cancelamento lento: Cancelar uma consulta pode demorar algum tempo enquanto a limpeza termina.
- Acesso não atualizado após alteração de permissões: Se alterar as permissões de uma consulta e vir que as permissões foram atualizadas, mas o seu acesso não pôde ser atualizado, selecione Retentar no aviso. Até que a atualização seja bem-sucedida, não pode editar, executar ou eliminar a consulta.
- Trabalho perdido: Reabra consultas fechadas a partir de Acesso Rápido na lista de consultas.