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.
# Ajout de métadonnées consultables à vos fonctionnalités
Dans Amazon SageMaker Feature Store, vous pouvez effectuer une recherche parmi toutes vos fonctionnalités. Pour rendre vos fonctionnalités plus visibles, vous pouvez y ajouter des métadonnées. Vous pouvez surveiller les types de métadonnées suivantes :
+ Description - description consultable de la fonctionnalité.
+ Paramètres — Paires clé-valeur consultables.
La description peut comporter jusqu'à 255 caractères. Pour les paramètres, vous devez spécifier une paire clé-valeur dans votre recherche. Vous pouvez ajouter jusqu’à 25 paramètres.
Pour mettre à jour les métadonnées d’une caractéristique, vous pouvez utiliser la console ou l’opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html).
## Comment ajouter à vos caractéristiques des métadonnées pouvant faire l’objet d’une recherche
Vous pouvez utiliser la console ou l'API Amazon SageMaker Feature Store pour ajouter des métadonnées consultables à vos fonctionnalités. 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.
### Ajout aux caractéristiques de métadonnées pouvant faire l’objet d’une recherche si Studio est votre expérience par défaut (console)
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. Pour visualiser vos groupes de caractéristiques, sous l’onglet **Catalogue de caractéristiques**, choisissez **Mon compte**.
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 des ressources du groupe de caractéristiques.
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 rechercher vos caractéristiques plus facilement, vous pouvez spécifier des plages de temps ou désélectionner 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. Disposer de 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).
1. Choisissez votre fonctionnalité.
1. Choisissez **Modifier les métadonnées**.
1. Dans le champ **Description**, ajoutez ou mettez à jour la description.
1. Dans le champ **Parameters** (Paramètres) sous **Parameters** (Paramètres), indiquez une paire clé-valeur pour le paramètre.
1. (Facultatif) Choisissez **Add new parameter** (Ajouter un paramètre) pour ajouter un autre paramètre.
1. Choisissez **Save changes** (Enregistrer les modifications).
1. Choisissez **Confirm** (Confirmer).
### Ajout à vos caractéristiques de métadonnées pouvant faire l’objet d’une recherche à l’aide du kit SDK pour Python (Boto3)
Le code de cette section utilise l’opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html) dans le kit AWS SDK pour Python (Boto3) pour ajouter à vos caractéristiques des métadonnées pouvant faire l’objet d’une recherche pour différents scénarios. 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_UpdateFeatureMetadata.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).
------
#### [ Add a list of parameters to a feature ]
Pour ajouter une liste de paramètres à une fonctionnalité, indiquez des valeurs pour les champs suivants :
+ `FeatureGroupName`
+ `Feature`
+ `Parameters`
L'exemple de code suivant utilise le AWS SDK pour Python (Boto3) pour ajouter deux paramètres.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature_group_name",
FeatureName="feature-name",
ParameterAdditions=[
{"Key": "example-key-0", "Value": "example-value-0"},
{"Key": "example-key-1", "Value": "example-value-1"},
]
)
```
------
#### [ Add a description to a feature ]
Pour ajouter une description à une fonctionnalité, indiquez des valeurs pour les champs suivants :
+ `FeatureGroupName`
+ `Feature`
+ `Description`
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature-group-name",
FeatureName="feature-name",
Description="description"
)
```
------
#### [ Remove parameters for a feature ]
Pour supprimer tous les paramètres d'une fonctionnalité, procédez comme suit.
Spécifiez des valeurs pour les champs suivants :
+ `FeatureGroupName`
+ `Feature`
Spécifiez les clés pour les paramètres que vous supprimez sous `ParameterRemovals`.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature_group_name",
FeatureName="feature-name",
ParameterRemovals=[
{"Key": "example-key-0"},
{"Key": "example-key-1"},
]
)
```
------
#### [ Remove the description for a feature ]
Pour supprimer la description d'une fonctionnalité, procédez comme suit.
Spécifiez des valeurs pour les champs suivants :
+ `FeatureGroupName`
+ `Feature`
Spécifiez une chaîne vide pour `Description`.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature-group-name",
FeatureName="feature-name",
Description=""
)
```
------
#### Exemple de code
Après avoir mis à jour les métadonnées d’une caractéristique, vous pouvez utiliser l’opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) pour voir les mises à jour que vous avez apportées.
Le code suivant décrit un exemple de flux de travail à l’aide de AWS SDK pour Python (Boto3). L’exemple de code effectue ce qui suit :
1. Configure votre environnement d' SageMaker IA.
1. Crée un groupe de fonctionnalités
1. Ajoute des fonctionnalités au groupe.
1. Ajoute des métadonnées aux fonctionnalités.
Pour plus d’exemples et de ressources liés à Feature Store, consultez [Ressources Amazon SageMaker Feature Store](feature-store-resources.md).
##### Étape 1 : configuration
Pour commencer à utiliser Feature Store, créez des SageMaker sessions AI, boto3 et Feature Store. Configurez ensuite le compartiment S3 que vous voulez utiliser pour vos fonctionnalités. Ceci est votre magasin hors ligne. Le code suivant utilise le bucket par défaut SageMaker AI et y ajoute un préfixe personnalisé.
**Note**
Le rôle que vous utilisez doit disposer des politiques gérées suivantes associées : `AmazonS3FullAccess` et `AmazonSageMakerFeatureStoreAccess`.
```
# SageMaker Python SDK version 2.x is required
%pip install 'sagemaker>=2.0.0'
import sagemaker
import sys
```
```
import boto3
import pandas as pd
import numpy as np
import io
from sagemaker.session import Session
from sagemaker import get_execution_role
from botocore.exceptions import ClientError
prefix = 'sagemaker-featurestore-introduction'
role = get_execution_role()
sagemaker_session = sagemaker.Session()
region = sagemaker_session.boto_region_name
s3_bucket_name = sagemaker_session.default_bucket()
sagemaker_client = boto_session.client(service_name='sagemaker', region_name=region)
```
##### Étape 2 : Créer un groupe de fonctionnalités et ajouter des fonctionnalités
Le code suivant est un exemple de la création d'un groupe de fonctionnalités avec des définitions de fonctionnalités.
```
feature_group_name = "test-for-feature-metadata"
feature_definitions = [
{"FeatureName": "feature-1", "FeatureType": "String"},
{"FeatureName": "feature-2", "FeatureType": "String"},
{"FeatureName": "feature-3", "FeatureType": "String"},
{"FeatureName": "feature-4", "FeatureType": "String"},
{"FeatureName": "feature-5", "FeatureType": "String"}
]
try:
sagemaker_client.create_feature_group(
FeatureGroupName=feature_group_name,
RecordIdentifierFeatureName="feature-1",
EventTimeFeatureName="feature-2",
FeatureDefinitions=feature_definitions,
OnlineStoreConfig={"EnableOnlineStore": True}
)
except ClientError as e:
if e.response["Error"]["Code"] == "ResourceInUse":
pass
else:
raise e
```
##### Étape 3 : Ajouter des métadonnées
Avant d'ajouter des métadonnées, utilisez l'opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) pour vérifier que l'état du groupe de fonctionnalités est `Created`.
```
sagemaker_client.describe_feature_group(
FeatureGroupName=feature_group_name
)
```
Ajoutez une description à la fonctionnalité.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1",
Description="new description"
)
```
Vous pouvez utiliser l’opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) pour voir si vous avez correctement mis à jour la description du groupe de caractéristiques.
```
sagemaker_client.describe_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1"
)
```
Vous pouvez également l’utiliser pour ajouter des paramètres au groupe de caractéristiques.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1",
ParameterAdditions=[
{"Key": "team", "Value": "featurestore"},
{"Key": "org", "Value": "sagemaker"},
]
)
```
Vous pouvez utiliser l’opération [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) pour vérifier si vous avez ajouté les paramètres avec succès.
```
sagemaker_client.describe_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1"
)
```