Ricerca di gruppi di funzionalità nel Feature Store

Con Amazon SageMaker Feature Store, puoi cercare i gruppi di funzionalità utilizzando la console o l'operazione di ricerca. 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 reperibilità, consulta. Condividi il catalogo del tuo gruppo di funzionalità

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

Puoi cercare le funzionalità utilizzando Amazon SageMaker Studio Classic o l'Searchoperazione nell' SageMaker API. La tabella seguente elenca tutti i metadati ricercabili e indica se è possibile 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	È possibile effettuare ricerche nella console?	Individuabili con account incrociato?
Tutti i tag	AllTags	Sì	No
Motivo dell'errore di creazione	FailureReason	No	No
Stato di creazione	FeatureGroupStatus	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	No	No
Nome del gruppo di funzionalità	FeatureGroupARN	No	No
Nome del gruppo di funzionalità	FeatureGroupName	Sì	Sì
Configurazione dell'archivio offline	OfflineStoreConfig	No	No
Stato dell'archivio offline	OfflineStoreStatus	Sì	Sì
Stato dell’ultimo aggiornamento	LastUpdateStatus	No	No
Nome della funzione di identificazione del record	RecordIdentifierFeatureName	Sì	Sì
Tag	Tags.key	Sì	No

Come trovare i gruppi di funzionalità

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

Trova i gruppi di funzionalità se Studio è la tua esperienza predefinita (console)

1. Apri la console Studio seguendo le istruzioni riportate inAvvia Amazon SageMaker Studio.

2. Scegli Dati nel riquadro di navigazione a sinistra per espandere l'elenco a discesa.

3. Dall'elenco a discesa, scegli Feature Store.

4. (Facoltativo) Per visualizzare i gruppi di funzionalità, scegli Il mio account. Per visualizzare i gruppi di funzionalità condivisi, scegli Cross account.

5. Nella scheda Feature Group Catalog, scegli Il mio account per visualizzare i tuoi gruppi di funzionalità.

6. Nella scheda Feature Group Catalog, scegli Cross account per visualizzare i gruppi di funzionalità che altri hanno reso disponibili per te. In Creato da, puoi visualizzare l'ID dell'account del proprietario della risorsa.

7. Puoi cercare i tuoi gruppi di funzionalità nell'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 cerchi un parametro, specificane sia la chiave che il valore. Per trovare i tuoi gruppi di funzionalità, puoi specificare intervalli di tempo, cancellare (deselezionare) le colonne che non vuoi interrogare, scegliere i negozi in cui cercare o cercare 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 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

Trova gruppi di funzionalità utilizzando SDK for Python (Boto3)

Il codice in questa sezione utilizza l'Searchoperazione descritta in AWS SDK for 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 nell'Amazon SageMaker API Reference.

Per ulteriori esempi e risorse sul Feature Store, consultaRisorse SageMaker di Amazon Feature Store.

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',
    ]
)