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 durchsuchbarer Metadaten zu Ihren Funktionen
Im Amazon SageMaker Feature Store können Sie alle Ihre Funktionen durchsuchen. Um Ihre Funktionen leichter auffindbar zu machen, können Sie ihnen Metadaten hinzufügen. Sie können die folgenden Arten von Metriken überwachen:
+ Beschreibung – Eine durchsuchbare Beschreibung der Funktion.
+ Parameter – Durchsuchbare Schlüssel-Wert-Paare.
Die Beschreibung kann bis zu 255 Zeichen lang sein. Für Parameter müssen Sie bei Ihrer Suche ein Schlüssel-Wert-Paar angeben. Sie können bis zu 25 Parameter hinzufügen.
Um die Metadaten eines Features zu aktualisieren, können Sie entweder die Konsole oder den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html)-Vorgang verwenden.
## So fügen Sie durchsuchbare Metadaten zu Ihren Features hinzu
Sie können die Konsole oder die Amazon SageMaker Feature Store-API verwenden, um Ihren Funktionen durchsuchbare Metadaten hinzuzufügen. Die Anweisungen zur Nutzung des Feature Store über die Konsole hängen davon ab, ob Sie den Feature Store aktiviert haben [Amazon SageMaker Studio](studio-updated.md) oder ob es sich um Ihr [Amazon SageMaker Studio Klassisch](studio.md) Standardkonfiguration handelt.
### Fügen Sie durchsuchbare Metadaten zu Funktionen hinzu, wenn Studio Ihr Standardkonfiguration ist (Konsole)
1. Öffnen Sie die Studio-Konsole, indem Sie den Anweisungen unter [Starten Sie Amazon SageMaker Studio](studio-updated-launch.md) folgen.
1. Wählen Sie im linken Navigationsbereich **Daten** aus, um die Dropdownliste zu erweitern.
1. Wählen Sie aus der Dropdown-Liste **Feature Store**.
1. (Optional) Um Ihre Funktionen anzuzeigen, wählen Sie **Mein Konto** aus. Wählen Sie **Kontoübergreifend** aus, um gemeinsam genutzte Funktionen anzuzeigen.
1. Auf der Registerkarte **Feature-Katalog** können Sie **Mein Konto** auswählen, um Ihre Feature-Gruppen anzuzeigen.
1. Auf der Registerkarte **Feature-Katalog** können Sie **Kontoübergreifend** auswählen, um Feature-Gruppen anzuzeigen, die für Sie auffindbar sind. Die Konto-ID des Ressourcenbesitzers der Feature-Gruppe finden Sie unter **Erstellt von**.
1. Sie können in der Dropdown-Liste **Suchen nach** Ihrer Funktion suchen.
+ (Optional) Wenn Sie Ihre Suche filtern möchten, wählen Sie das Filtersymbol neben der Dropdown-Liste **Suchen** aus. Sie können Filter verwenden, um Parameter oder Datumsbereiche in Ihren Suchergebnissen anzugeben. Wenn Sie nach einem Parameter suchen, geben Sie sowohl seinen Schlüssel als auch seinen Wert an. Um Ihre Features leichter zu finden, können Sie Zeitbereiche angeben oder die Auswahl von Spalten aufheben, die Sie nicht abfragen möchten.
+ Bei gemeinsam genutzten Ressourcen können Sie Feature-Gruppen-Metadaten oder Feature-Definitionen nur bearbeiten, wenn Ihnen das Konto des Ressourcenbesitzers die entsprechende Zugriffsberechtigung erteilt hat. Mit der Berechtigung „Auffindbarkeit“ allein können Sie keine Metadaten oder Feature-Definitionen bearbeiten. Weitere Informationen zum Erteilen der Zugriffsberechtigungen finden Sie unter [Aktivierung des kontoübergreifenden Zugriffs](feature-store-cross-account-access.md).
1. Wählen Sie Ihre Funktion aus.
1. Wählen Sie **Metadaten bearbeiten**.
1. Geben Sie im Feld **Beschreibung** eine Beschreibung für die Regel ein.
1. Geben Sie im Feld **Parameter** unter **Parameter** ein Schlüssel-Wert-Paar für den Parameter an.
1. (Optional) Wählen Sie **Neuen Parameter hinzufügen**, um einen weiteren Parameter hinzuzufügen.
1. Wählen Sie **Änderungen speichern ** aus.
1. Wählen Sie **Bestätigen** aus.
### Fügen Sie mit SDK for Python (Boto3) durchsuchbare Metadaten zu Ihren Funktionen hinzu
Der Code in diesem Abschnitt verwendet den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html)Vorgang in, AWS SDK für Python (Boto3) um Ihren Funktionen durchsuchbare Metadaten für verschiedene Szenarien hinzuzufügen. Informationen zu den anderen Sprachen, in denen Sie eine Anfrage einreichen können, finden Sie [unter „Siehe auch](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html#API_Search_SeeAlso)“ in der *Amazon SageMaker API-Referenz*.
Weitere Beispiele und Ressourcen für Feature Store finden Sie unter [Ressourcen für den Amazon SageMaker Feature Store](feature-store-resources.md).
------
#### [ Add a list of parameters to a feature ]
Um einem Feature eine Liste von Parametern hinzuzufügen, geben Sie Werte für die folgenden Felder an:
+ `FeatureGroupName`
+ `Feature`
+ `Parameters`
Der folgende Beispielcode verwendet die AWS SDK für Python (Boto3) , um zwei Parameter hinzuzufügen.
```
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 ]
Um einem Feature eine Beschreibung hinzuzufügen, geben Sie Werte für die folgenden Felder ein:
+ `FeatureGroupName`
+ `Feature`
+ `Description`
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature-group-name",
FeatureName="feature-name",
Description="description"
)
```
------
#### [ Remove parameters for a feature ]
Gehen Sie wie folgt vor, um alle Parameter für ein Feature zu entfernen.
Geben Sie Werte für folgende Felder ein:
+ `FeatureGroupName`
+ `Feature`
Geben Sie die Schlüssel für die Parameter an, die Sie entfernen möchten, unter `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 ]
Gehen Sie wie folgt vor, um die Beschreibung für ein Feature zu entfernen.
Geben Sie Werte für folgende Felder ein:
+ `FeatureGroupName`
+ `Feature`
Geben Sie eine leere Zeichenfolge für an `Description`.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature-group-name",
FeatureName="feature-name",
Description=""
)
```
------
#### Beispiel-Code
Nachdem Sie die Metadaten für ein Feature aktualisiert haben, können Sie den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) Vorgang verwenden, um die von Ihnen vorgenommenen Aktualisierungen anzuzeigen.
Der folgende Code durchläuft einen Beispiel-Workflow mit dem AWS SDK für Python (Boto3). Das Codebeispiel führt die folgenden Aufgaben durch:
1. Richtet Ihre SageMaker KI-Umgebung ein.
1. Erstellt eine Funktionsgruppe.
1. Fügt der Gruppe Funktionen hinzu.
1. Fügt den Features Metadaten hinzu.
Weitere Beispiele und Ressourcen für Feature Store finden Sie unter [Ressourcen für den Amazon SageMaker Feature Store](feature-store-resources.md).
##### Schritt 1: Einrichtung
Um mit der Nutzung von Feature Store zu beginnen, erstellen Sie SageMaker AI-, Boto3- und Feature Store-Sitzungen. Richten Sie dann den S3-Bucket ein, den Sie für Ihre Funktionen verwenden möchten. Dies ist Ihr Offline-Speicher. Der folgende Code verwendet den SageMaker AI-Standard-Bucket und fügt ihm ein benutzerdefiniertes Präfix hinzu.
**Anmerkung**
Der Rolle, die Sie verwenden, müssen die folgenden verwalteten Richtlinien zugeordnet sein: `AmazonS3FullAccess` und `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)
```
##### Schritt 2: Erstellen einer Feature-Gruppe und Hinzufügen von Funktionen
Der folgende Code ist ein Beispiel für die Erstellung einer Feature-Gruppe mit Feature-Definitionen.
```
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
```
##### Schritt 3: Hinzufügen von Metadaten
Stellen Sie vor dem Hinzufügen von Metadaten mithilfe des [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) Vorgangs sicher, dass der Status der Feature-Gruppe `Created` lautet.
```
sagemaker_client.describe_feature_group(
FeatureGroupName=feature_group_name
)
```
Fügen Sie dem Feature eine Beschreibung hinzu.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1",
Description="new description"
)
```
Sie können den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html)-Vorgang verwenden, um festzustellen, ob Sie die Beschreibung für die Feature-Gruppe erfolgreich aktualisiert haben.
```
sagemaker_client.describe_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1"
)
```
Sie können ihn auch verwenden, um der Featuregruppe Parameter hinzuzufügen.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1",
ParameterAdditions=[
{"Key": "team", "Value": "featurestore"},
{"Key": "org", "Value": "sagemaker"},
]
)
```
Sie können den [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) Vorgang erneut verwenden, um zu überprüfen, ob Sie die Parameter erfolgreich hinzugefügt haben.
```
sagemaker_client.describe_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1"
)
```