Filtrage des résultats de recherche de ressources
Appliquez des filtres pour restreindre la liste des résultats de ressource en fonction de divers attributs de ressource.
La façon dont vous filtrez les résultats d'une recherche de ressources dépend du mode utilisé pour rechercher les résultats.
- Utiliser la zone de recherche dans la page
- Utiliser les en-têtes de colonne dans la liste des résultats
Cette rubrique décrit comment utiliser la zone de recherche dans la page pour accéder aux filtres, mais les filtres dans les en-têtes de colonne de la liste de résultats se comportent de la même manière, si vous en avez.
Le mode d'interrogation avancé prend en charge le filtrage et le tri des ressources au moyen de la syntaxe du langage d'interrogation. Vous filtrez efficacement les résultats en ajoutant ou en supprimant des clauses ou en modifiant le contenu des clauses. La seule interrogation que vous pouvez effectuer qui ne filtre pas les résultats est une interrogation pour tout. Le seul filtre qui existe dans la console elle-même pour les résultats retournés par une interrogation est le filtre de région. Le langage d'interrogation ne prend pas en charge la spécification d'une région dans laquelle rechercher des résultats.
- Par défaut, si vous avez plusieurs chaînes avec des espaces entre elles dans une recherche en texte libre ou en mode de recherche de base, la console recherche les ressources contenant toutes les chaînes de recherche. La recherche n'essaie pas de trouver des ressources contenant toutes les chaînes de recherche. Pour plus d'informations sur les recherches en texte libre, voir Recherche en texte libre.
- En mode de base, vous pouvez utiliser la zone de recherche dans la page lorsque vous utilisez une liste de résultats de recherche pour appliquer des filtres aux résultats. Si disponible, vous pouvez également utiliser les filtres dans les en-têtes de colonne.
- Certains filtres incluent toutes les valeurs d'attribut possibles par défaut. À savoir, le filtre de compartiment inclut tous les compartiments dans la recherche jusqu'à ce que vous indiquiez les compartiments à supprimer du filtre. Pendant ce temps, les autres filtres ne correspondent à aucune valeur d'attribut par défaut.
- Vous pouvez effacer les filtres. Pour plus d'informations, voir Effacement des filtres de recherche de ressource.
- Vous pouvez modifier les filtres. Pour plus d'informations, voir Modification des filtres de recherche de ressources.
- Vous pouvez trier les résultats. Pour plus d'informations, voir Tri des résultats de recherche de ressources.
Ces étapes supposent que vous avez déjà effectué une recherche en texte libre et sélectionné la catégorie de résultats Ressources conformément aux instructions sous Exécution d'une recherche en texte libre.
- Dans la page Ressources, sélectionnez la zone de recherche, puis entrez ou sélectionnez un type de ressource ou un attribut de ressource à inclure dans les résultats de recherche filtrés. (Les attributs disponibles dépendent des types de ressource dans la liste des résultats.)
-
Procédez ensuite de l'une des façons suivantes :
- Si vous avez sélectionné un filtre qui fournit des options prédéfinies, sélectionnez l'option dans un menu ou en cochant une ou plusieurs cases.
- Si vous avez sélectionné un filtre dans lequel vous devez spécifier la valeur de l'attribut de ressource auquel comparer les résultats de recherche potentiels, sélectionnez la zone de filtre et entrez une valeur appropriée. (Note : Les filtres pour lesquels vous pouvez entrer une valeur personnalisée nécessitent d'entrer au moins trois caractères avant d'appliquer le filtre.)
- Si vous avez sélectionné le filtre Nom d'affichage ou OCID, vous ne pouvez entrer qu'une seule valeur à la fois pour l'un ou l'autre des filtres.
- Si vous avez sélectionné le filtre Marqueur, sélectionnez d'abord le type de marqueur dans les options du menu. Indiquez ensuite la ou les valeurs que vous souhaitez que le filtre corresponde. Enfin, indiquez si vous souhaitez correspondre à une valeur ou spécifier les valeurs correspondantes. (Les informations de la console peuvent être affichées dans un ordre différent de celui présenté dans cette rubrique.)
- Si vous avez sélectionné un filtre basé sur le temps, spécifiez la date de début, l'heure de début, la date de fin et l'heure de fin.
- Lorsque vous êtes prêt, sélectionnez Appliquer le filtre.
- (Facultatif) Pour ajouter un autre filtre, répétez les étapes précédentes.
Utilisez la commande oci search resource struct-search et les paramètres requis pour appliquer des filtres lors de la recherche de ressources :
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface. Pour plus d'informations sur la syntaxe des interrogations, voir Syntaxe du langage de recherche.
Exécutez l'opération SearchResources pour utiliser le langage SQL pour filtrer les ressources.
Exemple : Recherche de tous les attributs de ressource d'un type de ressource qui contiennent une chaîne spécifiqueCette section décrit comment utiliser l'API pour interroger tous les champs indexés d'un type de ressource particulier pour les correspondances avec une chaîne spécifique.
L'interrogation suivante recherche les utilisateurs avec tous les attributs qui contiennent "doe".
query user resources matching 'doe'Lorsque vous utilisez l'opération SearchResources pour exécuter une interrogation, la demande ressemble à ce qui suit. (L'en-tête d'autorisation et les autres en-têtes sont volontairement omis dans cet exemple.)
POST /20180409/resources Host: query.us-phoenix-1.oraclecloud.com <authorization and other headers> { "type": "Structured", "query": "query user resources matching 'doe'", "matchingContextType": "HIGHLIGHTS" }Si l'interrogation produit des résultats, la réponse liste les ressources correspondant au type de ressource et au marqueur que vous avez indiqués. La réponse a l'aspect suivant :
{ "items" : [ { "resourceType" : "User", "identifier" : "ocid1.user.oc1..examplea26nj4iqy2mbfauxovw5viuyblsbdn3p6cvbdmbrjtalxgjqdnemq", "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq", "timeCreated" : "2020-12-10T14:41:02.185Z", "displayName" : "janedoe", "availabilityDomain" : "ABCd:PHX-AD-3", "lifecycleState" : "ACTIVE", "freeformTags" : { }, "definedTags" : { }, "systemTags" : { }, "searchContext" : { "highlights" : { "displayName" : [ "<hl>janedoe</hl>" ], "name" : [ "<hl>janejdoe</hl>" ], "description" : [ "Jane <hl>Doe</hl> - <hl>jane.doe</hl>@example.com" ] } }, "identityContext" : { }, "additionalDetails" : { } }, { "resourceType" : "User", "identifier" : "ocid1.user.oc1..examplea27jaoic76zube2d6faux5hch5fsj36qetod474g57cvbhguoegfa", "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq", "timeCreated" : "2022-09-22T15:14:44.285Z", "displayName" : "sdoerner", "availabilityDomain" : "ABCd:PHX-AD-3", "lifecycleState" : "ACTIVE", "freeformTags" : { }, "definedTags" : { }, "systemTags" : { }, "searchContext" : { "highlights" : { "displayName" : [ "<hl>sdoerner</hl>" ], "name" : [ "<hl>sdoerner</hl>" ], "description" : [ "Scott <hl>Doerner</hl> - <hl>scott.doerner</hl>@example.com" ] } }, "identityContext" : { }, "additionalDetails" : { } }, { "resourceType" : "User", "identifier" : "ocid1.user.oc1..examplea2agbfauxqj57pwe2txjdc6mjdkcncdt5m5bmcvbbzznxzscixd7a", "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq", "timeCreated" : "2020-09-11T22:00:26.311Z", "displayName" : "patdoerr", "availabilityDomain" : "ABCd:PHX-AD-2", "lifecycleState" : "ACTIVE", "freeformTags" : { }, "definedTags" : { }, "systemTags" : { }, "searchContext" : { "highlights" : { "displayName" : [ "<hl>patdoerr</hl>" ], "name" : [ "<hl>patdoerr</hl>" ], "description" : [ "Pat <hl>Doerr</hl> - <hl>pat.doerr</hl>@example.com" ] } }, "identityContext" : { }, "additionalDetails" : { } } ] }À partir de ces résultats, vous pouvez effectuer plus d'actions, au besoin. Pour plus d'informations sur un type de ressource, notamment sur ses attributs, voir la page des informations de référence sur le type de ressource désiré dans le guide de référence sur l'API. Pour les pages d'informations de référence sur les types de ressource qui ont été indexés pour la recherche, voir Ressources prises en charge.