Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menambahkan fitur dan catatan ke grup fitur
<a name="feature-store-update-feature-group"></a>

Anda dapat menggunakan Amazon SageMaker Feature Store API atau konsol untuk memperbarui dan mendeskripsikan grup fitur serta menambahkan fitur dan catatan ke grup fitur Anda. Grup fitur adalah objek yang berisi data Anda dan fitur menjelaskan kolom dalam tabel. Saat Anda menambahkan fitur ke grup fitur, Anda secara efektif menambahkan kolom ke tabel. Saat Anda menambahkan catatan baru ke grup fitur, Anda mengisi nilai untuk fitur yang terkait dengan pengenal rekaman tertentu. Untuk informasi selengkapnya tentang konsep Toko Fitur, lihat[Konsep Toko Fitur](feature-store-concepts.md). 

Setelah berhasil menambahkan fitur ke grup fitur, Anda tidak dapat menghapus fitur tersebut. Fitur yang telah Anda tambahkan tidak menambahkan data apa pun ke catatan Anda. Anda dapat menambahkan catatan baru ke grup fitur atau menimpa mereka menggunakan [PutRecord](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_PutRecord.html)API. Untuk contoh tentang memperbarui, mendeskripsikan, dan menempatkan catatan ke dalam grup fitur, lihat[Contoh kode](#feature-store-update-feature-group-example).

Anda dapat menggunakan konsol untuk menambahkan fitur ke grup fitur. Untuk informasi selengkapnya tentang cara memperbarui grup fitur menggunakan konsol, lihat[Memperbarui grup fitur dari konsol](feature-store-use-with-studio.md#feature-store-update-feature-group-studio).

Bagian berikut memberikan ikhtisar penggunaan Feature Store APIs untuk menambahkan fitur ke grup fitur diikuti dengan contoh. Dengan API, Anda juga dapat menambahkan atau menimpa catatan setelah memperbarui grup fitur. 

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

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

Gunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html)operasi untuk menambahkan fitur ke grup fitur.

Anda dapat menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html)operasi untuk melihat apakah Anda telah berhasil menambahkan fitur.

Untuk menambah atau menimpa catatan, gunakan [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)operasi.

Untuk melihat pembaruan yang telah Anda buat pada rekaman, gunakan [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)operasi. Untuk melihat pembaruan yang telah Anda buat pada beberapa catatan, gunakan [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)operasi. Diperlukan waktu hingga lima menit agar pembaruan yang Anda buat muncul.

Anda dapat menggunakan kode contoh di bagian berikut untuk menelusuri penambahan fitur dan catatan menggunakan AWS SDK untuk Python (Boto3).

## Contoh kode
<a name="feature-store-update-feature-group-example"></a>

Kode contoh memandu Anda melalui proses berikut: 

1. Menambahkan fitur ke grup fitur

1. Memverifikasi bahwa Anda telah berhasil menambahkannya

1. Menambahkan catatan ke grup fitur

1. Memverifikasi bahwa Anda telah menambahkannya dengan sukses

### Langkah 1: Tambahkan fitur ke grup fitur
<a name="feature-store-update-feature-group-step-1"></a>

Kode berikut menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureGroup.html)operasi untuk menambahkan fitur baru ke grup fitur. Ini mengasumsikan bahwa Anda telah menyiapkan Feature Store dan membuat grup fitur. Untuk informasi lebih lanjut tentang memulai, lihat[Pengantar buku catatan contoh Toko Fitur](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"}
    ]
)
```

Kode berikut menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html)operasi untuk memeriksa status pembaruan. Jika [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)bidangnya`Successful`, Anda telah berhasil menambahkan fitur.

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

### Langkah 2: Tambahkan catatan baru ke grup fitur
<a name="feature-store-update-feature-group-step-2"></a>

Kode berikut menggunakan [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)operasi untuk menambahkan catatan ke grup fitur yang telah Anda buat.

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

Gunakan [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)operasi untuk melihat rekaman mana di grup fitur Anda yang tidak memiliki data untuk fitur yang telah Anda tambahkan. Anda dapat menggunakan [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)operasi untuk menimpa catatan yang tidak memiliki data untuk fitur yang telah Anda tambahkan.