Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Aggiungere funzionalità e record a un gruppo di funzionalità Puoi utilizzare l'API Amazon SageMaker Feature Store o la console per aggiornare e descrivere il tuo gruppo di funzionalità, nonché aggiungere funzionalità e record al tuo gruppo di funzionalità. Un gruppo di funzionalità è un oggetto che contiene i tuoi dati e una funzionalità descrive una colonna nella tabella. Quando si aggiunge una funzionalità al gruppo di funzionalità, si aggiunge effettivamente una colonna alla tabella. Quando si aggiunge un nuovo record al gruppo di funzionalità, si inseriscono i valori per le funzionalità associate a un identificatore di record specifico. Per ulteriori informazioni sui concetti dell'archivio funzionalità, consulta [Concetti di base sul Feature Store](feature-store-concepts.md). Dopo aver aggiunto correttamente delle funzionalità a un gruppo di funzionalità, non è possibile rimuoverle. Le funzionalità che hai aggiunto non aggiungono dati ai record. Puoi aggiungere nuovi record al gruppo di funzionalità o sovrascriverli utilizzando l'[PutRecord](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html)API. Per esempi sull'aggiornamento, la descrizione e l'inserimento di record in un gruppo di funzionalità, consulta [Codice di esempio](#feature-store-update-feature-group-example). Puoi utilizzare la console per aggiungere funzionalità a un gruppo di funzionalità. Per ulteriori informazioni su come aggiornare i gruppi di funzionalità con la console, consulta [Aggiornamento di un gruppo di funzionalità dalla console](feature-store-use-with-studio.md#feature-store-update-feature-group-studio). Le seguenti sezioni forniscono una panoramica sull'utilizzo del Feature Store APIs per aggiungere funzionalità a un gruppo di funzionalità seguita da esempi. Con l'API, è possibile anche aggiungere o sovrascrivere record dopo aver aggiornato il gruppo di funzionalità. **Topics** + [ ## "Hello, World\$1" ](#feature-store-update-feature-group-api) + [ ## Codice di esempio ](#feature-store-update-feature-group-example) ## "Hello, World\$1" Usa l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) per aggiungere funzionalità a un gruppo di funzionalità. È possibile utilizzare l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) per verificare se le funzionalità sono state aggiunte correttamente. Per aggiungere o sovrascrivere i record, usa l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html). Per vedere gli aggiornamenti che hai apportato a un record, usa l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_GetRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_GetRecord.html). Per vedere gli aggiornamenti che hai apportato a più record, usa l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_BatchGetRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_BatchGetRecord.html). Possono essere necessari fino a cinque minuti prima che gli aggiornamenti apportati vengano visualizzati. Puoi utilizzare il codice di esempio nella sezione seguente per vedere come aggiungere funzionalità e record utilizzando AWS SDK per Python (Boto3). ## Codice di esempio Il codice di esempio ti guida attraverso il seguente processo: 1. Aggiunta di funzionalità al gruppo di funzionalità 1. Verifica di averle aggiunte correttamente 1. Aggiunta di un record al gruppo di funzionalità 1. Verifica di averlo aggiunto correttamente ### Fase 1: aggiungere funzionalità e record a un gruppo di funzionalità Il codice seguente utilizza l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) per aggiungere nuove funzionalità al gruppo di funzionalità. Si presuppone che tu abbia configurato l'archivio funzionalità e creato un gruppo di funzionalità. Per ulteriori informazioni sulle nozioni di base, consulta [Introduzione al notebook di esempio Feature Store](feature-store-introduction-notebook.md). ``` import boto3 sagemaker_client = boto3.client("sagemaker") sagemaker_client.update_feature_group( FeatureGroupName=feature_group_name, FeatureAdditions=[ {"FeatureName": "new-feature-1", "FeatureType": "Integral"}, {"FeatureName": "new-feature-2", "FeatureType": "Fractional"}, {"FeatureName": "new-feature-3", "FeatureType": "String"} ] ) ``` Il codice seguente utilizza l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) per verificare lo stato dell'aggiornamento. Se il campo [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html#sagemaker-DescribeFeatureGroup-response-LastUpdateStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html#sagemaker-DescribeFeatureGroup-response-LastUpdateStatus) è `Successful`, le funzionalità sono state aggiunte correttamente. ``` sagemaker_client.describe_feature_group( FeatureGroupName=feature_group_name ) ``` ### Fase 2: aggiungere un nuovo record al gruppo di funzionalità Il codice seguente utilizza l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html) per aggiungere record al gruppo di funzionalità che hai creato. ``` record_identifier_value = 'new_record' sagemaker_featurestore_runtime_client = boto3.client("sagemaker-featurestore-runtime") sagemaker_runtime_client.put_record( FeatureGroupName=feature_group_name, Record=[ { 'FeatureName': "record-identifier-feature-name", 'ValueAsString': record_identifier_value }, { 'FeatureName': "event-time-feature", 'ValueAsString': "timestamp-that-feature-store-returns" }, { 'FeatureName': "new-feature-1", 'ValueAsString': "value-as-string" }, { 'FeatureName': "new-feature-2", 'ValueAsString': "value-as-string" }, { 'FeatureName': "new-feature-3", 'ValueAsString': "value-as-string" }, ] ) ``` Usa l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_GetRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_GetRecord.html) per vedere quali record del tuo gruppo di funzionalità non contengono dati per le funzionalità che hai aggiunto. Puoi utilizzare l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html) per sovrascrivere i record che non contengono dati per le funzionalità che hai aggiunto.