Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Adición de características y registros a un grupo de características
<a name="feature-store-update-feature-group"></a>

Puedes usar la API de Amazon SageMaker Feature Store o la consola para actualizar y describir tu grupo de características, así como para añadir características y registros a tu grupo de características. Un grupo de características es un objeto que contiene sus datos y una característica describe una columna de la tabla. Al agregar una característica al grupo de características, en efecto, se añade una columna a la tabla. Al agregar un registro nuevo al grupo de características, repone los valores de las características asociadas a un identificador de registro concreto. Para obtener más información sobre los conceptos del almacén de características, consulte [Conceptos del almacén de características](feature-store-concepts.md). 

Una vez que haya agregado correctamente las características a un grupo de características, no podrá eliminarlas. Las características que haya agregado no añaden ningún dato a sus registros. Puedes añadir nuevos registros al grupo de características o sobrescribirlos mediante la [PutRecord](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html)API. Para ver ejemplos sobre cómo actualizar, describir y colocar registros en un grupo de características, consulte [Código de ejemplo](#feature-store-update-feature-group-example).

Puede utilizar la consola para añadir características a un grupo de características. Para obtener más información sobre cómo actualizar los grupos de características con la consola, consulte [Actualización de un grupo de características desde la consola](feature-store-use-with-studio.md#feature-store-update-feature-group-studio).

En las siguientes secciones se proporciona una descripción general del uso del Feature Store APIs para añadir entidades a un grupo de entidades, seguida de ejemplos. Con la API, también puede agregar o sobrescribir registros después de actualizar el grupo de características. 

**Topics**
+ [API](#feature-store-update-feature-group-api)
+ [Código de ejemplo](#feature-store-update-feature-group-example)

## API
<a name="feature-store-update-feature-group-api"></a>

Utilice la operación [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) o para agregar características a un grupo de características.

Puede usar la operación [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) para comprobar si ha agregado las características correctamente.

Para agregar o sobrescribir registros, utilice la operación [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 las actualizaciones que ha realizado en un registro, utilice la operación [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 las actualizaciones que ha realizado en varios registros, utilice la operación [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). Pueden pasar hasta cinco minutos hasta que aparezcan las actualizaciones que ha realizado.

Puede usar el código de ejemplo de la siguiente sección para ver cómo agregar características y registros mediante el AWS SDK para Python (Boto3).

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

El código de ejemplo le guiará por el siguiente proceso: 

1. Agregar características al grupo de características

1. Verificar que las haya agregado correctamente

1. Agregar un registro al grupo de características

1. Verificar que lo haya agregado correctamente

### Paso 1: Agregar características y registros a un grupo de características
<a name="feature-store-update-feature-group-step-1"></a>

El código siguiente utiliza la operación [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) para agregar nuevas características al grupo de características. Se supone que ha configurado el almacén de características y ha creado un grupo de características. Si necesita más información sobre cómo comenzar, consulte [Introducción al cuaderno de ejemplo del almacén de características](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"}
    ]
)
```

El código siguiente utiliza la operación [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) para comprobar el estado de la actualización. Si el 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) es `Successful`, significa que ha agregado las características correctamente.

```
sagemaker_client.describe_feature_group(
    FeatureGroupName=feature_group_name
)
```

### Paso 2: Agregar un registro nuevo al grupo de características
<a name="feature-store-update-feature-group-step-2"></a>

El siguiente código utiliza la operación [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 agregar registros al grupo de características que ha creado.

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

Utilice la operación [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 qué registros de su grupo de características no tienen datos de las características que ha agregado. Puede usar la operación [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 sobrescribir los registros que no contienen datos de las características que ha agregado.