Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Recherche de fonctionnalités dans vos groupes de fonctionnalités
<a name="feature-store-search-metadata"></a>

Avec Amazon SageMaker Feature Store, vous pouvez rechercher les fonctionnalités que vous avez créées dans vos groupes de fonctionnalités. Vous pouvez effectuer une recherche parmi toutes vos caractéristiques sans avoir à sélectionner un groupe de caractéristiques au préalable. La fonctionnalité de recherche aide à trouver les caractéristiques pertinentes pour votre cas d’utilisation.

**Note**  
Les groupes de fonctionnalités dans lesquels vous recherchez des fonctionnalités doivent se trouver dans votre Région AWS et Compte AWS. Pour les groupes de caractéristiques partagés, les groupes de caractéristiques doivent être rendus découvrables par votre Compte AWS. Pour plus d’instructions sur la manière de partager le catalogue de groupes de caractéristiques et d’autoriser la découvrabilité, consultez [Partage de votre catalogue de groupes de fonctionnalités](feature-store-cross-account-discoverability-share-feature-group-catalog.md).

Si vous faites partie d’une équipe et que vos coéquipiers recherchent des caractéristiques à utiliser dans leurs modèles, ils peuvent rechercher les caractéristiques dans tous les groupes de caractéristiques.

Vous pouvez ajouter des paramètres et des descriptions interrogeables pour rendre vos fonctionnalités plus visibles. Pour de plus amples informations, veuillez consulter [Ajout de métadonnées consultables à vos fonctionnalités](feature-store-add-metadata.md).

Vous pouvez rechercher des fonctionnalités à l'aide de la console ou à l'aide de l'opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)API dans SageMaker AI. Le tableau suivant répertorie toutes les métadonnées pouvant faire l’objet d’une recherche et indique si vous pouvez les rechercher dans la console ou avec l’API.


****  

| Métadonnées d’ : | Nom de champ d’API | Peut être recherché dans la console ? | 
| --- | --- | --- | 
| Tous les paramètres | AllParameters | Oui | 
| Heure de création | CreationTime | Oui | 
| Description | Description | Oui | 
| Nom de groupe de fonctionnalités | FeatureGroupName | Non | 
| Nom de la fonctionnalité | FeatureName | Oui | 
| Type de fonction | FeatureType | Non | 
| Heure de la dernière modification | LastModifiedTime | Non | 
| Parameters | Paramètres. {{key}} | Oui | 

## Comment rechercher vos caractéristiques
<a name="feature-store-search-metadata-how-to"></a>

Les instructions d’utilisation de Feature Store via la console varient selon que vous avez activé [Amazon SageMaker Studio](studio-updated.md) ou [Amazon SageMaker Studio classique](studio.md) comme expérience par défaut. Choisissez l’une des procédures ci-dessous en fonction de votre cas d’utilisation.

### Recherche de caractéristiques si Studio est votre expérience par défaut (console)
<a name="feature-store-search-metadata-how-to-with-studio-updated"></a>

1. Ouvrez la console Studio en suivant les instructions figurant dans [Lancez Amazon SageMaker Studio](studio-updated-launch.md).

1. Choisissez **Données** dans le volet de navigation de gauche pour développer la liste déroulante.

1. Dans la liste déroulante, choisissez **Feature Store**.

1. (Facultatif) Pour visualiser vos caractéristiques, choisissez **Mon compte**. Pour visualiser les caractéristiques partagées, choisissez **Compte croisé**.

1. Sous l’onglet **Catalogue de caractéristiques**, choisissez **Mon compte** pour visualiser vos groupes de caractéristiques.

1. Sous l’onglet **Catalogue de caractéristiques**, choisissez **Compte croisé** pour visualiser les groupes de caractéristiques que d’autres ont rendus découvrables pour vous. Sous **Créé par**, vous pouvez visualiser l’ID de compte propriétaire de la ressource.

1. Vous pouvez rechercher votre caractéristique dans la liste déroulante **Rechercher** :
   + (Facultatif) Pour filtrer votre recherche, choisissez l’icône de filtre située à côté de la liste déroulante **Rechercher**. Vous pouvez utiliser des filtres pour spécifier des paramètres ou des plages de dates dans vos résultats de recherche. Si vous recherchez un paramètre, spécifiez à la fois sa clé et sa valeur. Pour trouver vos caractéristiques, spécifiez des plages de temps ou désélectionnez les colonnes que vous ne souhaitez pas interroger.
   + Pour des ressources partagées, vous pouvez modifier les métadonnées des groupes de caractéristiques ou les définitions de caractéristiques seulement si vous disposez de l’autorisation d’accès appropriée accordée à partir du compte propriétaire des ressources. La seule autorisation de découvrabilité ne vous permet pas de modifier les métadonnées ni les définitions de caractéristiques. Pour plus d’informations sur la façon d’accorder des autorisations d’accès, consultez [Activation de l’accès intercompte](feature-store-cross-account-access.md).

### Recherche de vos caractéristiques à l’aide du kit SDK pour Python (Boto3)
<a name="feature-store-search-metadata-how-to-with-sdk"></a>

Le code de cette section utilise l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)opération décrite dans le AWS SDK pour Python (Boto3) pour exécuter la requête de recherche afin de trouver des entités dans vos groupes de fonctionnalités. Pour plus d'informations sur les autres langues dans lesquelles envoyer une requête, [voir également](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html#API_Search_SeeAlso) dans le manuel *Amazon SageMaker API Reference*.

Pour plus d’exemples et de ressources liés à Feature Store, consultez [Ressources Amazon SageMaker Feature Store](feature-store-resources.md).

Le code suivant présente différents exemples de requêtes de recherche utilisant l’API :

```
# Return all features in your feature groups
sagemaker_client.search(
    Resource="FeatureMetadata",
)  

# Search for all features that belong to a feature group that contain the "ver" substring
sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
        ]
    }
)

# Search for all features that belong to a feature group that have the EXACT name "airport"
sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Equals',
                'Value': 'airport'
            },
        ]
    }
)

# Search for all features that belong to a feature group that contains the name "ver"
AND have a name that contains "wha"
AND have a parameter (key or value) that contains "hea"

sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'FeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllParameters', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ]
    }
)  

# Search for all features that belong to a feature group with substring "ver" in its name
OR features that have a name that contain "wha"
OR features that have a parameter (key or value) that contains "hea"

sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'FeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllParameters', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)              


# Search for all features that belong to a feature group with substring "ver" in its name
OR features that have a name that contain "wha"
OR parameters with the value 'Sage' for the 'org' key

sagemaker_client.search(
    Resource="FeatureMetadata",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'FeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'Parameters.org', 
                'Operator': 'Contains',
                'Value': 'Sage'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)
```