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à.

# Ricerca di gruppi di funzionalità nel Feature Store
<a name="feature-store-search-feature-group-metadata"></a>

Con Amazon SageMaker Feature Store, puoi cercare i gruppi di funzionalità utilizzando la console o l'operazione [di ricerca](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html). Puoi utilizzare la funzionalità di ricerca per trovare funzionalità e gruppi di funzionalità pertinenti ai modelli in fase di creazione. Puoi utilizzare la funzionalità di ricerca per trovare rapidamente i gruppi di funzionalità pertinenti al tuo caso d'uso.

**Nota**  
I gruppi di funzionalità che stai cercando devono trovarsi all'interno del tuo Regione AWS AWS account oppure essere condivisi e resi visibili al tuo Account AWS. Per ulteriori informazioni su come condividere il catalogo dei gruppi di funzionalità e garantire la rilevabilità, consulta [Condividi il catalogo del tuo gruppo di funzionalità](feature-store-cross-account-discoverability-share-feature-group-catalog.md).

La tabella seguente mostra i campi ricercabili e indica se puoi utilizzare la console per cercare un campo specifico.

Puoi cercare le funzionalità utilizzando Amazon SageMaker Studio Classic o l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)operazione nell' SageMaker API. La tabella seguente elenca tutti i metadati ricercabili e indica se puoi cercarli nella console. I tag possono essere ricercati per i tuoi gruppi di funzionalità, ma non per i gruppi di funzionalità resi individuabili dall'utente.


****  

| Metadati individuabili | Nome del campo API | Ricercabile nella console? | Individuabili con account incrociato? | 
| --- | --- | --- | --- | 
| Tutti i tag | AllTags | Sì | No | 
| Motivo dell'errore di creazione | FailureReason | No | No | 
| Stato di creazione | [FeatureGroupStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | Sì  | Sì | 
| Ora di creazione | CreationTime | Sì  | Sì | 
| Description | Description | Sì  | Sì | 
| Nome della funzionalità dell’ora dell’evento | EventTimeFeatureName | No | No | 
| Definizioni delle funzionalità | [FeatureDefinitions](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureDefinition.html) | No | No | 
| Nome del gruppo di funzionalità | [FeatureGroupARN](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | No | No | 
| Nome del gruppo di funzionalità | [FeatureGroupName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | Sì  | Sì | 
| Configurazione dell'archivio offline | [OfflineStoreConfig](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreConfig.html) | No | No | 
| Stato dell'archivio offline | [OfflineStoreStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreStatus.html) | Sì  | Sì | 
| Stato dell’ultimo aggiornamento | [LastUpdateStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_LastUpdateStatus.html) | No | No | 
| Nome della funzione di identificazione del record | RecordIdentifierFeatureName | Sì  | Sì | 
| Tag | Tags.key | Sì | No | 

## Come trovare i gruppi di funzionalità
<a name="feature-store-search-feature-group-metadata-how-to"></a>

Puoi utilizzare la console o l'API Amazon SageMaker Feature Store per trovare i tuoi gruppi di 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).

### Ricerca dei gruppi di funzionalità se Studio è la tua esperienza predefinita (console)
<a name="feature-store-search-feature-group-metadata-how-to-using-studio-updated"></a>

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 i tuoi gruppi di funzionalità, scegli **Il mio account**. Per visualizzare i gruppi di funzionalità condivisi, scegli **Multi-account**.

1. Nella scheda **Catalogo del gruppo di funzionalità**, scegli **Il mio account** per visualizzare i tuoi gruppi di funzionalità.

1. Nella scheda **Catalogo del gruppo di funzionalità**, scegli **Multi-account** per visualizzare i gruppi di funzionalità resi rilevabili da altri. In **Creato da**, puoi visualizzare l’ID dell’account proprietario di risorse.

1. Puoi cercare i gruppi di funzionalità dall’elenco a discesa **Cerca**.
   + (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 i gruppi di funzionalità, puoi specificare degli intervalli di tempo, rimuovere (deselezionare) le colonne da escludere dalle query, scegliere in quali archivi cercare o filtrare per stato.
   + 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).

### Ricerca dei gruppi di funzionalità con SDK per Python (Boto3)
<a name="feature-store-search-feature-group-metadata-how-to-with-sdk"></a>

Il codice in questa sezione utilizza l'[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)operazione in AWS SDK per Python (Boto3) per eseguire la query di ricerca per trovare i gruppi di funzionalità. Per informazioni sulle altre lingue in cui inviare una richiesta, consulta la sezione [Vedi anche](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.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).

Il codice seguente mostra diversi esempi di query di ricerca che utilizzano l’API:

```
# Return all feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
)  

# Search for feature groups that are shared with your account
sagemaker_session.search(
    resource="FeatureGroup",
    search_expression={
        "Filters": [
            {
                "Name": "FeatureGroupName",
                "Value": "MyFeatureGroup",
                "Operator": "Contains",
            }
        ],
        "Operator": "And",
    },
    sort_by="Name",
    sort_order="Ascending",
    next_token="token",
    max_results=50,
    CrossAccountFilterOption="SameAccount"
)

# Search for all feature groups with a name that contains the "ver" substring
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
        ]
    }
)

# Search for all feature groups that have the EXACT name "airport"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Equals',
                'Value': 'airport'
            },
        ]
    }
)

# Search for all feature groups that contains the name "ver"
# AND have a record identifier feature name that contains "wha"
# AND have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ]
    }
)  

# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR feature groups that have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)              


# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR tags with the value 'Sage' for the 'org' key
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'Tags.org', 
                'Operator': 'Contains',
                'Value': 'Sage'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)

# Search for all offline only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'NotEquals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)

# Search for all online only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'NotExists'
            }
        ]
    }
)

# Search for all feature groups that are BOTH online and offline
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)
```

Puoi anche usare python SDK di AWS RAM APIs per creare una condivisione di risorse. La firma API è riportata di seguito. Per utilizzare Python SDK of AWS RAM API, è necessario allegare una policy gestita ad accesso AWS RAM completo con il ruolo di esecuzione.

```
response = client.create_resource_share(
    name='string',
    resourceArns=[
        'string',
    ],
    principals=[
        'string',
    ],
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    allowExternalPrincipals=True|False,
    clientToken='string',
    permissionArns=[
        'string',
    ]
)
```