Aggiungere funzionalità e record a un gruppo di funzionalità

Puoi utilizzare Amazon SageMaker Feature Store API 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.

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. PutRecordAPI Per esempi sull'aggiornamento, la descrizione e l'inserimento di record in un gruppo di funzionalità, consulta Codice di esempio.

È possibile utilizzare la console per aggiungere funzionalità a un gruppo di funzionalità. Per ulteriori informazioni su come aggiornare i gruppi di funzionalità utilizzando la console, consultaAggiorna un gruppo di funzionalità dalla console.

Le seguenti sezioni forniscono una panoramica sull'utilizzo del Feature Store APIs per aggiungere funzionalità a un gruppo di funzionalità seguita da esempi. ConAPI, puoi anche aggiungere o sovrascrivere record dopo aver aggiornato il gruppo di funzionalità.

API

Usa l'operazione UpdateFeatureGroup per aggiungere funzionalità a un gruppo di funzionalità.

È possibile utilizzare l'operazione DescribeFeatureGroup per verificare se le funzionalità sono state aggiunte correttamente.

Per aggiungere o sovrascrivere i record, usa l'operazione PutRecord.

Per vedere gli aggiornamenti che hai apportato a un record, usa l'operazione GetRecord. Per vedere gli aggiornamenti che hai apportato a più record, usa l'operazione BatchGetRecord. 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 for Python (Boto3).

Codice di esempio

Il codice di esempio ti guida attraverso il seguente processo:

1. Aggiunta di funzionalità al gruppo di funzionalità

2. Verifica di averle aggiunte correttamente

3. Aggiunta di un record al gruppo di funzionalità

4. Verifica di averlo aggiunto correttamente

Fase 1: aggiungere funzionalità e record a un gruppo di funzionalità

Il codice seguente utilizza l'operazione UpdateFeatureGroup 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.

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 DescribeFeatureGroup per verificare lo stato dell'aggiornamento. Se il campo 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 PutRecord 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 GetRecord per vedere quali record del tuo gruppo di funzionalità non contengono dati per le funzionalità che hai aggiunto. Puoi utilizzare l'operazione PutRecord per sovrascrivere i record che non contengono dati per le funzionalità che hai aggiunto.