Adicionar recursos e registros a um grupo de atributos

Você pode usar a Amazon SageMaker Feature Store API ou o console para atualizar e descrever seu grupo de recursos, bem como adicionar recursos e registros ao seu grupo de recursos. Um grupo de atributos é um objeto que contém seus dados e um atributo descreve uma coluna na tabela. Ao adicionar um atributo ao grupo de atributos, você está efetivamente adicionando uma coluna à tabela. Ao adicionar um novo registro ao grupo de atributos, você está preenchendo valores para atributos associados a um identificador de registro específico. Para obter mais informações sobre os conceitos do Feature Store, consulte Conceitos do Feature Store.

Depois de adicionar com sucesso os atributos a um grupo de atributos, você não poderá removê-los. Os atributos que você adicionou não adicionam nenhum dado aos seus registros. Você pode adicionar novos registros ao grupo de recursos ou sobrescrevê-los usando o. PutRecordAPI Para obter exemplos sobre como atualizar, descrever e colocar registros em um grupo de atributos, consulte Código de exemplo.

Você pode usar o console para adicionar recursos a um grupo de recursos. Para obter mais informações sobre como atualizar seus grupos de recursos usando o console, consulteAtualizar um grupo de recursos do console.

As seções a seguir fornecem uma visão geral do uso do Feature Store APIs para adicionar recursos a um grupo de recursos, seguida por exemplos. Com oAPI, você também pode adicionar ou substituir registros depois de atualizar o grupo de recursos.

API

Use a operação UpdateFeatureGroup para adicionar atributos a um grupo de atributos.

Você pode usar a operação DescribeFeatureGroup para ver se você adicionou os atributos com sucesso.

Para adicionar ou substituir registros, use a operação PutRecord.

Para ver as atualizações que você fez em um registro, use a operação GetRecord. Para ver as atualizações que você fez em vários registro, use a operação BatchGetRecord. Pode demorar até cinco minutos para que as atualizações que você fez apareçam.

Você pode usar o código de exemplo na seção a seguir para ver como adicionar atributos e registros usando o AWS SDK for Python (Boto3).

Código de exemplo

O código de exemplo orienta você no processo a seguir:

1. Adicionar atributos ao grupo de atributos

2. Verificar se você os adicionou com sucesso

3. Adicionar um registro ao grupo de atributos

4. Verificar se você o adicionou com sucesso

Etapa 1: adicionar atributos a um grupo de atributos

O código a seguir usa a operação UpdateFeatureGroup para adicionar novos atributos ao grupo de atributos. Ele pressupõe que você configurou o Feature Store e criou um grupo de atributos. Para obter mais informações sobre os conceitos básicos, consulte Introdução ao bloco de anotações de exemplo do 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"}
    ]
)              
          

O código a seguir usa a operação DescribeFeatureGroup para verificar o status da atualização. Se o campo LastUpdateStatus for Successful, você adicionou os atributos com sucesso.

sagemaker_client.describe_feature_group(
    FeatureGroupName=feature_group_name
)
          

Etapa 2: adicionar um novo registro ao grupo de atributos

O código a seguir usa a operação PutRecord para adicionar registros ao grupo de atributos que você criou.

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

Use a operação GetRecord para ver quais registros em seu grupo de atributos não têm dados dos atributos que você adicionou. É possível usar a operação PutRecord para substituir os registros que não têm dados para os atributos que você adicionou.