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

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, lihatKonsep Toko Fitur.

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 PutRecordAPI. Untuk contoh tentang memperbarui, mendeskripsikan, dan menempatkan catatan ke dalam grup fitur, lihatContoh kode.

Anda dapat menggunakan konsol untuk menambahkan fitur ke grup fitur. Untuk informasi selengkapnya tentang cara memperbarui grup fitur menggunakan konsol, lihatMemperbarui grup fitur dari konsol.

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.

API

Gunakan UpdateFeatureGroupoperasi untuk menambahkan fitur ke grup fitur.

Anda dapat menggunakan DescribeFeatureGroupoperasi untuk melihat apakah Anda telah berhasil menambahkan fitur.

Untuk menambah atau menimpa catatan, gunakan PutRecordoperasi.

Untuk melihat pembaruan yang telah Anda buat pada rekaman, gunakan GetRecordoperasi. Untuk melihat pembaruan yang telah Anda buat pada beberapa catatan, gunakan BatchGetRecordoperasi. 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 for Python (Boto3).

Contoh kode

Kode contoh memandu Anda melalui proses berikut:

Langkah 1: Tambahkan fitur ke grup fitur

Kode berikut menggunakan UpdateFeatureGroupoperasi 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, lihatPengantar buku catatan contoh Toko Fitur.

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 DescribeFeatureGroupoperasi untuk memeriksa status pembaruan. Jika LastUpdateStatusbidangnyaSuccessful, Anda telah berhasil menambahkan fitur.

sagemaker_client.describe_feature_group(
    FeatureGroupName=feature_group_name
)
          

Langkah 2: Tambahkan catatan baru ke grup fitur

Kode berikut menggunakan PutRecordoperasi 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 GetRecordoperasi untuk melihat rekaman mana di grup fitur Anda yang tidak memiliki data untuk fitur yang telah Anda tambahkan. Anda dapat menggunakan PutRecordoperasi untuk menimpa catatan yang tidak memiliki data untuk fitur yang telah Anda tambahkan.