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. [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html)
## 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](studio-updated.md) atau [Amazon SageMaker Studio Klasik](studio.md) sebagai pengalaman default Anda.
### Tambahkan metadata yang dapat dicari ke fitur jika Studio adalah pengalaman default Anda (konsol)
1. Buka konsol Studio dengan mengikuti petunjuk di[Luncurkan Amazon SageMaker Studio](studio-updated-launch.md).
1. Pilih **Data** di panel navigasi kiri, untuk memperluas daftar dropdown.
1. Dari daftar dropdown, pilih **Feature** Store.
1. (Opsional) Untuk melihat fitur Anda, pilih **Akun saya**. Untuk melihat fitur bersama, pilih **Cross account**.
1. Untuk melihat grup fitur Anda, di bawah tab **Katalog Fitur**, pilih **Akun saya**.
1. 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.
1. Anda dapat mencari fitur Anda di daftar dropdown **Pencarian**.
+ (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](feature-store-cross-account-access.md)
1. Pilih fitur Anda.
1. Pilih **Edit metadata**.
1. Di bidang **Deskripsi**, tambahkan atau perbarui deskripsi.
1. Di bidang **Parameter** di bawah **Parameter**, tentukan pasangan kunci-nilai untuk parameter.
1. (Opsional) Pilih **Tambahkan parameter baru** untuk menambahkan parameter lain.
1. Pilih **Simpan perubahan**.
1. Pilih **Konfirmasi**.
### Tambahkan metadata yang dapat dicari ke fitur Anda menggunakan SDK for Python (Boto3)
Kode di bagian ini menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html)operasi di AWS SDK untuk 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](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html#API_Search_SeeAlso) di *Referensi Amazon SageMaker API*.
Untuk contoh dan sumber daya Toko Fitur lainnya, lihat[Sumber daya Toko SageMaker Fitur Amazon](feature-store-resources.md).
------
#### [ Add a list of parameters to a feature ]
Untuk menambahkan daftar parameter ke fitur, tentukan nilai untuk bidang berikut:
+ `FeatureGroupName`
+ `Feature`
+ `Parameters`
Kode contoh berikut menggunakan AWS SDK untuk 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 bawah`ParameterRemovals`.
```
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 untuk`Description`.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName={{"feature-group-name"}},
FeatureName={{"feature-name"}},
Description=""
)
```
------
#### Contoh kode
Setelah memperbarui metadata untuk suatu fitur, Anda dapat menggunakan [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html)operasi untuk melihat pembaruan yang telah Anda buat.
Kode berikut melewati alur kerja contoh menggunakan file. AWS SDK untuk Python (Boto3) Kode contoh melakukan hal berikut:
1. Menyiapkan lingkungan SageMaker AI Anda.
1. Membuat grup fitur.
1. Menambahkan fitur ke grup.
1. Menambahkan metadata ke fitur.
Untuk contoh dan sumber daya Toko Fitur lainnya, lihat[Sumber daya Toko SageMaker Fitur Amazon](feature-store-resources.md).
##### Langkah 1: Pengaturan
Untuk mulai menggunakan Feature Store, buat sesi SageMaker AI, boto3, dan Feature Store. Kemudian atur bucket S3 yang ingin Anda gunakan untuk fitur Anda. Ini adalah toko offline Anda. Kode berikut menggunakan bucket default SageMaker AI dan menambahkan awalan khusus ke dalamnya.
**catatan**
Peran yang Anda gunakan harus memiliki kebijakan terkelola berikut yang melekat padanya: `AmazonS3FullAccess` dan`AmazonSageMakerFeatureStoreAccess`.
```
# 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 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html)operasi untuk memastikan status grup fitur. `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 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html)operasi 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 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html)operasi lagi untuk melihat apakah Anda telah berhasil menambahkan parameter.
```
sagemaker_client.describe_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1"
)
```