As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Adicionar atributos e registros a um grupo de atributos
<a name="feature-store-update-feature-group"></a>

Você pode usar a API da Amazon SageMaker Feature Store 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](feature-store-concepts.md). 

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 a [PutRecord](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html)API. Para obter exemplos sobre como atualizar, descrever e colocar registros em um grupo de atributos, consulte [Código de exemplo](#feature-store-update-feature-group-example).

Você pode usar o console para adicionar atributos a um grupo de atributos. Para obter mais informações sobre como atualizar seus grupos de atributos usando o console, consulte [Atualizar um grupo de atributos pelo console](feature-store-use-with-studio.md#feature-store-update-feature-group-studio).

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 a API, você também pode adicionar ou substituir registros depois de atualizar o grupo de atributos. 

**Topics**
+ [solicitações de](#feature-store-update-feature-group-api)
+ [Código de exemplo](#feature-store-update-feature-group-example)

## solicitações de
<a name="feature-store-update-feature-group-api"></a>

Use a operação [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) para adicionar atributos a um grupo de atributos.

Você pode usar a operação [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) para ver se você adicionou os atributos com sucesso.

Para adicionar ou substituir registros, use a operação [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).

Para ver as atualizações que você fez em um registro, use a operação [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). Para ver as atualizações que você fez em vários registro, use a operação [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). 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 para Python (Boto3).

## Código de exemplo
<a name="feature-store-update-feature-group-example"></a>

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

1. Adicionar atributos ao grupo de atributos

1. Verificar se você os adicionou com sucesso

1. Adicionar um registro ao grupo de atributos

1. Verificar se você o adicionou com sucesso

### Etapa 1: adicionar atributos a um grupo de atributos
<a name="feature-store-update-feature-group-step-1"></a>

O código a seguir usa a operação [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) 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 caderno de exemplo do 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"}
    ]
)
```

O código a seguir usa a operação [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) para verificar o status da atualização. Se o 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) 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
<a name="feature-store-update-feature-group-step-2"></a>

O código a seguir usa a operação [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) 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 [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) 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 [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) para substituir os registros que não têm dados para os atributos que você adicionou.