Recherche de fonctionnalités dans vos groupes de fonctionnalités

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 dans toutes vos fonctionnalités sans avoir à sélectionner un groupe de fonctionnalités au préalable. La fonctionnalité de recherche permet de trouver les fonctionnalités qui correspondent à 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 and Compte AWS. Pour les groupes de fonctionnalités partagés, les groupes d'entités doivent être accessibles à votre Compte AWS. Pour plus d'instructions sur la manière de partager le catalogue de groupes d'entités et d'autoriser la découvrabilité, consultezPartage de votre catalogue de groupes de fonctionnalités.

Si vous faites partie d'une équipe et que vos collègues recherchent des fonctionnalités à utiliser dans leurs modèles, ils peuvent effectuer une recherche parmi les fonctionnalités de tous les groupes de fonctionnalités.

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.

Vous pouvez rechercher des fonctionnalités à l'aide de la console ou à l'aide de l'SearchAPIopération dans SageMaker. Le tableau suivant répertorie toutes les métadonnées consultables et indique si vous pouvez les rechercher dans la console ou à l'aide duAPI.

Métadonnées d' :	Nom de champ API	Vous pouvez effectuer des recherches 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
Paramètres	Paramètres.key	Oui

Comment rechercher vos fonctionnalités

Les instructions d'utilisation du Feature Store via la console varient selon que vous l'avez activé Amazon SageMaker Studio ou Amazon SageMaker Studio classique que vous l'avez configuré comme expérience par défaut. Choisissez l'une des instructions suivantes en fonction de votre cas d'utilisation.

Rechercher des fonctionnalités si Studio est votre expérience par défaut (console)

1. Ouvrez la console Studio en suivant les instructions figurant dansLancez Amazon SageMaker Studio.

2. Choisissez Data dans le volet de navigation de gauche pour développer la liste déroulante.

3. Dans la liste déroulante, choisissez Feature Store.

4. (Facultatif) Pour consulter vos fonctionnalités, sélectionnez Mon compte. Pour afficher les fonctionnalités partagées, choisissez Cross account.

5. Dans l'onglet Catalogue de fonctionnalités, choisissez Mon compte pour afficher vos groupes de fonctionnalités.

6. Dans l'onglet Catalogue de fonctionnalités, choisissez Compte croisé pour afficher les groupes de fonctionnalités que d'autres personnes vous ont rendus accessibles. Sous Créé par, vous pouvez consulter l'ID de compte du propriétaire de la ressource.

7. Vous pouvez rechercher votre fonctionnalité dans la liste déroulante de recherche :

   • (Facultatif) Pour filtrer votre recherche, cliquez sur l'icône de filtre à 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 fonctionnalités, spécifiez des plages temporelles ou effacez (désélectionnez) les colonnes que vous ne souhaitez pas interroger.

   • Pour les ressources partagées, vous ne pouvez modifier les métadonnées des groupes d'entités ou les définitions d'entités que si vous disposez de l'autorisation d'accès appropriée accordée par le compte du propriétaire de la ressource. L'autorisation de découvrabilité à elle seule ne vous permettra pas de modifier les métadonnées ou les définitions de fonctionnalités. Pour plus d'informations sur l'octroi d'autorisations d'accès, consultezActivation de l'accès intercompte.

Recherchez vos fonctionnalités en utilisant SDK for Python (Boto3)

Le code de cette section utilise l'Searchopération du AWS SDK for 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, consultez la section « Voir également » dans le manuel Amazon SageMaker API Reference.

Pour plus d'exemples et de ressources du Feature Store, consultezRessources Amazon SageMaker Feature Store.

Le code suivant montre différents exemples de requêtes de recherche utilisant 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"
    }
)