Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Lakewatch est en version Bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les versions préliminaires au niveau de l’espace de travail.
Utilisez la page de requête pour rechercher, filtrer et analyser les données de sécurité avec SQL. Vous pouvez écrire des requêtes personnalisées, affiner les résultats sans les relancer, et voir comment les résultats sont distribués dans le temps.
Note
Les requêtes enregistrées dans Lakewatch n’apparaissent pas dans l’éditeur SQL de Databricks. Lakewatch stocke ses requêtes dans un catalogue Lakewatch interne par espace de travail qui n’est pas affiché dans Catalog Explorer, et les gère via l’application Lakewatch.
Trouver et ouvrir les requêtes
Quand vous ouvrez Requête sans onglets de requête ouverts, vous voyez la liste des requêtes. Il affiche vos requêtes enregistrées et les brouillons non enregistrés, avec pour chaque requête Nom, Créé par, Entrepôt, ainsi que les horodatages Créé et Mis à jour.
- Pour trouver une requête, recherchez par nom, ou filtrez par Créé par ou Entrepôt.
- Pour ouvrir une requête, cliquez sur son nom.
- Pour lancer une nouvelle requête, cliquez sur Nouvelle requête SQL.
Chaque requête s’ouvre dans son propre onglet de requête. Vos onglets ouverts restent ouverts lorsque vous quittez la requête, et ils sont toujours là quand vous revenez. Pour revenir à la liste des requêtes, fermez tous les onglets ouverts.
Utiliser les onglets de requête
Avec les onglets de requête, vous pouvez travailler sur plusieurs requêtes en même temps, afin de comparer les résultats ou de garder des analyses séparées ouvertes.
Travailler avec les onglets
Utilisez les actions suivantes pour créer, renommer, fermer et rouvrir des onglets de requête :
- Créer un onglet : cliquez sur Ajouter l’onglet de requête (+) à côté de vos onglets ouverts pour ouvrir une requête nouvelle, existante ou récente.
- Renommer un onglet : Cliquez sur le nom de l’onglet actif pour le modifier. Chaque onglet doit avoir un nom différent.
- Fermer un onglet : Cliquez sur le X à droite du nom de la requête. Les requêtes que vous avez lancées sont sauvegardées dans Récents. Une requête que vous n’avez jamais lancée est mise en cache uniquement dans votre navigateur, et vous ne pouvez pas l’ouvrir depuis une autre machine tant que vous ne l’avez pas lancée une seule fois.
- Rouvrir une requête fermée : Ouvrez une requête récemment fermée depuis Accès rapide dans la liste des requêtes. Si vous avez un onglet ouvert, cliquez + pour ouvrir une requête existante ou récente.
-
Surveiller la progression : Chaque icône d’onglet affiche un indicateur circulaire de progression
pendant que sa requête s’exécute, et une coche
lorsque la requête est terminée.
Commandes des onglets
Chaque onglet de requête ouvert possède une barre d’outils avec ces contrôles :
-
Favori : Marquez la requête comme favorite pour un accès rapide plus tard.
-
Autorisations : Voyez qui peut ouvrir la requête et son niveau d’autorisation. Seuls les utilisateurs disposant de la permission Can manage peuvent modifier l’accès.
-
Voir l’historique de la requête : Voir l’historique des exécutions de la requête. Il est aussi dans le menu Actions de requête sous Historique des requêtes.
-
Actions de requête : Sélectionnez Copier le lien, Dupliquer la requête (ouvre une copie dans un nouvel onglet), Historique des requêtes, ou Supprimer.
Note
Les favoris,permissions, historique des requêtes et Dupliquer la requête ne fonctionnent que sur une requête enregistrée. Une requête est sauvegardée la première fois que vous l’exécutez.
Écrire et exécuter des requêtes
Vous écrivez des requêtes en SQL dans un onglet de requêtes. Pour obtenir de l’aide à la rédaction, au débogage ou à l’optimisation d’une requête avec Genie Code, consultez les exemples d’invites de Genie Code.
Exigences liées aux requêtes
Pour des résultats rapides et stables, incluez les clauses suivantes dans chaque requête :
-
Un filtre par plage de temps : Utilisez
WHERE IN_TIMERANGE(time)pour définir la portée de la requête à la plage que vous sélectionnez dans le sélecteur de date et d’heure. Vous n’écrivez pas vous-même les heures de début et de fin dans la requête. La colonne passée àIN_TIMERANGE()doit être du typeTIMESTAMPouDATE. Chaque table Lakewatch a unetimecolonne, doncIN_TIMERANGE(time)fonctionne sur n’importe quelle table Lakewatch. L’intervalle est semi-ouvert. Une ligne dont l’horodatage est égal au début du prévoyeur est incluse, mais une ligne dont l’horodatage est égal à la fin est exclue.IN_TIMERANGE()remplace l’ancieninRange(), qui filtre sur une plage inclusive. -
ORDER BY time: Conserve la pagination et la chronologie stables.
Si vous omettez l’une ou l’autre des clauses, Lakewatch vous invite à l’ajouter avant l’exécution de la requête, mais vous pouvez tout de même exécuter celle-ci.
IN_TIMERANGE() est aussi la méthode recommandée pour limiter la portée des règles de détection à leur fenêtre d’exécution. Consultez Limiter la portée des règles à une plage temporelle.
Exécuter une requête
Pour lancer une requête :
- Définissez la plage de temps avec le sélectionneur de date et d’heure. La requête s’exécute sur des données dans cette plage. Le sélecteur inclut les options suivantes :
- Fuseau horaire : Sélectionnez UTC ou heure locale, qui est détectée depuis votre appareil.
- Plages prédéfinies : Sélectionnez une plage prédéfinie, comme Dernières 24 heures.
- Plages personnalisées : utilisez le sélecteur de calendrier pour définir des dates et heures spécifiques de début et de fin.
- Écrivez votre requête SQL dans l’éditeur. Incluez les clauses indiquées dans Exigences relatives aux requêtes.
- Sélectionnez l’entrepôt SQL sur lequel exécuter la requête depuis le sélecteur de calcul dans la barre d’outils de requête. Si vous ne sélectionnez pas un entrepôt, la requête ne s’exécute pas, et Lakewatch vous invite à en sélectionner un.
- Cliquez sur Exécuter la requête.
Pour arrêter une requête en cours, cliquez sur Annuler. L’annulation peut prendre un moment pendant que le nettoyage se termine.
Affiner les résultats
Les raffinements filtrent, trient et regroupent les résultats des requêtes sans modifier ni relancer votre requête initiale, afin que vous puissiez explorer les résultats sans utiliser plus de calcul. Enchaînez plusieurs affinements pour affiner davantage les résultats.
Gérer les affinements dans la barre d’affinement
La barre de raffinements se trouve au-dessus des résultats de la requête :
- Pour ajouter un raffinement, saisissez une opération de pipe en utilisant la syntaxe SQL pipe, puis appuyez sur Entrée. Par exemple, utilisez
WHEREpour filtrer,ORDER BYtrier, ouAGGREGATEregrouper et résumer les résultats. - Pour déplacer les affinements vers votre requête SQL principale, cliquez sur
Déplacez les affinements vers la requête en haut à droite de l’éditeur de raffinements.
- Pour supprimer un raffinement, survolez-le, puis cliquez sur
, l’icône de suppression.
Affinez les résultats à partir du tableau des résultats
Vous pouvez aussi ajouter des affinements de filtre à partir de la table des résultats :
- Faites un clic droit sur une valeur de cellule pour filtrer ou exclure par cette valeur.
- Pour les champs JSON, vous pouvez aussi filtrer par champs imbriqués.
Visualisation de la chronologie
L’histogramme de la chronologie montre comment vos résultats de requête sont distribués dans le temps, afin que vous puissiez trouver des motifs, des anomalies et des périodes d’intérêt dans de grands ensembles de données. La chronologie apparaît lorsque vos résultats de requête incluent des colonnes temporelles.
Utilisez la chronologie
Explorez la frise chronologique comme suit :
- Survolez une barre pour voir le nombre d’événements et les horodatages de cet intervalle.
- Cliquez sur une barre pour accéder aux résultats à partir de ce moment.
- Faites glisser pour zoomer sur une fenêtre temporelle.
- Utilisez le bouton zoom avant ou zoom arrière en haut à droite pour ajuster l’intervalle que vous regardez.
Consultez les résultats dans le tableau
La table des résultats charge les résultats au fur et à mesure que vous faites défiler, et vous pouvez gérer les colonnes et inspecter les lignes individuelles.
Navigation dans le tableau
Travaillez avec le tableau de la manière suivante :
- Faites défiler pour charger plus de résultats.
- Utilisez le volet Champs pour afficher, masquer ou réorganiser les colonnes.
- Cliquez sur un objet JSON ou un tableau JSON pour l’étendre.
Détails des lignes
Cliquez sur n’importe quelle ligne pour ouvrir le volet des détails à droite. Si vous ouvrez le panneau depuis une cellule spécifique, le panneau met en évidence cette propriété.
Actions rapides
Faites un clic droit sur une cellule ou une ligne pour ouvrir un menu d’actions courantes :
- Cellules : copiez la valeur ou la ligne en JSON, filtrez ou excluez par la valeur, recherchez la valeur, ou regroupez par le champ.
- Lignes : Copiez la ligne en JSON.
Troubleshooting
Si une requête ne se comporte pas comme prévu, vérifiez ces causes courantes :
- Aucun résultat trouvé : vérifiez votre plage de temps et vos affinements. Essayez une plage de temps plus large.
- Chronologie manquante : Assurez-vous que les résultats de vos requêtes incluent une colonne basée sur le temps.
- Erreurs de requête : Examinez les détails de l’erreur sur la page, puis ajustez votre SQL ou vos paramètres.
- Annulation lente : Annuler une requête peut prendre un moment pendant que le nettoyage se termine.
- Accès non rafraîchi après un changement de permission : Si vous modifiez les permissions d’une requête et voyez que les permissions ont été mises à jour, mais que votre accès n’a pas pu être rafraîchi, sélectionnez Réessayer dans l’avertissement. Tant que le rafraîchissement n’a pas réussi, vous ne pouvez pas modifier, exécuter ou supprimer la requête.
- Travail perdu : Rouvrir les requêtes fermées depuis l’accès rapide dans la liste des requêtes.