View a markdown version of this page

Recherche de groupes de fonctionnalités dans Feature Store - Amazon SageMaker AI
Comment rechercher les groupes de 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 groupes de fonctionnalités dans Feature Store

Avec Amazon SageMaker Feature Store, vous pouvez rechercher les groupes de fonctionnalités à l'aide de la console ou de l'opération de recherche. Vous pouvez utiliser la fonctionnalité de recherche pour trouver des fonctions et des groupes de fonctions pertinents pour les modèles que vous créez. Vous pouvez utiliser la fonctionnalité de recherche pour trouver rapidement les groupes de caractéristiques pertinents pour votre cas d’utilisation.

Note

Les groupes de fonctionnalités que vous recherchez doivent se trouver dans votre AWS compte Région AWS and, ou être partagés avec votre compte et être accessibles à votre Compte AWS compte. Pour plus d’informations 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.

Le tableau suivant présente les champs pouvant faire l’objet d’une recherche et indique si vous pouvez utiliser la console pour rechercher un champ spécifique.

Vous pouvez rechercher des fonctionnalités à l'aide d'Amazon SageMaker Studio Classic ou à Searchl'aide de l' SageMaker API. 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. Les balises sont consultables pour vos propres groupes de fonctionnalités, mais pas pour les groupes de fonctionnalités rendus découvrables pour vous.

Métadonnées d’ : Nom de champ d’API Peut être recherché dans la console ? Recherche possible entre comptes ?
Toutes les balises AllTags Oui Non
Raison de l'échec de la création FailureReason Non Non
Statut de la création FeatureGroupStatus Oui Oui
Heure de création CreationTime Oui Oui
Description Description Oui Oui
Horodatage de l'événement Nom de la fonction EventTimeFeatureName Non Non
Définitions de fonctions FeatureDefinitions Non Non
ARN du groupe de fonctions FeatureGroupARN Non Non
Nom de groupe de fonctions FeatureGroupName Oui Oui
Configuration du magasin hors connexion OfflineStoreConfig Non Non
État du magasin hors connexion OfflineStoreStatus Oui Oui
Statut de la dernière mise à jour LastUpdateStatus Non Non
Nom de la fonction de l'identifiant d'enregistrement RecordIdentifierFeatureName Oui Oui
Étiquettes Balises.key Oui Non

Comment rechercher les groupes de caractéristiques

Vous pouvez utiliser la console ou l'API Amazon SageMaker Feature Store pour trouver vos groupes de fonctionnalités. Les instructions relatives à l’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.

  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 groupes de caractéristiques, choisissez Mon compte. Pour visualiser les groupes de caractéristiques partagés, choisissez Compte croisé.

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

  6. Sous l’onglet Catalogue de groupes 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 vos groupes de caractéristiques 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 rechercher vos groupes de caractéristiques, vous pouvez spécifier des plages de temps, désélectionner les colonnes que vous ne souhaitez pas interroger, choisir les magasins à rechercher ou effectuer une recherche par statut.

    • 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 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 feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
)  

# Search for feature groups that are shared with your account
sagemaker_session.search(
    resource="FeatureGroup",
    search_expression={
        "Filters": [
            {
                "Name": "FeatureGroupName",
                "Value": "MyFeatureGroup",
                "Operator": "Contains",
            }
        ],
        "Operator": "And",
    },
    sort_by="Name",
    sort_order="Ascending",
    next_token="token",
    max_results=50,
    CrossAccountFilterOption="SameAccount"
)

# Search for all feature groups with a name that contains the "ver" substring
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
        ]
    }
)

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

# Search for all feature groups that contains the name "ver"
# AND have a record identifier feature name that contains "wha"
# AND have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ]
    }
)  

# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR feature groups that have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)              


# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR tags with the value 'Sage' for the 'org' key
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'Tags.org', 
                'Operator': 'Contains',
                'Value': 'Sage'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)

# Search for all offline only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'NotEquals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)

# Search for all online only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'NotExists'
            }
        ]
    }
)

# Search for all feature groups that are BOTH online and offline
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)

Vous pouvez également utiliser le SDK Python AWS RAM APIs pour créer un partage de ressources. La signature d'API est donnée ci-dessous. Pour utiliser le SDK Python de l' AWS RAM API, vous devez associer une politique gérée d'accès AWS RAM complet au rôle d'exécution.

response = client.create_resource_share(
    name='string',
    resourceArns=[
        'string',
    ],
    principals=[
        'string',
    ],
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    allowExternalPrincipals=True|False,
    clientToken='string',
    permissionArns=[
        'string',
    ]
)