Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Aggiunta di metadati individuabili alle funzionalità
In Amazon SageMaker Feature Store, puoi cercare tra tutte le tue funzionalità. Per trovare più facilmente le tue funzionalità, puoi aggiungervi dei metadati. Puoi aggiungere i seguenti tipi di metadati:
-
Descrizione: una descrizione individuabile della caratteristica.
-
Parametri: coppie chiave-valore individuabili.
La descrizione può contenere un massimo di 255 caratteri. Per i parametri, è necessario specificare una coppia chiave-valore nella ricerca. È possibile aggiungere fino a 25 parametri.
Per aggiornare i metadati di una funzionalità, puoi utilizzare la console o l'UpdateFeatureMetadataoperazione.
Come aggiungere metadati ricercabili alle tue funzionalità
Puoi utilizzare la console o l'API Amazon SageMaker Feature Store per aggiungere metadati ricercabili alle tue funzionalità. Le istruzioni per utilizzare Feature Store tramite la console dipendono dal fatto che tu l'abbia abilitata Amazon SageMaker Studio o Amazon SageMaker Studio Classic come esperienza predefinita.
-
Apri la console Studio seguendo le istruzioni riportate in. Avvia Amazon SageMaker Studio
-
Scegli Dati nel riquadro di navigazione a sinistra per espandere l'elenco a discesa.
-
Dall'elenco a discesa, scegli Feature Store.
-
(Facoltativo) Per visualizzare le tue funzionalità, scegli Il mio account. Per visualizzare le funzionalità condivise, scegli Cross account.
-
Per visualizzare i tuoi gruppi di funzionalità, nella scheda Catalogo delle funzionalità, scegli Il mio account.
-
Nella scheda Feature Catalog, scegli Cross account per visualizzare i gruppi di funzionalità che altri rendono individuabili per te. In Creato da, puoi visualizzare l'ID dell'account del proprietario della risorsa del gruppo di funzionalità.
-
Puoi cercare una funzionalità dall'elenco a discesa Ricerca.
-
(Facoltativo) Per filtrare la ricerca, scegli l'icona del filtro accanto all'elenco a discesa Cerca. Puoi utilizzare i filtri per specificare parametri o intervalli di date nei risultati della ricerca. Se cerchi un parametro, specificane sia la chiave che il valore. Per trovare più facilmente le tue funzionalità, puoi specificare intervalli di tempo o deselezionare le colonne che non desideri interrogare.
-
Per le risorse condivise, è possibile modificare i metadati dei gruppi di funzionalità o le definizioni delle funzionalità solo se si dispone dell'autorizzazione di accesso appropriata concessa dall'account del proprietario della risorsa. La sola autorizzazione di reperibilità non consente di modificare i metadati o le definizioni delle funzionalità. Per ulteriori informazioni sulla concessione delle autorizzazioni di accesso, consulta. Abilitazione dell'accesso multi-account
-
-
Scegli la funzionalità.
-
Seleziona Modifica metadati.
-
Nel campo Descrizione, aggiungi o aggiorna la descrizione.
-
Nel campo Parametri, in Parametri, specifica una coppia chiave-valore per il parametro.
-
(Facoltativo) Scegli Aggiungi nuovo parametro per aggiungere un altro parametro.
-
Scegli Save changes (Salva modifiche).
-
Scegli Conferma.
Il codice in questa sezione utilizza l'UpdateFeatureMetadataoperazione descritta in AWS SDK per Python (Boto3) per aggiungere metadati ricercabili alle funzionalità per diversi scenari. Per informazioni sulle altre lingue in cui inviare una richiesta, consulta la sezione Vedi anche nell'Amazon SageMaker API Reference.
Per ulteriori esempi e risorse sul Feature Store, consultaRisorse SageMaker di Amazon Feature Store.
Codice di esempio
Dopo aver aggiornato i metadati di una funzionalità, puoi utilizzare l'operazione DescribeFeatureMetadata per visualizzare gli aggiornamenti apportati.
Il codice seguente illustra un esempio di flusso di lavoro utilizzando AWS SDK per Python (Boto3). Il codice esemplificativo si comporta come segue:
-
Configura il tuo ambiente di SageMaker intelligenza artificiale.
-
Crea un gruppo di funzionalità.
-
Aggiunge funzionalità al gruppo.
-
Aggiunge metadati alle funzionalità.
Per ulteriori esempi e risorse sul Feature Store, consultaRisorse SageMaker di Amazon Feature Store.
Fase 1: configurazione
Per iniziare a utilizzare Feature Store, crea sessioni SageMaker AI, boto3 e Feature Store. Configura quindi il bucket S3 che desideri utilizzare per le tue funzionalità. Questo è il tuo archivio offline. Il codice seguente utilizza il bucket SageMaker AI predefinito e vi aggiunge un prefisso personalizzato.
Nota
Al ruolo utilizzato devono essere collegate le seguenti policy gestite: AmazonS3FullAccess e 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)
Fase 2: creazione di un gruppo di funzionalità e aggiunta di funzionalità
Il codice seguente è un esempio di creazione di un gruppo di funzionalità con definizioni di funzionalità.
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
Fase 3: aggiunta di metadati
Prima di aggiungere i metadati, utilizza l'operazione DescribeFeatureGroup per assicurarti che lo stato del gruppo di funzionalità sia Created.
sagemaker_client.describe_feature_group( FeatureGroupName=feature_group_name )
Aggiungi una descrizione alla funzionalità.
sagemaker_client.update_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1", Description="new description" )
È possibile utilizzare l'DescribeFeatureMetadataoperazione per verificare se la descrizione del gruppo di funzionalità è stata aggiornata correttamente.
sagemaker_client.describe_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1" )
È inoltre possibile utilizzarla per aggiungere parametri al gruppo di funzionalità.
sagemaker_client.update_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1", ParameterAdditions=[ {"Key": "team", "Value": "featurestore"}, {"Key": "org", "Value": "sagemaker"}, ] )
È possibile utilizzare nuovamente l'operazione DescribeFeatureMetadata per verificare se i parametri sono stati aggiunti correttamente.
sagemaker_client.describe_feature_metadata( FeatureGroupName=feature_group_name, FeatureName="feature-1" )
