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’operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html).
## Come aggiungere metadati ricercabili alle funzionalità
Puoi utilizzare la console o l'API Amazon SageMaker Feature Store per aggiungere metadati ricercabili alle tue funzionalità. Le istruzioni sull’utilizzo dell’archivio delle caratteristiche dalla console variano a seconda che l’esperienza predefinita sia impostata su [Amazon SageMaker Studio](studio-updated.md) o [Amazon SageMaker Studio Classic](studio.md).
### Aggiunta di metadati ricercabili alle funzionalità se Studio è la tua esperienza predefinita (console)
1. Apri la console Studio seguendo le istruzioni riportate in [Avvia Amazon SageMaker Studio](studio-updated-launch.md).
1. Scegli **Dati** nel riquadro di navigazione a sinistra per espandere l’elenco a discesa.
1. Dall'elenco a discesa, scegli **Feature Store**.
1. (Facoltativo) Per visualizzare le tue funzionalità, scegli **Il mio account**. Per visualizzare le funzionalità condivise, scegli **Multi-account**.
1. Nella scheda **Catalogo delle funzionalità**, scegli **Il mio account** per visualizzare i tuoi gruppi di funzionalità.
1. Nella scheda **Catalogo delle funzionalità**, scegli **Multi-account** per visualizzare i gruppi di funzionalità resi rilevabili da altri. L’ID dell’account proprietario di risorse del gruppo di funzionalità può essere visualizzato in **Creato da**.
1. 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 stai cercando un parametro, specificane sia la chiave sia il valore. Per trovare più facilmente le funzionalità, puoi specificare intervalli di tempo o deselezionare le colonne che non intendi sottoporre a query.
+ 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 proprietario di risorse. La sola autorizzazione di rilevabilità non consentirà di modificare i metadati o le definizioni delle funzionalità. Per ulteriori informazioni sulla concessione delle autorizzazioni di accesso, consulta [Abilitazione dell'accesso multi-account](feature-store-cross-account-access.md).
1. Scegli la funzionalità.
1. Seleziona **Modifica metadati**.
1. Nel campo **Descrizione**, aggiungi o aggiorna la descrizione.
1. Nel campo **Parametri**, in **Parametri**, specifica una coppia chiave-valore per il parametro.
1. (Facoltativo) Scegli **Aggiungi nuovo parametro** per aggiungere un altro parametro.
1. Scegli **Save changes** (Salva modifiche).
1. Scegli **Conferma**.
### Aggiunta di metadati ricercabili alle funzionalità con SDK per Python (Boto3)
Il codice in questa sezione utilizza l’operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html) descritta in AWS SDK per Python (Boto3) per aggiungere metadati ricercabili alle funzionalità in diversi scenari. Per informazioni sulle altre lingue in cui inviare una richiesta, consulta la sezione [Vedi anche](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateFeatureMetadata.html#API_Search_SeeAlso) nell'*Amazon SageMaker API Reference*.
Per ulteriori esempi e risorse sull’archivio delle caratteristiche, consulta [Risorse SageMaker di Amazon Feature Store](feature-store-resources.md).
------
#### [ Add a list of parameters to a feature ]
Per aggiungere un elenco di parametri a una funzionalità, specifica i valori per i seguenti campi:
+ `FeatureGroupName`
+ `Feature`
+ `Parameters`
Il seguente codice di esempio utilizza AWS SDK per Python (Boto3) per aggiungere due parametri.
```
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 ]
Per aggiungere una descrizione a una funzionalità, specifica i valori per i seguenti campi:
+ `FeatureGroupName`
+ `Feature`
+ `Description`
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature-group-name",
FeatureName="feature-name",
Description="description"
)
```
------
#### [ Remove parameters for a feature ]
Per rimuovere tutti i parametri per una funzionalità, procedi come segue.
Specifica i valori per i seguenti campi:
+ `FeatureGroupName`
+ `Feature`
Specifica le chiavi per i parametri da rimuovere in `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 ]
Per rimuovere la descrizione di una funzionalità, procedi come segue.
Specifica i valori per i seguenti campi:
+ `FeatureGroupName`
+ `Feature`
Specifica una stringa vuota per `Description`.
```
sagemaker_client.update_feature_metadata(
FeatureGroupName="feature-group-name",
FeatureName="feature-name",
Description=""
)
```
------
#### Codice di esempio
Dopo aver aggiornato i metadati di una funzionalità, puoi utilizzare l'operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) 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:
1. Configura il tuo ambiente di SageMaker intelligenza artificiale.
1. Crea un gruppo di funzionalità.
1. Aggiunge funzionalità al gruppo.
1. Aggiunge metadati alle funzionalità.
Per ulteriori esempi e risorse sull’archivio delle caratteristiche, consulta [Risorse SageMaker di Amazon Feature Store](feature-store-resources.md).
##### 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 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureGroup.html) 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"
)
```
Puoi utilizzare l’operazione [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) per verificare se è stata aggiornata correttamente la descrizione del gruppo di funzionalità.
```
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 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeFeatureMetadata.html) per verificare se i parametri sono stati aggiunti correttamente.
```
sagemaker_client.describe_feature_metadata(
FeatureGroupName=feature_group_name,
FeatureName="feature-1"
)
```