View a markdown version of this page

Recherche de fonctionnalités dans vos groupes de fonctionnalités - Amazon SageMaker AI
Comment rechercher vos caractéristiques

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

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.

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.

Vous pouvez rechercher des fonctionnalités à l'aide de la console ou à l'aide de l'opération SearchAPI 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

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

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

  2. Choisissez Données 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 visualiser vos caractéristiques, choisissez Mon compte. Pour visualiser les caractéristiques partagées, choisissez Compte croisé.

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

  6. 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.

  7. 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.

Le code de cette section utilise l'Searchopé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 dans le manuel Amazon SageMaker API Reference.

Pour plus d’exemples et de ressources liés à Feature Store, consultez Ressources Amazon SageMaker Feature Store.

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"
    }
)