contains, opérateur
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Filtre un jeu d’enregistrements pour les données contenant une chaîne non sensible à la casse. contains recherche des sous-chaînes arbitraires plutôt que des termes.
Le tableau suivant compare les contains opérateurs à l’aide des abréviations fournies :
- RHS = côté droit de l’expression
- LHS = côté gauche de l’expression
| Opérateur | Description | Respecte la casse | Exemple (génère true) |
|---|---|---|---|
contains |
Le terme de droite est une sous-séquence du terme de gauche | Non | "FabriKam" contains "BRik" |
!contains |
RHS ne se produit pas dans LHS | Non | "Fabrikam" !contains "xyz" |
contains_cs |
Le terme de droite est une sous-séquence du terme de gauche | Oui | "FabriKam" contains_cs "Kam" |
!contains_cs |
RHS ne se produit pas dans LHS | Oui | "Fabrikam" !contains_cs "Kam" |
Pour plus d’informations sur d’autres opérateurs et pour déterminer l’opérateur le plus approprié pour votre requête, consultez les opérateurs de chaîne de type de données.
Astuces pour les performances
Remarque
Les performances dépendent du type de recherche et de la structure des données. Pour connaître les meilleures pratiques, consultez les meilleures pratiques relatives aux requêtes.
Si possible, utilisez contains_cs : version sensible à la casse de l’opérateur.
Si vous recherchez un terme, utilisez-le has pour obtenir des résultats plus rapides.
Syntaxe
Chaîne de col T | where contains_cs ()
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| T | string |
✔️ | entrée tabulaire dont les enregistrements doivent être filtrés. |
| col | string |
✔️ | Nom de la colonne à vérifier pour la chaîne. |
| string | string |
✔️ | Chaîne sensible à la casse par laquelle filtrer les données. |
Retours
Lignes de T pour lesquelles la chaîne est en col.
Exemple
StormEvents
| summarize event_count=count() by State
| where State contains "enn"
| where event_count > 10
| project State, event_count
| render table
Sortie
| State | event_count |
|---|---|
| PENNSYLVANIA | 1,687 |
| TENNESSEE | 1 125 |