Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Hinzufügen von Features und Datensätzen zu einer Feature-Gruppe
<a name="feature-store-update-feature-group"></a>

Sie können die Amazon SageMaker Feature Store-API oder die Konsole verwenden, um Ihre Feature-Gruppe zu aktualisieren und zu beschreiben sowie Funktionen und Datensätze zu Ihrer Feature-Gruppe hinzuzufügen. Eine Featuregruppe ist ein Objekt, das Ihre Daten enthält, und ein Feature beschreibt eine Spalte in der Tabelle. Wenn Sie der Feature-Gruppe ein Feature hinzufügen, fügen Sie der Tabelle quasi eine Spalte hinzu. Wenn Sie der Feature-Gruppe einen neuen Datensatz hinzufügen, geben Sie Werte für Features ein, die mit einer bestimmten Datensatz-ID verknüpft sind. Weitere Informationen zu Feature-Store-Konzepten finden Sie unter [Feature Store-Konzepte](feature-store-concepts.md). 

Nachdem Sie einer Feature-Gruppe erfolgreich Features hinzugefügt haben, können Sie diese Features nicht mehr entfernen. Die von Ihnen hinzugefügten Funktionen fügen Ihren Datensätzen keine Daten hinzu. Sie können der Feature-Gruppe neue Datensätze hinzufügen oder diese mithilfe der [PutRecord](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html)API überschreiben. Beispiele zum Aktualisieren, Beschreiben und Einfügen von Datensätzen in eine Featuregruppe finden Sie unter [Beispiel-Code](#feature-store-update-feature-group-example).

Sie können die Konsole verwenden, um Features zu einer Feature-Gruppe hinzuzufügen. Weitere Informationen dazu, wie Sie Ihre Feature-Gruppen mit der Konsole aktualisieren, finden Sie unter [Aktualisieren Sie eine Featuregruppe von der Konsole aus](feature-store-use-with-studio.md#feature-store-update-feature-group-studio).

Die folgenden Abschnitte bieten einen Überblick über die Verwendung von Feature Store APIs zum Hinzufügen von Funktionen zu einer Featuregruppe, gefolgt von Beispielen. Mit der API können Sie auch Datensätze hinzufügen oder überschreiben, nachdem Sie die Feature-Gruppe aktualisiert haben. 

**Topics**
+ [API](#feature-store-update-feature-group-api)
+ [Beispiel-Code](#feature-store-update-feature-group-example)

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

Verwenden Sie den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) Vorgang, um Funktionen zu einer Featuregruppe hinzuzufügen.

Sie können den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) Vorgang verwenden, um festzustellen, ob Sie die Funktionen erfolgreich hinzugefügt haben.

Verwenden Sie den [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) Vorgang, um Datensätze hinzuzufügen oder zu überschreiben.

Verwenden Sie den [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) Vorgang, um die Aktualisierungen anzuzeigen, die Sie an einem Datensatz vorgenommen haben. Verwenden Sie den [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) Vorgang, um die Aktualisierungen anzuzeigen, die Sie an mehreren Datensätzen vorgenommen haben. Es kann bis zu fünf Minuten dauern, bis die von Ihnen vorgenommenen Aktualisierungen angezeigt werden.

Sie können den Beispielcode im folgenden Abschnitt verwenden, um das Hinzufügen von Features und Datensätzen mithilfe von AWS SDK für Python (Boto3) zu erläutern.

## Beispiel-Code
<a name="feature-store-update-feature-group-example"></a>

Der Beispielcode führt Sie durch den folgenden Prozess: 

1. Hinzufügen von Features zur Feature-Gruppe

1. Wir überprüfen, ob Sie sie erfolgreich hinzugefügt haben

1. Einen Datensatz zur Featuregruppe hinzufügen

1. Wir überprüfen, ob Sie ihn erfolgreich hinzugefügt haben

### Schritt 1: Hinzufügen von Funktionen zu einer Feature-Gruppe
<a name="feature-store-update-feature-group-step-1"></a>

Der folgende Code verwendet den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html) Vorgang, um der Featuregruppe neue Funktionen hinzuzufügen. Es wird davon ausgegangen, dass Sie den Feature Store eingerichtet und eine Feature-Gruppe erstellt haben. Weitere Informationen zu den ersten Schritten finden Sie unter [Einführung in das Feature Store-Beispiel-Notebook](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"}
    ]
)
```

Der folgende Code verwendet die [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) Operation, um den Status des Updates zu überprüfen. Wenn das [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) Feld ist `Successful`, haben Sie die Funktionen erfolgreich hinzugefügt.

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

### Schritt 2: Hinzufügen eines neuen Datensatzes zur Feature-Gruppe
<a name="feature-store-update-feature-group-step-2"></a>

Der folgende Code verwendet den [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) Vorgang, um der von Ihnen erstellten Featuregruppe Datensätze hinzuzufügen.

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

Verwenden Sie den [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) Vorgang, um festzustellen, welche Datensätze in Ihrer Feature-Gruppe keine Daten für die von Ihnen hinzugefügten Features enthalten. Sie können den [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) Vorgang verwenden, um die Datensätze zu überschreiben, die keine Daten für die von Ihnen hinzugefügten Features enthalten.