Menambahkan metadata yang dapat dicari ke fitur Anda - Amazon SageMaker
Cara menambahkan metadata yang dapat dicari ke fitur Anda

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

Menambahkan metadata yang dapat dicari ke fitur Anda

Di Amazon SageMaker Feature Store, Anda dapat mencari melalui semua fitur Anda. Untuk membuat fitur Anda lebih mudah ditemukan, Anda dapat menambahkan metadata ke dalamnya. Anda dapat menambahkan jenis metadata berikut:

  • Deskripsi — Deskripsi fitur yang dapat dicari.

  • Parameter — Pasangan kunci-nilai yang dapat dicari.

Deskripsi dapat memiliki hingga 255 karakter. Untuk parameter, Anda harus menentukan pasangan kunci-nilai dalam pencarian Anda. Anda dapat menambahkan hingga 25 parameter.

Untuk memperbarui metadata fitur, Anda dapat menggunakan konsol atau operasi. UpdateFeatureMetadata

Cara menambahkan metadata yang dapat dicari ke fitur Anda

Anda dapat menggunakan konsol atau Amazon SageMaker Feature Store API untuk menambahkan metadata yang dapat dicari ke fitur Anda. Petunjuk untuk menggunakan Feature Store melalui konsol bergantung pada apakah Anda telah mengaktifkan SageMaker Studio Amazon atau Amazon SageMaker Studio Klasik sebagai pengalaman default Anda.

  1. Buka konsol Studio dengan mengikuti petunjuk diLuncurkan Amazon SageMaker Studio.

  2. Pilih Data di panel navigasi kiri, untuk memperluas daftar dropdown.

  3. Dari daftar dropdown, pilih Feature Store.

  4. (Opsional) Untuk melihat fitur Anda, pilih Akun saya. Untuk melihat fitur bersama, pilih Cross account.

  5. Untuk melihat grup fitur Anda, di bawah tab Katalog Fitur, pilih Akun saya.

  6. Di bawah tab Katalog Fitur, pilih Lintas akun untuk melihat grup fitur yang orang lain buat dapat ditemukan oleh Anda. Di bawah Dibuat oleh, Anda dapat melihat ID akun pemilik sumber daya dari grup fitur.

  7. Anda dapat mencari fitur Anda di daftar dropdown Penelusuran.

    • (Opsional) Untuk memfilter pencarian Anda, pilih ikon filter di sebelah daftar dropdown Pencarian. Anda dapat menggunakan filter untuk menentukan parameter atau rentang tanggal dalam hasil pencarian Anda. Jika Anda mencari parameter, tentukan kunci dan nilainya. Untuk menemukan fitur Anda dengan lebih mudah, Anda dapat menentukan rentang waktu atau membatalkan pilihan kolom yang tidak ingin Anda kueri.

    • Untuk sumber daya bersama, Anda hanya dapat mengedit metadata grup fitur atau definisi fitur jika Anda memiliki izin akses yang tepat yang diberikan dari akun pemilik sumber daya. Memiliki izin untuk dapat ditemukan saja tidak memungkinkan Anda untuk mengedit metadata atau definisi fitur. Untuk informasi selengkapnya tentang pemberian izin akses, lihat. Mengaktifkan akses lintas akun

  8. Pilih fitur Anda.

  9. Pilih Edit metadata.

  10. Di bidang Deskripsi, tambahkan atau perbarui deskripsi.

  11. Di bidang Parameter di bawah Parameter, tentukan pasangan kunci-nilai untuk parameter.

  12. (Opsional) Pilih Tambahkan parameter baru untuk menambahkan parameter lain.

  13. Pilih Simpan perubahan.

  14. Pilih Konfirmasi.

Kode di bagian ini menggunakan UpdateFeatureMetadataoperasi di AWS SDK for Python (Boto3) untuk menambahkan metadata yang dapat dicari ke fitur Anda untuk skenario yang berbeda. Untuk informasi tentang bahasa lain untuk mengirimkan kueri, lihat Lihat Juga di SageMaker APIReferensi Amazon.

Untuk contoh dan sumber daya Toko Fitur lainnya, lihatSumber daya Toko SageMaker Fitur Amazon.

Add a list of parameters to a feature

Untuk menambahkan daftar parameter ke fitur, tentukan nilai untuk bidang berikut:

  • FeatureGroupName

  • Feature

  • Parameters

Contoh kode berikut menggunakan AWS SDK for Python (Boto3) untuk menambahkan dua parameter.


sagemaker_client.update_feature_metadata(
    FeatureGroupName="feature_group_name",
    FeatureName="feature-name",
    ParameterAdditions=[
        {"Key": "example-key-0", "Value": "example-value-0"},
        {"Key": "example-key-1", "Value": "example-value-1"},
    ]
)
Add a description to a feature

Untuk menambahkan deskripsi ke fitur, tentukan nilai untuk bidang berikut:

  • FeatureGroupName

  • Feature

  • Description


sagemaker_client.update_feature_metadata(
    FeatureGroupName="feature-group-name",
    FeatureName="feature-name",
    Description="description"
)
Remove parameters for a feature

Untuk menghapus semua parameter untuk fitur, lakukan hal berikut.

Tentukan nilai untuk bidang berikut:

  • FeatureGroupName

  • Feature

Tentukan kunci untuk parameter yang Anda hapus di bawahParameterRemovals.


sagemaker_client.update_feature_metadata(
    FeatureGroupName="feature_group_name",
    FeatureName="feature-name",
        ParameterRemovals=[
        {"Key": "example-key-0"},
        {"Key": "example-key-1"},
    ]
)
Remove the description for a feature

Untuk menghapus deskripsi untuk fitur, lakukan hal berikut.

Tentukan nilai untuk bidang berikut:

  • FeatureGroupName

  • Feature

Tentukan string kosong untukDescription.


sagemaker_client.update_feature_metadata(
    FeatureGroupName="feature-group-name",
    FeatureName="feature-name",
    Description=""
)

Contoh kode

Setelah memperbarui metadata untuk suatu fitur, Anda dapat menggunakan DescribeFeatureMetadataoperasi untuk melihat pembaruan yang telah Anda buat.

Kode berikut melewati alur kerja contoh menggunakan AWS SDK for Python (Boto3). Kode contoh melakukan hal berikut:

  1. Mengatur SageMaker lingkungan Anda.

  2. Membuat grup fitur.

  3. Menambahkan fitur ke grup.

  4. Menambahkan metadata ke fitur.

Untuk contoh dan sumber daya Toko Fitur lainnya, lihatSumber daya Toko SageMaker Fitur Amazon.

Langkah 1: Pengaturan

Untuk mulai menggunakan Feature Store, buat SageMaker, boto3 dan sesi Feature Store. Kemudian atur bucket S3 yang ingin Anda gunakan untuk fitur Anda. Ini adalah toko offline Anda. Kode berikut menggunakan bucket SageMaker default dan menambahkan awalan kustom ke dalamnya.

catatan

Peran yang Anda gunakan harus memiliki kebijakan terkelola berikut yang melekat padanya: AmazonS3FullAccess danAmazonSageMakerFeatureStoreAccess.

# SageMaker Python SDK version 2.x is required
%pip install 'sagemaker>=2.0.0'
import sagemaker
import sys

import boto3
import pandas as pd
import numpy as np
import io
from sagemaker.session import Session
from sagemaker import get_execution_role
from botocore.exceptions import ClientError


prefix = 'sagemaker-featurestore-introduction'
role = get_execution_role()

sagemaker_session = sagemaker.Session()
region = sagemaker_session.boto_region_name
s3_bucket_name = sagemaker_session.default_bucket()
sagemaker_client = boto_session.client(service_name='sagemaker', region_name=region)
Langkah 2: Buat grup fitur dan tambahkan fitur

Kode berikut adalah contoh membuat grup fitur dengan definisi fitur.


feature_group_name = "test-for-feature-metadata"
feature_definitions = [
    {"FeatureName": "feature-1", "FeatureType": "String"},
    {"FeatureName": "feature-2", "FeatureType": "String"},
    {"FeatureName": "feature-3", "FeatureType": "String"},
    {"FeatureName": "feature-4", "FeatureType": "String"},
    {"FeatureName": "feature-5", "FeatureType": "String"}
]
try:
    sagemaker_client.create_feature_group(
        FeatureGroupName=feature_group_name,
        RecordIdentifierFeatureName="feature-1",
        EventTimeFeatureName="feature-2",
        FeatureDefinitions=feature_definitions,
        OnlineStoreConfig={"EnableOnlineStore": True}
    )
except ClientError as e:
    if e.response["Error"]["Code"] == "ResourceInUse":
        pass
    else:
        raise e
Langkah 3: Tambahkan metadata

Sebelum Anda menambahkan metadata, gunakan DescribeFeatureGroupoperasi untuk memastikan bahwa status grup fitur adalah. Created


sagemaker_client.describe_feature_group(
        FeatureGroupName=feature_group_name
    )

Tambahkan deskripsi ke fitur.


sagemaker_client.update_feature_metadata(
    FeatureGroupName=feature_group_name,
    FeatureName="feature-1",
    Description="new description"
)

Anda dapat menggunakan DescribeFeatureMetadataoperasi untuk melihat apakah Anda berhasil memperbarui deskripsi untuk grup fitur.


    sagemaker_client.describe_feature_metadata(
    FeatureGroupName=feature_group_name,
    FeatureName="feature-1"
)

Anda juga dapat menggunakannya untuk menambahkan parameter ke grup fitur.


sagemaker_client.update_feature_metadata(
    FeatureGroupName=feature_group_name,
    FeatureName="feature-1",
    ParameterAdditions=[
        {"Key": "team", "Value": "featurestore"},
        {"Key": "org", "Value": "sagemaker"},
    ]
)

Anda dapat menggunakan DescribeFeatureMetadataoperasi lagi untuk melihat apakah Anda telah berhasil menambahkan parameter.


    sagemaker_client.describe_feature_metadata(
    FeatureGroupName=feature_group_name,
    FeatureName="feature-1"
)